Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Command Reference


jajs_spmd_status

Organization of this page

Format

For JP1/AJS3 - Manager
jajs_spmd_status
     [-h logical-host-name]
     [-s|-a]
     [-t time]
For JP1/AJS3 - Agent
jajs_spmd_status
     [-h logical-host-name]
     [-t time]

Description

Checks the state of the jajs_spmd sub-processes against the jajs_spmd process or services.

For details about the jajs_spmd sub-processes or services, see B. List of Processes in the manual JP1/Automatic Job Management System 3 Troubleshooting.

Execution privileges

In Windows: Administrators privileges

In UNIX: Superuser privileges

Storage directory

In Windows:

JP1/AJS3 - Manager-installation-folder\bin\

JP1/AJS3 - Agent-installation-folder\bin\

In UNIX:

/opt/jp1ajs2/bin/

Arguments

-h logical-host-name

Specify the name of the logical host that you want to check for its status on a cluster system.

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

By default, the system assumes the logical host name specified by the JP1_HOSTNAME environment variable. If environment variable JP1_HOSTNAME is not specified, the physical host name (which can be determined by the hostname command) is assumed.

-s|-a

Specify the objects whose status you want to display for JP1/AJS3 - Manager.

  • -s

    Specify this option to display only the process status of each component service.

  • -a

    Specify this option to display the process status of each component service and the status of all processes subordinate to each component service.

-t time

Specify the timeout value for JP1/AJS3 status confirmation. The specified value applies to each process, and is not the timeout value for the entire command execution.

You can specify a value between 0 and 32,767 (seconds).

The default value is 60 seconds. Even if you specify 0, the system assumes that a value of 60 seconds is specified.

If confirmation by the jajs_spmd_status command is not terminated within a specified period of time, it is considered that execution of the jajs_spmd_status command has failed.

Correspondence between the displayed and actual process names

The following describes the correspondence between the process name output by the jajs_spmd_status command and the actual process name.

For details about the process, see B. List of Processes in the manual JP1/Automatic Job Management System 3 Troubleshooting.

Table 3‒29: Correspondence between the process name displayed by the JP1/AJS3 - Manager's jajs_spmd_status command and the actual process name (for Windows)

Process name displayed by the jajs_spmd_status command

Actual process name

jajs_dbmd

jajs_dbmd.exe

ajsdbmgrd#1

ajsdbmgrd.exe

jajs_hstd

jajs_hstd.exe

hlogd

ajshlogd.exe

ajsinetd

ajsinetd.exe

network

ajsnetwd.exe

queue

jpqman.exe

agentm

ajsagtmd.exe

submitqueue

jpqman.exe

hostevam

jpomanager.exe

gatewayd

ajsgwmasterd.exe

ajscdinetd

ajscdinetd.exe

ajsovstatd

ajsovstatd.exe

qlcltd

ajsqlcltd.exe

jajs_agtd

jajs_agtd.exe

queuea

jpqmon.exe

evactiona

jpoagent.exe

jajs_schd

jajs_schd.exe

slogd

ajslogd.exe

queuem

jpqman.exe

evactionm

jpomanager.exe

schedule

ajsmasterd.exe

agentmon

ajsagtmond.exe

Table 3‒30: Correspondence between the process name displayed by the JP1/AJS3 - Agent's jajs_spmd_status command and the actual process name (for Windows)

Process name displayed by the jajs_spmd_status command

Actual process name

qlcltd

ajsqlcltd.exe

queuea

jpqmon.exe

evactiona

jpoagent.exe

Table 3‒31: Correspondence between the process name displayed by the JP1/AJS3 - Manager's jajs_spmd_status command and the actual process name (for UNIX)

Process name displayed by the jajs_spmd_status command

Actual process name

jajs_dbmd

jajs_dbmd

ajsdbmgrd#1

ajsdbmgrd

jajs_hstd

jajs_hstd

ajshlogd

ajshlogd

ajsinetd

ajsinetd

ajsnetwd

ajsnetwd

ajsagtmd

ajsagtmd

jpqman_hst

jpqman#2

jpomanager_hst

jpomanager

ajsgwmasterd

ajsgwmasterd

ajscdinetd

ajscdinetd

ajsovstatd

ajsovstatd

jajs_agtd

jajs_agtd

jpqmon

jpqmon

jpoagent

jpoagent

jajs_schd

jajs_schd

ajslogd

ajslogd

jpqman

jpqman

jpomanager

jpomanager

ajsmasterd

ajsmasterd

ajsagtmond

ajsagtmond

Table 3‒32: Correspondence between the process name displayed by the JP1/AJS3 - Agent's jajs_spmd_status command and the actual process name (for UNIX)

Process name displayed by the jajs_spmd_status command

Actual process name

jpqmon

jpqmon

jpoagent

jpoagent

#1

database (for Windows only) and ajsembdb might be displayed when an upgrade installation from v9 to v10 is performed.

#2

In the case of HP-UX, AIX, and Linux, the detailed process name is jpqman32.

Notes

Return values

0

Any of the following:

  • All processes are being started.

  • Some processes have been stopped by the jajs_spmd_stop command with the -n option specified or by the ajsstop command.

  • The command is being stopped. (There are no abnormally terminated processes.)

1

Any of the following:

  • An error occurred in, for example, communication with process management.

  • The shared folder (shared directory) has not been mounted in a cluster system.

  • Execution permission is not granted.

4

Any of the following:

  • Some of the processes are being started (There are abnormally terminated processes.).

  • The command is being started.

  • The command is being stopped. (There are abnormally terminated processes.)

8

All processes are being terminated.

12

Any of the following:

  • An error occurred during the processing of the jajs_spmd_status command, and the process status could not be obtained.

  • A request to obtain the status of JP1/AJS3 timed out.

The jajs_spmd_status command could not obtain the status. This could be a temporary error, so take the following action:

  • Wait a while, and then re-execute the jajs_spmd_status command.

  • If you execute the jajs_spmd_status command several times and the error persists, handle the situation as an abnormal condition.

Example

The following command outputs the status of each JP1/AJS3 component service and the status of processes that belong to each JP1/AJS3 component service on logical host lhost.

jajs_spmd_status -h lhost -a

Output example 1

The following shows an output example when the -a option is specified for JP1/AJS3 - Manager.

[Figure]

Output example 2

The following shows an output example when the -s option is specified for JP1/AJS3 - Manager.

[Figure]

Output example 3

The following shows an output example for JP1/AJS3 - Agent.

[Figure]

The following shows the meaning of the output.

process name

Indicates the process name.

process ID

Indicates the process ID.

attribute

Indicates the setup identifier that identifies the embedded database or the scheduler service name.