1.2.3 Execution result log
The log data in execution result logs allows a user on an agent host to check information about the executions of event jobs, custom event jobs and other jobs. A user on the manager host might not be able to check the execution statuses of event jobs, custom event jobs and other jobs that are run on an agent host because of, for example, a communication error. In such cases, a user on the agent host can check the execution statuses of event jobs, custom event jobs and other jobs by using the execution result logs.
There are two execution result logs:
-
Job execution result log file
-
Event job execution result log file
- Organization of this subsection
(1) Job execution result log file
The log data in the job execution result log file allows a user on an agent host to check the execution statuses of jobs. This file is output if 1 or 2 is set for the JOBEXECRESULTLOG environment parameter.
(a) Output destination of the job execution result log file
The job execution result log file is output to the directory that is specified in the JOBEXECRESULTLOGPATH environment setting parameter. The following shows the default directory.
For Windows, if the installation folder is the default installation folder or is in a folder protected by the system:
-
For a physical host:
%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\log\jobexecresult
The default value for %ALLUSERSPROFILE% is system-drive\ProgramData.
A folder protected by the system is the path to a folder in any of the following:
-
system-drive\Windows
-
system-drive\Program Files
-
system-drive\Program Files (x86)
-
-
For a logical host:
shared-folder\jp1ajs2\log\jobexecresult
For Windows, if the installation folder is other than the above:
-
For a physical host:
JP1/AJS3-installation-folder\log\jobexecresult
-
For a logical host:
shared-folder\jp1ajs2\log\jobexecresult
For UNIX/Linux:
-
For a physical host:
/var/opt/jp1ajs2/log/jobexecresult
-
For a logical host:
shared-dircetory/jp1ajs2/log/jobexecresult
(b) Format of data output to the job execution result log file
The contents of the job execution result log file can be viewed in a text editor. The following figure shows an example of output to a job execution result log file.
|
The following tables describe the headers and output items in the job execution result log file.
Header |
Explanation |
---|---|
OS information |
The OS on which the log output function is running. |
Host name |
The name of the host on which the log output function is running. |
Time zone |
The time zone set for the OS. |
Time the log output function started |
The time that the log output function started |
Output item |
Explanation |
---|---|
Number (4 digits) |
The sequence number of the message record. |
Date (10 bytes) |
The date the message was collected: yyyy/mm/dd (year/month/day) |
Time (12 bytes) |
The local time the message was collected: hh:mm:ss.sss (hour:minutes:seconds.milliseconds) |
Application name (16 bytes or less) |
The name of the process for which the message is output. One of the following application names is output:
|
Process ID |
Process ID A process ID is output as a hexadecimal number. |
Thread ID |
Thread ID A thread ID is output as a hexadecimal number. |
Message ID |
Message ID The messages that are output to the job execution result log file are as follows:
|
Message text |
The text of a message output to the job execution result log file. For information about the message text for each message ID, see 5.1 List of messages beginning with KAVU in the manual JP1/Automatic Job Management System 3 Messages. |
(2) Event job execution result log file
The log data in the event job execution result log file allows a user on an agent host to check the execution statuses of event jobs and custom event jobs. This file is output if 1 or 2 is set for the EVJOBEXECRESULTLOG environment parameter.
(a) Output destination of the event job execution result log file
The event job execution result log file is output to the directory that is specified in the EVJOBEXECRESULTLOGPATH environment setting parameter. The following shows the default directory.
For Windows, if the installation folder is the default installation folder or is in a folder protected by the system:
-
For a physical host:
%ALLUSERSPROFILE%\Hitachi\JP1\JP1_DEFAULT\JP1AJS2\log\evjobexecresult
The default value for %ALLUSERSPROFILE% is system-drive\ProgramData.
A folder protected by the system is the path to a folder in any of the following:
-
system-drive\Windows
-
system-drive\Program Files
-
system-drive\Program Files (x86)
-
-
For a logical host:
shared-folder\jp1ajs2\log\evjobexecresult
For Windows, if the installation folder is other than the above:
-
For a physical host:
JP1/AJS3-installation-folder\log\evjobexecresult
-
For a logical host:
shared-folder\jp1ajs2\log\evjobexecresult
For UNIX/Linux:
-
For a physical host:
/var/opt/jp1ajs2/log/evjobexecresult
-
For a logical host:
shared-dircetory/jp1ajs2/log/evjobexecresult
(b) Format of data output to the event job execution result log file
The contents of the event job execution result log file can be viewed in a text editor. The following figure shows an example of output to an event job execution result log file.
|
The following tables describe the headers and output items in the event job execution result log file.
Header |
Explanation |
---|---|
OS information |
The OS on which the log output function is running. |
Host name |
The name of the host on which the log output function is running. |
Time zone |
The time zone set for the OS. |
Time the log output function started |
The time that the log output function started |
Output item |
Explanation |
---|---|
Number (4 digits) |
The sequence number of the message record. |
Date (10 bytes) |
The date the message was collected: yyyy/mm/dd (year/month/day) |
Time (12 bytes) |
The local time the message was collected: hh:mm:ss.sss (hour:minutes:seconds.milliseconds) |
Application name (16 bytes or less) |
The name of the process for which the message is output. One of the following application names is output:
|
Process ID |
Process ID A process ID is output as a hexadecimal number. |
Thread ID |
Thread ID A thread ID is output as a hexadecimal number. |
Message ID |
Message ID The messages that are output to the event job execution result log file are as follows:
|
Message text |
The text of a message output to the event job execution result log file. For information about the message text for each message ID, see 4.1 List of messages beginning with KAVT in the manual JP1/Automatic Job Management System 3 Messages. |