7.1.1 Setting up the data collection tools

The Windows versions of JP1/AJS3 - Manager, JP1/AJS3 - Agent, JP1/AJS3 - View, and JP1/AJS3 - Web Console provide data collection tools that can be used for collecting log data.

There are two data collection tools:

jajs_log.bat

Use this tool if you did not change the output destinations of log files and other data from their default values, or if you need to collect standard data items only. You cannot customize this tool.
_04.bat

Use this tool if you changed the output destinations of log files and other data from their default values, or if you need to collect non-standard data items. You can customize this tool to change the output destinations of log data and the storage locations of data to be collected.

Note that _04.bat is not provided by JP1/AJS3 - Web Console.

After installing JP1/AJS3 - Manager, JP1/AJS3 - Agent, or JP1/AJS3 - View, copy the data collection tool (_04.bat) to another folder and use it from that folder.

You can also collect only the log data you need by using Windows Explorer to copy a folder.

To set up the environment needed to use the data collection tool (_04.bat):

Use Explorer or another means to copy the data collection tool (_04.bat) to any folder. The location of the tool is as follows.
- For JP1/AJS3 - Manager or JP1/AJS3 - Agent
  
  JP1/AJS3-Manager-or-JP1/AJS3-Agent-installation-folder\tools\_04.bat
  
  This data collection tool also allows you to collect log data for JP1/AJS3 - View on the same host.
- For JP1/AJS3 - View
  
  JP1/AJS3-View-installation-folder\tools\_04.bat
  
  This data collection tool also allows you to collect log data for JP1/AJS3 - Manager or JP1/AJS3 - Agent on the same host.

Edit the copied data collection tool, and then change the file name to any convenient name.

Use a text editor to edit the data collection tool.

The table below lists the initial values specified in the data collection tool. You can change any inappropriate initial values to the appropriate values. If you change a value, do not use characters and symbols that have special meanings in a batch file. If you use such characters and symbols, an error might occur.

Table 7‒1: Initial values specified in the data collection tool
No.	Item	Initial value
1	HNTRLib installation folder	`@set INST_DIR_HNTRLIB=%PROGRAMFILES_DIR%\hitachi\HNTRLib`
2	HNTRLib2 installation folder	`@set INST_DIR_HNTRLIB2=%PROGRAMFILES_DIR%\hitachi\HNTRLib2`
3	JP1/AJS3 database storage folder^#1	`@set INST_DIR_DATABASE=%INST_DIR_MANAGER%\hitachi\JP1AJS2\database`
4	Folder for storing JP1/AJS3 temporary files	`@set LOG_DIR_AJSPDDIR=%INST_DIR_MANAGER%\tmp\schedule`
5	JP1/AJS3 job error information folder	`@set LOG_DIR_JOBINF=%INST_DIR_MANAGER%\jobinf`
6	Folder in which data collected by the data collection tool will be saved^#2	`@set DIR_BACKLOG=%TEMP%\jp1ajs2\backlog`
7	Folder used for storing data other than the above	`@rem @set DIR_ADD=` Delete `@rem`, and then specify the absolute path to the folder. Use this item if you have changed the log file destinations from the default^{#3, #4} or if you want to collect other information. To specify multiple folders, use spaces as delimiters as shown in the example below. If the absolute path contains a space character, you must enclose the entire path in double quotation marks (`"`). Example: `@set DIR_ADD=new-scheduler-log-output-folder` `"new-scheduler-trace-log-output-folder"`

#1:

Data will not be collected if directories in a location not under this directory are set for the scheduler service and the job execution environment database.

Place each database file under the desired directory, and specify the absolute path to that directory.

#2:

If the path of the backup destination for data collected by the data collection tool is too long, data collection might fail. If data collection fails, try again by specifying a shorter path. When specifying the backup-destination path for collected data, do not enclose the path in double quotation marks (").

#3:

For details about the log file storage folders initially specified in the data collection tool, see 1.2.5 List of log files and directories in the manual JP1/Automatic Job Management System 3 Troubleshooting and the list of files or folders in the appendix of the JP1/Base User's Guide.

#4:

The following table lists the output destinations that can be changed after JP1/AJS3 is installed.

Table 7‒2: List of output destinations that can be changed after JP1/AJS3 is installed
Control	Output destination that can be changed	Environment setting parameter
System management	System directory	`AJSSYSDIR`
	Log directory	`AJSLOGDIR`
	Host-based scheduler log file 1	`HOSTLOGFILE1`
	Host-based scheduler log file 2	`HOSTLOGFILE2`
Scheduler service	Scheduler trace log file	`TRACELOGFILE`
	Scheduler trace log file per scheduler service	`TRACELOGDIVDIR`
	Scheduler log file 1	`AJSLOGFILE1`
	Scheduler log file 2	`AJSLOGFILE2`
	Job error information directory	`JOBINFDIR`
	Database directory	`AJSDBDIRECTORY`
	System directory	`AJSSYSDIR`
	Log directory	`AJSLOGDIR`
JP1/AJS3 definition pre-check function	Definition check log directory	`AJSCHK_LOGDIR`
JP1/AJS3 definition pre-check function	Trace log file	`AJSCHK_TRACELOGFILE`
Queueless job execution environment	Trace log file	`AJSQL_TRACELOGFILE`
	Storage directory for internal log data output by the queueless file transfer service	`AJSQL_EXECLOG_FTPPATH`
	Storage directory for internal log data output by the queueless agent service	`AJSQL_EXECLOG_AGTPATH`
	Work path for queueless jobs or directory for temporary files	`AJSQL_AGTWORKPATH`

Cautionary note on the data collection tool (_04.bat):

The data collection tool (_04.bat) of JP1/AJS3 09-00 or later does not require the following modification:

When you use 64-bit Windows and the JP1/AJS3 data collection tool (_04.bat) in the WOW64 (Windows On Windows 64) environment to collect data, you need to modify the data collection tool (_04.bat).

The following describes the procedure for modifying the data collection tool (_04.bat):

Copy the data collection tool (_04.bat) to any folder.
Use a text editor to edit the copied batch file as follows, and then save the file with any file name.

To Page Top