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

jajs_spmd_stop

Format

For JP1/AJS3 - Manager

jajs_spmd_stop
     [-h logical-host-name]
     [-n jajs_agtd] |
      -n jajs_schd [-F scheduler-service-name]]
     [-job|-kill]

For JP1/AJS3 - Agent

jajs_spmd_stop
     [-h logical-host-name]
     [-job|-kill]

Description

The jajs_spmd command stops the JP1/AJS3 service or stops 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 terminating 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 stop. 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 stop the scheduler service, specify jajs_schd in the -n option, and specify the name of the scheduler service in the -F option. To stop the scheduler service of the logical host, specify both the -h and -F options.

If this option is omitted, the command stops all running processes that are specified in the process definition file.

-F scheduler-service-name

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

If you want to stop the scheduler service with advanced options specified, use the ajsstop command. For details on the ajsstop command, see ajsstop in 2. Commands.

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

-job|-kill

Specify the termination mode for the JP1/AJS3 process or services.

By default, the command issues a kill request to the jobs that are running with the JP1/AJS3 service specified as an agent (jobs started as processes subordinate to the JP1/AJS3 service), causing the process to be forcibly terminated without waiting for the currently running jobs and jobnets to terminate.

-job
The process or services is terminated after all jobs being executed are terminated.

-kill
The process or services is terminated after all jobs being executed are forcibly terminated.
Explicitly specifying this option performs a more forcible termination of processes or services than the kill request issued when neither -job nor -kill is specified.

Notes

This command does not allow you to terminate the following process states:

jpomlsrv (for Windows)

This command terminates without waiting for the end of process or services termination. Use the jajs_spmd_status command to check whether the JP1/AJS3 process or services has ended.

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

While JP1/AJS3 is being started, if the command is executed with the -kill option specified, the stop request made by the command is accepted. However, if the -kill option is not specified, the command results in an error.

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

If the event job execution continuation option is used, the status of an event job on the manager host does not change from Now running even if you use this command to stop JP1/AJS3 on the agent host. Therefore, if the -job option is used so that the process or services are terminated after all jobs are terminated, the command cannot stop JP1/AJS3. If you use both the event job execution continuation option and the -job option, you must ensure that the command is executed when no event jobs are running. For example, wait for the running event jobs to terminate, forcibly terminate running event jobs, or schedule execution of the command so that the command is always executed when event jobs are terminated.

Return values

0 Normal end

Values other than 0 Abnormal end

Example

The following command stops JP1/AJS3 services after all running jobs terminate.
 
jajs_spmd_stop -job

[Contents][Back][Next]

[Trademarks]