ajssuspend
- Organization of this page
Format
ajssuspend [-F service-name] {-S [-n]|-C [-r|-h|-p]|-U} [-R] [-E] [-T] root-jobnet-name-or-job-group-name...
Description
Suspends a root jobnet. This command also releases the suspension of a root 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 service name of the corresponding scheduler service.
You can specify a character string of 1 to 30 bytes.
-S
Suspends a root jobnet.
However, any root jobnet as the target will not be suspended if it is being executed. If you suspend a root jobnet being currently executed, you must specify this with the -n option.
-n
Suspends a root jobnet being currently executed.
By default, the root jobnet being executed will not be suspended.
-C
Cancels the suspension of the root jobnet.
When suspending a root jobnet being executed and adding units under the root jobnet, you can specify the -r, -h, or -p option to determine how the additional units will be handled after the suspension is canceled. Without the -r, -h, or -p option specified, the root jobnet being executed and all the units added below the root jobnet will be executed after the suspension is canceled.
-r
Executes a unit added during the state of suspension after the suspension is canceled.
-h
Holds a unit added during the state of suspension after the suspension is canceled.
-p
Does not execute a unit added during the state of suspension after the suspension is canceled.
-U
Deletes any ineffective unit records remaining in a database.
-R
Suspends a specified root jobnet or all the jobnets contained in a job group, or cancels the suspension.
If you specify this option with the -E and/or -T options, the system suspends the target jobnets or cancels the suspension according to the specification of each option.
-E
Suspends a root jobnet registered for execution, or cancels the suspension.
-T
Suspends a root jobnet, or cancels the suspension.
root-jobnet-name-or-job-group-name
Specify the name of the root jobnet you want to suspend. 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 root jobnet name or job group name. Note that you cannot specify a manager jobnet name or manager job group name.
You can specify a logical host name as the root jobnet name or job group name. You cannot specify an execution ID.
Notes
-
Either of the following users can suspend the root jobnet or cancel the suspend status:
-
A user granted the operation privilege when the jobs and jobnets contained in the root 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 the scheduler service is not running.
-
Only a root jobnet can be suspended/de-suspended.
-
This command terminates abnormally if a jobnet to be suspended is monitoring start conditions.
-
This command terminates abnormally if a root jobnet to be suspended has already been suspended.
-
This command terminates abnormally if a root jobnet to be suspended is currently in the suspension process.
-
This command terminates abnormally if a root jobnet to be suspended has already been de-suspended.
-
This command terminates abnormally if a root jobnet to be suspended is currently in the de-suspension process.
Return values
0 |
Normal end |
Multiple of 4 within the range from 4 to 124 |
Abnormal end |
Additional information
This command terminates only after a root jobnet becomes suspended. It also terminates only after the suspension is canceled.
Example 1
The following command suspends the jobnet (net1).
ajssuspend -S net1
Example 2
The following command cancels a root jobnet (net1) being suspended. Because the root jobnet was being executed before the suspension, it continues its execution after it is de-suspended. However, units have been added during suspension will be held.
ajssuspend -C -h net1