jpqjobshow

Format

jpqjobshow
     [-mh manager-host-name]
     {-q queue-name|-ah agent-host-name}
     [-u owner-name]
     -s {e|h|w|s|r}

To Page Top

Description

Outputs a list of information on the jobs not ended (including job numbers, job names and job status) to the standard output file.

You can also output job information about the JP1/NQSEXEC and JP1/OJE for VOS3 hosts.

You can also output job information about the AS/400 system. You can, however, specify only the -mh, -q, -u, and -s options for the AS/400 system.

This command is applicable for the following jobs:

When the database is in a standard configuration:

Submit jobs and queue jobs

When the database is in a standard configuration without ISAM:

None

To Page Top

Execution privileges

You must have any of the following JP1 privileges:

• JP1_JPQ_Admin privilege

• JP1_JPQ_Operator privilege

• JP1_JPQ_User privilege (allows you to manipulate only the jobs you own)

To Page Top

Arguments

To Page Top

Note

The number of bytes which can be output is fixed for each output item. If the contents of an output item exceed the output limit, they end with "..". (For example, the job name output limit is 26 bytes. If the job name exceeds 26 bytes, the 25th and subsequent bytes become "..".)

To output all the contents on each output item, use the jpqjobget command.

To Page Top

Return values

0	Normal end
1	Invalid parameter value
2	Information about a job not ended could not be output successfully owing to an internal cause of the output requester.
5	Initialization has failed. The definition of the logical host name or the environment setting contains an error.
6	Insufficient memory in the output requester of information about a job not ended
7	The output requester of information about a job not ended encountered a logic error.
100	The manager host cannot be connected for TCP/IP communication. As TCP/IP is not validly set, the manager host cannot be connected. The manager host name is invalid, or the manager host process stopped.
102	The IP address could not be solved successfully by the manager host name.
200	The manager host does not accept a request for outputting information about a job not ended. 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	Information about a job not ended could not be output successfully owing to an internal cause of the manager host.
206	You do not have the privilege required to output information about a job not ended.
207	The specified job is not found. The specified job is not in the database. As the specified user job not ended cannot be accessed, its information cannot be output.
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 non-ended job information output request to an unsupported host.
226	Invalid execution environment

To Page Top

Output example

The following gives an example of file output.

The following gives the meanings of output contents.

JOBID

Indicates a job number.

JOBNAME

Indicates a job name.

26 bytes of data are output.

When you use a QUEUE job or the jpqjobsub command to specify a job name, that job name is set. If no job name is specified, the execution file name is set.

When you define a PC job in a jobnet, the execution file name is set. When you define a Unix job in a jobnet, the script file name is set. If you do not specify a script file name, and define a job name in a command statement, script_job is set as the job name.

For an action job, the name of the fixed execution file executed by each action job is set as the job name. For an execution file name, the first 63 bytes of the characters from the beginning in the file name, excluding the path information, are set as the job name, and the first 26 bytes are displayed.

T

Indicates a queue type.

• q: Queue

• a: Agent host

QUEUE

Indicates a queue name (or an agent host name).

27 bytes of data are output.

STATUS

Shows the job status.

• EXECUTING: Being executed

• HOLDING: Placed on hold

• WAITING: Waiting to be executed

• SCHEDULED: Waiting for a time

• ROUTING: Being distributed^#

#

ROUTING is a job status in the JP1/NQSEXEC system.

In a system that consists of only JP1/AJS3, ROUTING is never output.

If you specify a queue name used by only JP1/NQSEXEC in the -q option, ROUTING might be output.

To Page Top