Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Troubleshooting


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 and other jobs. A user on the manager host might not be able to check the execution statuses of 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 and other jobs by using the execution result logs.

There are two execution result logs:

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.

Figure 1‒3: Example of output to a job execution result log file

[Figure]

The following tables describe the headers and output items in the job execution result log file.

Table 1‒3: Meaning of headers 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

Table 1‒4: Meaning of the output items in the job execution result log file

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:

  • jpqagt

  • jpqagtchild

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:

  • KAVU3613-I: Message indicating a job was accepted

  • KAVU3614-I: Message indicating that a job started (in Windows)

  • KAVU3615-I: Message indicating that a job started (in UNIX)

  • KAVU3616-I: Message indicating that a job ended

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

Figure 1‒4: Example of output to an event job execution result log file

[Figure]

The following tables describe the headers and output items in the event job execution result log file.

Table 1‒5: Meaning of headers 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

Table 1‒6: Meaning of the output items in the event job execution result log file

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:

  • jpoagent

  • jpoagtsub

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:

  • KAVT0966-I: Message indicating that event monitoring started

  • KAVT0967-I: Message indicating that an event was detected

  • KAVT0968-I: Message indicating that event monitoring ended

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.