ajsagtcheck

Organization of this page

Format
Description
Execution privileges
Arguments
Return values
Example 1
Example 2
Output example

Format

ajsagtcheck
     [-h logical-host-name]
     [-m { start | stop | status }]

To Page Top

Description

The ajsagtcheck command starts and stops the communication status check for the job distribution delay reduction function, and outputs the status for all execution agents other than the execution agents whose status is Unavailable.

You can execute this command 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

Execution privileges

In Windows: Administrators privilege

In UNIX: Superuser privilege

To Page Top

Arguments

`-h` `logical-host-name`

Specify the name of the logical host on which the execution agent whose communication status you want to check 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.

`-m { start | stop | status }`

Specify the operation for the job distribution delay reduction function. You can specify the following values:

If you omit this option, the system assumes status.

start

Starts a communication status check.

If a communication error is detected for the execution agent during a communication status check, a communication recovery check is performed.

Note that you cannot check the communication status of an execution agent whose status has been set to Not available by the ajsagtalt command.

If a communication status check is already running, the command is interrupted and then an error message appears. The communication status check continues.
stop

Stops a communication status check. However, the communication recovery check continues for an execution agent on which a communication error has been detected.

If a communication status check is not running, the command is interrupted and then an error message appears.
status

Outputs the following items to the standard output:
- The time when a communication status check was performed
- The time when a communication status recovery check is performed
- Progress of communication status checks or communication recovery checks in progress (number of execution agents by status)
For details about the output format, see the output example.

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 host is now being started, now being stopped, has stopped, or is running in reduced-operation mode. The job distribution delay reduction function is disabled. The agent monitoring process is being stopped. No operable status was returned.
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.
36	An error occurred in communication with the JP1/AJS3 service, or the JP1/AJS3 service returned no response. An error occurred in communication with the agent monitoring process, or the agent monitoring process returned no response.
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 start a communication status check for an execution agent on a physical host, execute the following command:

ajsagtcheck -m start

To Page Top

Example 2

To view the status of a communication status check for an execution agent on a logical host (lhost1), execute the following command:

ajsagtcheck -h lhost1 -m status

To Page Top

Output example

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

ajsagtcheck -m status
KNAC1202-I The output of the agent monitoring information will now start.
HOSTNAME:HOST01
 
CONNECT
START TIME : 2016/02/02 10:10:05
END   TIME : 2016/02/02 10:11:10
 
RECOVERY
START TIME : 2016/02/02 11:20:04
END   TIME : 2016/02/02 11:20:35
 
  CONNECTABLE UNCONNECTABLE   NOT CHECKED   UNAVAILABLE
------------- ------------- ------------- -------------
          100             5             0             4
KNAC1203-I The output of the agent monitoring information will now end.

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.

CONNECT

START TIME

Indicates the start time of the communication status check in YYYY/MM/DD hh:mm:ss format.
END TIME

Indicates the end time of the communication status check in YYYY/MM/DD hh:mm:ss format.

If the communication status check is running, ----/--/-- is displayed.

RECOVERY

START TIME

Indicates the start time of the communication recovery check in YYYY/MM/DD hh:mm:ss format.
END TIME

Indicates the end time of the communication recovery check in YYYY/MM/DD hh:mm:ss format.

If the communication recovery check is running, ----/--/-- is displayed.

CONNECTABLE

Indicates the number of execution agents in Connectable status.

UNCONNECTABLE

Indicates the number of execution agents in Unconnectable status.

NOT CHECKED

Indicates the number of execution agents in Not checked status.

UNAVAILABLE

Indicates the number of execution agents in Unavailable status.

To Page Top