Hitachi

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


jpqagtunlink

Organization of this page

Format

jpqagtunlink
     [-mh manager-host-name]
     {-q queue-name|-ah agent-host-name}
     -lh name-of-the-host-to-be-disconnected

Description

Cancels the connection between the queue and its agent hosts.

Execution privileges

You must have the following JP1 privilege:

Arguments

-mh manager-host-name

Specify the name of the manager host that contains the queue whose agent host connection you want to cancel.

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

By default, the system assumes the local host name.

-q queue-name

When you want to disconnect an agent host from a queue (other than the default queue), specify the name of the queue.

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

-ah agent-host-name

When you want to disconnect an agent host from the default queue, specify the agent host name (default queue name) registered on the manager host when the default queue was created.

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

-lh name-of-the-host-to-be-disconnected

Specify the name of the agent host whose connection you want to cancel.

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. An attempt to disconnect any non-connected agent host results in an error.

  3. You cannot disconnect 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, or action job.

Return values

0

Normal end

1

Invalid parameter value

2

An attempt to disconnect an agent host failed due to an internal cause of the host on which the jpqagtunlink 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 jpqagtunlink command was executed.

7

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

100

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

  • The host on which the jpqagtunlink 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 jpqagtunlink command was executed.

200

The manager host does not accept disconnecting the agent host.

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

201

You cannot use a specified queue.

  • The specified queue is not found.

  • The specified default queue does not exist.

202

The manager host has returned no response.

203

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

206

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

214

There is no agent host connected to the manager host.

219

The manager host is busy.

220

Memory shortage has occurred on the request side of the manager host.

222

A fatal error has occurred.

  • A system call has encountered an error.

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

232

There is no agent host connection.

233

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