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:
-
JP1_JPQ_Admin 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
-
This command cannot be used for a request from JP1/AJS3 to JP1/OJE for VOS3.
-
An attempt to disconnect any non-connected agent host results in an error.
-
You cannot disconnect the agent host if it has a job that is being executed, assuming that the job is a QUEUE job or submit 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.
|
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.
|
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.
|
201 |
You cannot use a specified queue.
|
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.
|
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 QUEUE job or submit job. |