Job Management Partner 1/Automatic Job Management System 3 Command Reference 2

[Contents][Glossary][Index][Back][Next]

jpqagtunlink

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. During linkage with JP1/NQSEXEC and JP1/OJE for VOS3, you cannot use this command for JP1/NQSEXEC queues and JP1/OJE for VOS3 queues.
  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.

[Contents][Back][Next]

[Trademarks]

Copyright (C) 2009, 2010, Hitachi, Ltd.
Copyright (C) 2009, 2010, Hitachi Solutions, Ltd.