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

jajs_spmd

Format

For JP1/AJS3 - Manager

jajs_spmd
     [-h logical-host-name]
     [-n jajs_agtd] |
      -n jajs_schd [-F scheduler-service-name]]
     [-hot|-warm|-cold][-q {clear|noclear}]]
     [-HA]

For JP1/AJS3 - Agent

jajs_spmd
     [-h logical-host-name]
     [-cold]
     [-HA]

Description

For JP1/AJS3 - Manager

The jajs_spmd command starts the process that corresponds to a JP1/AJS3 function.

For JP1/AJS3 - Agent

The jajs_spmd command starts the JP1/AJS3 service or starts the process that corresponds to a JP1/AJS3 function.

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 starting the process or services 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.

-n process-name

Specify the name of the process you want to start. You can specify any of the process names shown below.

For JP1/AJS3 - Manager

jajs_schd (Scheduler-service-management)

jajs_agtd (Agent-service-management)

If you want to start the scheduler service, specify jajs_schd in the -n option, and specify the name of the scheduler service in the -F option. To start the scheduler service of the logical host, specify both the -h and -F options.

-F scheduler-service-name

Specify the name of the scheduler service you want to start. You can specify this option only when you specify jajs_schd in the -n option.

If you want to start the scheduler service with advanced options specified, use the ajsstart command. For details on the ajsstart command and the ajsagtprint command, see ajsstart in 2. Commands.

If you omit this option, the system assumes the default scheduler service name.

-hot|-warm|-cold

Specify the startup mode for the JP1/AJS3 process or services. For the states of jobnets and jobs for each startup mode, see the explanation of states of jobnets and jobs for each startup mode in 7.2.1 Temporarily changing the start mode of JP1/AJS3 in the Job Management Partner 1/Automatic Job Management System 3 Administration Guide.

If you specify none of these options when JP1/AJS3 - Manager is used, the value of the STARTMODE environment setting parameter is assumed.

-hot
Performs a hot start of JP1/AJS3 (starts the process or services while holding the state available at the end of the previous process or services). You cannot specify this option when you specify jajs_agtd in the -n option.

-warm
Performs a warm start of JP1/AJS3 (starts the process or services while holding the state available at the end of the previous process or services. However, any jobnet being executed at the end of the process or services will be completed and execution will be made according to the schedule on the process or services start day.) You cannot specify this option when you specify jajs_agtd in the -n option.

-cold
Performs a cold start of JP1/AJS3 (starts the process by canceling the state available at the end of the previous process or services.)

-q {clear|noclear}

Selects whether or not to initialize the job information in the job execution environment database at the time of a cold start.

You can specify this option with the -cold option, not with any other options.

If this option is omitted, the value of the ColdStartMode environment setting parameter is assumed. If specification of the ColdStartMode environment setting parameter is in the default status, the job information for the job execution environment database is initialized.

clear
Initializes the job information in the job execution environment database at the time of a cold start. However, initialization does not occur if there is a scheduler service whose setting is not specified as automatic start.

noclear
Does not initialize the job information about the job execution environment database at the time of a cold start.

-HA

Terminates all processes for the JP1/AJS3 process or service, instead of performing a reduced operation, when there is something wrong with the JP1/AJS3 process or services.

Specify this option to fail over the cluster if some JP1/AJS3 processes or services have failed.

If this option is used for a logical host, regardless of the restart option specified in the extended startup process definition file, the processes or services are not restarted. If you want these to be restarted in a cluster system, set cluster software so that they are restarted.

Notes

You cannot specify the -n option while JP1/AJS3 is not running. You can specify the option only when JP1/AJS3 is running and you want to start a process separately.

If you specify both the -n and -HA options, the -HA option is valid for only the child process specified in the -n option.

Do not execute this command concurrently with the jajs_start or jajs_start.cluster command. JP1/AJS3 may not start successfully.

The command terminates without waiting for the process or services to complete its startup. Use the jajs_spmd_status command to check whether the JP1/AJS3 process or services has started.

For the JP1/AJS3 - Manager agent service management function and JP1/AJS3 - Agent, if a process or service error occurs, all agent service management function processes or all JP1/AJS3 services are terminated regardless of the -HA option specification. Reduced operation is not performed.

In Windows, to start a JP1/AJS3 service, use the Services dialog box that is displayed by double-clicking Administrative Tools and then Services in Windows Control Panel. This operation is equivalent to executing the command without specifying options (on a logical host, the -h and -HA options have effect).

Do not execute this command if the process of system termination is being conducted from JP1/Power Monitor during linkage with JP1/Power Monitor.

You cannot execute several instances of the jajs_spmd_xxxx command on the same logical host.

In UNIX, if you want to execute the jajs_spmd command by using a remote shell command, disconnect the standard input, standard output, and standard error output. That is, assign /dev/null to the standard input, standard output, and standard error output. If you execute the command without disconnecting these, the remote shell command might be unable to terminate when JP1/AJS3 processes or services are started.

In UNIX, if you have started the JP1/AJS3 service by using this command, do not delete the current directory from which you executed the command. If you are planning to delete the current directory from which you started the JP1/AJS3 service, make sure that the service has terminated before deleting the directory.

Return values

0 Normal end

Values other than 0 Abnormal end

Example 1

The following command cold-starts JP1/AJS3.
 
jajs_spmd -cold
 

Example 2

The following command is used to restart only JP1/AJS3 scheduler service AJSROOT1 after the scheduler service has terminated abnormally and the cause of the problem has been solved.
 
jajs_spmd -n jajs_schd -F AJSROOT1

[Contents][Back][Next]

[Trademarks]