jajs_spmd
- Organization of this page
Format
- For JP1/AJS3 - Manager
jajs_spmd [-h logical-host-name] [-n jajs_agtd | -n jajs_schd [-F scheduler-service-name]| -n jajs_dbmd [-id embedded-database-setup-ID]] [-hot|-warm|-cold [-q {clear|noclear}]|-disaster] [-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)
-
jajs_dbmd (DB 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.
If you want to start the embedded database, specify jajs_dbmd in the -n option, and specify the embedded database setup identifier in the -id option. To start the embedded database of the logical host, specify both the -h and -id 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 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 start the embedded database with advanced options specified, use the ajsembdbstart command. For details about the ajsembdbstart command, see ajsembdbstart in 3. Commands Used for Normal Operations.
If this option is omitted, _JF0 is assumed.
-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 6.2.1 Temporarily changing the start mode of JP1/AJS3 in the JP1/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 or jajs_dbmd 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 or jajs_dbmd 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.) You cannot specify this option when you specify jajs_dbmd in the -n option.
-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.
-disaster
This option starts JP1/AJS3 in disaster recovery mode.
Specify this option to start JP1/AJS3 in disaster recovery mode when operation switches from the main site to the remote site and vice versa.
In disaster recovery mode, JP1/AJS3 - Manager starts with job and jobnet execution suppressed as a precaution.
-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 any options in UNIX (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 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)
-
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.
-
In Windows, this command cannot be executed using short file names.
-
If you operate JP1/AJS3 in disaster recovery mode, before executing this command, execute the jajs_rpsite command with the -v or -V option specified to confirm that disaster recovery mode has been set up correctly.
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