ajsagtdel

Format

ajsagtdel
     [-h logical-host-name]
     {-a execution-agent-name | -g execution-agent-group-name}

ajsagtdel
     [-h logical-host-name]
     -a execution-agent-name

ajsagtdel
     [-h logical-host-name]
     -g execution-agent-group-name

To Page Top

Description

Deletes an execution agent or execution agent group.

To Page Top

Execution privileges

This command can be executed by a user at the following JP1 permission level:

• JP1_JPQ_Admin privilege

To Page Top

Arguments

To Page Top

Notes

• Before you execute ajsagtdel command, use the ajsagtalt command to change the job transfer restriction status of the execution agent you want to delete to Blocked so that jobs are not executed on the agent. For details about the job transfer restriction status of an execution agent, see 5.2 Restricting job transfer in the manual JP1/Automatic Job Management System 3 Overview.

  Note that the job transfer restriction status of an execution agent has no effect on event jobs. Therefore, ensure that a new event job or jobnet with start conditions is not executed on the execution agent to be deleted.

  You cannot delete an execution agent on which a job (PC, UNIX, custom, flexible, HTTP connection, action, or event job) is running. To delete an execution agent on which a job is running, you must forcibly terminate the job.

  You can use the ajsagtshow command to check for jobs that are running. For details on the ajsagtshow command, see ajsagtshow in 3. Commands Used for Normal Operations.

• If you execute ajsagtdel command on a target host on which an event job or a jobnet with start conditions was executed, the target host remembers the manager host name that executed ajsagtdel command. If the target host remembers the manager host name, the host performs communication with the manager host to report that the host has started or stopped. Because this communication is unnecessary, use the following procedure to delete the manager host name that executed ajsagtdel command.

  To delete the manager host name remembered by the target host you want to delete:

  1. Check whether the target host remembers the manager host name that executed ajsagtdel command.

     To do this, on the target host, execute the following command:

     jpoagoec -p [-h logical-host-name]^#

  2. Delete the manager host name that executed ajsagtdel command.

     Execute the following command:

     jpoagoec [-h logical-host-name]^# -d manager-host-name-that-executed-ajsagtdel-command

  #

  You do not need to specify the -h option if the manager host targeted by the command is a physical host.

  For details on the jpoagoec command, see jpoagoec in 3. Commands Used for Normal Operations.

• Do not perform the following operations while an event job or a jobnet with a start condition is running:

  • Stop the OS before stopping the JP1/AJS3 service on the execution host for the execution agent.

  • Turn off the target host system acting as the execution agent.

  If you execute ajsagtdel command after performing either of these operations, the specified execution agent cannot be deleted. If this occurs, stop and cold start the JP1/AJS3 service on the manager host or delete information about event jobs or jobnets with start conditions being executed on the execution agent, and then execute ajsagtdel command again.

  To delete information about event jobs or jobnets with start conditions being executed on the execution agent:

  1. For each scheduler service, check whether there are any event jobs being executed or jobnets with start conditions being monitored by the execution agent in question.

     Execute the following command:

     jpomanjobshow [-h logical-host-name]^# -F scheduler-service-name -a execution-agent-name

  2. Stop the scheduler service you identified in step 1.

  3. From the scheduler service you stopped in step 2, delete the information for the event job being executed or jobnet with start conditions being monitored by the execution agent in question.

     Execute the following command:

     jpomanevreset [-h logical-host-name]^# -F scheduler-service-name -a execution-agent-name -s

  #

  You do not need to specify the -h option if the manager host targeted by the command is a physical host.

  For details on how to stop a scheduler service, see 7.5.2 Stopping the scheduler service in the JP1/Automatic Job Management System 3 Administration Guide. For details on the jpomanjobshow command, see jpomanjobshow in 3. Commands Used for Normal Operations, and for details on the jpomanevreset command, see jpomanevreset in 3. Commands Used for Normal Operations.

• ajsagtdel command cannot be used for a request from JP1/AJS3 to JP1/NQSEXEC or JP1/OJE for VOS3.

• ajsagtdel command cannot be executed for JP1/AJS3 - Manager installed on another host.

• The maximum number of ajsagtadd, ajsagtalt, and ajsagtdel commands that can be executed concurrently on the same host is five. If you attempt to execute more than five commands, the commands terminate abnormally.

To Page Top

Return values

To Page Top

Example 1

To delete execution agent AP1, execute the following command:

ajsagtdel -a AP1

To Page Top

Example 2

To delete execution agent group APG1, execute the following command:

ajsagtdel -g APG1

To Page Top