ajsleave
- Organization of this page
Format
ajsleave [-F service-name] [-B execution-registration-number |-b [[year/]month/]day [-e [[year/]month/]day] |-v [[year/]month/]day [-w [[year/]month/]day]] [-R] [-E] [-T] jobnet-name-or-job-group-name...
Description
Cancels the execution registration of a jobnet.
Execution privileges
You must have any of the following JP1 privileges:
-
JP1_AJS_Admin privilege
-
JP1_AJS_Manager privilege
-
JP1_AJS_Operator 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 execution-registration-number
Specify the execution registration number of the jobnet whose execution registration you want to cancel.
The following table lists the execution registration numbers you can specify:
Execution registration number |
Description |
---|---|
all |
All execution registration information for the jobnet |
schedule |
Schedule information |
result |
Result information |
YYYYMMDDNNN# |
Specified execution schedule or result |
YYYYMMDD# |
Specified execution schedule or result |
- #
-
The meaning of the characters is as follows:
YYYY: Year of the scheduled date of execution
MM: Month of the scheduled date of execution
DD: Day of the scheduled date of execution
NNN: Execution registration sequence number for the scheduled date of execution
For details of 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 omit this option, the system assumes -B all.
You cannot specify this option with the -b, -e, -v, or -w option.
-b [[year/]month/]day
Specify the start date of the period for which you want to cancel registration as a calendar date.
The start time is the base time.
-
year
You can specify a value between 1994 and the value of the SCHEDULELIMIT environment setting parameter for the year. For details about the SCHEDULELIMIT environment setting parameter, see 20.4.2(123) SCHEDULELIMIT in the JP1/Automatic Job Management System 3 Configuration Guide.
-
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 in which you executed the command
year/month: The year and month in which you executed the command
You cannot specify this option with the -B, -v, or -w option.
-e [[year/]month/]day
Specify the end date of the period for which you want to cancel registration as a calendar date.
The end date must be the same as or follow 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 the value of the SCHEDULELIMIT environment setting parameter for the year. For details about the SCHEDULELIMIT environment setting parameter, see 20.4.2(123) SCHEDULELIMIT in the JP1/Automatic Job Management System 3 Configuration Guide.
-
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 in which you executed the command
year/month: The year and month in which you executed the command
You must specify this option with the -b option. You cannot specify this option with the -B, -v, or -w option.
-v [[year/]month/]day
Specify the start date of the period for which you want to cancel registration as an execution date.
The start time is the base time.
-
year
You can specify a value between 1994 and the value of the SCHEDULELIMIT environment setting parameter for the year. For details about the SCHEDULELIMIT environment setting parameter, see 20.4.2(123) SCHEDULELIMIT in the JP1/Automatic Job Management System 3 Configuration Guide.
-
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 in which you executed the command
year/month: The year and month in which you executed the command
You cannot specify this option with the -B, -b, or -e option.
-w [[year/]month/]day
Specify the end date of the period for which you want to cancel registration as an execution date.
The end date must be the same as or follow 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 the value of the SCHEDULELIMIT environment setting parameter for the year. For details about the SCHEDULELIMIT environment setting parameter, see 20.4.2(123) SCHEDULELIMIT in the JP1/Automatic Job Management System 3 Configuration Guide.
-
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 in which you executed the command
year/month: The year and month in which you executed the command
You must specify this option with the -v option. You cannot specify this option with the -B, -b, or -e option.
-R
Cancels execution registration for all units contained in the specified job group.
If you specify this option with the -E and/or -T options, the system cancels the execution registration for jobnets according to the specification of each option.
If you do not specify the -T option together with the -R option, the registration of all the units is canceled, and the registration cancel processing for the units except the root jobnet ends abnormally.
-E
Cancels execution registration for all registered jobnets.
-T
Cancels execution registration for the root jobnet.
jobnet-name-or-job-group-name
Specify the name of the jobnet whose execution registration you want to cancel. You can also specify a jobnet name or job group name 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. If you want to specify a jobnet name, however, you can specify only a root jobnet 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 jobnet or job group name. If you specify an execution ID, however, the -B option is disabled. For details about how to specify the execution ID, see 1.1 Command syntax.
Notes
-
Either of the following users can cancel the registration of a jobnet for execution:
-
A user granted the operation privilege when the jobs contained in the jobnet and the jobnet were defined or when their 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 who has Administrators or superuser privileges must have the operation privilege.
-
-
This command terminates abnormally if you execute it when a scheduler service is not running.
-
You can cancel execution registration for the root jobnet only.
-
This command terminates abnormally if the jobnet that you attempt to cancel execution registration is running.
-
This command terminates abnormally if the target jobnet is being suspended.
Return values
0 |
Normal end |
Multiple of 4 within the range from 4 to 124 |
Abnormal end |
Additional information
The specification method for the -b, -e, -v, and -w options might differ depending on the value specified in the ROOTJOBNETSCHEDULERANGE environment setting variable. The following describes how to specify the -b, -e, -v, and -w options when the schedule definition is based on 48 hours and 24 hours:
-
When the root jobnet schedule definition is based on 48 hours
When the root jobnet schedule definition is based on 48 hours, an execution date may differ from the corresponding calendar date.
When the base time is 7:00, for example, registering the execution start date/time for /jobnet001 as 2010/7/2 32:00 results in the calendar date being July 3 and the execution date being July 2. (The calendar date is the date on which the jobnet will be started, assuming a day is 24 hours, so that 32:00 on July 2, 2010 is assumed as 8:00 on July 3, 2010.) You can cancel registration by specifying either of the following commands because the -b and -e options specify a calendar date while the -v and -w options specify an execution date:
-
For a calendar date
ajsleave -b 2010/7/3 -e 2010/7/3 /jobnet001
-
For an execution date
ajsleave -v 2010/7/2 -w 2010/7/2 /jobnet001
Note, however, that you cannot use the -b and -e options when canceling registration of a jobnet execution scheduled at or after 24:00 on December 31 in the year set for the SCHEDULELIMIT environment setting parameter. To cancel registration of such a jobnet, use the -v and -w options. This is because if you use the -b and -e options, the time you specify will be at or after 0:00 on January 1 of the year after the year set for the SCHEDULELIMIT environment setting parameter. For the -b and -e options, you can specify a four-digit year in the range from 1994 to the value of the SCHEDULELIMIT environment setting parameter. For details about the SCHEDULELIMIT environment setting parameter, see 20.4.2(123) SCHEDULELIMIT in the JP1/Automatic Job Management System 3 Configuration Guide.
-
-
When the root jobnet schedule definition is based on 24 hours
When the root jobnet schedule definition is based on 24 hours, an execution date equals the corresponding calendar date.
When the base time is 7:00, for example, registering the execution start date/time for /jobnet001 as 2010/7/2 32:00 results in the calendar date being July 3 and the execution date being July 3. You can cancel registration by specifying either of the following commands because the -b and -e options specify a calendar date while the -v and -w options specify an execution date:
-
For a calendar date
ajsleave -b 2010/7/3 -e 2010/7/3 /jobnet001
-
For an execution date
ajsleave -v 2010/7/3 -w 2010/7/3 /jobnet001
-
Example
The following command cancels the execution registration of jobnet net1:
ajsleave net1