jpqresshow

Organization of this page

Format

jpqresshow
     [-mh manager-host-name]
     {-res execution-locked-resource-name|-a|-n}

To Page Top

Description

Outputs information about execution-locked resources (the name, the status of the job using the execution-locked resources, and the job ID) to the standard output file.

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

To Page Top

Arguments

-mh `manager-host-name`

Specify the name of the manager host that contains the execution-locked resources for which information needs to be output.

You can specify a character string of 1 to 255 bytes.

By default, the system assumes the local host name.

-res `execution-locked-resource-name`

Specify the name of an execution-locked resource when you want to display its name, its status of the job using the execution-locked resource, and its job ID.

You can specify a character string of 1 to 63 bytes.

-a

Regarding all the execution-locked resources registered with the manager host specified by the -mh option, the system outputs their names, the status of the job using the execution-locked resources, and their job IDs.

-n

Regarding all the execution-locked resources registered with the manager host specified by the -mh option, the system outputs only their names.

To Page Top

Note

This command cannot be used for a request from JP1/AJS3 to JP1/OJE for VOS3.

To Page Top

Return values

0	Normal end
1	Invalid parameter value
2	The execution-locked resource could not be output successfully owing to an internal cause of the requester.
5	Initialization has failed. The definition of the logical host name or the environment setting contains an error.
6	Execution-locked resource outputting requester's insufficient memory
7	The execution-locked resource outputting requester 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 an execution-locked resource outputting request. 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 execution-locked resource. The specified execution-locked resource is not found.
202	No response from the manager host
203	The execution-locked resource could not be output successfully owing to an internal cause of the manager host.
206	You do not have the privilege required to output the execution-locked resource.
212	The attempt to output an execution-locked resource has failed because the execution-locked resource is being added or changed.
213	The manager host contains no execution-locked resource.
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 request to a host other than JP1/AJS3.
226	Invalid execution environment

To Page Top

Output example 1

With the -res option specified, here is an example of file output, together with what the output means.

[Figure]

The content of the output is explained below.

RESOURCE

Specifies the execution-locked resource name.

STATUS

Shows the status of the job using execution-locked resources.

EXECUTING: The job is currently being executed.
WAITING: The job is not currently being executed.

JOBID

Shows the job ID of the job using execution-locked resources.

To Page Top

Output example 2

With the -a option specified, here is an example of file output, together with what the output means.

[Figure]

The content of the output is explained below.

RESOURCE

Specifies the execution-locked resource name. You can output up to 57 bytes. If the execution-locked resource name is 58 bytes or longer, the portion exceeding 55 bytes is indicated by "..".

STATUS

Shows the status of the job using execution-locked resources.

EXECUTING: The job is currently being executed.
WAITING: The job is not currently being executed.

JOBID

Shows the job ID of the job using execution-locked resources.

To Page Top

Output example 3

With the -n option specified, here is an example of file output, together with what the output means.

[Figure]

The content of the output is explained below.

RESOURCE: Specifies the execution-locked resource name.

To Page Top