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

ajsdelete

Format

ajsdelete
     [-F service-name]
     [-i]
     [-S]
     [-R]
     [-L]
     [-T]
     [-G|-N|-J]
     job-name-or-jobnet-name-or-job-group-name...

Description

Deletes a unit. This command guarantees consistency in the relationship even if you delete a jobnet or job for which you have made a relationship with other elements.

Execution privileges

You must have any of the following JP1 privileges:

JP1_AJS_Admin privilege

JP1_AJS_Manager privilege

JP1_AJS_Editor privilege

Arguments

-F service-name

Specify the name of the target scheduler service.

You can specify a character string of 1 to 30 bytes.

-i

Displays a message with a confirmation prompt before deleting a unit.

-S

This option makes it possible to delete nested jobnets and jobs, even for suspended jobnets that have been registered for execution. Even for suspended jobnets, however, you cannot delete definitions in the following situations:

While deleting the root jobnet

While deleting the job group containing the root jobnet

While jobnets are being executed

-R

Deletes all units in the specified job group or jobnet, according to the other specified options.

If you specify this option with the -L, -T, -G, -N and/or -J options, the system deletes the unit according to the specification of each option.

-L

Deletes job groups, jobnets not registered for execution, and jobs.

If you specify this option with the -T, -N, and/or -J options, the system deletes unregistered jobnets according to the specification of each option. You cannot specify this option with the -G option.

-T

Deletes root jobnets.

If you specify this option with the -L option, the system deletes root jobnets according to the specification of the -L option. If you specify this option with the -N option, the -N option is disabled. You cannot specify this option with the -G or -J option.

-G

Deletes job groups.

You cannot specify this option with the -L, -T, -N, or -J option.

-N

Deletes jobnets and recovery jobnets.

If you specify this option with the -L option, the system deletes jobnets and recovery jobnets according to the specification of the -L option. If you specify this option with the -T option, the -N option is disabled. You cannot specify this option with the -G or -J option.

-J

Deletes jobs.

You cannot specify this option with the -T, -G, or -N option.

job-name-or-jobnet-name-or-job-group-name

Specify the name of the job, jobnet or job group you want to delete.

You can specify a character string of 1 to 930 bytes.

You can specify more than one job, jobnet, or job group name. You cannot, however, specify the root job group (/).

You cannot specify a logical host name or execution ID as a job, jobnet or job group name.

Notes

You can delete a unit only if you have the update privilege for the unit assigned.

Before deleting a root jobnet registered for execution and the job group containing the root jobnet, you must use the ajsleave command to cancel the registration (Otherwise, the delete process is not effective).

For units other than in the root jobnet, the job group containing the root jobnet, and the remote jobnet, however, specifying the -s option in this command while keeping the target jobnet suspended makes it possible to conduct the delete process without having to cancel the registered jobnet. (If the target unit is being currently executed, the delete process is not effective even if the -s option is specified.)

If you attempt to delete a release target jobnet (root jobnet for which release entry is made), the definition of all jobnets for which release entry is made is deleted. If you attempt to delete a unit in a root jobnet for which release entry is made, the jobnet definitions in Being applied status are deleted.

This command terminates abnormally if the target jobnet or job is undergoing a suspended-state change.

Return values

0 Normal end

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

Example

The following command deletes only unregistered jobnets among the units contained in job group /group1, after displaying a prompt for confirmation:
 
ajsdelete -iRLN /group1

[Contents][Back][Next]

[Trademarks]

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