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).


ParameterPossible valuesMeaning
AckForValue0/1If 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.
AlarmsWithoutFocus0/1If 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
AllowNonAdminConfLogin0/1If 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.
ControlRightForKvit0/1If 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):
  • 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 thereinafter.
CtrlAckDialog0/1

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

0 - no, 1 - yes.

CtrlCloseAfterSetValue0/1

Auto close control window based on application parameter

0 - no, 1 - yes.

descInTitleBar0/1Displaying 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.
dynamGraphLineType0/1Definition of a graphic flow type for dynamic graphs.
0 - a smooth line, 1 - a straight line.
dynamGraphDescTable0/1Displaying the descriptive table of dynamic graphs.
0 - hide table, 1 - show table.
dynamGraphAllStatistics0/1Displaying all the graphic flows of statistic values in dynamic graphs.
0 - hide graphic flows, 1 - show graphic flows.
dynamGraphMultiArchFALSE/TRUEOpens 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.
dynamGraphPointer0/1Displaying 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.
ExpandTree0/1If 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).
KeepObjectValueAfterSave0/10 - 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_DoNotAllowConsoleOverLimit0/1Disables the logon of the console (HI) if the license limit is exceeded. Default = off (0).
LIC_DoNotAllowSysProcOverLimit0/1Disables the logon of the system process if the license limit is exceeded. Default = off (0).
LIC_PostponeLicWrnToUsersDWORDWhen 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/1Defines 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.

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.
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 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.
SecurityPolicy
0/1If 1 - activation of new rules, if 0 - default behavior during a change of user's password.
ShowConsoleUsers0/1It determines if the users of console type (*.HIP.LOG) will be displayed in the List of objects.
SingleCommand0/1If 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_MinLength0...20Minimal password length.
SP_MinLowerCaseLetters
Minimal count of lower case in the password.
SP_MinNumbers0...10Minimal count of numbers in password.
SP_MinSpecials0...10Minimal count of special symbols (e.g. ! @ # $ % ^ & a pod.) in a password.
SP_MinUpperCaseLetters
Minimal count of upper case in the password.
SP_Similarity0...100The ratio for similarity of the new password to previous ones. The value can be within the interval 0...100.
SP_History0...10The 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_CheckMinCharacters0/1If 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.
SrvApplHelpTypeHelpFileChm

Selection of Application Help Types - NoHelp, HelpFileChm, HelpWebServerConfluence, HelpWebServerHtml, HelpSharedDir, HelpLocalApplDir, HelpLocalAnyPath

SrvApplHelpPath
Set the location of the help by type SrvApplHelpType.
SrvApplHelpMainPage
Default application help page.
SrvD2000HelpTypeHelpWebIPSSelection of help types for D2000 - HelpWebIPS, HelpWebServerHtml, HelpSharedDir, HelpLocalD2000Dir, HelpLocalAnyPath
SrvD2000HelpPathhttps://doc.ipesoft.com/label/D2DOCVSet the location of the help by type SrvD2000HelpType. Popis nastavenia umiestnenia závisí je vysvetlený je nižšie.

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:
  • 0 - the server is a production server, not a test server (default)
  • 1 - the server is a test server: the heading of D2000 HI has a red color
Note: Parameter is implemented since version 7.02.001.
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.
UseServerTimeZone0/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.

XmlGitSharedRepoInRedundancy0/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.

ParameterMeaning
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 **
  • TRUE - for a selected time interval, the following will be valid: StartTime ≤interval<EndTime
  • FALSE - for a selected time interval, the following will be valid: StartTime ≤interval≤EndTime


* 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.


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:

  1. An exception occurs while the item is being processed:    "%%%[src_tree_name]:!EXCEPTION;[name_or_id_key]/[step_enum]"
  2. Name of element is different than the object one:         "%%%[src_tree_name]:elmN<>refN;[src_object];[name_key]"
  3. ID of the element is different than the object one:        "%%%[src_tree_name]:elmI<>refI;[src_object];[id_key]"
  4. Type of the tree is different than the object one:         "%%%[src_tree_name]:TYPE<>refT;[src_object];[tree_type]"
  5. Src element is not in cmp tree:                                  "%%%[src_tree_name]:FIND?[cmp_tree_name];[src_object];null"
  6. Src element is different in cmp tree:                          "%%%[src_tree_name]:ADDR?[cmp_tree_name];[src_object];[cmp_object]"
  7. 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
Napíšte komentár