6.3.2 The procedures for collecting the data of JP1/DH - AJE (Job Execution)

(a) About the information collection tool

The information collection tool is a batch file.

In Windows

1. The file path

   <The install destination folder of JP1/DH - AJE (Job Execution)>\tools\dhaje_log.bat

2. The function

   This tool collects the following data as files

   Table 6‒2: The data that is collected by the information collection tool (In Windows)

   Items	Assumed size [KB]	Contents	Storage file or folder of the collected data
   The files under the install destination folder ob JP1/DH - AJE (Job Execution)	281,600+ (The operation log file size * the number of the backup files of the operation log file)	The files under the install destination folder of JP1/DH - AJE	file\sdata\DHAJE\
   The log files	Variable by the environment settings	The log files of JP1/DH - AJE (Job Execution)	The case of a default: file\pdata\log\dhajee_information[x].log When you change the destination of the log file: file\cdata\log_custom\dhajee_information[x].log
   The registry information about JP1/DH - AJE (Job Execution)	20	The contents of the following registry keys: HKEY_LOCAL_MACHINE\SOFTWARE\HITACHI\JP1DH\AJE\AJEE HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\HITACHI\JP1DH\AJE\AJEE(In theWow64 Environment)	registry1.txt or registry2.txt #1
   The process list of OS	20	Image name Process ID Session name Session Memory usage Status User name CPU time Window title	tasklist.txt
   The system information of OS	15	Host Name OS Name OS Version OS Manufacturer OS Configuration OS Build Type Registered Owner Registered Organization Product ID Original Install Date System Boot Time System Manufacturer System Model System Type Processor(s) BIOS Version Windows Directory System Directory Boot Device System Locale Input Locale Time Zone Total Physical Memory Available Physical Memory Virtual Memory: Max Size Virtual Memory: Available Virtual Memory: In Use Page File Location(s) domain Logon Server Hotfix(s) Network Card(s)	systeminfo.txt
   The system information of Windows event log	Variable by the server condition	Log Name Source Date Event ID Task Level Opcode Keyword User User Name Computer Description	evevtsystem.txt
   The application information of Windows event log	Variable by the server condition	Log Name Source Date Event ID Task Level Opcode Keyword User User Name Computer Description	eventapp.txt
   The information of netstat	2	All connections and listening ports	netstata.txt
   The information of netstat	2	Ethernet statistics	netstate.txt
   The information of netstat	2	Address and port numbers	netstatn.txt
   The information of netstat	2	Routing table	netstatr.txt
   The information of netstat	2	Per-protocol statistics	netstats.txt
   Program files that used by system	Variable by the server condition	Program files that used by system	Not publication

   #1 The registry1.txt is made if JP1/DH - AJE (Job Execution) is installed in a 32bit OS, and the registry2.txt is made if JP1/DH - AJE (Job Execution) is installed in a 64bit OS.

   Make sure there is enough space as the output destination of the information collection tool. In addition, don't run DH custom jobs during the running of the information collection tool. If you run a DH custom job during the running of the information collection tool, the running of the DH custom job may fail.

   During practice of information collection tool, please do not access output destination of the information collection tool.

   And then, don't move the information collection tool. Use it in the installed place.

3. The execute permission

   An OS user who has Administrators privilege.

4. The procedure of running the information collection tool

   1. If a problem occurred in a host that JP1/DH - AJE is installed, log in to the host as an OS user who has the administrator's privilege.

   2. If you want to change the output destination of information that is collected by the information collection tool, edit the tool (dhaje_log.bat) by an editor, and changes the "OUT_DIR_CUST" to the folder that you want to output information. The folder name that you specified as the "OUT_DIR_CUST" shouldn't be enclosed by double quotes even though the folder name includes spaces.

   Example:

   set OUT_DIR_CUST=C:\temp\JP1DHAJE

   3. You edit The information collection tool (dhaje_log.bat) by editors and, for CUST_LOG_DIR or CUST_RCV_DIR or CUST_WRK_DIR, set the folder name which you changed, when you change modifiable item "the destination folder of outputting operation log files <LogOutDir >" or "the storage folder of files that is used by system <RecvListDir>" or "work folder that is used by running of DH Custom Job <SendRecvTemp>" in Environment configuration file(config.xml). The folder name that you specified as the "OUT_DIR_CUST" shouldn't be enclosed by double quotes even though the folder name includes spaces.

   Example:

   set CUST_LOG_DIR=C:\temp\JP1DHAJE\log set CUST_RCV_DIR=C:\tempJP1DHAJE\recvlist set CUST_WRK_DIR=C:\temp\JP1DHAJE\work

   4. Execute the information collection tool.

5. The exit status code

   Table 6‒3: The exit status code of the information collection tool

   Exit status code	Meaning	Contents
   0	Normal	The collection of information has finished normally.
   1	Warning	The running of the information collection tool was canceled. If the output destination folder \already existed, the tool asks to a user whether the tool remove the folder or not. If the user select "N", the tool does not remove the folder, stop the running, and return the exit status code.
   10	Error	The collection of information has failed.

6. The storage folder of the result of running of the information collection tool

   If you didn't change the OUT_DIR_CUST, the result of running of the information collection tool is stored in the following folder:

   %TEMP%\DHAJE\backlog\information

   %TEMP% means the environment value %TEMP% of Windows.

   Note: When you carry out the overwrite installation from 10-00 version, the information collection tool (dhaje_log.bat) returns to initial state. When you change contents of the information collection tool (dhaje_log.bat) in 10-00 version, carry it out after editing the information collection tool (dhaje_log.bat) again.

In Linux

1. The file path

   /opt/jp1dh/aje/ajee/tools/dhaje_log.sh

2. The function

   This tool collects the following data as files

   Table 6‒4: The data that is collected by the information collection tool (In Linux)

   Items	Assumed size [KB]	Contents	Storage file or folder of the collected data
   The files under the install destination folder ob JP1/DH - AJE (Job Execution)	281,600+ (The operation log file size * the number of the backup files of the operation log file)	The files under the install destination folder of JP1/DH - AJE	file/sdata
   The log files	Variable by the environment settings	The log files of JP1/DH - AJE (Job Execution)	The case of a default: file/pdata/log/dhajee_information[x].log When you change the destination of the log file: file/cdata/log_custom/dhajee_information[x].log
   The process list of OS	20	List of processes starting in the system	Process.txt
   The system information of OS	20	Information of the system	systeminfo.txt
   The information of syslog	Variable by the system condition	syslog files	syslog/
   The information of netstat	2	All connections and listening ports	netstata.txt
   The information of netstat	2	Ethernet statistics	netstate.txt
   The information of netstat	2	Address and port numbers	netstatn.txt
   The information of netstat	2	Routing table	netstatr.txt
   The information of netstat	2	Per-protocol statistics	netstats.txt
   The patch information of OS	Variable by the system condition	The patch information of OS	rpminfo.txt
   Program files that used by system	Variable by the send/receive condition	Program files that used by system	Not publication

   Make sure there is enough space as the output destination of the information collection tool. In addition, don't run DH custom jobs during the running of the information collection tool. If you run a DH custom job during the running of the information collection tool, the running of the DH custom job may fail.

   During practice of information collection tool, please do not access output destination of the information collection tool.

   And then, don't move the information collection tool. Use it in the installed place.

3. The execute permission

   An OS user who has superuser privilege.

4. The procedure of running the information collection tool

   1. If a problem occurred in a host that JP1/DH - AJE is installed, log in to the host as an OS user who has the superuser's privilege.

   2. If you want to change the output destination of information that is collected by the information collection tool, edit the tool (dhaje_log.sh) by an editor, and changes the "OUT_DIR_CUST" to the folder that you want to output information. The folder name that you specified as the "OUT_DIR_CUST" shouldn't be enclosed by double quotes even though the folder name includes spaces.

   Example:

   OUT_DIR_CUST="/tmp/ajee/backlog"

   3. You edit The information collection tool(dhaje_log.sh) by editors and, for CUST_LOG_DIR or CUST_RCV_DIR or CUST_WRK_DIR, set the folder name which you changed, when you change modifiable item "the destination folder of outputting operation log files <LogOutDir >" or "the storage folder of files that is used by system <RecvListDir>" or "work folder that is used by running of DH Custom Job <SendRecvTemp>" in Environment configuration file(config.xml).

   Example:

   CUST_LOG_DIR="/tmp/DHAJE/log" CUST_RCV_DIR="/tmp/DHAJE/recvlist" CUST_WRK_DIR="tmp/DHAJE/work"

   4. Execute the information collection tool.

5. The exit status code

   Table 6‒5: The exit status code of the information collection tool

   Exit status code	Meaning	Contents
   0	Normal	The collection of information has finished normally.
   1	Warning	The running of the information collection tool was canceled. If the output destination folder \already existed, the tool asks to a user whether the tool remove the folder or not. If the user select "N", the tool does not remove the folder, stop the running, and return the exit status code.
   10	Error	The collection of information has failed.

6. The storage folder of the result of running of the information collection tool

   If you didn't change the OUT_DIR_CUST, the result of running of the information collection tool is stored in the following folder:

   /tmp/ajee/backlog/information

(a) The DH custom job definition information

See manual Job Management Partner 1/Automatic Job Management System 3 Administration Guide Backing Up and Restoring Jobnets about the getting method of the definition information.

(b) The information of JP1/AJS3 - Manager or JP1/AJS3 - Agent that DH custom jobs have been executed on them.

See Job Management Partner 1/Automatic Job Management System 3 Troubleshooting Collecting data for troubleshooting about the getting method of the information.