jpqagtlink
- Organization of this page
Format
jpqagtlink [-mh manager-host-name] {-q queue-name|-ah agent-host-name} -lh name-of-the-agent-host-to-be-connected {[-lp connection-priority-for-an-agent-host-that-has-not-been-connected]| -clp connection-priority-for-an-agent-host-that-has-been-connected} [-em]
Description
The jpqagtlink command is used to connect an agent host to a queue. The command is also used to set the priority of an agent host to be connected to a queue.
Execution privileges
You must have the following JP1 privilege:
-
JP1_JPQ_Admin privilege
However, specifying the -em option requires the following privileges (but does not require JP1_JPQ_Admin privileges).
-
Windows: Administrators privileges
-
UNIX: Superuser privileges
Arguments
-mh manager-host-name
When you want to connect an agent host to a queue, specify the name of the manager host on which the queue has been created. Alternatively, when you want to set the priority of an agent that has been connected to a queue, specify the name of the manager host on which the queue has been created.
You can specify a character string of 1 to 255 bytes.
By default, the system assumes the local host name.
When you specify this option together with the -em option, you can specify only two types of host names: the local host name and the logical host name on the local host. Specifying any other value results in an error (error code: 25). Also note that you cannot specify an alias host name in the -mh option.
-q queue-name
When you want to connect an agent host to a queue other than the default queue, specify the name of the queue. Alternatively, when you want to set the priority of an agent that has been connected to a 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 connect an agent host to the default queue, specify the agent host name (default queue name) registered on the manager host when the default queue was created. Alternatively, when you want to change the priority of the agent host that has been connected to 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-agent-host-to-be-connected
Specify the name of the agent you want to connect to the specified queue or the name of the agent host for which you want to set the priority.
You can specify a character string of 1 to 255 bytes.
-lp connection-priority-for-an-agent-host-that-has-not-been-connected
Specify the priority of destination agent hosts.
You can specify a value between 1 and 16. The lowest priority is 1 and the highest is 16. Jobs with higher levels of priority are given execution precedence.
If you omit this option, the system assumes 16.
Use this option to set the queue connection priority for an agent host (specified by the -lh option) that has not been connected to a queue (specified by the -q option) or the default queue (specified by the-ah option).
-clp connection-priority-for-an-agent-host-that-has-been-connected
Specify the priority of destination agent hosts.
You can specify a value between 1 and 16. The lowest priority is 1 and the highest is 16. Jobs with higher levels of priority are given execution precedence.
Use this option to change the queue connection priority for an agent host (specified by the -lh option) that has been connected to a queue (specified by the -q option) or the default queue (specified by the-ah option).
-em
Specify this option for emergency execution.
Specifying this option enables emergency execution upon failure because a request is sent to a different communication path that is not used under normal conditions.
When you specify this option, note that you cannot assign an IP address to the manager host name.
Notes
-
This command cannot be used for a request from JP1/AJS3 to JP1/NQSEXEC or JP1/OJE for VOS3.
-
You should use the -em option for the sole purpose of recovering from an agent host failure. You should avoid specifying the -em option under any normal condition, because you may fail to take corrective action when a failure actually occurs.
Return values
0 |
Normal end |
1 |
Invalid parameter value |
2 |
An attempt to connect an agent host or change the connection priority failed due to an internal cause of the host on which the jpqagtlink command was executed. |
5 |
Initialization has failed.
|
6 |
Memory became insufficient on the host on which the jpqagtlink command was executed. |
7 |
A logical error occurred on the host on which the jpqagtlink command was executed. |
25 |
The specified manager host name is neither the local host name nor the logical host name. |
100 |
The host on which the jpqagtlink 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 jpqagtlink command was executed. |
200 |
The manager host does not accept connection to the agent host or changes of its priority.
|
201 |
You cannot use a specified queue.
|
202 |
The manager host has returned no response. |
203 |
The agent host could not be connected or its priority could not change successfully owing to an internal cause of the manager host. |
206 |
You do not have the privilege required to connect the agent host or change its priority. |
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.
|
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 |
An attempt has been made to connect to connected agent hosts. |
239 |
An attempt has been made to change the priority of non-connected agent hosts by means of the -clp option. |