Hitachi

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


jpqagtshow

Organization of this page

Format

jpqagtshow
     [-mh manager-host-name]
     {-ah agent-host-name|-a|-n}
     [-em]

Description

Outputs agent host information (including the agent host name and the schedule of the number of concurrently-executable job limit of a day) to the standard output file.

Execution privileges

You must have the following JP1 privilege:

However, specifying the -em option requires the following privileges (but does not require JP1_JPQ_Admin privileges).

Arguments

-mh manager-host-name

When you want to output information about an agent host, specify the name of the manager host on which the agent host has been registered.

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.

-ah agent-host-name

Specify the name of the agent host whose agent host information is to be output.

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

-a

Outputs information about all the agent hosts registered to the manager host set by the -mh option.

-n

Outputs the names of all the agent hosts registered to the manager set by the -mh option.

-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

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

  2. For the -a option, up to 57 bytes can be output as the agent host name. If the agent host name exceeds 57 bytes, the 56th and subsequent bytes become "..".

  3. 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 output agent host information failed due to an internal cause of the host on which the jpqagtshow 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 jpqagtshow command was executed.

7

A logical error occurred on the host on which the jpqagtshow 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 jpqagtshow command was executed cannot connect to the manager host via TCP/IP communication.

  • The host on which the jpqagtshow 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 jpqagtshow command was executed.

200

The manager host does not accept output agent host 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 agent host.

  • The specified agent host is not found.

202

The manager host has returned no response.

203

Agent host 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 agent host information.

You do not have the privilege required to output the agent host name.

212

The attempt to output information about the agent host has failed because an agent host is currently being added or changed.

214

No agent host is connected to the manager host.

219

The manager host is busy.

220

The manager host memory is insufficient.

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

The following gives an example of file output when you specify the -ah option, and describes the meanings of output contents.

[Figure]

The following shows the meaning of the output.

AGENT

Indicates an agent host name.

CUREXECHGNUM

Indicates the current number of concurrently-executable job limit.

EXECUTING

Indicates the number of jobs being executed.

CHANGEPOINT

Indicates the schedule of the number of the concurrently-executable job limit on a day in the format of multiplicity-setup-start-time - multiplicity-setup-end-time (number-of-concurrently-executable-job-limit).

Output example 2

The following gives an example of file output when you specify the -a option, and describes the meanings of output contents.

[Figure]

The following shows the meaning of the output.

AGENT

Indicates an agent host name.

57 bytes of data are output.

CUREXECHG

Indicates the current number of concurrently-executable job limit.

EXECUTING

Indicates the number of jobs being executed.

Output example 3

The following gives an example of file output when you specify the -n option, and describes the meanings of output contents.

[Figure]

The following shows the meaning of the output.

AGENT

Indicates an agent host name.