ServiceManager

-c

Command that is to be processed.
This parameter must always be specified.

GET_PROCESS_LIST

Requests a list of all services belonging to a ServiceManager environment on a computer together with the available information.

START_PROCESS

Starts a service

STOP_PROCESS

Stops a service

-h

Computer
This parameter must always be specified.

Computer name

Name of the computer on which the ServiceManager is to be handled.

A remote computer can also be used. This computer must be available from the computer which is calling it. The user must be authorized to access services on this remote computer.

Port number 

In UNIX, the port number of the ServiceManager must additionally be indicated.

-n

ServiceManager environment.
This parameter must always be specified.

Phrase

Name of the ServiceManager environment which summarizes/outlines the various AE services on a computer. In the dialog program of the ServiceManager, this is designated as a phrase.

-s

Service.
This parameter must always be specified, with the sole exception of GET_PROCESS_LIST.

Name of the service

Specification of the name of a service

Available in the following places:

• it is shown in the "Service" column of the dialog program
• it is listed in the definition file Phrase.SMD
• in the output of the command  GET_PROCESS_LIST

Since a service name can also contain spaces, it should always be entered within quotation marks.

-m

End mode.
This parameter is optional for STOP_PROCESS.

Stop mode

Way in which a service should be ended

Allowed values: "C" (default value), "S", "A"
"C" = Close. The service ends normally.
"S" = Shutdown. The service stops immediately independent of ongoing tasks.
"A" = Abnormally. The service is immediately stopped by the ServiceManager through a system call (kill). Use this command only when attempts by the service to stop itself were not successful.

-p

Password.
This parameter is optional for START_PROCESS and STOP_PROCESS. For information on encrypting passwords, see Encoding Passwords.

Password

Password for service start and stop authorization.

The start mode of server work processes (WPs)

The values that are allowed for the parameter -sm depend on the service definition in the ServiceManager's SMD configuration file.
To ensure that a specific start mode can be assigned to the WP when it starts, you must set START1=, START2=, START3= ... in the SMD file for each DEFINE of a WP service. The supplied SMD file UC4.SMD includes some sample definitions.

For example, the definition of a WP service in an SMD file (including variables):

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)

For this WP service, the following values can be used for the parameter -sm

"Coldstart" = Cold start mode
"Systemstop" = Normal start. The system is stopped for this purpose.
"Coldstart with Systemstop" = Cold start including a system stop.

Service

The name of the service.

Status

Service status.
"R" = Running. Service is active.
"S" = Stopped. Service ended.

ProcID

Process number of a service
Only information pertaining to active services (Status = R) will be displayed.

Starttime

The start date and time of a service.
Format: "YYYY-MM-DD HH:MM"
Only information pertaining to active services (Status = R) will be displayed.

Runtime

The runtime of a service.
Format: "DD/HH:MM"
Only information pertaining to active services (Status = R) will be displayed.

CPU Time

The CPU time that a service requires.
Format: "DD/HH:MM:SS:HS"
HS represents hundredths of seconds
Only information of active services (Status = R) will be displayed.

0

A command has been processed without an error.

1

An incorrect command has been entered.

2

No active ServiceManager has been located on the specified computer.

Possible reason:
Either the name of the computer was not entered, or no ServiceManager is active on this computer.

3

The ServiceManager reacts to a command in an unexpected way.

Possible reason:
The ServiceManager version is not up to date.

4

Errors occurred with the ServiceManager connection.

5

The specified ServiceManager environment is not present on the corresponding computer.

Possible reason:
The ServiceManager for the specified ServiceManager environment is either not installed or not started.