Hitachi

JP1 Version 12 JP1/Base User's Guide


Start sequence definition file (Windows only)

Organization of this page

Format

# Comment

[ControlValue]

ForcedTerminateExec=YES

[FrontOtherServiceXXX]

Name=any-name

ServiceName=name-of-the-service-to-start-and-stop

StartCommand=command-to-execute-at service-startup

StopCommand=command-to-execute-at-service-stop

Parallel=YES

Wait=maximum-wait-time(in seconds)-for-completion-of-service-startup-processing

StopWait=maximum-wait-time(in seconds)-for-completion-of-service-stop-processing

[Jp1XXX]

Name=any-name

ServiceName=name-of-the-service-to-start-and-stop

StartCommand=command-to-execute-at service-startup

StopCommand=command-to-execute-at-service-stop

Parallel=YES

Wait=maximum-wait-time(in seconds)-for-completion-of-service-startup-processing

StopWait=maximum-wait-time(in seconds)-for-completion-of-service-stop-processing

[OtherServiceXXX]

Name=any-name

ServiceName=name-of-the-service-to-start-and-stop

StartCommand=command-to-execute-at service-startup

StopCommand=command-to-execute-at-service-stop

Parallel=YES

Wait=maximum-wait-time(in seconds)-for-completion-of-service-startup-processing

StopWait=maximum-wait-time(in seconds)-for-completion-of-service-stop-processing

[Command]

ReadyCommand=command-to-execute-after-all-service-startup-processing-has-completed

StopReadyCommand=command-to-execute-after-all-service-stop-processing-has-completed

Parameters by type

Required parameters:

None

Custom parameters:

[ControlValue] section:

  • ForcedTerminateExec

[FrontOtherServiceXXX] and [Jp1XXX] sections:

  • Name

  • ServiceName

  • StartCommand

  • StopCommand

  • Parallel

  • Wait

  • StopWait

[Command] section:

  • ReadyCommand

  • StopReadyCommand

File name

JP1SVPRM.DAT (Start sequence definition file)

JP1SVPRM.DAT.MODEL (Start sequence definition file model file)

Storage destination directory

installation-folder\conf\boot\

Description

This file specifies the startup and stop sequences for the JP1 series product services, non-JP1 series product services, and the commands and batch files to be executed after the services have started or stopped.

Application of settings

Execute the cpysvprm command to create the start sequence definition file (JP1SVPRM.DAT). Restart Windows to apply the settings. For details on the cpysvprm command, see cpysvprm (Windows only) in 15. Commands.

Definition details

The parameters of the start sequence definition file (JP1SVPRM.DAT) are described below. In the start sequence definition file (JP1SVPRM.DAT), you can specify file names that are longer than 8 characters or include spaces. To insert a comment line, prefix the line with #. The characters following # and up to the next linefeed constitute a comment.

[ControlValue]

Specify parameters in this section to perform a sequenced stop of services when a forced termination is performed from JP1/Power Monitor. You can specify just ForcedTerminateExec= in this section.

For a JP1/Power Monitor planned termination, JP1/Base always performs service stop processing as defined in the start sequence definition file (JP1SVPRM.DAT), even if you omit the [ControlValue] section.

ForcedTerminateExec=

Specify YES to execute service stop processing at forced termination from JP1/Power Monitor. If you specify a value other than YES for this parameter or omit this parameter, JP1/Base will not perform service stop processing at a forced termination from JP1/Power Monitor.

[FrontOtherServiceXXX]

In this section, write information about the non-JP1 services that you want to start before services provided by JP1 programs. In xxx, write any name using no more than 60 alphanumeric characters. Letters are not case sensitive.

[Jp1XXX]

In this section, specify information about the services provided by JP1 products. xxx represents a product name. For services provided by JP1 products, xxx has been written in the supplied file JP1SVPRM.DAT.MODEL. You can also specify any name in xxx to add a service that is not included in the model file. Write no more than 60 alphanumeric characters. Letters are not case sensitive.

[OtherServiceXXX]

In this section, write information about the non-JP1 services that you want to start after services provided by JP1 programs. In xxx, write any name using no more than 60 alphanumeric characters. Letters are not case sensitive.

Name=

Specify this parameter in the [FrontOtherServicexxx], [Jp1xxx], and [OtherServicexxx] sections. You can write any identifier in Name=.

ServiceName=

Specify this parameter in the [FrontOtherServicexxx], [Jp1xxx], and [OtherServicexxx] sections. Write the name of the service that you want to start and stop. If you omit this parameter, start and stop will not be controlled.

The service name written in this parameter might differ from the service name displayed in the Services dialog box, which opens from the Control Panel. For details, check with the manufacturer of the particular program.

StartCommand=

Specify this parameter in the [FrontOtherServicexxx], [Jp1xxx], and [OtherServicexxx] sections. Specify a command to be executed at service startup. Only one command can be specified.

StopCommand=

Specify this parameter in the [FrontOtherServicexxx], [Jp1xxx], and [OtherServicexxx] sections. Specify a command to be executed at service stop. If you omit this parameter, stop processing will not be performed. Only one command can be specified.

Parallel=

Specify this parameter in the [FrontOtherServicexxx], [Jp1xxx], and [OtherServicexxx] sections. Specify YES to start the service in parallel, during start processing of another service. If you specify a value other than YES for this parameter or omit this parameter, start processing for this service will begin after completion of start processing for the preceding service.

The Parallel= parameter is enabled when the service start sequence is being controlled. When the service stop sequence is being controlled, stop processing for this service will begin after the completion of shutdown processing for the preceding service, regardless of the Parallel= parameter setting.

Wait=

Specify this parameter in the [FrontOtherServicexxx], [Jp1xxx], and [OtherServicexxx] sections. Specify the maximum wait time (in seconds) for completion of service start processing. If start processing has not completed within the specified time, JP1/Base begins start processing for the next service. The specifiable range is from 1 to 86400 (seconds). The default is 60 (seconds).

StopWait=

Specify this parameter in the [FrontOtherServicexxx], [Jp1xxx], and [OtherServicexxx] sections. Specify the maximum wait time (in seconds) for completion of service stop processing. If stop processing has not completed within the specified time, JP1/Base begins stop processing for the next service. The default is 60 (seconds). The specifiable range is 1 to 86400 seconds (24 hours).

[Command]

In this section, write information about the command or batch file to be executed after all services have started or stopped. You can write simply ReadyCommand= or StopReadyCommand= in this section.

ReadyCommand=

Write this parameter in the [Command] section. Specify a command to be executed after completion of start processing for all services. To execute multiple commands, prepare a batch file and specify the batch file name in ReadyCommand=.

StopReadyCommand=

Write this parameter in the [Command] section. Specify a command to be executed after the processing for all of the services has completed. To execute multiple commands, prepare a batch file and specify the batch file name in StopReadyCommand=.

Notes

Definition examples

# Enter the following definition to stop services in sequence when there is a forced termination from JP1/Power Monitor.
[ControlValue] 
ForcedTerminateExec=YES 
 
# Specify the services you want to start before the JP1 services.
[FrontOtherService1] 
Name=ABC 
ServiceName=ABC 
StartCommand="c:\Program Files\ABC\start.exe" -start 
StopCommand="c:\Program Files\ABC\start.exe" -stop   
[FrontOtherService2] 
Name=DEF 
ServiceName=def_serv 
 
# Specify the services provided by JP1 products.
[Jp1BaseStart] 
Name=JP1/Base 
ServiceName=JP1Base 
StopCommand="jbs_spmd_stop.exe" 
[Jp1BaseEvent] 
Name=JP1/Base Event 
ServiceName=JP1_Base_Event 
   :
[Jp1Nps] 
Name=JP1/Nps 
ServiceName=JP1_NPS 
Wait=60 
Parallel=YES 
 
# Specify the services you want to start after the JP1 services.
[OtherService1] 
Name=XYZ 
ServiceName=XYZ 
 
# Specify the command to be executed after all services have stopped.
[Command] 
StopReadyCommand=c:\sfiles\stop.exe