jpqqueopen
- Organization of this page
Format
jpqqueopen
[-mh manager-host-name]
{-q queue-name|-ah agent-host-name}
[{-en|-ex}]
[-em]
Description
Opens the job inlet or outlet for a queue.
Execution privileges
You must have either of the following JP1 privileges:
-
JP1_JPQ_Admin privilege
-
JP1_JPQ_Operator privilege
However, specifying the -em option requires the following privileges (but does not require JP1_JPQ_Admin or JP1_JPQ_Operator privileges).
-
Windows: Administrators privileges
-
UNIX: Superuser privileges
Arguments
-mh manager-host-name
Specify the name of the manager host containing a queue to be opened.
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
Specify the name of a queue to be opened.
You can specify a character string of 1 to 63 bytes.
-ah agent-host-name
When you want to open a default queue, specify the corresponding agent host name that has been registered on the manager host. When an agent host is registered, the default queue is created with the same name as the agent host.
You can specify a character string of 1 to 255 bytes.
-en
Opens the queue entrance.
-ex
Opens the queue exit.
-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 open a queue failed due to an internal cause of the host on which the jpqqueopen command was executed. |
|
5 |
Initialization has failed.
|
|
6 |
Memory became insufficient on the host on which the jpqqueopen command was executed. |
|
7 |
A logical error occurred on the host on which the jpqqueopen 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 jpqqueopen 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 jpqqueopen command was executed. |
|
200 |
The manager host does not accept a queue opening request.
|
|
201 |
You cannot use a specified queue.
|
|
202 |
No response from the manager host |
|
203 |
The queue could not be opened successfully owing to an internal cause of the manager host. |
|
206 |
You do not have the privilege required to open the queue. |
|
219 |
The manager host is busy. |
|
220 |
Insufficient manager host memory |
|
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 |