Setting Up an SMD File

Service

Service name.

You can also use blanks.

component

Path and file name of the AE program that should start.

You can use absolute or relative path specifications. "*OWN" means that the program must be listed in the directory of the calling ServiceManager.

Agents for SAP, JMX, databases and Rapid Automation require a Java call.
For example: java -jar ucxjr3x.jar

Java agents: Also specify the Java path because the ServiceManager under UNIX does not read all environment variables.
Example: /usr/java/latest/bin/java -jar ucxjsqlx.jar

Insert a blank between the parameters component and INI file.

INI file

File name of the INI file that should be used.

You can also specify an absolute or relative path (relative refers to the program that should be started).

Working directory

Working directory for the program that should start.

If the program to be started is a Java-based agent (SAP, Databases, JMX, Rapid Automation), the working directory must be the path to the JAR file.

-svc%port%

Additional display option for server processes.

With this start parameter being specified, the ServiceManager dialog program displays the name of the server process and the number of connections in addition to the name of the service.

LOGON=

LoginAnmeldedaten für Zielsysteme. Auch ein eigener Objekttyp in der Automation Engine. data for the AE program.

This parameter only applies for the ServiceManager on Windows.

Start1=
Start2=
etc.

Several start methods for a server process (WP).

Syntax:
START1=( name , command )
START2=( name , command )
START3=( name , command )

Name = The name of the start mode that you can define using the ServiceManager start parameter -sm.
Command = The complete start command of a WP (path and file name) including the start mode parameter(-parm).

To start the WP with a specific mode, you must append the following parameter:
-parm"StartMode=value;SystemStop=value"
The allowed values for StartMode= are "NORMAL" (regular start) and "COLD" (cold start).
The allowed values for SystemStop= are "NORMAL" (the client status remains the same) and "YES" (all clients are stopped).

For example:
The following is an extraxt of an SMD file that includes the definition of a service that you can use to start a WP with a different start mode.

VAR SRV_STARTPATH;*OWN\..\..\Server\bin
VAR WP_STARTCMD;*SRV_STARTPATH\UCsrvwp.exe *SRV_STARTPATH\ucsrv.ini -svc%port%
VAR WP_STARTCMD_COLD;*WP_STARTCMD -parm"StartMode=Cold"
VAR WP_STARTCMD_STOP;*WP_STARTCMD -parm"SystemStop=Yes"
VAR WP_STARTCMD_COLDSTOP;*WP_STARTCMD -parm"StartMode=Cold;SystemStop=Yes"

DEFINE UC4 WP2;*WP_STARTCMD;*SRV_STARTPATH;START1=(Coldstart,*WP_STARTCMD_COLD);START2=(Systemstop,*WP_STARTCMD_STOP);START3=(Coldstart with Systemstop,*WP_STARTCMD_COLDSTOP)