Job Management Partner 1/Automatic Job Management System 3 Command Reference 2

jpqagtshow

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:

• JP1_JPQ_Admin privilege

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

• Windows: Administrators privileges
• UNIX: Superuser 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. During linkage with JP1/NQSEXEC and JP1/OJE for VOS3, you cannot use this command for JP1/NQSEXEC queues and JP1/OJE for VOS3 queues.
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.

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.

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.

The following shows the meaning of the output.

AGENT

Indicates an agent host name.

[Contents][Back][Next]

Copyright (C) 2009, 2010, Hitachi, Ltd.
Copyright (C) 2009, 2010, Hitachi Solutions, Ltd.