ajsintrpt
- Organization of this page
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 JP1/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
-
Either of the following users can interrupt execution of a jobnet:
-
A user granted the operation privilege when the units contained in the jobnet to be interrupted 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.
-
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 information in ajsplan in 3. Commands Used for Normal Operations.
-
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, custom event jobs or for a jobnet that uses event jobs or custom event jobs, because of the limit values for event jobs and custom event jobs. For details about the limit values for event jobs and custom event jobs, see B.8 Limits for the event/action control in the JP1/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 information
-
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.
-
This command ends when a request is made to the scheduler service to interrupt the specified unit. The command does not wait for the specified unit to finish.
Example
The following command stops the execution of jobnet net1:
ajsintrpt net1