Hitachi

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


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

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