jajs_spmd_stop
- Organization of this page
Format
- For JP1/AJS3 - Manager
jajs_spmd_stop [-h logical-host-name] [-n jajs_agtd | -n jajs_schd [-F scheduler-service-name]| -n jajs_dbmd [-id embedded-database-setup-ID]] [-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)
-
jajs_dbmd (Database-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 you want to stop the embedded database, specify jajs_dbmd in the -n option, and specify the embedded database setup identifier in the -id option. To stop the embedded database of the logical host, specify both the -h and -id 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 3. Commands Used for Normal Operations.
If you omit this option, the system assumes the default scheduler service name.
-id embedded-database-setup-ID
Specify _JFn (where n is a value from 0 to 9 or A to Z) as the setup identifier used to identify the embedded database. Specify the value that was specified in the -id option of the ajsembdbbuild command.
To operate the embedded database created by using the jajs_setup, jajs_setup_cluster, and jajs_migrate commands, use the ajsembdbidlist command to check the setup identifier of the embedded database that will be used. For details about the ajsembdbidlist command, see ajsembdbidlist in 2. Commands Used during Setup.
To stop the embedded database with advanced options specified, use the ajsembdbstop command. For details about the ajsembdbstop command, see ajsembdbstop in 3. Commands Used for Normal Operations.
If this option is omitted, _JF0 is assumed.
-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 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 or services to be forcibly terminated without waiting for the currently running jobs and jobnets to terminate.
If you execute the command with this option specified when the JP1/AJS3 service is starting or undergoing a planned termination, the command intervenes and immediately kills the process or service. If the JP1/AJS3 service is starting when you execute the command and you do not specify the -kill option, an error occurs.
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.
-
You cannot execute this command together with any of the following commands on the same logical host:
ajsprofalter command
ajsembdbstart command
ajsembdbstop command
jajs_hstd command
jajs_hstd_stop command
jajs_spmd command (if the -n value is not jajs_schd)
jajs_spmd_status command
jajs_spmd_stop command (if the -n value is not jajs_schd)
jajs_start command (UNIX only)
jajs_start.cluster command (UNIX only)
jajs_stop command (UNIX only)
jajs_stop.cluster command (UNIX only)
-
You cannot execute this command together with any of the following commands if the same scheduler service is specified:
ajsstart command
ajsstop command
jajs_spmd command (if the -n value is jajs_schd)
jajs_spmd_stop command (if the -n value is jajs_schd)
-
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.
-
In Windows, this command cannot be executed using short file names.
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