Parameters for D2000 Server
English
SlovenskyParameters 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 |
|---|---|---|
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 |
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. |
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. |
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. |
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. |
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. |
ConfigSynchroTimeout | 0... | Maximum timeout [s] for synchronizing the configuration database. |
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):
Start Debug info, via DBG.CHECK.DODM_TREES, to see the information on the process of the DODM tree consistency check. |
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. |
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. |
dynamGraphDescTable | 0/1 | Displaying the descriptive table of dynamic graphs. |
dynamGraphAllStatistics | 0/1 | Displaying all the graphic flows of statistical values in dynamic graphs. |
dynamGraphMultiArch | FALSE/TRUE | Opens the archive objects in multigraphs. |
dynamGraphPointer | 0/1 | Displaying the pointer on opening dynamic graphs. |
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). |
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 |
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: |
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. |
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. |
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: Note: This parameter does not allow for restricting dynamic process types
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. |
OEM_ProtX_Name |
| Name of OEM protocol nr. X, as will be displayed in the D2000 CNF environment. |
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. |
OldMasks |
| Change of the format masks behavior. |
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:
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 | Selection of D2000 help type:
For an explanation, see below. |
SrvD2000HelpPath | The D2000 help location setting (depending on the type specified by SrvD2000HelpType). The description of the location setting is explained below. | |
TCP_NO_DELAY | DEFAULT | During registration of every client connecting via TCP/IP protocol (start parameters /TP or /TPP), the process D2000 Server can change the value of the socket parameter TCP_NODELAY to TRUE/FALSE. More details are available in the description of the TCP_NO_DELAY command. |
TestVersion | DWORD 0 .. 10 | The color distinction of production and test server in the process D2000 HI:
 Note: Parameter is implemented since version 22.0.76 |
TNS_Service_Name |
| Configuration parameter for the configuration and log databases on the Oracle platform - defines the TNS of the database with the configuration and log tablespaces. |
UseServerTimeZone | 0/1 | Allows the client processes to use the server time zone offset (KERNEL). By default, each process uses its system time zone offset. |
ValuesToInstanceKoms | 0/1 | In case of multiple instance KOM processes, new values of I/O tags from one (active) will be forwarded to other KOM processes (passively, or actively, if the Active-Active Instance mode is enabled). This way, all KOM processes will have the latest values of I/O tags available. |
WinDisColorUse |
| Indication for the usage of the color defined in WinDisColorValue as the color for disabled window controls in schemes. |
WinDisColorValue |
| Colour in disabled window controls in schemes (text input, buttons, trees, and lists). |
XmlGitRepositoryEnabled | 0/1 | If the value is 1 and the path to the GIT repository is set - all changes to objects in D2000 are stored in the GIT object history |
XmlGitRepositoryPath |
| Path to the GIT repository where all changes to objects are stored. |
XmlGitSharedRepoInRedundancy | 0/1 | If the value is 1 and the system is in redundant mode, and storing changes into the GIT repository is enabled, all changes are written only by the active (hot) server |
The following four parameters allow setting the logical beginning and end of the day for the application. The settings have an effect on the dialog boxes for defining a time interval - when you define time interval, hours and minutes are to be adjusted according to the parameters.
Parameter | Meaning |
|---|---|
day_start_hour * | The hour of the beginning of the day. Default value: 0. |
day_start_min * | The minute of the beginning of the day. |
day_end_hour * | The hour of the end of the day. |
day_end_min * | The minute of the end of the day. |
day_end_strong_ineq ** |
|
* Example - technological day begins at 06:00 o'clock and ends the next day at 06:00 o'clock.
day_start_hour = 6
day_start_min = 0
day_end_hour = 30
day_end_min = 0
** Example - user selects the entire day of January 1st 2005:
if day_end_strong_ineq=TRUE, then StartTime=1.1.2005 00:00:00.000 and EndTime=1.1.2005 23:59:59.999
if day_end_strong_ineq=FALSE then StartTime=1.1.2005 00:00:00.000 and EndTime=2.1.2005 00:00:00.000
Note:: Individual parameters of the process D2000 Server can be changed after selecting the particular parameter in the right part of the window and pressing Enter, or after double-clicking the parameter.
Setting up the system help in D2000
The setup consists of 2 parts:
By entering the keyword in SrvD2000HelpType
By defining the help location in SrvD2000HelpPath. Locations are somewhat relative, and the resulting path is composed according to the rules described below. The addition depends on the type of help given by the keyword and is described in the table. Links to specific help pages are then added to the calculated path. Some paths are predefined and cannot be changed. The reason for using "relative" paths is the possibility of using multilingual help depending on the language used by the user on their console and help for different versions.
Note: For a specific user, it is still necessary to set the help parameters in the D2000 HI, in the Help Settings. There, it is possible to specify the use of server settings or enter custom settings that are subsequently used in the D2000 HI, D2000 Cnf, and D2000 GrEditor processes.
Note: Offline documentation (zip) is available for environments that are not connected to the Internet.
Keyword | Meaning | SrvD2000HelpPath - Help location setting |
|---|---|---|
HelpWebIPS | Web server Ipesoft (Confluence) - current help available on the website of Ipesoft s.r.o. It is continuously updated. | The path is defined by the text "https://doc.ipesoft.com/label/D2DOCV" and cannot be changed. The final destination path is supplemented as follows: the D2000 version is added to the path, e.g., 22, and the language of the help, e.g., EN. Example of the resulting location: https://doc.ipesoft.com/label/D2DOCV22EN/ |
HelpWebServerHtml | Web server (HTML) - help available through a website. | The path leads to the Internet address. It is necessary to specify it. E.g.: https://MyWebsite/help The physical location is supplemented as follows: the help language is added to the path, for example, EN + keyword label Example of the resulting location: https://MyWebsite/help/EN/label |
HelpSharedDir | Shared directory (HTML). A directory with help located on a network share, common to multiple D2000 system consoles that have access to it. | The path points to any location on the network drive. It is necessary to enter it. E.g: S:\D2000_HELP. The physical location is supplemented as follows: the help language is added to the path, for example, EN + keyword label Example of the resulting location: S:\D2000_HELP\EN\label |
HelpLocalD2000Dir | HELP directory of D2000 installation (HTML) | The path points to the location of the D2000 installation and cannot be changed. E.g: C:\D2000\D2000_V22.0.76\D2000_EXE\HELP. The physical location is supplemented as follows: the help language is added to the path, for example, EN + keyword label Example of the resulting location: C:\D2000\D2000_V22.0.76\D2000_EXE\HELP\EN\label\ |
HelpLocalAnyPath | Local directory (HTML) A directory with help located on a local or network drive that can be accessed by the console of the D2000 system. | The path points to any location on the local disk. It is necessary to enter it. E.g: C:\D2000_HELP. The physical location is supplemented as follows: the help language is added to the path, for example, EN + keyword label Example of the resulting location: C:\D2000_HELP\EN\label\ |
The language of help
When opening the help, the language of the help is selected according to the language used by the user on the client process (HI, CNF,...) The following labels are allowed:
SK - for Slovak and Czech languages
EN - for other languages
Setting up the application help in D2000
The setup consists of 2 parts:
By specifying the keyword in SrvApplHelpType
By defining the help location in SrvApplHelpPath. The locations are relative in a way, and the resulting path is composed according to the rules described below. The addition depends on the type of help given by the keyword and is described in the table. Links to specific help pages are then added to the calculated path. Some paths are predefined and cannot be changed. The reason for using "relative" paths is the possibility of using multilingual help depending on the language used by the user on their console and help for different versions.
Note: For a specific user, it is still necessary to set the help parameters in the D2000 HI, in the Help Settings. There, it is possible to specify the use of server settings or enter custom settings that are subsequently used in the D2000 HI, D2000 Cnf, and D2000 GrEditor processes.
Keyword | Meaning | SrvApplHelpType - Help location setting |
|---|---|---|
NoHelp | Without help | Not specified. |
HelpFileChm | HELP application directory (CHM). Help type chm is used. | The path points to the location of the HELP directory in the D2000 application directory and cannot be changed. E.g: C:\D2000\D2000_V22.0.76\D2000_APP\Demo\HELP |
HelpWebServerConfluence | Web server (Confluence) - help available through a website created in Confluence. | The path leads to the Internet address. It is necessary to specify it. Physical location is final and must comply with Confluence rules. |
HelpWebServerHtml | Web server (HTML) - help available through a website. | The path leads to the Internet address. It is necessary to specify it. E.g.: https://MyWebsite/help The physical location is supplemented as follows: the help language is added to the path, for example, EN + keyword label Example of the resulting location: https://MyWebsite/help/EN/label |
HelpSharedDir | Shared directory (HTML). A directory with help located on a network share, common to multiple D2000 system consoles that have access to it. | The path points to any location on the network drive. It is necessary to enter it. E.g: S:\MY_HELP. The physical location is supplemented as follows: the help language is added to the path, for example, EN + keyword label Example of the resulting location: S:\MY_HELP\EN\label |
HelpLocalApplDir | HELP application directory (HTML) | The path points to the location of the HELP directory in the D2000 application directory and cannot be changed. E.g: C:\D2000\D2000_V22.0.76\D2000_APP\Demo\HELP The physical location is supplemented as follows: the help language is added to the path, for example, EN + keyword label Example of the resulting location: C:\D2000\D2000_V22.0.76\D2000_APP\Demo\HELP\EN\label |
HelpLocalAnyPath | Local directory (HTML) A directory with help located on a local or network drive that can be accessed by the console of the D2000 system. | The path points to any location on the local disk. It is necessary to enter it. E.g: C:\MY_HELP. The physical location is supplemented as follows: the help language is added to the path, for example, EN + keyword label Example of the resulting location: C:\MY_HELP\EN\label\ |
The language of help
When opening the help, the language of the help is selected according to the language used by the user on the client process (HI, CNF,...) The following labels are allowed:
SK - for Slovak and Czech languages
EN - for other languages
When Debug info is activated via DBG.CHECK.DODM_TREES for this activity, these messages are written into the D2000 Server log:
CheckDODMTreesConsistency.START[All:N=<name_tree_count>,T=<type_trees_count>,I=<id_trees_count>]
CheckDODMTreesConsistency.END[Static:N=<name_tree_count>,T=<type_trees_count>,I=<id_trees_count>]
Start means the beginning of the DODM tree consistency check, with the number of items in all trees.
End means the end of the DODM tree consistency check, with the number of items in all trees.
The following messages (errors) may occur:
An exception occurs while the item is being processed:
"%%%[src_tree_name]:!EXCEPTION;[name_or_id_key]/[step_enum]"Name of element is different than the object one:
"%%%[src_tree_name]:elmN<>refN;[src_object];[name_key]"ID of the element is different than the object one:
"%%%[src_tree_name]:elmI<>refI;[src_object];[id_key]"The type of the tree is different than the object one:
"%%%[src_tree_name]:TYPE<>refT;[src_object];[tree_type]"Src element is not in the cmp tree:
"%%%[src_tree_name]:FIND?[cmp_tree_name];[src_object];null"Src element is different in the cmp tree:
"%%%[src_tree_name]:ADDR?[cmp_tree_name];[src_object];[cmp_object]"An exception for a complete check:
"CheckDODMTreesConsistency.END[EXCEPTION]"
The messages are written into the D2000 Server log.
These reports may be imported in the form of CSV data into MS Excel.
For elements of the name tree, it can print the messages 1/2/3, or 5/6 when comparing with the ID tree.
For elements of the type tree, it can print the messages 1/3/4, or 5/6 when comparing with the ID tree.
For elements of the ID tree, it can print the messages 1/3, or 5/6 when comparing with the name or corresponding type tree.
The log of allocated space for "HEAP" array after starting the application with parameter HeapArrSizeRef - value 100 000:
[05-08-2010 13:22:48] RecRef.HeapArrayCore_COL_REF.Initialize: HeapArray is allocated with size = 5200008.
[05-08-2010 13:22:48] RecRef.HeapArrayCore_COL_REFs.Initialize: HeapArray is allocated with size = 2800008.
[05-08-2010 13:22:48] RecRef.HeapArray_ColRefName.HeapElementArray.Initialize: HeapArray is allocated with size = 6800008.
[05-08-2010 13:22:48] RecRef.HeapArray_ColRefIdx.HeapElementArray.Initialize: HeapArray is allocated with size = 3200008.
[05-08-2010 13:22:48] RecRef.HeapArrayCore_TData.Initialize: HeapArray is allocated with size = 16000008.
[05-08-2010 13:22:48] RecRef.HeapArray_HobjRefTObjName.HeapElementArray.Initialize: HeapArray is allocated with size = 10000008.
[05-08-2010 13:22:48] RecRef.HeapArray_HobjRefHOBJ.HeapElementArray.Initialize: HeapArray is allocated with size = 3200008.
[05-08-2010 13:22:48] RecRef.HeapArray_HobjRefD2UID.HeapElementArray.Initialize: HeapArray is allocated with size = 10000008.
[05-08-2010 13:22:48] HeapArray total allocated size: 57200064 bytes
Related pages: