ajsleave

Organization of this page

Format
Description
Execution privileges
Arguments
Notes
Return values
Additional information
Example

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...

To Page Top

Description

Cancels the execution registration of a jobnet.

To Page Top

Execution privileges

You must have any of the following JP1 privileges:

JP1_AJS_Admin privilege
JP1_AJS_Manager privilege
JP1_AJS_Operator privilege

To Page Top

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:

Table 3‒11: Execution registration numbers
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 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 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 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 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 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 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 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 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.

To Page Top

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.

To Page Top

Return values

0	Normal end
Multiple of 4 within the range from 4 to 124	Abnormal end

To Page Top

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
```
You cannot, however, use the -b and -e options to cancel registration of schedules after 24:00 on December 31, 2036. In such a case, use the -v and -w options. If you specify a schedule after 24:00 on December 31, 2036 as a calendar date, it means a schedule after 0:00 on January 1, 2037, which falls outside the valid range for a schedule year (1994 to 2036).
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
```

To Page Top

Example

The following command cancels the execution registration of jobnet net1:

ajsleave net1

To Page Top