ajsshow
- Organization of this page
Format
ajsshow [-F service-name] [{-s|-p|-l|-xw [-xi {b|c}]|-r|-f "format-indicator"| -i "two-byte-format-indicator"}] [-t "format-indicator"] [-k] [-g {number-of-generations|a} |-b year/month[/day] [-e year/month[/day]] |-v year/month[/day] [-w year/month[/day]] |-B execution-registration-number] [-u user-name] [-c] [-R] [-E] [-T] [-N|-J] [-d [[year/]month/]day] [-h hours[:minutes]] [-X {yes|no|auto}] job-name-or-jobnet-name-or-job-group-name...
Description
Outputs the results of the past execution, the current status, the next execution schedule, and other information on a jobnet or job already registered for execution to the standard output file. (For details about the output format, see Additional information 1 later.)
Execution privileges
You must have any of the following JP1 privileges:
-
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.
-s
Outputs execution registration information scheduled to be performed in the specified jobnet in the next cycle.
If there is nothing scheduled for subsequent execution, the option outputs the execution registration information for the jobnet that was executed in the previous cycle or is currently being executed.
Note that for a jobnet that has been registered for planned execution, if the next execution is not scheduled, a non-scheduled generation is generated for the next execution. Therefore, if you specify this option when the next execution is not scheduled, Not sched. to exe. is output as the status.
When you use the function that automatically selects a unit being operated, select a jobnet scheduled to be executed in the next cycle from those in the root jobnet under the planning group, and output the execution registration information. If there is nothing scheduled for subsequent execution, the option selects the jobnet that was executed in the previous cycle or is currently being executed and outputs the execution registration information.
You cannot specify this option for a job.
You cannot specify this option with the -p, -l, -xw, -r, -f, -i, -g, -b, -e, -v, -w, -B, or -J option.
You cannot specify this option if you specify the execution ID for a job, jobnet, or job group name.
-p
Outputs information on the next execution schedule of a specified jobnet.
If you are using the function for automatically selecting a target unit, the command outputs information on the next execution schedule of the jobnet scheduled to be executed next under the root jobnets in a planning group.
You cannot specify this option for a job.
You cannot specify this option with the -s, -l, -xw, -r, -f, -i, -g, -b, -e, -v, -w, -B, or -J option.
You cannot specify this option if you specify the execution ID for a job, jobnet, or job group name.
-l
Outputs execution result information on a specified jobnet, and jobs and jobnets in it.
If you are using the function for automatically selecting a target unit, the command outputs result information for the jobnets or jobs that belong to as many generations as the number specified with the -g option, starting from generation number 1, under the root jobnets in a planning group.
You cannot specify this option with the -s, -p, -xw, -r, -f, -i, -b, -e, -v, -w, or -B option.
You cannot specify this option if you specify the execution ID for a job, jobnet, or job group name.
-xw
Outputs the status of the specified unit with wait conditions and the units whose ends are being waited for. Information about the units whose ends are being waited for relates to the generation whose end is currently being waited for.
When a jobnet with start conditions for which wait conditions are set is to be output, specify c for the -xi option. If a jobnet with start conditions for which wait conditions are set is output without c being specified for the -xi option, the ajsshow command ends abnormally. For details, see the -xi option.
For details about checking units whose ends are being waited for, see 2.2.5(7) Checking units whose ends are being waited for in the JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.
If you are using the function for automatically selecting a target unit, the command outputs results for a number of generations of jobnets or jobs equivalent to the number specified with the -g option, starting from generation number 1, under the root jobnets in a planning group.
You cannot specify this option together with the -l, -s, -p, -r, -f, -i, -b, -e, -v, or -w option.
This option is only available when the database uses a standard configuration.
If you specify an execution ID in the -B option or as the unit name, the command outputs information only for that generation.
If you specify a value of 1 or greater for the -g option, the command outputs information for a number of generations of jobnets or jobs equivalent to the number specified with the -g option, starting from generation 1. If generation 1 does not exist, the command outputs information for generation 0.
If you specify 0 in the -g option, the command outputs results for generation 0.
If you omit the -B option, an execution ID, and the -g option, the system assumes 1 as the value of the -g option.
-xi {b|c}
Specify the output format of wait information. Specify this option together with the -xw option. If it is omitted, b is assumed.
When a jobnet with start conditions for which wait conditions are set is to be output, the generation to be output (monitoring generation or execution generation) differs depending on the specification (b or c).
-
b
Outputs information about the units with wait conditions or the information set as a wait condition. Note, however, that settings information for A jobnet with start conditions is waiting is not output.
To output a jobnet with start conditions, output both monitoring and execution generations. Note, however, that if the execution generation does not have wait information, the ajsshow command ends abnormally.
-
c
Information about units with wait conditions or the information set as wait conditions are output. Settings information for A jobnet with start conditions is waiting is also output.
When a jobnet with start conditions is to be output, only the monitoring generation is output. The execution generations are not output. If you use the -g option to output only the execution generations, the ajsshow command ends abnormally.
The following table describes the differences between generations that are output according to the argument of the -xi option.
No. |
-xi option argument |
How generations are specified |
Jobnet generation where a start condition is used |
Jobnet generation where no start condition is used |
|
---|---|---|---|---|---|
Monitoring generation |
Execution generation |
||||
1 |
b |
Execution ID or execution registration number |
Y |
E |
Y |
2 |
-g option |
Y |
E |
Y |
|
3 |
c |
Execution ID or execution registration number |
Y |
N |
Y |
4 |
-g option |
Y |
N or E# |
Y |
- Legend
-
Y: Information is subject to output, and is output.
N: Information is not subject to output
E: Information is subject to output, but the ajsshow command ends abnormally.
- #
-
If the -g option is used to include all generations, information is not to be output. If the -g option is used to output the execution generation only, the ajsshow command ends abnormally.
For output examples of the -xi option, see Example 8.
-r
Outputs the standard error output file name for a specified job.
If the specified job does not send information to the standard error output, the default standard error output file name is output.
You cannot specify this option with the -s, -p, -l, -xw, -f, -i, -T, or -N option.
-f "format-indicator"
Outputs the information specified by the format indicator for a specified jobnet or job.
Specify the format indicator by % followed by an alphabetic character of one byte. For details about the format indicator, see Additional information 1 later.
Characters are output as specified, except for the format indicator enclosed in double quotation marks (").
-i "two-byte-format-indicator"
Outputs the information specified by the format indicator for a specified jobnet or job.
Specify the format indicator by % followed by an alphabetic character of two bytes. For details about the format indicator, see Additional information 1 later.
Characters are output as specified, except for the format indicator enclosed in double quotation marks (").
-t "format-indicator"
Outputs the information specified by the format indicator to the title row.
Specify the format indicator by % followed by an alphabetic character of one byte. For details about the format indicator, see Additional information 1 later.
Characters are output as specified, except for the format indicator enclosed in double quotation marks (").
You must specify this option with the -f or -i option. Specify this option with the -f option. If you specify it with the -s, -p, -l, -xw, or -k option, it is disabled.
-k
Does not output the title row.
When you specify this option with the -s, -p, -l, or -xw option, only the AJSPATH= row is output.
-g {number-of-generations|a}
Outputs execution result information in descending order from the latest generation to the specified generation.
The default is 1. However, even when you specify 1 for number-of-generations, if generation number 1 does not exist, 0 is assumed as the number of generations.
If you are using the function for automatically selecting a target unit, the command outputs information about the jobnets or jobs that belong to as many generations as the specified number, starting from generation number 1 or 0, under the root jobnets in a planning group.
You cannot specify this option with the -s, -p, -b, -e, -v, -w, or -B option.
-
number-of-generations
You can specify 0 to 99 generations. You can, however, enable the system setting option to expand the number of generations up to 999.
If you set 0, the system outputs information on the jobnets not executed and jobnets being held (in this case, you cannot specify this option with the -l option).
Even though a nest jobnet is not executed or is being held, the number of generations is assumed to be 1 if its root jobnet is being executed.
If the number of generations is other than 0, the generation number is output to the title row when you specify the -l option.
-
a
Outputs execution result information on all the generations.
When you execute this command for a unit that has never been executed, the results of generation 0 are output. When you execute this command for a unit that has already been executed, the results of generation 1 or greater are output.
-b year/month[/day]
Specify the start date of the period of information output as a calendar date.
The start time is the base time.
-
year
You can specify a value between 1994 and 2036 for the year.
-
month
You can specify a value between 1 (or 01) and 12.
-
day
You can specify a value between 1 (or 01) and 31. If you omit this option, the system assumes the base date for the specified year and month.
Specify the end date of the information output period in the -e option.
The command outputs information for specified units that have results or have schedule information in the period from the start date to the end date.
If the specified unit has no result or no schedule information in the period from the start date to the end date, the command does not output information.
If you are using the function for automatically selecting a target unit, the command outputs information about the units having result or schedule information for the specified period under the jobnets in a planning group.
Specify this option together with the -f or -i option. You cannot specify it with the -s, -p, -l, -xw, -g, -v, -w, or -B option.
See the usage examples below for details on how to use this option.
-e year/month[/day]
Specify the end date of the period of information output as a calendar date.
For the end date, specify a date the same as or following the start date.
If you omit this option, the system assumes the date specified with the -b option.
The end time is the base time plus 23 hours: 59 minutes: 59 seconds.
-
year
You can specify a value between 1994 and 2036 for the year.
-
month
You can specify a value between 1 (or 01) and 12.
-
day
You can specify a value between 1 (or 01) and 31. If you omit this option, the system assumes the base date for the specified year and month. (For example, if you set the base date to 20, the system assumes 19 as the end date.)
Specify this option with the -f or -i option and the -b option. You cannot specify it with the -s, -p, -l, -xw, -g, -v, -w, or -B option.
-v year/month[/day]
Specify the start date of the period of information output as an execution date.
The start time is the base time.
-
year
You can specify a value between 1994 and 2036 for the year.
-
month
You can specify a value between 1 (or 01) and 12.
-
day
You can specify a value between 1 (or 01) and 31. If you omit this argument, the system assumes the base date in the specified month and year.
The command outputs information for specified units whose root jobnets have results or have schedule information in the period from the start date to the end date.
If results or schedule information exists for the upper-level root jobnet in the period from the start date to the end date, but none exists for the specified unit in the period specified by the -v and -w options, the command outputs information for all units (including unscheduled units) defined under the specified unit.
If you are using the function for automatically selecting a target unit, the command outputs information about the units having result or schedule information for the specified period under the jobnets in a planning group.
Specify this option together with the -f or -i option. You cannot specify it with the -s, -p, -l, -xw, -g, -b, -e, or -B option.
See the usage examples below for details on how to use this option.
-w year/month[/day]
Specify the end date of the period of information output as an execution date.
For the end date, specify a date the same as or following the start date.
If you omit this option, the system assumes the date specified with the -v option.
The end time is the base time plus 23 hours: 59 minutes: 59 seconds.
-
year
You can specify a value between 1994 and 2036.
-
month
You can specify a value between 1 (or 01) and 12.
-
day
You can specify a value between 1 (or 01) and 31. If you omit this option, the system assumes the base date for the specified year and month. (For example, if you set the base date to 20, the system assumes 19 as the end date.)
Specify this option with the -f or -i option and the -v option. You cannot specify it with the -s, -p, -l, -xw, -g, -b, -e, or -B option.
-B execution-registration-number
Specify the execution registration number of the jobnet whose information you want to display in the YYYYMMDDNNN format. The following gives the contents of YYYYMMDDNNN.
YYYY: Year of the date of execution
MM: Month of the date of execution
DD: Day of the date of execution
NNN: Execution registration sequence number for the date of execution
For details about the execution registration number, see 4.5.13 Methods of specifying generations when executing commands in the manual JP1/Automatic Job Management System 3 Overview.
If you are using the function for automatically selecting a target unit, the command outputs information about the units having an execution registration number under the jobnets in a planning group.
You cannot specify this option with the -s, -p, -l, -g, -b, -e, -v, or -w option. Specify this option together with the -f, -i, -r, or -xw option.
-u user-name
To output information on a jobnet registered by a specified user, specify the user name.
You can specify a character string of 1 to 31 bytes.
-c
Obtains information for the specified jobnet or job, and then outputs it in the high-speed mode.
You cannot obtain information about a job or jobnet that is added while it is suspended.
Format indicators %B, %b, %O, and %o are displayed in the ****/**/** **:**:** or ****/**/** **:** format.
Format indicator %a is displayed in the 00:00:00 format.
Specify this option with the -f, -i, or -r option.
You cannot specify this option with the -s, -p, -l, -xw, -b, -e, -v, -w, or -R option. However, you can specify this option with the -R option if you also specify the -T option.
-R
Outputs information on all the jobnets or jobs contained in a specified unit.
If you specify this option with the -E, -T, -N, and/or -J options, the system outputs information on the jobnets or jobs according to the specification of each option.
-E
Outputs information on a jobnet already registered for execution.
-T
Outputs information on the root jobnet.
You cannot specify this option with the -r or -J option.
-N
Outputs information on a jobnet.
You cannot specify this option with the -r or -J option.
-J
Outputs information on a job.
You cannot specify this option with the -s, -p, -T, or -N option.
-d [[year/]month/]day
Specify the starting date for re-executing the root jobnet. Use this option when you specify the 2-byte format indicator %ab or %an for the -i option to obtain the estimated required time.
-
year
You can specify a value between 1994 and 2036.
-
month
You can specify a value between 1 (or 01) and 12.
-
day
You can specify a value between 1 (or 01) and 31.
If you omit the specification of the year or both the year and month for this option, the system assumes the following values:
year: The year when the command was executed
year/month: The year and month in which you executed the command
By default, the system assumes the date on which you execute the command.
This option is invalid if you do not specify the 2-byte format indicator %ab or %an for the -i option.
You cannot specify this option with the -s, -p, -l, -xw, -r, -f, -g, -B, or -c option.
You must specify this option with the -i option and either the -b or -v option.
-h hours[:minutes]
Specify the starting time for re-executing the root jobnet. Use this option when you specify the 2-byte format indicator %ab or %an for the -i option to obtain the estimated required time.
-
hours
You can specify a value between 0 (or 00) and 24.
-
minutes
You can specify a value between 0 (or 00) and 59. If you do not specify a value, 0 is assumed.
By default, the system assumes the time at which you execute the command.
This option is invalid if you do not specify the 2-byte format indicator %ab or %an for the -i option.
You cannot specify this option with the -s, -p, -l, -xw, -r, -f, -g, -B, or -c option.
You must specify this option with the -i option and either the -b or -v option.
-X {yes|no|auto}
Specify whether to automatically select the current unit for operation from the units listed in a planning group. The units in the job group are not, however, automatically selected regardless of the specified value. You cannot omit a root jobnet name.
-
yes
Specify this to automatically select a target unit.
When specifying a unit name in the command, omit a root jobnet name in a planning group.
-
no
Specify this if you do not want to automatically select a target unit.
You must specify a unit for which the command will operate. You cannot omit a root jobnet name in a planning group.
-
auto
Whether a target unit will automatically be selected depends on how the unit name is specified.
-
If you want to automatically select a target unit
Specify a unit name without a root jobnet name in a planning group.
-
If you do not want to automatically select a target unit
Specify a unit name with a root jobnet name in a planning group. The command will operate for the specified unit only. However, if there is a unit having the same name as the path name specified without a root jobnet name in a planning group, a root jobnet name is assumed to be omitted so that a target unit will be selected automatically.
-
job-name-or-jobnet-name-or-job-group-name
Specify the name of the job or jobnet whose information you want to output. You can also specify a job, jobnet, or job group name with the -R, -E, -T, -N, or -J option.
You can specify a character string of 1 to 930 bytes.
You can specify more than one job, jobnet, or job group name. You cannot specify a manager job group name or manager jobnet name.
You can specify a logical host name or execution ID as a job, jobnet or job group name. If you specify an execution ID, however, the -g, -b, -e, -v, -w, and -B options are disabled.
To specify an execution ID as a job, jobnet or job group name, also specify the -f, -i, -r, or -xw option. You cannot specify the execution ID with the -s, -p, or -l (default) option. For details about how to specify the execution ID, see 1.1 Command syntax.
Notes
-
When extracting data from the output information, extract the data based on its delimiting spaces, not by fixed byte count.
-
Either of the following users can output unit information:
-
A user granted the reference privilege when the unit whose information is to be output was defined or when its attributes were changed
-
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.
-
-
The period of information output can be specified through a combination of the -b and -e options or the -v and -w options. Such different combinations give different output results. For details, see Example 5.
-
If you use the -b, -e, -v, or -w option to set the period of information output, the information is output in ascending order starting from the oldest generation.
-
Information about a unit added to a suspended root jobnet is not output until the root jobnet is released from suspension. After the root jobnet is released from suspension, simulated results are output. Therefore, the results output when the root jobnet is suspended are different from the results output after the root jobnet is released from suspension.
-
You may specify multiple units with the -c option and the -g option that specifies the number of generations. In this case, the system outputs execution result information on each jobnet or job in descending order from the latest generation to the specified generation.
-
When you specify that a target unit automatically be selected from the units in a planning group, an error occurs if you do not have the appropriate operation privilege for the automatically selected unit.
-
When the -X option is omitted, a target unit in a planning group is determined according to the value specified for the AJSAUTOJUDGE environment variable.
-
For an explanation of how to specify the name of a unit in a planning group, see Additional information in ajsplan in 3. Commands Used for Normal Operations.
-
If you specify none of the -s, -p, -r, -f, and -i options, the -l option is assumed.
-
If you specify the -l, -r, -f, or -i option without specifying the -g, -b, -e, -v, -w, or -B option or execution ID, the system assumes -g 1.
-
If you specify the -b, -e, -v, or -w option, a schedule simulation and an execution simulation are performed. When you specify -g (default), -B, or an execution ID, no simulation is performed. For details about simulations, see 4.4.2 Simulation in the manual JP1/Automatic Job Management System 3 Overview.
Arguments that can be specified when executing the command from JP1/AJS3 - View
You can specify the following arguments when executing the ajsshow command from JP1/AJS3 - View:
No. |
Arguments |
Required? |
---|---|---|
1 |
-F service-name |
Y |
2 |
-s |
-- |
3 |
-p |
-- |
4 |
-l |
-- |
5 |
-xw |
-- |
6 |
-xi {b|c} |
-- |
7 |
-r |
-- |
8 |
-f "format-indicator" |
-- |
9 |
-i "two-byte-format-indicator" |
-- |
10 |
-t "format-indicator" |
-- |
11 |
-k |
-- |
12 |
-g {number-of-generations|a} |
-- |
13 |
-b year/month[/day] |
-- |
14 |
-e year/month[/day] |
-- |
15 |
-v year/month[/day] |
-- |
16 |
-w year/month[/day] |
-- |
17 |
-B execution-registration-number |
-- |
18 |
-u user-name |
-- |
19 |
-c |
-- |
20 |
-R |
-- |
21 |
-E |
-- |
22 |
-T |
-- |
23 |
-N |
-- |
24 |
-J |
-- |
25 |
-d [[year/]month/]day |
-- |
26 |
-h hours[:minutes] |
-- |
27 |
-X {yes|no|auto} |
-- |
28 |
job-name-or-jobnet-name-or-job-group-name |
Y |
- Legend:
-
Y: Required
--: Optional
You cannot specify any other options when executing the ajslogprint command from JP1/AJS3 - View.
For details about how to execute JP1/AJS3 commands from JP1/AJS3 - View, see 10.4 Executing JP1/AJS3 commands from JP1/AJS3 - View in the JP1/Automatic Job Management System 3 Operator's Guide.
Return values
0 |
Normal end |
Multiple of 4 within the range from 4 to 124 |
Abnormal end |
Additional information 1
Table 3-18 lists the format indicators to output jobnet and job definitions.
Table 3-19 lists the two-byte format indicators to output jobnet and job definitions.
Table 3-20 lists the other format indicators.
Table 3-21 provides the output formats of the format indicators.
Format indicator |
Output information |
-f |
-t |
---|---|---|---|
%J |
Jobnet or job full-path name |
Yes |
Yes |
%j |
Jobnet or job name Character string of up to 30 bytes |
Yes |
Yes |
%A |
Character string specified for AJSPATH= Character string specified with %J except the part that follows the right-most slash (/) |
Yes |
Yes |
%T |
Unit type mgroup: Manager job group group: Job group mnet: Manager jobnet condn: Start condition (.CONDITION) net: Jobnet rnet: Jobnet for recovery rmnet: Remote jobnet rrnet: Remote jobnet for recovery job: Unix job rjob: Unix job for recovery pjob: PC job rpjob: PC job for recovery qjob: QUEUE job rqjob: QUEUE job for recovery jdjob: Judgment job rjdjob: Judgment job for recovery orjob: OR job rorjob: OR job for recovery cmsjb: OpenView status report job rcmsjb: OpenView status report job for recovery evwjb: JP1 event reception monitoring job revwjb: JP1 event reception monitoring job for recovery flwjb: File monitoring job rflwjb: File monitoring job for recovery mlwjb: Email reception monitoring job rmlwjb: Email reception monitoring job for recovery mqwjb: Message queue reception monitoring job rmqwjb: Message queue reception monitoring job for recovery mswjb: MSMQ reception monitoring job rmswjb: MSMQ reception monitoring job for recovery lfwjb: Log file monitoring job rlfwjb: Log file monitoring job for recovery ntwjb: Windows event-log monitoring job rntwjb: Windows event-log monitoring job for recovery tmwjb: Execution interval control job rtmwjb: Execution interval control job for recovery evsjb: JP1 event sending job revsjb: JP1 event sending job for recovery mlsjb: Email sending job rmlsjb: Email sending job for recovery mqsjb: Message queue sending job rmqsjb: Message queue sending job for recovery mssjb: MSMQ sending job rmssjb: MSMQ sending job for recovery pwljb: Local power control job rpwljb: Local power control job for recovery pwrjb: Remote power control job rpwrjb: Remote power control job for recovery cuujb: Custom Unix job rcuujb: Custom Unix job for recovery cupjb: Custom PC job rcupjb: Custom PC job for recovery netcn: Jobnet connector |
Yes |
Yes |
%C |
Jobnet or job status |
Yes#10 |
-- |
%U |
User name of a jobnet registered for execution Character string of up to 31 bytes |
Yes#9 |
-- |
%D |
Time when the jobnet was registered for execution#7 |
Yes#9 |
-- |
%L |
Number of jobnet nests with respect to the root jobnet as 0 |
Yes#9 |
Yes |
%p#3 |
Whether the next execution is scheduled exist none |
Yes#27 |
-- |
%P#3 |
Date and time of the next execution schedule#7 |
Yes#1 |
-- |
%M#3 |
Next execution method schedule plan shift |
Yes#1 |
-- |
%R |
Return value or signal code *** if there is no return value or signal code |
Yes#2 |
-- |
%S |
Date and time when jobnet execution is started or when a job is submitted#7 |
Yes#12 |
-- |
%s |
Date and time when jobnet execution is started or when a job is submitted#7 |
Yes#12 |
-- |
%K |
Date and time when jobnet re-execution is started#7 |
Yes#1, #15 |
-- |
%k |
Date and time when jobnet re-execution is started#7 |
Yes#1, #15 |
-- |
%E |
Date and time when jobnet or job execution is ended#7 |
Yes |
-- |
%e |
Date and time when jobnet or job execution is ended#7 |
Yes |
-- |
%V |
Date and time when jobnet or job execution is started in another host#7 |
Yes#2 |
-- |
%Q |
Date and time when jobnet or job execution was ended in another host#7 |
Yes#2 |
-- |
%W |
$LANG value |
Yes#9 |
Yes |
%Z |
$TZ value |
Yes#9 |
Yes |
%G |
Generation number#8 (0 or less for scheduled generations) (1 or greater for generations being executed or execution result generations) |
Yes#8 |
Yes |
%N |
Priority of execution#24 A value of 1 to 5 |
Yes |
-- |
%H |
Agent host name |
Yes#2 |
-- |
%I |
Job number |
Yes#2, #17 |
-- |
%Y |
The number of executions of jobnets or jobs that ended normally after the registration for execution#13 |
Yes |
-- |
%B |
Scheduled execution start date and time obtained from a computed processing cycle#7 |
Yes#4, #18, #22 |
-- |
%b |
Scheduled execution start date and time obtained from a computed processing cycle#7 |
Yes#4, #19 |
-- |
%a |
Estimated time required for execution#7 |
Yes#5, #16, #22 |
-- |
%O |
Scheduled execution end date and time obtained from a computed processing cycle#7 |
Yes#4, #14, #20, #22 |
-- |
%o |
Scheduled execution end date and time obtained from a computed processing cycle#7 |
Yes#4, #14, #21, #22 |
-- |
%v |
Start time of the period that schedule and result information is output#7, #28 |
Yes#6 |
Yes#6 |
%w |
End time of the period that schedule and result information is output#7 |
Yes#6 |
Yes#6 |
%F |
Hold attribute of the next execution schedule#26 yes no Before Abnormal End Before Warning End |
Yes |
-- |
%i |
Type of registration for execution immediate definit planned simulation |
Yes#9 |
-- |
%l |
Execution registration number#7 |
Yes#8 |
-- |
%r |
Standard error output file name If the standard error output file does not exist, the default standard error output file name is output. The standard error output file will not exist when, for example, no jobs have been executed or no errors have occurred. Output example: /var/opt/jp1ajs2/jobinf/7.14a.0.8.err |
Yes #8, #23 |
-- |
%d |
Delay status none start-delay nest-start-delay end-delay nest-end-delay |
Yes#25 |
-- |
%# |
execution-ID |
Yes#8 |
-- |
%m |
Time at which start conditions are effective unlimited#7 |
Yes#11 |
-- |
%q |
Number of times by which start conditions are effective A decimal value unlimited |
Yes#11 |
-- |
- Legend:
-
Yes: Format indicators specifiable in the -f or -t option
--: Format indicators not specifiable in the -f or -t option
- #1
-
Valid only for a unit type of net. In the other cases, an asterisk (*) is output.
- #2
-
Valid only for a unit type of job. In the other cases, an asterisk (*) is output.
- #3
-
Information about a jobnet having a generation number of 0.
- #4
-
****/**/** **:** and ****/**/** **:**:** are output if you also specify the -g option.
- #5
-
For a jobnet and job not executed, a value of 1 is assumed.
- #6
-
****/**/** **:**:** is output if you do not specify the -b -e, -v, or -w option.
- #7
-
For details about the output format, see Table 3-21.
- #8
-
For simulation, three asterisks (***) are output.
- #9
-
Effective only when the unit type is net. Otherwise, three asterisks (***) are output.
- #10
-
For a unit that is added while it is suspended, its output reads "plan unexecuted" if the existing upper-level unit is completed. Otherwise, the output reads "unplanned".
- #11
-
Effective only when the unit type is net or condn. Otherwise, three asterisks (***) are output.
- #12
-
For a job, the submitted time is output. For a queueless job, the time when the execution of the job was requested is output.
- #13
-
The total count after registration is output, regardless of the number of logs to keep or generations to be output.
- #14
-
The sum of the values of Scheduled execution start date and time obtained from a computed processing cycle and Estimated time required for execution is output as the time.
- #15
-
The start time at which the unit was re-executed is displayed.
When the unit is re-executed, the date/time re-execution started is set at the point re-execution of the upper-level jobnets started. If the root jobnet is being executed, however, the date/time of re-execution start is not set for the root jobnet.
When the root jobnet has been completed, the date/time re-execution started is set only for the root jobnet if the root jobnet is specified at the point re-execution started.
- #16
-
Output when -b, -e, -v, -w, -B, or an execution ID is specified.
In other cases, 00:00:00 is output.
- #17
-
For a queueless job, three asterisks (***) are output.
- #18
-
For a jobnet or job that has been completed, the date/time that is output here is the same as the actual date/time execution started for the jobnet or job (%St).
- #19
-
For a jobnet or job that has been completed, the date/time that is output here is the same as the actual date/time execution started for the jobnet or job (%st).
- #20
-
For a jobnet or job that has been completed, the date/time that is output here is the same as the actual date/time execution was completed for the jobnet or job (%E).
- #21
-
For a jobnet or job that has been completed, the date/time that is output here is the same as the actual date/time execution was completed for the jobnet or job (%e).
- #22
-
A result of execution simulation is output. For details about execution simulations, see 4.4.2(2) Execution simulation in the manual JP1/Automatic Job Management System 3 Overview.
If the schedule is changed temporarily, execution simulation is performed based on the new time.
- #23
-
Effective only when the unit type is job, netcn, or a connection-destination jobnet.
Otherwise, three asterisks (***) are output.
- #24
-
Effective only when the unit type is net.
Otherwise, none is output (when the language type is English).
- #25
-
Effective only when the unit type is any of the following:
net, pjob, job, qjob, evwjb, flwjb, mlwjb, mqwjb, mswjb, lfwjb, ntwjb, tmwjb, evsjb, mlsjb, mqsjb, mssjb, cmsjb, pwljb, pwrjb, cupjb, cuujb
Otherwise, three asterisks (***) are output.
- #26
-
For a generation that is not scheduled to be executed the next time (Result, Now running, or Not sched. to exe.), three asterisks (***) are output.
- #27
-
Effective only when the unit type is net or rmnet. Otherwise, three asterisks (***) are output.
- #28
-
For a flexible job, the following time is output.
- When a relay agent is used:
-
Start time or end time of execution of the relay agent
- When no relay agent is used:
-
Start time or end time of execution of the manager host
Two-byte format indicator |
Output information |
---|---|
%SP |
The state of being suspended (or not) exist none |
%OP |
Execution date for a jobnet#1 |
%St |
Actual execution start date and time of a jobnet or job#1 |
%st |
Actual execution start date and time of a jobnet or job#1 |
%Pt |
Date and time at which jobnet execution is to start#2, #10 |
%Jm |
Full-path jobnet or job name (a root jobnet name is omitted for a unit in a planning group) |
%Am |
Character string specified with AJSPATH= (a root jobnet name is omitted for a unit in a planning group). Character string specified with %Jm except the part that follows the right-most slash (/). |
%Ed |
Whether or not to suppress the execution if the scheduled time for execution has passed during startup of the scheduler service.#3 yes: Suppress the execution no: Do not suppress the execution |
%cm |
Comment#4 (character string of up to 80 bytes) |
%ab |
Estimated time between the start of the abnormally ended job and the end of the root jobnet#1, #5 |
%an |
Estimated time between the start of the unit next to the abnormally ended job and the end of the root jobnet#1, #5 |
%FG |
Number of future generations #6 (from 1 to 99) |
%ds |
Date/time for monitoring the start delay #1 |
%de |
Date/time for monitoring the termination delay #1, #7 |
%Ft |
Hold attributes hold: Holds not-hold: Does not hold abend-hold: Holds if the previous state was abend warning-hold: Holds if the previous state was warning hold-set: Sets the hold attribute temporarily, or sets hold when jobs or jobnets are registered for execution hold-release: Releases the hold attribute temporarily |
%MV |
Macro variable name and passing information specified at the time jobnets are registered for execution or the macro variable name and inherit result information taken over when jobs are executed#1, #4, #8, #9 |
%CN |
Unit full name of the connection-destination#11, #14 If a jobnet connector is specified, the unit full name of the connection-destination jobnet is output. If a connection-destination jobnet is specified, the unit full name of the jobnet connector is output. |
%CI |
Execution ID of the connection-destination#11, #12 If a jobnet connector is specified, the execution ID of the connection-destination jobnet is output. If a connection-destination jobnet is specified, the execution ID of the jobnet connector is output. |
%CS |
Method for controlling the execution order of the connection-destination jobnet#13 |
%CH |
Host name of the connection-destination#11, #15 If this format indicator is specified for a jobnet connector, the host name of the connection-destination jobnet is output. If this format indicator is specified for a connection-destination jobnet, the host name of the jobnet connector is output. |
%CF |
Name of the scheduler service for the connection-destination#11, #15 If this format indicator is specified for a jobnet connector, the name of the scheduler service for the connection-destination jobnet is output. If this format indicator is specified for a connection-destination jobnet, the name of the scheduler service for the jobnet connector is output. |
%RI |
Release-ID#16 |
%so |
Standard output file name#17, #18 The assumed standard output file name is output even if the standard output file does not exist. For example, the file does not exist if you specify a unit that does not use the standard output (an OR job, judgment job, event job, jobnet connector, or connection-destination jobnet) or specify a job that has not been executed. |
%PW |
Whether any aspect of the wait condition is yet to be satisfied. exist: The wait condition is not satisfied none: The wait condition is satisfied ***: No wait condition is defined |
%RY |
Number of retry executions#19 |
%RC |
Retry status
|
%RS |
Retry registration time#1, #20 The date and time of submission for a retry execution (year, month, date, hour, and minute are output) |
%Rs |
Retry registration time#1, #20 The date and time of submission for a retry execution (year, month, date, hour, minute, and second are output) |
%RT |
Retry start time#1 The execution start date and time for a retry execution (year, month, date, hour, and minute are output) |
%Rt |
Retry start time#1 The execution start date and time for a retry execution (year, month, date, hour, minute, and second are output) |
- Note
-
The format indicators shown in Table 3-18 allow specifying a set of two alphabetic characters as a two-byte format indicator. For example, %S can be specified as -i %SS. The -f and -t options will not accept two-byte format indicators. That is, all of the following are incorrect: -f %JJ, -t %JJ, and -f %SP.
- #1
-
For details about the output format, see Table 3-21.
- #2
-
Effective only when the unit is a jobnet. Otherwise, an asterisk (*) is output.
- #3
-
Effective only when the type of the unit is net, netcn, rmnet, or hlnet.
Otherwise, three asterisks (***) are output.
- #4
-
Double quotation marks (") are output at the beginning and end of the character string.
If there is no value to be output, only "" is output.
- #5
-
The required time is estimated based on the execution result after the root jobnet is registered for execution only when the -b, -e, -v, or -w option is specified. One minute is the estimate for a job that has never been executed in the generation containing a job that has ended abnormally. 0 seconds is the estimate for a job that has already ended normally. The information about a unit that has ended without being executed is not output by specifying the -b or -e option. To output the information about a unit that has ended without being executed, use the -v or -w option.
For details about the estimated required time, see Additional information 3 below.
- #6
-
The *** string is output if the number of future generations is not specified at the time of registration for execution. This is the information about the root jobnet, which is 0 in the generation number sequence.
- #7
-
If you use the time-required-for-execution to monitor the date/time for end delay, the monitoring date/time is not output. The * string is output instead.
- #8
-
This is effective only when the unit type is root jobnet (excluding remote jobnets) or job. Otherwise, the *** string is output.
- #9
-
The "" string is output for a pseudo schedule.
- #10
-
The date and time that execution has been scheduled is output. If the schedule is temporarily changed, the new schedule is output.
- #11
-
This is effective only when the unit type is a jobnet connector or jobnet (connection-destination jobnet).
Otherwise, the *** string is output. The *** string is also output when permission to view the jobnet connector or connection-destination jobnet is not granted.
If an invalid unit is specified as the unit to be connected by the jobnet connector or connection-destination jobnet, the execution ID, unit full name, host name, and scheduler service name are displayed. However, the status of the unit changes to Ended abnormally because a definition error occurs during execution.
To check whether the definition is correct, specify the jobnet connector in the ajschkdef command. For details on the ajschkdef command, see ajschkdef in 3. Commands Used for Normal Operations and 8. Definition Pre-Check in the JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.
- #12
-
If a jobnet connector or connection-destination jobnet is defined on a different host or in a different scheduler service, the *** string is output for a generation scheduled to be executed.
For details about how to check the execution ID of a jobnet connector or connection-destination jobnet defined on a different host or in a different scheduler, see Additional information 4 below.
- #13
-
This is effective only for a connection-destination jobnet. Otherwise, three asterisks (***) are output.
- #14
-
If Connection range is Other service, the information defined for the unit is output.
- #15
-
If Connection range is Same service, the *** string is output.
- #16
-
For a release target jobnet (a root jobnet for which release entry is made) or its subordinate unit, the release ID is output. Otherwise, three asterisks (***) are output.
- #17
-
This is effective only when the unit type is any of the following:
net,pjob,job,qjob,evwjb,flwjb,mlwjb,mqwjb,mswjb,lfwjb,ntwjb,tmwjb,evsjb,mlsjb,mqsjb,mssjb,cmsjb,pwljb,pwrjb,cupjb,cuujb,orjob,jdjob,netcn
Otherwise, three asterisks (***) are output.
- #18
-
For simulation, three asterisks (***) are output.
- #19
-
0 is output if retry execution is not performed. For units that are not subject to automatic retry, *** is output.
- #20
-
For a job, the time when the job was submitted is output. For a queueless job, the time when job execution was requested is output.
Format indicator |
Output information |
---|---|
%% |
% |
%n |
Line feed character |
%t |
Tab character |
%x |
Current date# |
%X |
Current time# |
- #
-
Time at which you started executing the ajsshow command. For details about the output format, see the following table:
Format indicator |
Output format |
|
---|---|---|
Japanese |
English |
|
%D %P %S %E %K %V %Q %B %O %m %St %Pt %ds %de %RS %RT |
YYYY/MM/DD hh:mm For MM, DD, hh and mm, a zero (0) is prefixed.
|
MMM DD YYYY hh:mm For DD, if the value to be output is one digit, a space is prefixed. For hh and mm, a zero (0) is prefixed.
|
%s %e %k %b %o %v %w %st %Rs %Rt |
YYYY/MM/DD hh:mm:ss For MM, DD, hh, mm and ss, a zero (0) is prefixed.
|
MMM DD YYYY hh:mm:ss For DD, if the value to be output is one digit, a space is prefixed. For hh and mm, a zero (0) is prefixed.
|
%x %OP |
YYYY/MM/DD For MM and DD, a zero (0) is prefixed.
|
MMM DD YYYY For DD, if the value to be output is one digit, a space is prefixed.
|
%X %a %ab %an |
hh:mm:ss
|
|
%l |
YYYYMMDDNNN
|
|
%MV |
"information-1:information-2"[,"information-1:information-2"[...]] information-1: macro variable name information-2: passing information, or inherit result information
|
Additional information 2
The following table shows differences between information output when a target unit is automatically selected from the units in a planning group and that output when a target unit is not automatically selected.
Format indicator |
When a target unit is automatically selected |
When a target unit is not automatically selected |
---|---|---|
%p %P %M |
Information about the unit to be executed next in the planning group |
Schedule for the next execution of the specified unit |
%G |
Generation number obtained by integrating execution information for the root jobnets in the planning group |
Generation number for the specified unit only |
%l |
Execution registration number obtained by integrating execution information for the root jobnets in the planning group |
Execution registration number for the specified unit only |
%Y %a |
This information is maintained for each unit. Information for each unit is output even if you specify the function for automatically selecting a target unit. |
|
%B %b %O %o |
Information obtained from processing cycle calculation is calculated based on information maintained for each unit. Information for each unit is output even if you specify the function for automatically selecting a target unit. |
The following example planning group definition shows differences in information output with %P, %G, and %l depending on the specification with the -X option.
- Example planning group definition
-
Planning group (/group1) has three units, /group1/jobnet001, /group1/jobnet002, and /group1/jobnet003.
The scheduled start times for the units are as follows:
The scheduled start time for /group1/jobnet001 is 08:00 (absolute time).
The scheduled start time for /group1/jobnet002 is 09:00 (absolute time).
The scheduled start time for /group1/jobnet003 is 10:00 (absolute time).
- Example 1:
-
Information output with %P when the -X option is set to yes.
ajsshow -f "Next schedule=%P %C %J" -g 1 -X yes /group1
- Output result
Next schedule=Aug 13 20XX 08:00 normal /group1/jobnet003
- Explanation:
-
In this case, the command outputs the next scheduled execution time for the unit to be executed next (/group1/jobnet001) under the root jobnets in the planning group.
- Example 2:
-
Information output with %P when the -X option is set to no.
ajsshow -f "Next schedule=%P %C %J" -g 1 -X no /group1/jobnet003
- Output result
Next schedule=Aug 15 20XX 10:00 normal /group1/jobnet003
- Explanation:
-
In this case, the command outputs the next scheduled execution time for the specified unit (/group1/jobnet003).
- Example 3:
-
Information output with %G when the -X option is set to yes.
ajsshow -f "Generation=%G Start time=%S %C %J" -g 3 -X yes /group1
- Output result
Generation=1 Start time=Aug 12 20XX 10:00 normal /group1/jobnet003 Generation=2 Start time=Aug 11 20XX 09:00 normal /group1/jobnet002 Generation=3 Start time=Aug 10 20XX 08:00 normal /group1/jobnet001
- Explanation:
-
In this case, the command outputs the generation number obtained by integrating execution information for the root jobnets in the planning group.
- Example 4:
-
Information output with %G when the -X option is set to no.
ajsshow -f "Generation=%G Start time=%S %C %J" -g 3 -X no /group1/jobnet001
- Output result
Generation=1 Start time=Aug 10 20XX 08:00 normal /group1/jobnet001 Generation=2 Start time=Aug 7 20XX 08:00 normal /group1/jobnet001 Generation=3 Start time=Aug 4 20XX 08:00 normal /group1/jobnet001
- Explanation:
-
In this case, the command outputs the generation number based on execution information for the specified unit.
- Example 5:
-
Information output with %l when the -X option is set to yes.
ajsshow -f "Registration number=%l Start time=%S %C %J" -b 20XX/8/3 -X yes /group1
- Output result
Registration number=20XX0803001 Start time=Aug 3 20XX 08:00 normal /group1/jobnet001 Registration number=20XX0803002 Start time=Aug 3 20XX 09:00 normal /group1/jobnet002 Registration number=20XX0803003 Start time=Aug 3 20XX 10:00 normal /group1/jobnet003
- Explanation:
-
In this case, the command outputs the execution registration number obtained by integrating execution information for the root jobnets in the planning group.
- Example 6:
-
Information output with %l when the -X option is set to no.
ajsshow -f "Registration number=%l Start time=%S %C %J" -b 20XX/8/3 -X no /group1/jobnet003
- Output result
Registration number=20XX0803001 Start time=20XX/08/03 10:00 Normal end /group1/jobnet003
- Explanation:
-
In this case, the command outputs the execution registration number based on execution information for the specified jobnet.
Additional information 3
The following example shows how to calculate the estimated required time for a job that has ended abnormally.
- Example 1:
-
The following describes how to calculate the estimated required time to determine whether to immediately re-execute a job that has ended abnormally, using the example jobnet configuration as shown below.
The jobs /jobnet1/nestjobnet001/job3 and /jobnet1/nestjobnet002/job2 have ended abnormally.
The following shows the output information and output results for %ab when the -v and -w options are specified.
- Output information
ajsshow -i "Estimated required time=%ab UnitName=%JJ" -v 20XX/2/12 -w 20XX/2/12 -RN /jobnet1
- Output result
Estimated required time=07:00:00 UnitName=/jobnet1 Estimated required time=07:00:00 UnitName=/jobnet1/nestjobnet001 Estimated required time=03:00:00 UnitName=/jobnet1/nestjobnet002
- Explanation:
-
The output results indicate that the execution of jobnet001 will require seven hours so that you might decide to re-execute only this unit (jobnet1/nestjobnet001) at night or immediately re-execute only the jobnet1/nestjobnet002 unit, which will require three hours.
- Example 2:
-
Suppose the jobnet that follows the abnormally ended job has a scheduled start time specified. The result of calculating the estimated required time may vary with whether the time when the job ends due to the start of re-execution precedes or follows the scheduled start time for the next jobnet.
-
If the time when the job ends due to the start of re-execution precedes the scheduled start time for the next jobnet
The job /jobnet1/nestjobnet001/job2 has ended abnormally. The scheduled start time for the next jobnet (/jobnet1/nestjobnet002) is 05:00.
If re-execution starts at 03:00, the job /jobnet1/nestjobnet001/job2 is executed between 03:00 and 04:00 and nestjobnet001 ends at 04:00. The jobnet nestjobnet002 waits until 05:00 (scheduled start time) and then starts at 05:00 and ends at 07:00. The following shows the output information and output results:
- Output information
ajsshow -i "Estimated required time=%ab UnitName=%JJ" -v 20XX/8/21 -w 20XX/8/21 -d 20XX/8/21 -h 3:00 -RN /jobnet1
- Output result
Estimated required time=04:00:00 UnitName=/jobnet1 Estimated required time=01:00:00 UnitName=/jobnet1/nestjobnet001 Estimated required time=02:00:00 UnitName=/jobnet1/nestjobnet002
- Explanation:
-
The output results indicate that jobnet1 will require four hours, 3:00 to 7:00.
-
If the time when the job ends due to the start of re-execution follows the scheduled start time for the next jobnet
The job /jobnet1/nestjobnet001/job2 has ended abnormally. The scheduled start time for the next jobnet (/jobnet1/nestjobnet002)is 05:00.
If re-execution starts at 05:00, the job /jobnet1/nestjobnet001/job2 is executed between 05:00 and 06:00 and nestjobnet001 ends at 06:00. The jobnet nestjobnet002, for which the scheduled start time, 05:00 is already passed, is immediately executed and ends at 08:00. The following shows the output information and output results:
- Output information
ajsshow -i "Estimated required time=%ab UnitName=%JJ" -v 20XX/8/21 -w 20XX/8/21 -d 20XX/8/21 -h 5:00 -RN /jobnet1
- Output result
Estimated required time=03:00:00 UnitName=/jobnet1 Estimated required time=01:00:00 UnitName=/jobnet1/nestjobnet001 Estimated required time=02:00:00 UnitName=/jobnet1/nestjobnet002
- Explanation:
-
The output results indicate that jobnet1 will require three hours, 5:00 to 8:00.
As shown above, you can specify the -d and -h options when calculating the estimated required time to determine how long re-execution will take depending on the time when re-execution is started.
-
Additional information 4
If a jobnet connector or a connection-destination jobnet connector is defined on a different host or in a different scheduler service, *** is output even if %CI is specified in the -i option.
If you want to check the execution ID of a jobnet connector or connection-destination jobnet defined on a different host or in a different scheduler, remotely execute the ajsshow command as described in the following procedure.
To check the execution ID of a jobnet connector or connection-destination jobnet defined on a different host or in a different scheduler:
-
Remotely execute the ajsshow command to display the host name, scheduler service name, and unit full name of the connection-destination.
Execute the following command:
ajsshow -v 20XX/07/01 -i "%CH %CF %CN" unit-name
-
Display the execution ID of the connection-destination from the information displayed in step 1.
Execute the following command:
host-name-displayed-in-step-1:scheduler-service-name-displayed-in-step-1:ajsshow -v 20XX/07/01 -i "%CI" unit-name
Additional information 5
If you specify a for the -g option, execution result information for jobnets with start conditions specified is output in order from the generation with the latest scheduled start time to the one with the earliest.
If you register a jobnet for execution with start conditions specified, a generation for monitoring the start conditions is created when the start time is reached. At the same time, generations in the Wait for start cond. status are also created and are executed when the start conditions are satisfied.
The scheduled start time for the generation being monitored is also assumed for the generations in the Wait for start cond. status and the generations executed when start conditions are satisfied. If you are using jobnets with start conditions and jobnets without start conditions, note the order in which the execution result information is output.
The following shows an example when the number of logs to keep is 10. In this example, a jobnet (net) with start conditions specified is registered for execution, and later a jobnet without start conditions specified is registered for execution.
As shown, a jobnet (net) with start conditions specified is registered for execution on March 1 and a generation for monitoring the start conditions is created (1-0 in the figure). At the same time, generations in the Wait for start cond. status are created. These generations are executed on March 2, March 4, and March 5 when their start conditions are satisfied (1-1, 1-2, and 1-3 in the figure).
In addition, a jobnet (net) without start conditions specified is registered for execution on March 3(2 in the figure).
- Output information
ajsshow -f "Generation=%G %J %# %C" -g a -T /net
- Output result
Generation=1 /net @A103 Normal end Generation=2 /net @A105 Wait for start cond.# Generation=3 /net @A104 Normal end# Generation=4 /net @A102 Normal end# Generation=5 /net @A101 Normal end# Generation=6 /net @A100 Now monitoring#
# Execution result information for a generation with start conditions specified
- Explanation:
-
When you execute the ajsshow command to output execution result information, the result of executing the jobnet that was registered for execution on March 3 is output as generation 1, since it is the latest execution result of the jobnet (net). For generations 2 to 6, the results of executing the jobnet with start conditions registered for execution on March 1 are output in order by generation according to the generation whose start conditions were satisfied last.
Example 1
The following command outputs the results of executing jobnet net1, and jobnets and jobs in it to the standard output file.
ajsshow -l net1
Example 2
The following command outputs two generations of results of executing a jobnet in the job group group1. The information to be displayed is the full-path jobnet name, the execution start time, and the execution end time.
ajsshow -t"Generation: %G" -g2 -f"%J %S %E" -RE /group1
- Output example
Generation: 1 /group1/net1 Jun 8 20XX 10:00 Jun 8 20XX 12:00 Generation: 2 /group1/net1 Jun 1 20XX 10:00 Jun 1 20XX 11:30 Generation: 1 /group1/net2 Jun 8 20XX 11:00 Jun 8 20XX 11:30 Generation: 2 /group1/net2 Jun 1 20XX 11:00 Jun 1 20XX 12:00
Example 3
The following command outputs scheduled execution information (jobnet name, generation number and execution start time) on jobnet net for July 2010 (July 1, 2010 to July 31, 2010), displaying the target output period on the title row.
ajsshow -t "Period %v-%w" -f" %j %G %B"-b 2010/7/1 -e 2010/7/31 /net
- Output example
Period Jul 1 2010 00:00:00-Jul 31 2010 23:59:59 net -5 Jul 7 2010 10:00 Period Jul 1 2010 00:00:00-Jul 31 2010 23:59:59 net -6 Jul 14 2010 10:00 Period Jul 1 2010 00:00:00-Jul 31 2010 23:59:59 net -7 Jul 21 2010 10:00 Period Jul 1 2010 00:00:00-Jul 31 2010 23:59:59 net -8 Jul 31 2010 10:00
Example 4
The following command outputs the name of the standard error output file for job job1 in jobnet net, whose execution registration number is 20100701001. Assume that the job error information directory (/var/opt/jp1ajs2/jobinf) is set for the JOBINFDIR environment setting parameter.
ajsshow -B 20100701001 -r /net/job1
- Output example
/var/opt/jp1ajs2/jobinf/e/67/0.e.err
Example 5
For the following jobnet (net) and jobs (job1, job2, and job3) under the jobnet, this example specifies the period using the -b, -e, -v, and -w options to output the execution start and end dates and times.
- Specifying 2010/07/21 in the -b and -e options
ajsshow -b 2010/07/21 -e 2010/07/21 -f "%S %E %J" -R /net
- Output example
Jul 21 2010 10:00 Jul 22 2010 06:00 /net Jul 21 2010 16:00 Jul 21 2010 21:00 /net/job1 Jul 21 2010 21:00 Jul 22 2010 02:00 /net/job2
- Explanation:
-
The calendar date is the target of output.
The output covers the information about net as well as job1 and job2 under net where execution is started on 2010/07/21.
- Specifying 2010/07/21 in the -v and -w options
ajsshow -v 2010/07/21 -w 2010/07/21 -f "%S %E %J" -R /net
- Output example
Jul 21 2010 10:00 Jul 22 2010 06:00 /net Jul 21 2010 16:00 Jul 21 2010 21:00 /net/job1 Jul 21 2010 21:00 Jul 22 2010 02:00 /net/job2 Jul 22 2010 02:00 Jul 22 2010 06:00 /net/job3
- Explanation:
-
The execution date for the jobnet is the target of output.
The output covers the information about net as well as the three jobs under net where execution is started on 2010/07/21.
- Specifying 2010/07/22 in the -b and -e options
ajsshow -b 2010/07/22 -e 2010/07/22 -f "%S %E %J" -R /net
- Output example
Jul 21 2010 10:00 Jul 22 2010 06:00 /net Jul 21 2010 21:00 Jul 22 2010 02:00 /net/job2 Jul 22 2010 02:00 Jul 22 2010 06:00 /net/job3
- Explanation:
-
The calendar date is the target of output.
The output covers the information about job2 where execution is ended on 2010/07/22, and job3 where execution is started on 2010/07/22.
- Specifying 2010/07/22 in the -v and -w options
ajsshow -v Jul 22 2010 -w Jul 22 2010 -f "%S %E %J" -R /net
- Explanation:
-
The execution date for the jobnet is the target of output.
The output covers no information even if you specify 2010/07/22 in the -v and -w options because the execution date for net is 2010/07/21.
Example 6
This example explains how you can output information about a jobnet connector or connection-destination jobnet by using the -i option.
-
jobnet connector
host name: HOSTA
scheduler service name: AJSROOT1
unit name: /JC/jobnet-connector
execution ID: @A544
-
connection-destination jobnet
host name: HOSTB
scheduler service name: AJSROOT2
unit name: /JC-NET
execution ID: @A546
- When a jobnet connector is specified for the -i option:
ajsshow -i "%JJ %TT %CH %CF %CN %CI %CS" /JC/jobnet-connector
- Output example
/JC/jobnet-connector netcn HOSTB AJSROOT2 /JC-NET @A546 ***
- When a connection-destination jobnet is specified for the -i option:
ajsshow -i "%JJ %TT %CH %CF %CN %CI %CS" /JC-NET
- Output example
-
/JC-NET net HOSTA AJSROOT1 /JC/jobnet-connector @A544 nosync
Example 7
The following command outputs the name of the standard output file used by job job1 in jobnet net executed in the period from 2010/08/06 to 2010/08/07. Assume that the job information storage directory (C:\Program Files\HITACHI\JP1AJS2\jobinf) is set for the JOBINFDIR environment setting parameter.
ajsshow -b 2010/08/06 -e 2010/08/07 -i "%so" /net/job1
- Output example
C:\Program Files\HITACHI\JP1AJS2\jobinf\d\6e\0.e.std
Example 8
The following figure shows an example of using the -xi option for registering jobnet execution. 7/1 is registered when a start condition is used, and 7/2 is registered when a start condition is not used.
Information about the jobnet (netB) in the figure is output.
- Example 1: When all generations are output and the -xi b option is specified
ajsshow -xw -xi b -g a /netB
- Output example
-
- Explanation:
-
Information about the monitoring generations, execution generations, and generations that do not use a start condition are output. Generations 1 to 4 in the figure are subject to output. Note, however, that the ajsshow command ends abnormally because generations 2 and 3 are execution generations and there is no wait information.
- Example 2: When all generations are output with the -xi c option specified
ajsshow -xw -xi c -g a /netB
- Output example
-
- Explanation:
-
Generations 1 and 4 are subject to output, because information about the monitoring generation and generations that do not use a start condition is to be output. Generations 2 and 3 are not output because they are execution generations.
Output example 1
-
When you specify the -s option
-
When you specify the -p option
-
When you specify the -l option
Explanation of the output items
- AJSPATH=
-
Indicates the contents of the full-path jobnet or job name except the jobnet or job name covered in name.
- Name
-
Indicates a jobnet or job name.
- Type
-
Indicates the type of a unit.
mgroup: Manager job group
group: Job group
mnet: Manager jobnet
condn: Start condition (.CONDITION)
net: Jobnet
rnet: Jobnet for recovery
rmnet: Remote jobnet
rrnet: Remote jobnet for recovery
job: Unix job
rjob: Unix job for recovery
pjob: PC job
rpjob: PC job for recovery
qjob: QUEUE job
rqjob: QUEUE job for recovery
jdjob: Judgment job
rjdjob: Judgment job for recovery
orjob: OR job
rorjob: OR job for recovery
cmsjb: OpenView status report job
rcmsjb: OpenView status report job for recovery
evwjb: JP1 event reception monitoring job
revwjb: JP1 event reception monitoring job for recovery
flwjb: File monitoring job
rflwjb: File monitoring job for recovery
mlwjb: Email reception monitoring job
rmlwjb: Email reception monitoring job for recovery
mqwjb: Message queue reception monitoring job
rmqwjb: Message queue reception monitoring job for recovery
mswjb: MSMQ reception monitoring job
rmswjb: MSMQ reception monitoring job for recovery
lfwjb: Log file monitoring job
rlfwjb: Log file monitoring job for recovery
ntwjb: Windows event-log monitoring job
rntwjb: Windows event-log monitoring job for recovery
tmwjb: Execution interval control job
rtmwjb: Execution interval control job for recovery
evsjb: JP1 event sending job
revsjb: JP1 event sending job for recovery
mlsjb: Email sending job
rmlsjb: Email sending job for recovery
mqsjb: Message queue sending job
rmqsjb: Message queue sending job for recovery
mssjb: MSMQ sending job
rmssjb: MSMQ sending job for recovery
pwljb: Local power control job
rpwljb: Local power control job for recovery
pwrjb: Remote power control job
rpwrjb: Remote power control job for recovery
cuujb: Custom Unix job
rcuujb: Custom Unix job for recovery
cupjb: Custom PC job
rcupjb: Custom PC job for recovery
netcn: Jobnet connector
n: Job group
p: Planning group
fxj: Flexible job
rfxj: Flexible job for recovery
htpjb: HTTP Connection job
rhtpjb: HTTP Connection job for recovery
- Status
-
Indicates the status of a jobnet or job.
- Plan
-
Indicates whether the displayed jobnet or job is scheduled to be executed next.
exist: The jobnet or job is scheduled to be executed next.
none: The jobnet or job is not scheduled to be executed next.
- Registrant
-
Indicates the name of the user who registered the jobnet for execution.
- Registered time
-
Indicates the date and time when the jobnet was registered for execution.
- Next execution time
-
Indicates the scheduled next execution time.
If the next execution time is not scheduled, *** ** **** **:** is displayed.
- Method
-
Indicates the method of the next execution.
schedule: Follows the planned execution schedule for execution.
plan: Changes the plan temporarily for execution
shift: Shift for execution
- Code
-
Indicates the return value or the cancellation signal code.
If there is no return value or signal code, *** appears.
- Start time
-
Indicates the execution start date and time.
If execution is not started, *** ** **** **:** appears.
- End time
-
Indicates the execution end date and time.
If execution is not ended, *** ** **** **:** appears.
Output example 2
-
When the -xw and -xi b options are specified
-
When the -xw and -xi c options are specified
Explanation of the output items
- AJSPATH=
-
The full path name of the jobnet or job without the unit name output as the Name item.
- An unit with wait condition
-
Indicates that the following information relates to a unit with wait conditions.
- Name
-
The jobnet name or job name of the unit with wait conditions.
- Generation
-
The generation number of the unit with wait conditions. If you specified a future generation, this item outputs a negative value.
- Execution ID
-
The execution ID of the unit with wait conditions.
- Status
-
The status of the unit with wait conditions.
Indicates the status of the monitoring generation when a unit with wait conditions is a jobnet with start conditions.
- Wait method
-
The wait method.
AND: The wait condition is satisfied when all units whose ends are being waited for finish executing.
OR: The wait condition is satisfied when any one of the units whose ends are being waited for finishes executing.
- No generations to wait for
-
The behavior of the unit with wait conditions when there are no applicable generations of the units whose ends are being waited for.
Execute: When there are no applicable generations of the units whose ends are being waited for, the unit starts executing.
Do not execute: When there are no applicable generations of the units whose ends are being waited for, the unit with wait conditions continues waiting for the wait condition to be satisfied.
- When Unmonitored + Ended
-
Indicates the behavior of a unit with wait conditions when the unit with wait conditions is a jobnet with start conditions, and the monitoring generation is in the Unmonitored + Ended status.
Execute: When the monitoring generation is in the Unmonitored + Ended status, the unit with wait conditions starts execution.
Do not execute: When the monitoring generation is in the Unmonitored + Ended status, the unit with wait conditions does not start execution.
- Abnormal end for an execution generation
-
Indicates the behavior of a unit with wait conditions when a unit with wait conditions is a jobnet with start conditions, and the execution generation ended abnormally.
Execute: If the execution generation ends abnormally, the unit with wait conditions starts execution.
Do not execute: When the execution generation ends abnormally, the unit with wait conditions does not start execution.
- Wait status
-
The wait status with respect to the unit whose end is being waited for
Incomplete: The end of the waiting-target unit is still being waited for.
Complete: The wait process has completed.
Incomplete_manually: The end of the waiting-target unit is still being waited for, as a result of manual reinstatement of the wait condition.
Complete_manually: The end of the waiting-target unit is no longer being waited for, as a result of manual deactivation of the wait condition.
Incomplete_rerun: The waiting-target unit has ended. However, the wait status is regarded as incomplete because the status was changed from abnormal end when the subsequent unit was re-executed.
- Unit whose end is being waited for
-
Indicates that the following information relates to a unit whose end is being waited for.
- Status
-
The status of the unit whose end is being waited for. If the target of the wait condition is a planning group, this item displays the status of the unit in the planning group whose end is actually being waited for.
Asterisks (***) appear for this item when:
-
The definition of the unit whose end is being waited for is invalid
-
There are no applicable generations of the unit whose end is being waited for
-
The unit whose end is being waited for is not registered
-
- Execution ID
-
The execution ID of the unit whose end is being waited for. If the target of the wait condition is a planning group, this item displays the execution ID of the unit in the planning group whose end is actually being waited for.
Asterisks (***) appear for this item when:
-
The definition of the unit whose end is being waited for is invalid
-
There are no applicable generations of the unit whose end is being waited for
-
The unit whose end is being waited for is not registered
-
- Comment
-
The comment defined for the unit whose end is being waited for. If the target of the wait condition is a planning group, this item displays the comment for the unit in the planning group whose end is actually being waited for.
Asterisks (***) appear for this item when:
-
The definition of the unit whose end is being waited for is invalid
-
There are no applicable generations of the unit whose end is being waited for
-
The unit whose end is being waited for is not registered
-
You do not have reference permission for the unit whose end is being waited for
-
- Name
-
The full path name of the unit whose end is being waited for.