ServiceManager - Service

The ServiceManager serves to start, stop and access components such as the Automation EngineDiese Komponente steuert ein Automation Engine-System. Besteht aus verschiedenen Serverprozessen. processes or agents from a central point.

The parameters of the ServiceManager (Service) are the same for Windows and UNIX.

Default values have been specified for most parameters. They can be changed if required. Parameters which must be adjusted to your system environment at any case are written in red letters.

Structure of the INI File UCYBSMGR.INI

Section/Parameter Description
[GLOBAL]  
language=

Language in which logging is carried out. Entries for primary and secondary language.

Allowed values: "E", "D", "F"
Default: "E,D" (Primary language English, secondary language German)

If there is no message in the primary language, the secondary language will be searched for a message.

logging= Path and file name of the log file.

The number signs serve as place holders for a series in numerical order. When starting the ServiceManager, the log files are renamed so that the most current log file is always the one with the number "00".

logcount=

Number of stored log files.

helplib=

Path and name of the message file.

helpcache= Availability of the messages and language dependant strings.

Allowed values: "ALL", "NONE", "CONTROLS"
Default: "ALL"

"ALL" = The complete message file is held in the RAM.
"NONE" = Always read from the hard drive.
"CONTROLS" = All language-dependant strings which are necessary for the display of the dialog program are held in the RAM (not relevant for the ServiceManager).

port=

Port number of the ServiceManager.

restart_limit=

Maximum number of automatic start attempts which are processed for a server process within a particular time span.

When the ServiceManager runs on UNIX, an automatic restart takes place for all specified programs (server processes, agents) that end with SIGABRT. The limitation to server processes does not apply in this case.

Format: (<period in seconds>, <number of start attempts>)

Default value: (60,3)

If the second of these two values is "0", no restart will be attempted.

The ServiceManager attempts to restart the server process which has been ended after the occurrence of an invalid message. This parameter specifies the maximum number of attempts within a time span.

restart_delay=

This parameter introduces an additional delay for the restart time defined in restart_limit= The delay defined here will take effect as soon as the process's actually scheduled execution time has been reached.

Format: Delay in seconds.

Allowed values: >0

Default value: 60

password=

Encrypted password of the ServiceManager dialog program

This parameter stores the password you determine via the ServiceManager dialog program's interface in encrypted form.

reuseaddr=

If you set this parameter to "1" the ServiceManager on restart can reuse a port it previously had connected to. Thus restarting the ServiceManager will be faster.

Allowed values: "1"

Default value: "0"

[TRACE]

 

file= Path and file name of the trace file.

The number signs serve as place holders for a series in numerical order. When starting a trace, the trace files will be renamed so that the most current trace file is always the one with the number "00".

trccount=

Number of stored trace files.

cmd=

Trace-flag commands.

Allowed values: "0" to "9"
Default value: "0"

[Destination Phrase]

Section for definition of a ServiceManager environment.

Default value: "UC4"

deffile= Name of the SMD file in which the AE services within the starting sequence are defined.

The path specification "*OWN" designates its own path and is important here as it has to do with a service.

cmdfile= Name of the file which contains commands for the ServiceManager.

This file is automatically applied by the ServiceManager during initial startup and also updated later on. This file is not to be edited manually!

"*OWN" must be used here as a path specification as well.

Example of an INI File (Windows)

[GLOBAL]
language=(D,E)
logging=*OWN\..\temp\SMgr_LOGG_##.txt
helplib=*OWN\uc.msl
helpcache=all
port=8871
restart_limit=(60,3)
password=­­106E1B857FA6B1280E


[TRACE]
file=*OWN\..\temp\SMgr_TRACE_##.txt
cmd=0

[Destination UC01]
deffile=*OWN\UC01.smd
cmdfile=*OWN\UC01.smc

See also:

Setup of the SMD File