ajsdelete

Organization of this page

Format
Description
Execution privileges
Arguments
Notes
Return values
Example

Format

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

To Page Top

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.

To Page Top

Execution privileges

You must have any of the following JP1 privileges:

JP1_AJS_Admin privilege
JP1_AJS_Manager privilege
JP1_AJS_Editor privilege

To Page Top

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.

To Page Top

Notes

Either of the following users can delete a unit:
- A user granted the update privilege for the unit to be deleted
- 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 with Administrators or superuser privileges must have the update privilege.
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.

To Page Top

Return values

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

To Page Top

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

To Page Top