Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Command Reference


jpqagtdel

Organization of this page

Format

jpqagtdel
     [-mh manager-host-name]
     -ah agent-host-name

Description

The jpqagtdel command deletes an agent host from a manager host, and deletes the default queue to which the agent host is connected.

Execution privileges

You must have the following JP1 privilege:

Arguments

-mh manager-host-name

Specify the name of the manager host from which you want to delete an agent host.

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

By default, the system assumes the local host name.

-ah agent-host-name

Specify a agent host name you want to delete.

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

Notes

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

  2. Before executing this command, you must make the following preparations:

    • Use jpqqueclose or a similar command to close the entrance of the default queue to which the agent host you want to delete is connected. Then make sure that no jobs are running and no jobs are contained in the default queue.

      You cannot delete the agent host if it has a job that is being executed, assuming that the job is a standard job (PC, UNIX, or QUEUE), custom job, action job, or event job.

      When the default queue that contains jobs is deleted, any jobs whose status is Waiting to execute, Being held, or Waiting for time are forcibly terminated.

    • Use jpqagtunlink or a similar command to disconnect all queues (other than the default queue) from the agent host you want to delete.

      You cannot delete an agent host if it is connected to any queue other than the default queue.

    • Executing more than one jpqagtdel command in parallel requires a considerably long time for processing. When deleting multiple agent hosts, delete them one by one.

  3. If an event job or a jobnet with start conditions is executed on an agent host already deleted by the jpqagtdel command, the manager host name that was specified in the -mh option of the command has been retained on the agent host. On the agent host, delete the manager host specified in the -mh option of the command.

    The procedure is as follows.

    1. Check whether the manager host name specified in the -mh option of the jpqagtdel command has been retained on the agent host.

    Execute the following command:

    jpoagoec -p

    2. Delete the manager host name specified in the -mh option.

    Execute the following command:

    jpoagoec -d manager-host-name-specified-in-the-mh-option

    This prevents unnecessary communication (start or stop notification) to the manager host when the agent host is started or stopped. For details on the jpoagoec command, see jpoagoec in 3. Commands Used for Normal Operations earlier in this chapter.

  4. If an event job or a jobnet with start conditions is being executed on an agent host, do not stop the OS or turn off the machine before you stop the JP1/AJS3 service on the agent host. If you do so, the jpqagtdel command will not be able to delete the agent. If the command has become unable to delete the agent, stop the JP1/AJS3 service on the manager host, cold-start the host, and then re-execute the command. Alternatively, delete the information about an event job or a jobnet with start conditions being executed on the agent host, and then re-execute the command.

    The following describes the procedure for deleting information about an event job or a job with start conditions being executed on an agent host.

    1. Stop the JP1/AJS3 service on the manager host.

    2. On the manager host, make sure that an event job is being executed or a jobnet with start conditions is being monitored on the agent host.

    Execute the following command:

    jpomanjobshow -h manager-host-name -a name-of-agent-host-to-delete

    3. On the manager host, delete information about the event job being executed or the jobnet with start conditions being monitored on the agent host.

    Execute the following command:

    jpomanevreset -h manager-host-name -a agent-host-name -s

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

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

Return values

0

Normal end

1

Invalid parameter value

2

An attempt to delete an agent host failed due to an internal cause of the host on which the jpqagtdel command was executed.

5

Initialization has failed.

  • The definition of the logical host name or the environment setting contains an error.

6

Memory became insufficient on the host on which the jpqagtdel command was executed.

7

A logical error occurred on the host on which the jpqagtdel command was executed.

100

The host on which the jpqagtdel command was executed cannot connect to the manager host via TCP/IP communication.

  • The host on which the jpqagtdel command was executed cannot connect to the manager host because TCP/IP is not set up correctly.

  • The manager host name is invalid, or the manager host process stopped.

102

The IP address could not be resolved from the name of the manager host on which the jpqagtdel command was executed.

200

The manager host does not accept the agent host deleting request.

  • The manager host is now being started, now being stopped, has stopped, or is running in the reduced-operation mode.

202

The manager host has returned no response.

203

The agent host could not be deleted successfully owing to an internal cause of the manager host.

206

You do not have the privilege required to delete the agent host.

214

There is no agent host connected to the manager host.

219

The manager host is busy.

220

The manager host memory is insufficient.

222

A fatal error has occurred.

  • A system call error has occurred.

223

The manager host encountered a logic error.

224

You have issued a request to a host other than JP1/AJS3.

226

Invalid execution environment

233

There is a job being executed, which is a standard job, custom job, or action job.

234

There is a job being executed, which is an even job.

236

The agent host is connected to a queue.

240

The event/action control manager is changing the agent host configuration definition.