jpqqueshow

Organization of this page

Format
Description
Execution privileges
Arguments
Notes
Return values
Output example 1
Output example 2
Output example 3

Format

jpqqueshow
     [-mh manager-host-name]
     {-q queue-name|-ah agent-host-name|-a|-ad|-n}
     [-em]

To Page Top

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.

To Page Top

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

To Page Top

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.

To Page Top

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.

To Page Top

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. The definition of the logical host name or the environment setting contains an error.
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. The host on which the `jpqqueshow` 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 `jpqqueshow` command was executed.
200	The manager host does not request output queue information. 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.
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. A system call 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

To Page Top

Output example 1

The following gives an example of file output when you specify the -q or -ah option.

[Figure]

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.

To Page Top

Output example 2

The following gives an example of file output when you set the -a or -ad option.

[Figure]

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.

To Page Top

Output example 3

The following gives an example of file output when you set the -n option.

[Figure]

The following gives the meanings of output contents.

QUEUE: Indicates a queue name.

To Page Top