Parameters for D2000 Server

Parameters for D2000 Server

Parameters for the D2000 Server process

The D2000 Server process reads the following parameters from the system registry during its start. Values are adjusted using the D2000 Application Manager process (D2Smc.exe).

Parameter

Possible values

Meaning

Parameter

Possible values

Meaning

AckForValue

0/1

If the parameter value is 1, every new value in the system will be set to the attribute NoAckValue. An operator can acknowledge that he saw the value in the object control window.

AlarmOnUserModification

0/1

If the parameter value is 1, every modification of the user generates the alarm "UserModifiedWarning"

AlarmsWithoutFocus

0/1

If the value of this parameter is 1, the window opened by a new alarm doesn't take the focus of another window of the HI process

AllowNonAdminConfLogin

0/1

If the value of this parameter is 1, users without administrative rights are allowed to log in to the configuration processes of the D2000 system. The default value is 0. That means non-administrative users can not log in to configuration processes.

AuditDepth_RES_GROUP

 

The value differing from 0 sets the full monitoring of changes in the configuration of the Object group. It represents the time depth of the stored information in months. The value 0 (or absence of parameter) deactivates the monitoring.

AuditDepth_USER

 

The value differing from 0 sets the full monitoring of changes in the configuration of the User. It represents the time depth of the stored information in months. The value 0 (or absence of parameter) deactivates the monitoring.

APPL_NAME

 

Application name.

AuthMethod

 

The default authentication method. The parameter can acquire the following values:

Detailed information about the parameter is mentioned in the topic Authentication in D2000, part AuthMethod.

AuthSecPrinc

 

Security principal for Kerberos authentication.
Detailed information about the parameter is mentioned in the topic Authentication in D2000, part AuthSecPrinc.

BackupSysCfgDeep

 

Depth of configuration database backups that are created automatically. The backups older than the defined depth are automatically deleted. It is defined in seconds.

Note: If the value is 0 (zero), the automatic backup of the configuration database is disabled.

BackupSysCfgOffset

 

A shift of the automatic backup of the configuration database within a given period. It is defined in the format HH:MM, i.e., shift in hours and minutes.

BackupSysCfgPath

 

Path to the directory in which the backups of the configuration database, created automatically, are to be stored. The default setting is %D2000_APP%\%application_name%\SysCfg\Backup.

Note: For proper functionality of the automatic backup of the configuration database, no other directories and files should be created in the directory where these backups are stored.

BackupSysCfgPeriod

 

The period of an automatic backup of the configuration database. it is defined in the format NX, where N is an integer and X is a time unit. The permitted time units are H - hour, D - day, W - week, M - month.

Note: If you set an empty value or 0H, the backup of the configuration database is disabled.

ColorMandatoryItems

 

Background color for a mandatory item in pictures (Text entry field and List box). Default value = FFFFFF – i.e. no background. The color is represented by the number that can be derived from the RGB by the following formula: R + 256*G + 65536*B (see %MakeRGB function)

ColorConditionalItems

 

Background color for a conditional item in pictures (Text entry field and List box). Default value = FFFFFF – i.e. no background. The color is represented by the number that can be derived from the RGB by the following formula: R + 256*G + 65536*B (see %MakeRGB function)

ConfigBackUpTimeout

0...

Maximum time [s] of backup of the configuration database. The backup is executed through the external process.
If the parameter is:
> 0 - The process is ended forcibly if the backup has not been executed successfully within a defined time.
= 0 - The process is ended after the database backup is executed. It can take a very long time when the process is jammed.

ConfigSynchroTimeout

0...

Maximum timeout [s] for synchronizing the configuration database.
If the parameter is:
> 0 - The synchronization is ended forcibly if it has not been finished within a defined timeout.
= 0 - The synchronization can take unlimited time.

ControlRightForKvit

0/1

If the parameter value is 1, a user can acknowledge an alarm only if the user has the access right with the level Control or higher to the alarm. If the value is 0, the user needs the access level with the level Read (default state) only.

character_encoding_APP_DEFAULT

 

Initial character encoding in the application. This parameter is used when there is "@APP_DEFAULT@" encoding in the ESL function. The initial value is "@OS_ACTUAL@".

CheckDODMTreesInterval

 

Defines DODM tree consistency check in regular intervals. A default value is 0 (zero) in seconds. The time of the next processing of the parameter value depends on the parameter value that has been set while processing it (it may be changed while the system is running):

  • value > 0: it starts the DODM tree consistency check and then calculates the time of next processing (clock + interval[s]),

  • otherwise: a check is disabled; the processing starts in a minute (clock + 60[s]).

Start Debug info, via DBG.CHECK.DODM_TREES, to see the information on the process of the DODM tree consistency check.
More detailed reports regarding this activity are mentioned hereinafter.

CtrlAckDialog

0/1

Confirm setting a new value by opening a new window asking: Do you want to set the X value?

0 - no, 1 - yes.

CtrlCloseAfterSetValue

0/1

Auto-close control window based on application parameter

0 - no, 1 - yes.

descInTitleBar

0/1

Displaying of description in the title bar of graphs, reports, pictures, or structures instead of the object name.
0 - hide description (shows object name only), 1 - show description
The parameter is not valid for users with Administrator access rights.

dynamGraphMaxTime

 

Time length [min], which determines the range of the horizontal (time) axis of dynamic graphs.

dynamGraphShiftTime

 

The parameter [min] determines the shift of the time axis of dynamic graphs when drawing a graphic flow reaches the right margin of the axis.

dynamGraphLineType

0/1

Definition of a graphic flow type for dynamic graphs.
0 - a smooth line, 1 - a straight line.

dynamGraphDescTable

0/1

Displaying the descriptive table of dynamic graphs.
0 - hide table, 1 - show table.

dynamGraphAllStatistics

0/1

Displaying all the graphic flows of statistical values in dynamic graphs.
0 - hide graphic flows, 1 - show graphic flows.

dynamGraphMultiArch

FALSE/TRUE

Opens the archive objects in multigraphs.
TRUE - The archive objects are opened in separate multigraphs (default).
FALSE- The archive objects are opened together with other objects in the multigraphs.

dynamGraphPointer

0/1

Displaying the pointer on opening dynamic graphs.
0 - hide the pointer, 1 - show the pointer

HeapArrSizeRef

 

It represents the size of auxiliary "HEAP" arrays. The parameter is set automatically when the application is started for the first time. The default value is 100,000. It enables the optimization of some bulk allocations. The setting is especially important for  XML Import. An example of the log of allocated space for "HEAP" arrays is available here.

ExpandTree

0/1

If the value of the parameter is 1, then all selection windows in the system will consist complete list of logical groups (expanded). If the value is 0, then all the windows will consist list with basic logical groups only (collapsed list).

GraphsOpenMode

0/1

0 - The graphs open in the standard way (HI surface)

1 - The graphs open as dialog windows (desktop surface)

KeepObjectValueAfterSave

0/1

0 - After saving the configuration, the object value is set to "invalid" - (standard behavior - the default value of the parameter).
1 - After saving the configuration, the object value is not invalidated.

LIC_DoNotAllowConsoleOverLimit

0/1

Disables the logon of the console (HI) if the license limit is exceeded. Default = off (0).

LIC_DoNotAllowSysProcOverLimit

0/1

Disables the logon of the system process if the license limit is exceeded. Default = off (0).

LIC_PostponeLicWrnToUsers

DWORD

When a problem with the license occurs, first, only the administrators are informed. When the specified time expires, all users will be informed. The default value is 1 hour. The permitted maximum is limited by the time 
Constant Integer := 10*24; – [hours].

LogRecsLateSynchro

0/1

Defines whether CfgSynchroAuto will be started with or without /NO_OBJLIFE parameter (the object life logs are not synchronized). CfgSynchroAuto is called by D2000 Server, which is in a HOT state when it receives a request for synchronization of the configuration database from another D2000 Server connecting to a redundant group.

Allowed values:
0 - default synchronization
1 - synchronization with /NO_OBJLIFE

Detailed meaning of the parameters for CfgSynchroAuto is described in Synchronization of configuration databases.

LogRecsLimit

DWORD

The parameter specifies the maximum number of object history records that are kept in the configuration database (and can be exported as part of the XML configuration).

The default value is 7 records

LogTrezorPath

 

Path to the directory, where the log database depository will be created.

LogTrezorCompressPath

 

Path to the directory for storing compressed log database depositories.

LogTrezorCompressTime

 

Time period, during which the disconnected log database depository is available for writing delayed data. The database will be compressed after the expiration of this period. The value of the parameter LogTrezorCompressTime must be less than the value of the parameter LogTrezorPeriod. It is given in the format NX, where N is an integer number and X gives a time unit.
Permitted time units: H - hour, D - day, W - week, M - month.

LogTrezorPeriod

 

Period for creating the log database depository. It is given in the format NX, where N is an integer number and X gives a time unit.
Permitted time units: H - hour, D - day, W - week, M - month.
Zero value (e.g. 0H) disables the log database depository. The default value of this parameter is 0H.

MailingAddress

 

The email address to which the user can send the application error information.

MaxMonitorItems

 

The maximal number of items that the process D2000 Server gives to the process D2000 HI on request for the list from the log database.

NewClientsAllowed

 

The parameter allows you to limit the dynamic creation of new static processes to specified types, which can be used as part of application hardening.

If it is empty, the D2000 Server will connect a client of any type (e.g. CNF process MyUser.CNF) and create the corresponding process in the configuration database. If it is not empty, it must contain the listed process types (suffixes, e.g. CNF, HIP, GRE) so that the D2000 Server will connect the client and create the corresponding process in the configuration database.

Example: if NewClientsAllowed contains only the HIP string, it is not possible to connect to the D2000 Server with a GRE process (e.g. MyComp.GRE) if it did not previously exist in the configuration database.

List of all static process types:
HIP, GRE, API, KOM, CNF, ALA, ARC, CLC, GTW, EVH, PNK, UPM, BRW, XLW, SWP, TPL, DBM, SMC, TEL, EVV, KNL, OPC, OUS, SAS, TTS, TCD, EDS, DCS, RRS, SES, DCP, SGC, EMS, WSC

Note: This parameter does not allow for restricting dynamic process types

  • with dynamic names: TCL, WBK, ODB, VBA, EDA, ISS

  • with static names: SCO, DCC, EDC, SEE, HIS, SWR, SWC, DMC, ACL

Its primary purpose is to limit the connection of system processes without a user interface (ARC, KOM, EVH, CLC, GTW, DBM, TPL, API, SWP, KNL, OPC, OUS, RRS, EDS, DCP, SGC, EMS, WSC).

numLastUsers

 

The number of last entered users in the list of Logon dialog box of HI and GrEditor - max. 10.

If the number is equal to 1, a text box is displayed instead of a list box.
If the number is greater than 1, the list of the last entered <numLastUser> users is displayed.

OEM_ProtX_Name

 

Name of OEM protocol nr. X, as will be displayed in the D2000 CNF environment.
For more details, see the description of the D2000 KomAPI interface.

OEM_ProtX_DLL

 

Name of a dynamic library (.dll on Windows, .so on Linux), in which the communication protocol OEM nr. X is implemented. The name is specified without a suffix.
For more details, see the description of the D2000 KomAPI interface.

OldMasks

 

Change of the format masks behavior.
0 - The character # after the decimal point means that the occurrence of the number is not required
1 - The character # after the decimal point is identical with the character 0 (required number occurrence) - compatible with D2000 v5.0 and older versions.

RouteArchiveMessages

0/1

The parameter enables message routing for the D2000 Gateway. Messages for the INSERTARCHARR, DELETEARCHDATA, UPDATEARCHVAL actions and user changes to archive values ​​will be routed - see description for more information.

SecurityPolicy

0/1

If 1 - activation of new rules, if 0 - default behavior during a change of the user's password.

ShowConsoleUsers

0/1

It determines if the users of the console type (*.HIP.LOG) will be displayed in the List of objects.

SingleCommand

0/1

If the value of this parameter is 1, just one control window can be opened for one object at the same time in the process D2000 HI.

SP_MinLength

0...20

Minimal password length.

SP_MinLowerCaseLetters

 

Minimal count of lower case in the password.

SP_MinNumbers

0...10

Minimal count of numbers in the password.

SP_MinSpecials

0...10

Minimal count of special symbols (e.g. ! @ # $ % ^ & a pod.) in a password.

SP_MinUpperCaseLetters

 

Minimal count of uppercase characters in the password.

SP_Similarity

0...100

The ratio for the similarity of the new password to previous ones. The value can be within the interval 0...100.

SP_History

0...10

The number of previous passwords that will be compared with the new password.

SP_AccountLockoutDuration

 

Time [s], which determines how long a user's account will be blocked, when the user exceeds the permitted count of logons.

SP_AccountLockoutTreshold

 

The number of permitted invalid logons. If the number is exceeded, the user's account will be blocked for the time defined by the parameter SP_AccountLockoutDuration. If the value of the parameter SP_AccountLockoutTreshold is 0, the user's account will never be blocked.

SP_MaxConsecutiveCharacters

 

The maximum number of consecutive characters included in the password.

SP_CheckMinCharacters

0/1

If the value is 1 - the number of digits and non-digits in the password is also to be checked. In this case, the value of the parameter SP_MinNumbers defines the minimum number of both digits and non-digits.

SrvApplHelpType

HelpFileChm

Selection of Application help type:

  • NoHelp

  • HelpFileChm

  • HelpWebServerConfluence

  • HelpWebServerHtml

  • HelpSharedDir

  • HelpLocalApplDir

  • HelpLocalAnyPath

For an explanation, see below

SrvApplHelpPath

 

Application help location setting (depending on the type specified by SrvApplHelpType). The description of the location setting is explained below

SrvApplHelpMainPage

 

The default application help page in an application using application help. It also opens in pictures (schemes) that do not have application help set in some other way (in the scheme configuration, by inheriting from the main scheme,...).

SrvD2000HelpType

HelpWebIPS