jpqjobshow
- Organization of this page
Format
jpqjobshow [-mh manager-host-name] {-q queue-name|-ah agent-host-name} [-u owner-name] -s {e|h|w|s|r}
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
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)
Arguments
-mh manager-host-name
Specify the name of the manager host to which you have submitted a job whose job 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.
-q queue-name
Specify the name of the queue to which you have submitted a job whose job information is to be output.
You can specify a character string of 1 to 63 bytes.
-ah agent-host-name
Specify the name of the agent host to which you have submitted a job whose job information is to be output.
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.
-u owner-name
To output information about a job the user has submitted, specify the job owner name.
You can specify a character string of 1 to 63 bytes. By default, the system assumes all the users if a user having the JP1_JPQ_Admin privilege or JP1_JPQ_Operator privilege executes the command. If a user having the JP1_JPQ_User privilege executes the command, the system assumes that user.
-s {e|h|w|s|r}
Outputs information about a job in certain status. You can specify multiple types of status.
-
e
Outputs information about an executing job.
-
h
Outputs information about a held job.
-
w
Outputs information about a job waiting to be executed.
-
s
Outputs information about a job waiting for time.
-
r
Outputs information about a job 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.
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.
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.
|
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.
|
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.
|
201 |
You cannot use a specified queue.
|
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.
|
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 non-ended job information output request to an unsupported host. |
226 |
Invalid execution environment |
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.
-