ajsagtshow

Organization of this page

Format
Description
Execution privileges
Arguments
Notes
Return values
Example 1
Example 2
Example 3
Output example 1
Output example 2
Output example 3
Output example 4
Output example 5
Note

Format

ajsagtshow
     [-h logical-host-name]
     {-a execution-agent-name | -g execution-agent-group-name|-l|-n|-e}

Format1 (for displaying information about an execution agent)

ajsagtshow
     [-h logical-host-name]
     -a execution-agent-name

Format2 (for displaying information about an execution agent group)

ajsagtshow
     [-h logical-host-name]
     -g execution-agent-group-name

Format3 (for displaying information about all execution agents and execution agent groups)

ajsagtshow
     [-h logical-host-name]
     -l

Format4 (for displaying the names of all execution agents and execution agent groups)

ajsagtshow
     [-h logical-host-name]
     -n

Format5 (for displaying information about the status of execution agents)

ajsagtshow
     [-h logical-host-name]
     -e

To Page Top

Description

The ajsagtshow command outputs the job execution status and other information about execution agents or execution agent groups to the standard output.

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

In Windows: Administrators privilege

In UNIX: Superuser privileges

To Page Top

Arguments

`-h` `logical-host-name`

Specify the logical host name of the local host on which the execution agent or execution agent group for which you want to output execution agent information is registered.

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

If this option is omitted, the logical host name specified in the JP1_HOSTNAME environment variable is assumed. If the JP1_HOSTNAME environment variable is not specified, the physical host name is assumed.

For a physical host, make sure that you specify neither this option nor the JP1_HOSTNAME environment variable.

`-a` `execution-agent-name`

Specify the name of an execution agent for which you want to output execution agent information.

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

If the job distribution delay reduction function is enabled, the status of the execution agent is also output.

`-g` `execution-agent-group-name`

Specify the name of an execution agent group for which you want to output execution agent information.

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

If the job distribution delay reduction function is enabled, the status of the execution agent is also output.

`-l`

Specify this option if you want to output the information for all execution agents and execution agent groups.

If the job distribution delay reduction function is enabled, the status of the execution agent is also output.

`-n`

Specify this option if you want to output only the names of all execution agents and execution agent groups. If this option is specified, information other than the names of execution agents and execution agent groups is not output.

`-e`

Specify this option if you want to output the status of execution agents.

You can specify this option only when the job distribution delay reduction function is enabled. If this function is disabled, the command is interrupted and then an error message appears.

To Page Top

Notes

This command cannot be used for a request from JP1/AJS3 to JP1/NQSEXEC or JP1/OJE for VOS3.
This command cannot be executed for JP1/AJS3 - Manager installed on another host.

To Page Top

Return values

0	Normal end.
4	An environment variable used for command execution is incorrect. The JP1/AJS3 service is not running. The `-h` option is specified but the specified logical host does not exist or environment settings are incorrect. The specified execution agent does not exist. The specified execution agent group does not exist. The authentication server is not running. When the `-e` option was specified, the job distribution delay reduction function was disabled.
8	An argument specified in the command is incorrect.
12	Memory became insufficient during command processing.
20	An attempt to access shared memory failed because the access target was locked.
24	Permission to execute the command is not granted.
40	A system limit was exceeded during allocation of shared memory, file descriptors, or resources for exclusive use.
120	An unexpected error was detected for an OS system call.
124	An unexpected error was detected in JP1/AJS internal processing.

To Page Top

Example 1

To output the information for all execution agents and execution agent groups, execute the following command:

ajsagtshow -l

To Page Top

Example 2

To output the definition information for execution agent AP1, execute the following command:

ajsagtshow -a AP1

To Page Top

Example 3

To output the status of execution agents, execute the following command:

ajsagtshow -e

To Page Top

Output example 1

The following shows a sample execution of the command with the -a option specified:

Note that, in this example, the job distribution delay reduction function is disabled.

ajsagtshow -a AGT01
KNAC1101-I The output of the agent manager information started.
HOSTNAME:HOST01
AGENT   STATUS HOST     CON-EXE   QUE   JOB EVENT DESCRIPTION
------- ------ ------- -------- ----- ----- ----- -----------
AGT01   Ef     AGT01          5     0     0     0
KNAC1102-I The output of the agent manager information ended.

The following shows the meaning of the output.

HOSTNAME

Indicates a host name.

For a physical host, the local host name is displayed. For a logical host, the name of the logical host is output.

AGENT

Indicates that execution agent names are output in this column.

STATUS

Indicates that the job transfer restriction status of each execution agent is output in this column.

Value	Status	Description
`Ef`	Effective	Jobs are accepted and then delivered to the target host.
`In`	Ineffective	New jobs are not accepted but the jobs that have already been accepted are delivered to the target host.
`Hd`	Hold	Jobs are accepted but are not delivered to the target host.
`Bl`	Blockade	Jobs are neither accepted nor delivered to the target host.

HOST

Indicates that target host names are output in this column.

CON-EXE

Indicates that the maximum number of jobs that can be executed concurrently is output in this column.

QUE

Indicates that the number of queued jobs (UNIX, PC, flexible, HTTP connection, action, custom, and passing information setting jobs) is output in this column.

JOB

Indicates that the number of running jobs (UNIX, PC, flexible, HTTP connection, action, custom, and passing information setting jobs) is output in this column.

EVENT

Indicates that the number of event jobs being executed is output in this column.

DESCRIPTION

Indicates that the comment about the execution agent that was specified when the execution agent was added or changed is output in this column.

To Page Top

Output example 2

The following shows a sample execution of the command with the -g option specified:

Note that, in this example, the job distribution delay reduction function is disabled.

ajsagtshow -g AGTG01
KNAC1101-I The output of the agent manager information started.
HOSTNAME:HOST01
AGENT GROUP   STATUS   QUE LINKAGENT      AGT ST DESCRIPTION
------------- ------ ----- -------------- ------ ------------
AGTG01        Ef         0 -              -
              -          - AGT01:16       Ef
              -          - AGT02:16       Ef
KNAC1102-I The output of the agent manager information ended.

The following shows the meaning of the output.

HOSTNAME

Indicates a host name.

For a physical host, the local host name is displayed. For a logical host, the name of the logical host is output.

AGENT GROUP

Indicates that execution agent group names are output in this column.

STATUS

Indicates that the job transfer restriction status of each execution agent group is output in this column.

Value	Status	Description
`Ef`	Effective	Jobs are accepted and then delivered to the target host.
`In`	Ineffective	New jobs are not accepted but the jobs that have already been accepted are delivered to the target host.
`Hd`	Hold	Jobs are accepted but are not delivered to the target host.
`Bl`	Blockade	Jobs are neither accepted nor delivered to the target host.

QUE

Indicates that the number of queued jobs (UNIX, PC, flexible, HTTP connection, action, and custom jobs) is output in this column.

LINKAGENT

Indicates that the names and priority levels of each execution agent in the execution agent group are output in this column. A colon (:) is output between the name and priority, with 1 being the lowest priority level and 16 being the highest priority level.

AGT ST

Indicates that the job transfer restriction status of the execution agent is output in this column.

Value	Status	Description
`Ef`	Effective	Jobs are accepted and then delivered to the target host.
`In`	Ineffective	New jobs are not accepted but the jobs that have already been accepted are delivered to the target host.
`Hd`	Hold	Jobs are accepted but are not delivered to the target host.
`Bl`	Blockade	Jobs are neither accepted nor delivered to the target host.

DESCRIPTION

Indicates that the comment about the execution agent group that was specified when the execution agent group was added or changed is output in this column.

To Page Top

Output example 3

The following shows a sample execution of the command with the -a option specified:

The following shows an example when the job distribution delay reduction function is enabled.

ajsagtshow -a AGT01
KNAC1101-I The output of the agent manager information started.
HOSTNAME:HOST01
AGENT     STATUS HOST      CON-EXE  QUE  JOB EVENT DESCRIPTION
--------- ------ --------- ------- ---- ---- ----- -----------
AGT01     In-Co  AGT01          10    0    5     3 Agent1
KNAC1102-I The output of the agent manager information ended.

The following shows the meaning of the output.

HOSTNAME

Indicates a host name.

For a physical host, the local host name is displayed. For a logical host, the name of the logical host is output.

AGENT

Indicates that execution agent names are output in this column.

STATUS

Indicates that the job transfer restriction status for execution agents and the status of execution agents are output in this column.

The following table lists the job transfer restriction status.

Value	Status	Description
`Ef`	Effective	Jobs are accepted and then delivered to the target host.
`In`	Ineffective	New jobs are not accepted but the jobs that have already been accepted are delivered to the target host.
`Hd`	Hold	Jobs are accepted but are not delivered to the target host.
`Bl`	Blockade	Jobs are neither accepted nor delivered to the target host.

If the job distribution delay reduction function is enabled, the value indicating the job transfer restriction status of an execution agent is followed by the status of the execution agent indicated in -execution-agent-status format.

The following table lists the status of execution agent.

Value	Status	Description
`Nc`	Not checked	The status of the execution agent is Not checked.
`Co`	Connectable	The status of the execution agent is Connectable.
`Uc`	Unconnectable	The status of the execution agent is Unconnectable.
`Ua`	Unavailable	The status of the execution agent is Unavailable.

HOST

Indicates that target host names are output in this column.

CON-EXE

Indicates that the maximum number of concurrently executable jobs is output in this column.

QUE

Indicates that the number of queued jobs (UNIX, PC, flexible, HTTP connection, action, custom, and passing information setting jobs) is output in this column.

JOB

Indicates that the number of running jobs (UNIX, PC, flexible, HTTP connection, action, custom, and passing information setting jobs) is output in this column.

EVENT

Indicates that the number of event jobs being executed is output in this column.

DESCRIPTION

Indicates that the comment on the execution agent specified when the execution agent was added or changed is output in this column.

To Page Top

Output example 4

The following shows a sample execution of the command with the -g option specified:

The following shows an example when the job distribution delay reduction function is enabled.

ajsagtshow -g AGTG01
KNAC1101-I The output of the agent manager information started.
HOSTNAME:HOST01
AGENT GROUP    STATUS   QUE LINKAGENT        AGT ST DESCRIPTION
-------------- ------ ----- ---------------- ------ -----------
AGTG01         Ef         0 -                -      AgentGroup
               -          - AGT01:1          In-Co  Agent1
               -          - AGT02:2          Bl-Co  Agent2
KNAC1102-I The output of the agent manager information ended.

The following shows the meaning of the output.

HOSTNAME

Indicates a host name.

For a physical host, the local host name is displayed. For a logical host, the name of the logical host is output.

AGENT GROUP

Indicates that execution agent group names are output in this column.

STATUS

Indicates the job transfer restriction status of the execution agent group.

Value	Status	Description
`Ef`	Effective	Jobs are accepted and then delivered to the target host.
`In`	Ineffective	New jobs are not accepted but the jobs that have already been accepted are delivered to the target host.
`Hd`	Hold	Jobs are accepted but are not delivered to the target host.
`Bl`	Blockade	Jobs are neither accepted nor delivered to the target host.

QUE

Indicates that the number of queued jobs (UNIX, PC, flexible, HTTP connection, action, and custom jobs) is output in this column.

LINKAGENT

Indicates that the name and priority of the execution agent in the execution agent group are output in this column. A colon (:) is output between the name and priority. 1 indicates the lowest priority and 16 indicates the highest priority.

AGT ST

Indicates that the job transfer restriction status for execution agents and the status of execution agents are output in this column.

The following table lists the job transfer restriction status.

Value	Status	Description
`Ef`	Effective	Jobs are accepted and then delivered to the target host.
`In`	Ineffective	New jobs are not accepted but the jobs that have already been accepted are delivered to the target host.
`Hd`	Hold	Jobs are accepted but are not delivered to the target host.
`Bl`	Blockade	Jobs are neither accepted nor delivered to the target host.

The following table lists the status of execution agent.

Value	Status	Description
`Nc`	Not checked	The status of the execution agent is Not checked.
`Co`	Connectable	The status of the execution agent is Connectable.
`Uc`	Unconnectable	The status of the execution agent is Unconnectable.
`Ua`	Unavailable	The status of the execution agent is Unavailable.

DESCRIPTION

Indicates that the comment on the execution agent group specified when the execution agent group was added or changed is output in this column.

To Page Top

Output example 5

The following shows a sample execution of the command with the -e option specified:

ajsagtshow -e
KNAC1101-I The output of the agent manager information started.
HOSTNAME:HOST01
AGENT           STATUS HOST           IP ADDRESS      CHECK TIME
--------------- ------ -------------- --------------- -------------------
AGT01           Ef-Co  AGT01          -               2016/01/01 10:00:00
AGT02           Ef-Nc  AGT02          -               ----/--/-- --:--:--
AGT04           Ef-Uc  AGT04          123.456.789.25  2016/01/01 10:00:10
                -                     123.456.987.10  2016/01/01 10:01:40
                -                     123.456.797.65  2016/01/01 10:03:10
AGT05           Hd-Ua  AGT05          -               ----/--/-- --:--:--
AGT06           Ef-Uc  AGT06          123.456.789.27  2016/01/01 10:00:11
KNAC1102-I The output of the agent manager information ended.

HOSTNAME

Indicates a host name.

For a physical host, the local host name is displayed. For a logical host, the name of the logical host is output.

AGENT

Indicates that execution agent names are output in this column.

STATUS

Indicates that the job transfer restriction status for execution agents and the status of execution agents are output in this column in job-transfer-restriction-status-for-exec-agent-execution-agent-status format.

The following table lists the job transfer restriction status.

Value	Status	Description
`Ef`	Effective	Jobs are accepted and then delivered to the target host.
`In`	Ineffective	New jobs are not accepted but the jobs that have already been accepted are delivered to the target host.
`Hd`	Hold	Jobs are accepted but are not delivered to the target host.
`Bl`	Blockade	Jobs are neither accepted nor delivered to the target host.

The following table lists the status of execution agent.

Value	Status	Description
`Nc`	Not checked	The status of the execution agent is Not checked.
`Co`	Connectable	The status of the execution agent is Connectable.
`Uc`	Unconnectable	The status of the execution agent is Unconnectable.
`Ua`	Unavailable	The status of the execution agent is Unavailable.

HOST

Indicates that target host names are output in this column.

IP ADDRESS

Indicates that connection IP addresses are output in this column when the status of the execution agent is Unconnectable.

Each IP address that caused a communication error is displayed on one line. A maximum of four IP addresses are displayed (in the order of error occurrence with the most recent shown first).

Communication errors that occurred before IP addresses were resolved are not displayed.

CHECK TIME

The time when the execution agent was checked is displayed in YYYY/MM/DD hh:mm:ss format for each IP address.

To Page Top

Note

The IP ADDRESS and CHECK TIME columns only contain information about the execution agents for which a communication error was detected by the communication status check for the job distribution delay reduction function. To check information about errors detected by any method other than the communication status check, see the error messages output to the integrated trace log.

To Page Top