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

[Contents][Glossary][Index][Back][Next]

ajsagtshow

Format

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

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]

Description

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

Execution privileges

You must have any of the following JP1 privileges:

or

In Windows:Administrators privilege

In UNIX:Superuser privileges

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.

-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.

-l

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

-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.

Notes

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 target host is starting operation, stopping operation, has stopped operation, or is operating in reduced mode.
  • The specified execution agent does not exist.
  • The specified execution agent group does not exist.
  • The authentication server is not running.
  • A compatible ISAM configuration is used.
8 An argument specified in the command is incorrect.
12 Memory became insufficient during command processing.
20 An attempt to access the database or shared memory failed because the access target was locked.
24 Permission to execute the command is not granted.
36
  • A database input or output error occurred.
  • An error occurred in communication with the JP1/AJS3 service or the JP1/AJS3 service does not respond.
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.

Example 1

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

 
ajsagtshow -l

Example 2

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

 
ajsagtshow -a AP1

Output example 1

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

 
ajsagtshow -a AGT01
HOSTNAME:<host-name#>
KNAC1101-I The output of the agent manager information started.
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.

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

The following shows the meaning of the output.

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

STATUS
Indicates the job transfer restriction status of the execution agent.
  • Ef:
    Indicates that the job transfer restriction status is effective.
  • In:
    Indicates that the job transfer restriction status is ineffective.
  • Hd:
    Indicates that the job transfer restriction status is Hold.
  • Bl:
    Indicates that the job transfer restriction status is Blocked.

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, action, and custom jobs) is output in this column.

JOB
Indicates that the number of running jobs (UNIX, PC, action, and custom 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.

Output example 2

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

 
ajsagtshow -g AGTG01
HOSTNAME:<host-name#>
KNAC1101-I The output of the agent manager information started.
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.

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

The following shows the meaning of the 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.
  • Ef:
    Indicates that the job transfer restriction status is effective.
  • In:
    Indicates that the job transfer restriction status is ineffective.
  • Hd:
    Indicates that the job transfer restriction status is Hold.
  • Bl:
    Indicates that the job transfer restriction status is Blocked.

QUE
Indicates that the number of queued jobs (UNIX, PC, 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 the job transfer restriction status of the execution agent.
  • Ef:
    Indicates that the job transfer restriction status is effective.
  • In:
    Indicates that the job transfer restriction status is ineffective.
  • Hd:
    Indicates that the job transfer restriction status is Hold.
  • Bl:
    Indicates that the job transfer restriction status is Blocked.

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.

[Contents][Back][Next]

[Trademarks]

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