Job Management Partner 1/Automatic Job Management System 3 Command Reference 2

jpqqueshow

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 submitted jobs, and the number of submitted 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.

During linkage with JP1/NQSEXEC and JP1/OJE for VOS3, you cannot use this option for JP1/NQSEXEC queues and JP1/OJE for VOS3 queues.

-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.

During linkage with JP1/NQSEXEC and JP1/OJE for VOS3, you cannot use this option for JP1/NQSEXEC queues and JP1/OJE for VOS3 queues.

-a

Outputs all queue information on the manager host set with the -mh option (except for default queue information).

During linkage with JP1/NQSEXEC and JP1/OJE for VOS3, you cannot use this option for JP1/NQSEXEC queues and JP1/OJE for VOS3 queues.

-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. During linkage with JP1/NQSEXEC and JP1/OJE for VOS3, you cannot use this option for JP1/NQSEXEC queues and JP1/OJE for VOS3 queues.

-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.

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

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 submitted 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 submitted 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.

[Contents][Back][Next]

[Trademarks]

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