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
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.
-