jpqqueshow
- Organization of this page
Format
jpqqueshow [-mh manager-host-name] {-q queue-name|-ah agent-host-name|-a|-ad|-n} [-em]
Description
Outputs queue information (including queue names, limit and warning values on the maximum number of submit jobs, and the number of submit jobs) to the standard output.
You can also queue information about the JP1/NQSEXEC and JP1/OJE for VOS3 hosts.
You can also output queue information about the AS/400 system. You can specify only the -mh and -n options for the AS/400 system.
Execution privileges
You must have any of the following JP1 privileges:
-
JP1_JPQ_Admin privilege
-
JP1_JPQ_Operator privilege (-ad option not allowed)
-
JP1_JPQ_User privilege (-ad option not allowed)
However, specifying the -em option requires the following privileges (but does not require JP1_JPQ_Admin, JP1_JPQ_Operator, or JP1_JPQ_User privileges).
-
Windows: Administrators privileges
-
UNIX: Superuser privileges
Arguments
-mh manager-host-name
Specify the name of the manager host containing the queue whose queue information is to be output.
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 the queue whose queue information is to be output.
You can specify a character string of 1 to 63 bytes.
This option cannot be specified for a request from JP1/AJS3 to JP1/NQSEXEC or to JP1/OJE for VOS3.
-ah agent-host-name
When you want to output information about 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.
This option cannot be specified for a request from JP1/AJS3 to JP1/NQSEXEC or to JP1/OJE for VOS3.
-a
Outputs all queue information on the manager host set with the -mh option (except for default queue information).
This option cannot be specified for a request from JP1/AJS3 to JP1/NQSEXEC or to JP1/OJE for VOS3.
-ad
Outputs all queue information on the manager host set with the -mh option (including default queue information).
This option can be specified by only users having the JP1_JPQ_Admin privilege. This option cannot be specified for a request from JP1/AJS3 to JP1/NQSEXEC or to JP1/OJE for VOS3.
-n
As queue information, outputs the names of all the queues in the manager host set with the -mh option (excluding information about the default queue).
-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
-
For the -a and -ad options, the queue name output limit is 21 bytes. If the queue name consists of more than 21 bytes, the 20th and subsequent bytes are "..".
-
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 jpqqueshow command was executed. |
5 |
Initialization has failed.
|
6 |
Memory became insufficient on the host on which the jpqqueshow command was executed. |
7 |
A logical error occurred on the host on which the jpqqueshow 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 jpqqueshow 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 jpqqueshow command was executed. |
200 |
The manager host does not request output queue information.
|
201 |
You cannot use a specified queue.
|
202 |
No response from the manager host |
203 |
Queue information could not be output successfully owing to an internal cause of the manager host. |
206 |
You do not have the privilege required to output queue information. |
212 |
Queue information could not be output successfully because the process of adding or changing agent hosts or queues is under way. |
213 |
The manager host contains no 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 queue information output request to an unsupported host. |
226 |
Invalid execution environment |
Output example 1
The following gives an example of file output when you specify the -q or -ah option.
The following shows the meaning of the output.
- QUEUE
-
Indicates queue information in the format of queue-type: queue-name (or agent-host-name).
The queue types are:
-
q: Queue
-
a: Agent host
-
- MAXQUEUE
-
Indicates the maximum number of jobs submitted.
10 bytes of data are output.
- WARNQUEUE
-
Indicates a warning value on the number of jobs submitted.
10 bytes of data are output.
- ENTRYSTATUS
-
Indicates the status of a queue entrance.
-
OPEN: Open
-
CLOSE: Closed
-
- EXITSTATUS
-
Indicates the status of a queue exit.
-
OPEN: Open
-
CLOSE: Closed
-
- QUEUING
-
Indicates the number of already submit jobs (excluding the number of jobs currently executed).
- EXECUTING
-
Indicates the number of jobs being executed.
- LINKAGENT
-
Indicates information on a connected agent host in the format of connected-agent-host-name:priority.
Output example 2
The following gives an example of file output when you set the -a or -ad option.
The following shows the meaning of the output.
- T
-
Indicates a queue type.
-
q: Queue
-
a: Agent host
-
- QUEUE
-
Indicates a queue name (or an agent host name).
21 bytes of data are output.
- MAXQUEUE
-
Indicates the maximum number of jobs submitted.
- WARNQUEUE
-
Indicates a warning value on the number of jobs submitted.
- ENT
-
Indicates the status of a queue entrance.
-
OPEN: Open
-
CLOSE: Closed
-
- EXIT
-
Indicates the status of a queue exit.
-
OPEN: Open
-
CLOSE: Closed
-
- QUEUING
-
Indicates the number of already submit jobs (excluding the number of jobs currently executed).
- EXECUTING
-
Indicates the number of jobs being executed.
Output example 3
The following gives an example of file output when you set the -n option.
The following gives the meanings of output contents.
- QUEUE
-
Indicates a queue name.