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:
-
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
-
This command cannot be used for a request from JP1/AJS3 to JP1/NQSEXEC or JP1/OJE for VOS3.
-
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 "..".
-
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.
|
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.
|
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.
|
201 |
You cannot use a specified agent host.
|
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.
|
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.