ajskill

Format

ajskill
     [-F service-name]
     [-B execution-registration-number]
     [-R]
     [-E]
     [{-T|-J}]
     [-X {yes|no|auto}]
     job-name-or-jobnet-name-or-job-group-name...

To Page Top

Description

Kills the execution of a job or jobnet.

If you kill a jobnet, the system aborts all jobs contained in that jobnet (including any nested jobnets). No other jobs in the jobnet will be newly created.

To Page Top

Execution privileges

You must have any of the following JP1 privileges:

• JP1_AJS_Admin privilege

• JP1_AJS_Manager privilege

• JP1_AJS_Operator privilege

To Page Top

Arguments

To Page Top

Notes

• Either of the following users can kill a job:

  • A user granted the operation privilege when the job and all jobnets that contain the job 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 with Administrators or superuser privileges must have the operation privilege.

• Either of the following users can kill a jobnet:

  • A user granted the operation privilege when the jobs contained in the jobnet and the 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 with 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 you attempt to kill a job or jobnet which is not running.

• You can kill only processes started by JP1/AJS3. If a process has been started by JP1/AJS3, however, you may not able to kill it depending on the status of the process.

• You cannot use this command for units subordinate to remote jobnets.

• This command terminates abnormally if the target job or 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.

• You cannot forcibly terminate a jobnet connector.

• You can forcibly terminate units that are in any of the following statuses:

  • A job that is queued or running

    If the job is a queueless job, you can also forcibly terminate the job in Waiting for execution status.

  • A root jobnet that is in Now running, Running + Warning, Running + Abend, or Now monitoring status

• 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 might affect operations. 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.

To Page Top

Return values

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

To Page Top

Additional information

• If you kill a particular job, other jobs and jobnets in the jobnet containing the killed job, say jobnet A, will be executed as scheduled. To prevent other jobs and jobnets from running, you should stop the execution of jobnet A beforehand. You can use the ajsintrpt command to stop the execution of a jobnet.

• Under UNIX, the system uses SIGKILL to kill a job or jobnet, so that you can also kill any application which captures a signal.

• If you kill 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 killed.

• This command ends when a request is made to the scheduler service to kill the specified unit. The command does not wait for the specified unit to finish.

To Page Top

Example

The following command kills job job1. Assume that this job is contained in the root jobnet, net1, and that the job group name is set in environment variable AJSPATH (if environment variable AJSPATH contains the job group name, you can omit the specification of the job group when executing the command).

ajskill net1/job1

To Page Top