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:
-
JP1_AJS_Admin privilege
-
JP1_AJS_Manager privilege
-
JP1_AJS_Editor privilege
-
JP1_AJS_Operator privilege
-
JP1_AJS_Guest privilege
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 2099/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
-
Either of the following users can execute this command:
-
A user granted the reference privilege for the root jobnet to be specified
-
A JP1 user mapped to the OS user who has Administrators or superuser privileges
Note, however, that if yes is set after changing the ADMACLIMIT environment setting parameter from its default, even a JP1 user who was mapped to an OS user with Administrators or superuser privileges must have the reference privilege.
-
-
If you re-executed a temporary change in the Temporary Changes dialog box of JP1/AJS3 - View, the command does not output the first attempted execution of the temporary change that was later re-executed. It only outputs the temporary change information for the re-execution of the change.
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.
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.
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.