Job Management Partner 1/Automatic Job Management System 3 Command Reference 1

ajsleave

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:

Table 2-9 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 Job Management Partner 1/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 must specify this option with the -e option. 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 must specify this option with the -w option. 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.

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

Notes

Users can cancel a jobnet registered for execution if they are assigned the manipulation or update privileges when all the jobs and jobnets contained in the jobnet are defined, or when you modified the job and jobnet attributes. However, a user having superuser privileges (in UNIX systems), or being logged on as a member of the Administrators group (in Windows systems) can cancel a jobnet.

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

Example

The following command cancels the execution registration of jobnet net1:
 
ajsleave net1

[Contents][Back][Next]

[Trademarks]

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