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 process D2000 Application Manager (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. |
| 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 | 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 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 automatic backup of configuration database in a given period. It is defined in the format HH:MM, i.e. shift in hours and minutes. | |
| BackupSysCfgPath | Path to directory in which the backups of configuration database, created automatically, are to be stored. Default setting is %D2000_APP%\%application_name%\SysCfg\Backup. Note: For proper functionality of automatic backup of configuration database, no other directories and files should be created in the directory where these backups are stored. | |
| BackupSysCfgPeriod | Period of an automatic backup of the configuration database. it is defined in the format NX, where N is 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 in a defined time. = 0 - the process is ended after the database backup is executed. It can take very long when the process is jammed. |
ConfigSynchroTimeout | 0... | Maximum time [s] of synchronizing of the configuration database. If the parameter is: > 0 - the synchronization is ended forcibly if it has not been finished in a defined time. = 0 - the synchronization can take unlimited time. |
| ControlRightForKvit | 0/1 | If the parameter value is 1, a user can acknowledge an alarm only if he/she 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 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):
More detailed reports regarding this activity are mentioned thereinafter. | |
| 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], that 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 statistic 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). |
| 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 the administrator is informed until this time expires. After this, 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: |
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 disconnected log database depository is available for writing delayed data. The database will be compressed after the expiration of this period. The value of 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. | |
| 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. 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 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 user's password. |
| ShowConsoleUsers | 0/1 | It determines if the users of 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 password. |
| SP_MinSpecials | 0...10 | Minimal count of special symbols (e.g. ! @ # $ % ^ & a pod.) in a password. |
| SP_MinUpperCaseLetters | Minimal count of upper case in the password. | |
| SP_Similarity | 0...100 | The ratio for 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, which are to 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 to be also 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 | 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 | https://doc.ipesoft.com/label/D2DOCV | D2000 help location setting (depending on the type specified by SrvD2000HelpType). The description of the location setting is explained below. |
TCP_NO_DELAY | DEFAULT TRUE FALSE | 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. If the value of the TCP_NO_DELAY parameter is not set or is equal to DEFAULT, parameter TCP_NODELAY will not be changed. |
TestVersion | The color distinction of production and test server in the process D2000 HI:
| |
| TNS_Service_Name | Configuration parameter for the configuration and log databases on Oracle platform - defines TNS of the database the configuration and log tablespaces are in. | |
| 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. |
| WinDisColorUse | Indication for the usage of the defined color in WinDisColorValue as the color in disable wincontrols in schemes. 0 - no 1 - yes | |
| WinDisColorValue | Colour in banned window controls in schemes (text input, buttons, trees, and lists). 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) | |
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 GIT repository where all changes of 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 * | Hour of the beginning of the day. Default value: 0. |
| day_start_min * | Minute of the beginning of the day. |
| day_end_hour * | Hour of end day. |
| day_end_min * | Minute of end 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 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 his 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, D2000 GrEditor processes.
| 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 mutation 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 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 his 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, 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 mutation 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
Parameter CheckDODMTreesInterval - detailed reports
When Debug info is activated via DBG.CHECK.DODM_TREES for this activity, these messages are written into 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 containing all items in each tree.
End means the end of DODM tree consistency check containing the static items in each tree.
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]" - Type of the tree is different than the object one:
"%%%[src_tree_name]:TYPE<>refT;[src_object];[tree_type]" - Src element is not in cmp tree:
"%%%[src_tree_name]:FIND?[cmp_tree_name];[src_object];null" - Src element is different in cmp tree:
"%%%[src_tree_name]:ADDR?[cmp_tree_name];[src_object];[cmp_object]" - An exception for complete check:
"CheckDODMTreesConsistency.END[EXCEPTION]"
The messages are written into D2000 Server log.
These reports may be imported in the form of CSV data into MS Excel.
The messages relating to the name tree elements are a/b/c, or e/f when the name tree is compared with ID tree.
The messages relating to the type tree elements are a/b/c, or e/f when the type tree is compared with ID tree.
The messages relating to the ID tree elements are a/c, or e/f when the ID tree is compared with the name tree or type one.
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:
Pridať komentár