Hitachi

Job Management Partner 1 Version 10 Job Management Partner 1/Advanced Shell Description, User's Guide, Reference, and Operator's Guide


3.4.1 Outputting the contents of the job execution log by job type

What is output to the job execution log depends on the type of job that is executed, as described in the following subsections.

Organization of this subsection

(1) Destination and output contents of the job execution log when root jobs are executed

This subsection explains the destination and output contents of the job execution log when root jobs are executed in the expansion output mode, the simple output mode, or the minimum output mode (as specified in the OUTPUT_MODE_ROOT parameter).

(a) When the expansion output mode is selected

The following table describes the output contents of the job execution log when the expansion output mode is selected:

Message output destination

Description

JOBLOG

Output to spool files.

During debug execution, JOBLOG is also output to the standard error output during job execution.

Script image

Output to spool files.

Destination of the standard output

Output to the destination specified by either of the following methods:

  • -s option in the adshexec command

  • OUTPUT_STDOUT parameter in the environment file

During debug execution, this information is also output to the standard error output in effect at the time debug execution started.

Destination of the standard error output

Output to spool files.

During debug execution, this information is output to the standard error output in effect at the time debug execution started.

A spool job directory is created for each job.

After job execution, the contents of the job execution log, excluding the contents for the standard output, are output to the standard error output.

During debug execution, the contents of the job execution log after job execution are not output to the standard error output.

(b) When the simple output mode is selected

The following table describes the output contents of the job execution log when the simple output mode is selected:

Message output destination

Description

JOBLOG

Output to spool files.

Script image

Destination of the standard output

Not output to spool files. This information is output to the destination in effect when the process started.

Error messages for the standard error output and the standard output are output (during debug execution, messages other than error messages are also output).

Also, error messages for JOBLOG are output to the standard error output.

During normal execution, output of any message whose type is W or I (excluding signal reception and event reception messages) is suppressed.

Destination of the standard error output

Note that the job execution log is not output to the standard error output when the job terminates.

(c) When the minimum output mode is selected

The following table describes the output contents of the job execution log when the minimum output mode is selected:

Message output destination

Description

JOBLOG

Messages that are not subject to output suppression are output to spool files.

Script image

Destination of the standard output

Not output to spool files. This information is output to the destination in effect when the process started.

Messages for the standard error output and the standard output that are not subject to output suppression are output (during debug execution, messages that are not subject to output suppression are also output).

Also, messages for JOBLOG that are not subject to output suppression are output to the standard error output.

Destination of the standard error output

Note that the job execution log is not output to the standard error output when the job terminates.

Output of the following messages is suppressed:

Timing

Message whose output is suppressed

During normal execution

  • Messages whose type is W or I (excluding signal reception and event reception messages)

  • The following messages whose type is E:

    KNAX0101-E, KNAX2201-E, KNAX6521-E, KNAX6522-E, KNAX6541-E, KNAX6542-E, KNAX6551-E, KNAX6552-E, KNAX6561-E, KNAX6562-E, KNAX6586-E, KNAX6591-E, KNAX6592-E, KNAX6593-E, KNAX6594-E, KNAX6596-E

  • The following messages whose type is I:

    KNAX7893-I, KNAX7896-I

During debug execution

  • Messages whose type is W or I (excluding signal reception and event reception messages)

  • The following messages whose type is E:

    KNAX0101-E, KNAX2201-E, KNAX6521-E, KNAX6522-E, KNAX6541-E, KNAX6542-E, KNAX6551-E, KNAX6552-E, KNAX6561-E, KNAX6562-E, KNAX6586-E, KNAX6591-E, KNAX6592-E, KNAX6593-E, KNAX6594-E, KNAX6596-E

(2) Destination and output contents of the job execution log when child jobs are executed

This subsection explains the destination and output contents of the job execution log when child jobs are executed in the expansion output mode, the simple output mode, or the minimum output mode (as specified in the OUTPUT_MODE_CHILD parameter). For the output contents when a child job's spool job is to be merged into the root job's spool job, see (3) Merging a child job's spool job into the root job's spool job.

(a) When the expansion output mode is selected

The following table describes the output contents of the job execution log when the expansion output mode is selected:

Message output destination

Description

JOBLOG

Temporarily output to spool files.

When the child job terminates, this file is deleted from the spool after JOBLOG has been output to the standard error output in effect when the process started.

Script image

Temporarily output to spool files, but is deleted when the child job terminates.

Destination of the standard output

Output to the destination in effect when the process started.

Destination of the standard error output

A spool job directory is created during job execution, but this directory is deleted after the job has executed. Because the program output data file allocated in the spool job directory is also deleted, the KNAX6380-I message indicating successful renaming of the spool job directory is not output.

After job execution, the contents of JOBLOG are output to the standard error output. However, the following header lines are not output:

---------------------------------------------------------------
 Advanced Shell version-number
 
 [Information]
   Job ID          : job-ID
   Spool directory : spool-job-directory-path
   Date            : execution-date
   EnvFile(system) : environment-file-path (System environment file)
   EnvFile(job)    : environment-file-path (Job environment file)
   Host name       : host-name
 [Environment variable from Automatic Job Management System]
   environment-variables-passed-from-JP1/AJS
---------------------------------------------------------------
********  JOB CONTROLLER MESSAGE  ********

Because no job execution log other than JOBLOG is output, the job execution log cannot be referenced from other programs, such as JP1/AJS or the login shell.

Because the job return code is output to JOBLOG for the parent process's job, the KNAX7999-I message indicating termination of adshexec command execution is not output to the standard error output.

(b) When the simple output mode is selected

The following table describes the output contents of the job execution log when the simple output mode is selected:

Message output destination

Description

JOBLOG

Output to spool files for each child job in the root job's spool.

Script image

Temporarily output to spool files, but is deleted when the child job terminates.

Destination of the standard output

Output to the destination in effect when the process started.

Error messages for the standard error output and the standard output are output. Error messages for JOBLOG are also output to the standard error output.

Only error messages are output.

Output of messages whose type is W or I (excluding signal reception and event reception messages) is suppressed.

Destination of the standard error output

Messages are output to JOBLOG during job execution. Error messages among these messages are also output to the standard error output.

The job execution log is output to spool files for each child job under the root job's spool job directory. The job execution log is not output to the standard error output even after the job has executed.

(c) When the minimum output mode is selected

The following table describes the output destination of the job execution log when the minimum output mode is selected:

Message output destination

Description

JOBLOG

Messages that are not subject to output suppression are output to files for each child job in the root job's spool.

Script image

Temporarily output to spool files, but is deleted when the child job terminates.

Destination of the standard output

Output to the destination in effect when the process started.

Messages for the standard error output and the standard output that are not subject to output suppression are output. Also, messages for JOBLOG that are not subject to output suppression are output to the standard error output.

Messages whose output is suppressed are not output.

Destination of the standard error output

Output of the following messages is suppressed:

  • Messages whose type is W or I (excluding signal reception and event reception messages)

  • The following messages whose type is E:

    KNAX0101-E, KNAX2201-E, KNAX6521-E, KNAX6522-E, KNAX6541-E, KNAX6542-E, KNAX6551-E, KNAX6552-E, KNAX6561-E, KNAX6562-E, KNAX6586-E, KNAX6591-E, KNAX6592-E, KNAX6593-E, KNAX6594-E, KNAX6596-E

  • The following messages whose type is I:

    KNAX7893-I, KNAX7896-I

(3) Merging a child job's spool job into the root job's spool job

If MERGE is specified in the SPOOLJOB_CHILDJOB parameter, the child job's spool job is merged into the root job's spool job. An overview of the job execution log contents is provided below. For an example of job execution log output, see 3.4.3 Example of job execution log output (when a child job's spool job is merged into the root job's spool job).

(a) During normal operation

  • JOBLOG

    JOBLOG for a child job is output between a message indicating that the rule for replacing the child job's execution was satisfied and a message indicating that the command used to execute the child job has terminated.

    The symbols indicating the start and end of the child job's JOBLOG are displayed before and after JOBLOG, as shown in the following figure:

    [Figure]

  • SCRIPT

    A child job's SCRIPT is displayed before its root job's SCRIPT. The header (******** Script IMAGE ********) is not displayed in the child job output section.

  • STDERR

    The symbols indicating the start and end of the child job's STDERR are displayed before and after the child job's standard error output as shown below.

    These symbols are not displayed when the child job is in the simple output mode or the minimum output mode.

    [Figure]

  • STDOUT

    STDOUT is not merged.

(b) During debug execution

  • JOBLOG

    JOBLOG is merged in the same format as during normal execution. For the standard error output, the same contents are also displayed immediately after termination of the child job.

  • SCRIPT

    SCRIPT is merged in the same format as during normal execution. The contents of SCRIPT are not output to the standard error output.

  • STDERR, STDOUT

    The symbols indicating the start and end of a set of a child job's STDERR and STDOUT are displayed before and after the child job's standard error output, as shown below. The text [STDERR,STDOUT] is displayed in the standard error output even when the child job's standard error output and standard output are redirected.

    These symbols are not displayed when the child job is in the simple output mode or the minimum output mode.

    [Figure]

(c) When the output mode of the root job differs from that of the child job

When MERGE is specified in the SPOOLJOB_CHILDJOB environment setting parameter and the root job is run in the expansion output mode and the child job is run in the minimum output mode, the results of merging JOBLOG and SCRIPT are as follows:

  • JOBLOG

    • If no message has been output to JOBLOG of the child job running in the minimum output mode

      This child job's JOBLOG is not merged into the root job's JOBLOG. Therefore, the strings indicating the beginning and end of output of the child job's JOBLOG are also not output.

    • If messages have been output to JOBLOG of the child job running in the minimum output mode

      This child job's JOBLOG is merged into the root job's JOBLOG. The strings indicating the beginning and end of output of the child job's JOBLOG are also output.

    During both normal execution and debug execution, the strings that indicate the beginning and end of output of the child job's JOBLOG are >>>>>> [JOBLOG] path-name and <<<<<< [JOBLOG] path-name, respectively.

  • SCRIPT

    The child job's SCRIPT is not merged into the root job's SCRIPT.

    When the child job is run in the minimum output mode and its grandchild job is run in the expansion output mode or the simple output mode, the child job's SCRIPT is not merged either. Therefore, the grandchild job's SCRIPT merged into the child job's SCRIPT is not output.

    [Figure]

    The same applies when the root job is run in the simple output mode or the minimum output mode. However, in this case, SCRIPT is not output to the standard error output.