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

ajsintrpt

Format

ajsintrpt
     [-F service-name]
     [-B execution-registration-number]
     [-R]
     [-E]
     [-T]
     [-X {yes|no|auto}]
     jobnet-name-or-job-group-name...

Description

Stops the execution of a jobnet after the currently running job is completed.

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 for which you want to stop execution, in the YYYYMMDDNNN format. The meaning of YYYYMMDDNNN 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.

-R

Stops the execution of all jobnets contained in the specified job group and jobnet.

If you specify this option with the -E and/or -T options, the system stops the execution of jobnets according to the specification of each option.

-E

Stops the execution of registered jobnets.

-T

Stops the execution of the root jobnet.

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

jobnet-name-or-job-group-name

Specify the name of the jobnet for which you want to stop execution. 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

Users can stop a jobnet 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 or jobnet attributes. However, a user logged on as a member of the Administrators group (in Windows systems), or having superuser privileges (in UNIX systems) can stop a jobnet.

This command terminates abnormally if you execute it when a scheduler service is not running.

This command terminates abnormally if the target jobnet is being suspended.

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 informations in ajsplan in 2. Commands.

If this command is executed, communication and database updating take place in JP1/AJS3. Therefore, if this command is executed many times in a short period, the overall JP1/AJS3 system will become heavily loaded and operations might be affected. For example, processing might be delayed. If you need to repeat execution of the command, pause for a few seconds between each execution. In particular, you must be careful when you execute the command for event jobs or for a jobnet that uses event jobs, because of the limit values for event jobs. For details about the limit values for event jobs, see B(7) Limits for the event/action control in the Job Management Partner 1/Automatic Job Management System 3 System Design (Configuration) Guide.

Return values

0 Normal end

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

Additional informations

If you stop the generation in the Now monitoring status, that generation enters the Monitor terminated status. The generation in the Now running status or the generation in the Wait for start cond status waiting for the end of the generation in the Now running status is not stopped.

You can use the ajsrerun command to re-execute a stopped jobnet.

Example

The following command stops the execution of jobnet net1:
 
ajsintrpt net1

[Contents][Back][Next]

[Trademarks]

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