Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Command Reference


jpqresshow

Organization of this page

Format

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

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.

Execution privileges

You must have any of the following JP1 privileges:

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.

Note

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

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

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.

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.

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.