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

ajssuspend

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

Users can suspend a root jobnet or cancel such suspension if they are assigned the manipulation privileges when all the jobs and jobnets contained in the jobnet are defined or their attributes are changed. However, a user logged on as a member of the Administrators group in Windows systems), or having superuser privileges (in UNIX systems) can suspend a root jobnet or cancel such suspension.

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

[Contents][Back][Next]

[Trademarks]

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