Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Command Reference


ajsplanout

Organization of this page

Format

ajsplanout
     [-F service-name]
     [-b output-start-date]
     [-d|-c]
     [-R]
     [-E]
     [-T]
     job-name-or-jobnet-name

Description

Outputs to the standard output about temporary changes information made to the execution schedule of a root jobnet, or a jobnet or job defined under a root jobnet.

Execution privileges

You must have any of the following JP1 privileges for the root jobnet:

Arguments

-F service-name

Specify the name of the target scheduler service.

You can specify a character string of 1 to 30 bytes.

-b output-start-date

Specify the start date of the range for which you want to output temporary change information, in the format yyyy/mm/dd.

You can specify a value in the range from 1994/01/01 to 2036/12/31.

If you omit this option, the command outputs temporary change information for the current date onwards.

-d

Outputs temporary change information.

You cannot specify this option together with the -c option.

If you omit both the -d and -c options, the system assumes the -d option.

-c

Outputs temporary change information to the command line.

You cannot specify this option together with the -d option.

If you omit both the -d and -c options, the system assumes the -d option.

-R

Outputs temporary change information for all specified units including subordinate units.

If you specify this option together with the -E and -T options, the command outputs temporary change information according to the specification of each option.

If you do not specify the -T option together with the -R option, the command applies to all unit types and the output processing of temporary change information ends abnormally for units other than the root jobnet.

-E

Outputs temporary change information for units that have been registered for execution.

-T

Outputs temporary change information for the root jobnet.

job-name-or-jobnet-name

Specify the name of the jobnet for which to output temporary change information, or the name of the job group if specified together with the -R, -E, or -T option.

You can specify a character string of 1 to 930 bytes.

You can specify more than one jobnet name or job group name. However, if you want to specify a jobnet name, you can specify only a root jobnet name. You cannot specify a manager job group name or manager jobnet name.

Notes

Return values

0

Normal end

Multiple of 4 within the range from 4 to 124

Abnormal end

Example 1

The following command outputs the temporary change information for generations of root jobnet (net1) and its subordinate units scheduled for execution from today to the standard output file.

ajsplanout -d /net1

Example 2

The following command outputs the temporary change information for generations of root jobnet (net1) and its subordinate units scheduled for execution on 2011/08/01 or later to the standard output file.

ajsplanout -d -b 2011/08/01 /net1

Example 3

The following command outputs the temporary change information for generations of root jobnet (net1) and its subordinate units scheduled for execution on 2011/08/01 or later to standard output as an executable command line.

ajsplanout -c -b 2011/08/01 /net1

Output example 1

The following shows an output example when the -d option is specified.

[Figure]

Explanation of the output items

  • When temporary change information exists for the target root jobnet

    Outputs lines (1) to (8).

    If more than one piece of temporary change information is associated with the root jobnet, the command repeats lines (3) to (8) without the title portion.

  • When no temporary change information exists for the target root jobnet

    Outputs lines (1) and (2) and the message KAVS4670-I before terminating abnormally.

(1) Root jobnet

The full path name of the root jobnet whose temporary change information is being output.

(2) Output time

The date and time when the ajsplanout command output the temporary change information (according to the locale setting of the scheduler service), in the format YYYY/MM/DD HH:MM:SS.

(3) Re-executed

Outputs Operated if the temporary change has been re-executed.

This field displays a hyphen (-) if the temporary change has not been re-executed.

(4) Start date

Outputs the scheduled start date component (YYYYMMDD) of the execution registration number (YYYYMMDDNNN) in the format YYYY/MM/DD.

Single-digit MM or DD values are prefixed with 0 (for example: 2012/01/01). ****/**/** appears in this field if you used the -d or -t option of the ajsentry command to add an execution date, or added a fixed execution schedule in the Daily Schedule or Monthly Schedule window.

(5) Seq

Outputs the sequence number component (NNN) of the execution registration number (YYYYMMDDNNN)

*** appears in this field if you used the -d or -t option of the ajsentry command to add an execution date, or added a fixed execution schedule in the Daily Schedule or Monthly Schedule window.

(6) Operation time

Outputs the date and time when the temporary change was executed in the format YYYY/MM/DD HH:MM:SS.

(7) Operation user

Outputs the name of the user who executed the temporary change.

(8) Command

Outputs executed temporary changes as an executable command line.

Lines for temporary changes that were scheduled for execution with a TZ environment variable set are prefixed with the value of the TZ environment variable.

Depending on the target environment, you might not be able to execute the command line as output. In this case, modify the command line to suit the target environment.

Output example 2

The following shows an output example when the -c option is specified.

[Figure]

Explanation of the output items

The command outputs the date and time the temporary change information were output, and details of each temporary change in the form of an executable command line. For a description of the contents of the Output time and Command fields, see items (2) and (8) in output example 1.

This command does not output the root jobnet name or the title row. If no temporary change information exists for the root jobnet, the command outputs the Output time field and the message KAVS4670-I before terminating abnormally.