Start parameters of processes

Start parameters can be used to start processes. During the process configuration, these parameters are defined by means of the button Parameters in the configuration dialog box or in file Start Parameters (Processes)#default.arg. The parameters may be set also in the registry on a computer with D2000 Server to which the process is connecting.

The following table includes the overview of the start parameters for processes.

ParameterParameter validityMeaning
/?

/h

All client processes of the D2000 systemDisplays the list of permissible parameters along with an explanation of their meaning for the existing process.
When this parameter is set, all other start parameters will be ignored. After writing up a text with an explanation for the process, this process will be ended.
/AF<Method>
D2000 HI, D2000 GrEditor, D2000 CNF, D2000 Application Manager, D2000 DDE Server, D2000 System Console, D2000 Tell, D2000 BrowserForces another authentication method for verification of a user's identity than the authentication method required by the process D2000 Server.
Value of <Method> parameter can beTo use a specific authentication method, it must be permitted for the in his configuration (parameter Authentication methods).
/AN<Name>
D2000 HI, D2000 GrEditor, D2000 CNFName is the name of a D2000 system user for automatic login into the process after starting the process. If the /AP parameter is not entered, the name is added into the login window and a password will be required.

--ANONYMIZEPERIOD=<seconds>

D2000 DBManagerThe parameter sets time period in seconds of anonymization and table rows deletion. Default value is 3600 seconds (1 hour).
--ANSI
D2000 GateWay Client, D2000 GateWay ServerThe parameter enforces the Windows 1250 encoding for transmitted texts. If it is not entered, the texts use UTF8 encoding. The parameter must be used providing that the communication partner is of older version than 9.X and the text values are transmitted.
/AO<NameOfPicture>D2000 HI, D2000 GrEditorNameOfPicture is the name of picture opened after +1. logon into the process

/AP<Password>

D2000 HI, D2000 GrEditor, D2000 CNF

Password is the user's password for automatic login into the process after starting the process. /AP means that the password is an empty string.

The parameter is also used when changing the access password to the configuration database by the kernel.exe process.

/AS D2000 HI, D2000 GrEditorDisables the synchronization of bitmaps when starting the process.
/ASE D2000 System ConsoleEnables switching the HOT server (manual or automatic).
/ASG<group> D2000 System ConsoleAutomatic HOT server switching. The parameter group defines the name of a redundant group.
/ASI<interval> D2000 System ConsoleAutomatic HOT server switching. The parameter interval defines the time interval, after the lapse of which the HOT server is to be switched.
/B<BkpNr> D2000 ServerBkpNr is the number of configuration database backups. Database backups is generated when starting the process. The parameter /B0 causes no generation of the backup. The number of backups (value of the parameter BkpNr) can be within 0...3. If the parameter is not entered, there are automatically used the parameters /B0 for the process D2000 Server.
--batch_mode
D2000 Event HandlerParameter modifies an interpretation of DB_SET_PROCESS_PARAMS.
/C<ApplName>
D2000 ServerApplication name.
/CTAll client processes of D2000 systemThe process will use the time of the computer, where it is started. If the parameter is not entered (Default), the process will use the time of the computer where the D2000 Server is running.
/DBCA
D2000 ArchivThe process D2000 Archiv in the active mode deletes old data from the archive database and reorganizes it (in redundant systems, the process must be also connected to HOT Server).
/DBCP
D2000 ArchivThe process D2000 Archiv in the passive mode deletes old data from the archive database and reorganizes it (or passive mode in redundant systems, but the process must be connected to SBS Server).
/DBCS
D2000 Archiv (only for Oracle database)The process D2000 Archiv will use ALTER TABLE SHRINK SPACE instead of SQL command ALTER TABLE MOVE for reorganization (this command is available only for Oracle 10g and above).
/DBCY
D2000 ArchivEnables the reorganization of the archive database. If the process D2000 Archiv is not started with the parameter, the process deletes old data from the archive database but doesn't reorganize the archive tables (for reasons of backward compatibility before the implementation of the reorganization features).
/DBCY
D2000 DBManager

Enables the debug information on the status of the Oracle cluster.
The parameter can be used only when the database TNS points to the cluster and contains the FAILOVER section (recovering the connection after one of the instances of the Oracle cluster fails). If the FAILOVER section is not included in the database TNS, no debug information will be generated on a failure or disconnecting of a cluster instance.

Warning: The parameter can be used just for dbmanager_ora.exe.

/DBCP D2000 ArchivOnly in passive mode, the process D2000 Archiv can delete old data from the archive database and reorganize it (ORACLE).
/DBD<number_of_days> D2000 ArchivThe process D2000 Archiv limits the maximum archive depth to the number of days defined by the parameter <number_of_days>.
The limitation is to be applied to all objects of Historical values, no matter how the objects are configured.

/DBD<version>

D2000 KOM

When the parameter is entered, the D2000 KOM process will report the specified version of the KomAPI interface (VerLo item in the InitParams structure) during the initialization of the OEM protocols. Attention - in fact the interface does not change, so OEM protocols may not work correctly if they use non-existent InitParams structure items or items that were moved or changed when the interface version was changed.

/DBD<number_of_requests>
D2000 DBManagerThe process D2000 DBManager will log performance warnings when a number of requests queued for a non-transactional connection exceed the value number_of_requests. This parameter can be used for performance tuning. More...
/DBIV<flag> D2000 ArchivThe process D2000 Archiv ignores all values with the same flag as defined by the parameter <flag>.
The parameter can be used to ignore several flags at the same moment (e.g. the process started with the parameter /DBIVI /DBIVG ignores all values with the flags of I or G).
/DBPO
D2000 ArchivActivates the archive attribute (Archiv keeps only primary data). Requests for recalcs of the statistic and calculated archive objects are ignored.
Parameter can be controlled by TELL command SET_OPTION DBPO ON/OFF.

/DBS<size>

D2000 DBManager

Support for long strings (e.g. for working with CLOB columns of Oracle database). By default, D2000 DBManager works with strings up to 4000 characters long. With this parameter, a reserved maximum size for a string can be changed.
Note: An increase in reserved size will affect memory consumption.

/DBSH
D2000 ArchivThe process D2000 Archiv shares the archive database with another process D2000 Archiv (e.g. at work with database cluster). There are 2 possible configurations:
  1. Two (or more) archive processes (SELF.ARC), where one is connected to the HS Server, the other (s) is connected to SBS Server (s). If SELF.ARC is connected to the SBS Server, it works in the ReadOnly mode. If it is connected to the HS Server, works as usual.
  2. Two (or more) instance archive processes (SELF.ARC_1, SELF.ARC_2, etc.), that are connected to the HS Server. The active instance works as usual, the passive one (s) works in the ReadOnly mode.

/DBSH

D2000 DBManagerThe parameter is meaningful only in redundant systems.
The process D2000 DBManager will close all databases connections if
  • its D2000 server changes its state to SBS
  • DbManager is run as an instance (supported since version D2000 8.0) and the instance becomes passive
When the server changes its status to HS again (resp. when the instance becomes active), the connections to the databases will be restored.

Note: Without the parameter /DBSH in a redundant system with two (or possibly more according to the degree of redundancy) processes D2000 DBManager it is necessary to consider the fact that a total number of open database connections may be as much as twice the value in a non-redundant system. That can cause problems, e.g. for the Oracle database if the value of the pfile parameter processes is not sufficiently large.

/DBSH

D2000 KOM

For Serial, Serial Line Redundant, and Modem communication lines, it causes the serial port to be closed if the D2000 KOM process is connected to the SBS Server or if the D2000 KOM process becomes a passive instance. See note for more information.

/DBX

D2000 DBManager

If the parameter is specified, when working with a PostgreSQL database with BLOB fields (BYTEA), these will be read/written in hexadecimal format - DbManager will convert individual letters into hex code according to the ASCII table, i.e. if the string "ABC" is in the BLOB, it will be read as "414243".

/DC D2000 HIDisables the cache for pictures. The aim is to decrease the memory requirements of the process at the expense of slowing down the picture opening.
--DEFAULT-TOOLBAR-COLOR D2000 HIPaint toolbars using default grey color. If not specified, toolbars are painted white.
/DG D2000 HIDecreases the memory requirements of the process at work with graphs at the expense of slowing down the drawing of graphs which contains a lot of data.
/DI D2000 HI, D2000 GrEditor, D2000 ArchivShows specialized information (debug info) when starting the process.
/DL D2000 HI, D2000 GrEditorEnables writing the contents of Listener window to *.LOG file (HI.LOG or GRE.LOG).
/DM<nickname>
D2000 Server

Developer mode: enables the parallel running of several D2000 Server processes on one computer for development purposes. The value of <nickname> will be displayed in the topic of text console window of the D2000 Server process (if the console window is visible, see the parameter /X) and it will be also added to the name of shared memory used for interprocess communication.
To avoid collision and change the standard number of TCP port (3119) all processes D2000 Server (with the exception of a single one using standard TCP port 3119 and standard name of shared memory) must be run using the parameters /P and /DM.
Example:

ServerA: kernel.exe /P:1001 /CApp1 /DMThisIsApp1
ServerB: kernel.exe /P:1002 /CApp2 /DMThisIsApp2

local connection to ServerA via shared memory: hi.exe /P:1001 /DMThisIsApp1
local connection to ServerB via shared memory: hi.exe /P:1002 /DMThisIsApp2

local connection to ServerA via TCP/IP: hi.exe /P:1001 /TP
local connection to ServerB via TCP/IP: hi.exe /P:1002 /TP

remote connection to ServerA: hi.exe /Sserver_name /P:1001 /TP
remote connection to ServerB: hi.exe /Sserver_name /P:1002 /TP

Note: Starting with version 7.02.006, the process D2SMC supports parameters /DM and /P. Multiple instances of D2SMC can be executed, each of them connected to a different D2000 Server running in developer mode.

/DP
Processes with text console(Debug Pipe) – The process will display the course of communication with the D2000 Server.
/DPA
/DPP
/DPR
D2000 HI, D2000 GrEditorMode of receiving messages from the process D2000 Server:
/DPR - when receiving
/DPP - before processing
/DPA - both the modes
/DUMP
/DUMP_MEDIUM
/DUMP_FULL
All client processes of D2000 systemThe monitoring process procdump.exe is started up along with the given process. It monitors the unhandled exceptions that may occur in the given process. If the process crashes due to this exception, a dump file is created in the log file of the D2000 system (subdirectory dumps). The dump file contains the information about the process at the time of its crash, from which a user may determine the reason for the crash.
Size of dump file and contents depend on the used parameter:
  • /DUMP - generates the file with the basic information about the process, such as threads and their call stacks. The size of this file is quite small. Mostly, the information in this file is sufficient for analyzing the reasons for the crash.
  • /DUMP_MEDIUM - generates the file with the information about the process and a part of memory that is formed by the heap. The size of this file is bigger than when using /DUMP parameter.
  • /DUMP_FULL - generates the file containing the full process image at the time of the crash. The size of this file can be very large (equal to the size of the process in memory). Use this parameter only in extraordinary situations!
/DWProcesses with text consoleNot minimizing the text window of the process after starting. If the parameter is not defined, the window will be minimized after starting.
/E+<debug_category>
/E-<debug_category>
All processes of the D2000 system

Enables (+) / disables (-) displaying of debug information of a given category (debug_category) at the start of the process.
Debug information is designed for internal development purposes.

To enable/disable displaying of debug information and to view it you may also use the process D2000 System Console.

Warning: Displaying debug information may cause system overload.

/E+DBG.CHECK.OBJECTS D2000 ServerAfter the process D2000 Server has been started it executes the check of the configuration of all objects.
/E+DBG/E+RTM.USELOCALCACHED2000 HIIt activates the use of the cache data that are transferred from the D2000 Server to D2000 HI. It enables, especially for slow networks (WiFi), to speed up the start of D2000 HI. The parameter must be entered when starting the process. When it is started for the first time, it creates the cache, which stores a lot of files into the localstore subdirectory (on the client-side) in the application directory (for example, one for each event and picture).
/F<Period>
All client processes of the D2000 systemThe period is the sending period of WatchDog messages between the client process and the D2000 Server process. It is set in seconds, where zero means not sending the message. Default value is /F60.
Note: As a part of the WatchDog message, the D2000 Server sends the current time. This allows remote client processes (running on another computer) to calculate the local time difference from the D2000 Server time. This difference is then used as a correction for all times of new values generated by the client process.
/FI
D2000 Event HandlerTimeout for processing a request. It is given in seconds.
Default value is /FI120.
More...
/FM D2000 TopologyUsing this parameter the topology will use complete calculation instead of partial More..
/FS D2000 HI, D2000 GrEditor, D2000 CNFTime to display error report if attempting to establish a connection with D2000 Server has failed. The default value is 60 s. For the value of /FS0, there will be displayed neither the start window nor the error report.
--fullscreen
D2000 HISwitches to full-screen mode - it hides a header and toolbars of the main window and maximized dialog windows (pictures) as well. This functionality can be changed to a special mode of HI. See more in the chapter Specific displaying of HI.
/GTWC<ipAddress:portNr>D2000 Gateway ClientIP address and port of D2000 Gateway Server, to which D2000 Gateway Client connects to. The parameter may be specified several times (in systems with redundant networks and/or redundant D2000 Gateway Servers).
/GTWL<portNr>   D2000 Gateway ServerTCP port to listen for incoming D2000 Gateway Clients.
/H D2000 ServerIncreases the priority for D2000 Server. The result is to get a better response during communication with network client processes.
/HWAll client processes of the D2000 systemThe parameter allows the process to log on to the WDDemon application that checks the functionality of client processes.
The parameter may be used only if the WatchDog message sending period (the parameter /F) is different from 0 (zero).
/KA<ArchivSize>
D2000 KOMThe parameter enables a function of the KOM Archiv. <ArchivSize> is the size of archive file - buffer within the range of 1...400 megabytes.
/KC<ApplName>
D2000 KOMThe parameter is valid just for the process KOM with the function KOM Archiv, which is starting without the D2000 Server.
<ApplName> must be the same as for the parameter /C of the server, the process KOM is attempting to connect to.
/KD<seconds> D2000 KOMThis parameter is meaningful only for values that are acquired with timestamp information.

If the value of the parameter seconds is positive, only those values from communication will be accepted which have the timestamps newer than the current time minus seconds (i.e. TimeNew > Clock - seconds).

If the value of the parameter seconds is negative, only those values from communication will be accepted which have the timestamps newer than the timestamp of current value minus the absolute value of seconds (i.e. TimeNew > TimeOld - |seconds| ). Moreover, if the current value is invalid, the newly acquired value with an old timestamp will have its timestamp updated to the current time and it will be accepted. This feature enables the KOM process to accept valid values (with updated timestamps) from communication (which may come with old timestamp) right after the startup - when all I/O tags have invalid values with current timestamp.
A special case is setting the parameter seconds=-1, which causes the old values not to be discarded, and in case that current value is invalid, a newly acquired value with an old timestamp will have its timestamp updated to the current timestamp and will be accepted.
If the parameter /KD is not set or if it has a default value seconds=0 then the values will not be discarded/modified as described above.

Discarded values will be logged in the subdirectory TRACE of the application directory - in a file named DISCARDED_VALUES_SELF_KOM.log (for SELF.KOM) or DISCARDED_VALUES_name_KOM.log (for name.KOM).

Values with modified time will be logged in the subdirectory TRACE of the application directory - in a file named CHANGED_VALUES_SELF_KOM.log (for SELF.KOM) or CHANGED_VALUES_name_KOM.log (for name.KOM).

The format of rows in both log files is following: current time - timestamp of current value - timestamp of newly acquired value - I/O tag's name - current value - newly acquired value.
/KD<seconds>D2000 DBManagerThis parameter concerns the warnings timeout expired, that the process DBManager writes to the log files and publishes via system variable SystemError if a database operation takes more than 60 seconds to complete.
Via this parameter, a default value of 60 seconds can be changed. It can be set to a higher value e.g. if DBManager executes SQL queries (e.g. runs stored procedures), that can take a longer time to complete and generate undesirable alarms.
More information is available in document D2000 DBManager - logs evaluation.

/KDBC

D2000 KOMThis parameter disables the cache for browsing values (Kom Disable Browser Cache) in selected protocols that support spontaneous sending of values without prior request or with group request (IEC101, IEC104, KNX, DNP3). By default, caching is enabled for these protocols, so spontaneously incoming values are stored in it. In configurations with many objects, the cache can take up a significant amount of memory, which this parameter can prevent.
/KDI<mask> D2000 KOMStartup value of mask for debugging of values. This mask can be changed later by TELL command DI ON/OFF.
/KI
D2000 KOMIf the parameter is entered, the initial values of input I/O tags will be loaded from the process D2000 Server after starting the process D2000 KOM.
If it is not entered, the initial values will be invalid. So the process D2000 KOM started without the parameter sends the values of all input I/O tags and started with the parameter then sends just the values changed.
Note: Values of input I/O tags are read by the process D2000 KOM always after its start from D2000 Server (since the D2000 v7.01.011).

/KKVOE

D2000 KOMIf the parameter is entered, the I/O tag values will not be invalidated (Kom Keep Values On Error) after a communication failure occurs and after the station switches to StHARDERR.

/KM<ArchiveMode>

D2000 KOMMethod for sending values from the KOM Archiv after connection with D2000 Server. <ArchiveMode> can get the values:
  • 1 - automatic sending of values, gained during work in the offline mode, from the KOM archive (implicit value),
  • 2 - values are sent only on demand (TELL command).
  • 3 - automatic sending of values from KOM archive (as the mode 1), but the statistical archive values are not recalculated.
/KO D2000 KOMUsing the parameter, the process D2000 KOM will switch over all stations to the status STOFF - switch off all communication.
/KS<period> D2000 KOMUsing the parameter, the process D2000 KOM will simulate the values of all I/O tags.

The parameter period is optional and is given in seconds. Minimum value of the parameter is 5 s.
If period is not specified, the process D2000 KOM will simulate the values of I/O tags with the period specified by the polling parameter Delay of respective station (if Delay is not specified, i.e. 0:0:0, the values of I/O tags will be simulate with the period of 5 s.).

/KS<count>D2000 DBManager

DbManager tries to find a connection to the database up to count times, always with a 1-second delay. The default value is 10 times. The parameter is important when switching redundancy when the /DBSH parameter is used (the database connection is maintained by only the active DbManager) so that the database operations of initializing events don't fail because the connections to the database are not yet functional.
The original behavior (a single attempt to find a connection) can be achieved by setting / KS1.

/KX
All client processes of the D2000 systemThe parameter allows operating in the offline mode (even for KOM Archiv). If the connection with the process D2000 Server is broken (stop or crash of D2000 Server, the connection failure), the process is still running and attempting to connect to D2000 Server. For functionality, it is necessary to set the parameter /F other than 0 (zero).
/L<LNG>All client processes of the D2000 systemDefinition of process language mutation. Parameter <LNG> can be:
  • SK - for Slovak version
  • CZ - for Czech version
  • GB (EN) - for English version
  • RU* - for Russian version
  • KZ* - for Kazakh version
  • RS* - for Serbian version

If the parameter is not entered, then the language version of the process is set by the regional settings of the operating system.

*The parameters apply for D2000 HI, other processes use English.

Note: For on-line help applies, if it exists for given language, it will be used, if not, English version will be used.

/M D2000 HIEnables the system-modal mode of the HI main window.
--MEMORY_LIMIT_TERMINATE=<byte count> D2000 HI  (64bit)If the process uses more operating memory than <byte count>, it is automatically stopped. Default value is 10000000000, i.e. 10GB.
--MPTCOUNT=<count> D2000 ServerExperimental feature. When you enter this parameter, D2000 Server will use <count> parallel threads to process the requests. Default value is 1.

/N

D2000 ServerUsing the parameter, D2000 Server does not start any processes (ignores the parameter Autostart in the configuration of objects of Process type).

/NES

D2000 DBManagerNo empty strings: the empty string to be written to the database as NULL (behavior compatible with Oracle, which understands the empty string and NULL as identical).

/NMI

D2000 DBManagerDo not mask invalid: The null string will be interpreted as an invalid value. By default, a null string is interpreted as a valid empty string (Oracle compatibility).
/NPAll client processes of the D2000 systemEnables the communication between the client process and the process D2000 Server through the protocol NamedPipes (if is not defined, the communication is performed through TCP/IP).
/NQ
D2000 DBManagerDo not use quotation marks - if the parameter is used, then the D2000 DBManager does not close the column names into quotes when working with the PostgreSQL database.
/NQD2000 ServerWhen starting, the application (kernel.exe process) always checks the structures of the configuration database are up-to-date. If they are old, the application considers it as error and *terminates itself*. This status will be written to a log file. Then, the kernel.exe must be started manually with the parameters /Capplication_name and /NQ. This combination of parameters will ensure the upgrade of the database.
/NQ parameter will start up kernel.exe in order to upgrade the configuration database of an application. The process will check the database is up-to-date and, if needed, will upgrade it and *terminate itself*. For that reason, this parameter must not be used when configuring the production application. If the database is already updated, its backup will be stored in the directory ApplDir\ApplicationName\Backup_CNV_yyyy_mm_dd before the system updating. The characters yyyy_mm_dd are replaced by the current year, month and day.

/NS

D2000 Server

Allow changing the UUID of system structured variables. This feature can be useful if it is necessary to transfer their values through the transparent gateway to another application (in combination with the renaming of system structured variables and the functionality of the transparent gateway based on UUIDs).

/P:<PortNr>

All client processes of D2000 system, D2000 ServerPortNr is the number of a TCP port, through which the TCP/IP communication between the process D2000 Server and D2000 client processes is being performed.
If the parameter is not entered, the process D2000 Server is listening on standard D2000 port 3119.
More information about using parameter /P is available in the description of parameter /DM.
Note: If the local computer is not running D2000 Server but D2000 SAS, it is also necessary to enter / TP parameter.

/QM

D2000 TopologyQuick topology calculation mode, in which the topology calculation stops, as soon as a contribution with the same value and coming from the same direction has already been made as the currently contributing node is making.
More...
/Q
D2000 Calc

The parameter activates a feature that causes the calculation of eval tags and publishing of values after the redundancy switching (values can be published through the value of the own eval tag or by writing to the structure fields in the case of structured eval tags). This behavior is not desirable and is disabled by default (recalculation is not performed after redundancy is switched). If necessary, you can activate this feature by the / Q parameter.

/RD<RDG_name>
D2000 HI, D2000 SASUsing the parameter allows a client to connect the active (hot) server of the given redundant group (RDG). The active server is detected by means of multicast TCP/IP network messages. More details are described here.
/Replay
D2000 KOMProcess D2000 KOM started with this parameter, does not communicate with devices. It is in the mode to be ready to replay data by tell command START_REPLAY (data are recorded by START_RECORD command).
/RF<RDG_name>
D2000 HI, D2000 SASUsing the parameter allows a client to connect the active (hot) server of the given redundant group (RDG). The active server is searched from the list of servers, which are defined in the system registry.
It is appropriate for connecting D2000 clients placed behind routers, which do not send multicast network messages (see the parameter /RD).
More details are described here.
/RO
D2000 ServerRuns the application with no possibility to write into a log database.
/RO
D2000 ArchivRuns the archive in "Read-only" mode. It is not possible to write into and delete any data from the archive.
The parameter can be controlled by the command SET_OPTION RO ON/OFF.
/RO
D2000 Gateway ClientRuns the Gateway Client (gtwcli.exe) in "Read-only" mode. It is not possible to write any value to Gateway Server, i.e. all write operations from Gateway Client to Gateway Server will be ignored.
/RS
D2000 ArchivArchive database backup will be executed by the command "COPY" also for Sybase and MS SQL. (By default, Sybase executes the backup using its own utility dbbackup. Using Sybase of the version 6.0.2 on multiprocessor computers, this utility randomly "freezes" and block the archive. By default, MS SQL executes the backup by the command BACKUP DATABASE into a .dat file. Using the parameter temporarily disconnects the database and .mfd and .ldf will be copied)....more
The parameter can be controlled by the command SET_OPTION RS ON/OFF.
/RX
D2000 ServerRuns the application with no possibility to delete anything from the log database.
/RX
D2000 ArchivRuns the archive with no possibility to delete any data from the archive. Running the archive in the mode requires the operator's confirmation.
The parameter can be controlled by the command SET_OPTION RX ON/OFF.

/RXN

D2000 ArchivRuns the archive with no possibility to delete any data from the archive. Running the archive in the mode doesn't require the operator's confirmation.

/RXN

D2000 KOM

When the parameter is specified, the communication of the OEM protocols will be stopped (and in the case of TCP/IP-TCP and TCP/IP-TCP Redundant lines, the connections will also be closed) while the D2000 KOM process is passive. It is thus possible to make the D2000 KOM process redundant with simple request-response type OEM protocols without modifying the source codes of the OEM protocols.

/S<Server>
/S<ServerIP>
/S<ServerIP1,ServerIP2>
All client processes of the D2000 systemThe server is the name of the server (computer) with the running process D2000 Server. ServerIP is the IP address of a computer with the running process D2000 Server. In case of a redundant network (computers have 2 network interfaces and 2 IP addresses), it is possible to use the 3-rd form of parameter, where ServerIP1 and ServerIP2 are IP addresses of a computer with the running process D2000 Server.
It is necessary to use one of the forms of /S parameter when starting a client process remotely - on a different computer than the computer with running D2000 Server (unless parameters /RD or /RF are used).
/T<Time>All client processes of the D2000 system

Time is the waiting period (in seconds) of the client process for the initialization of the D2000 Server. The default value is 1 second.
Note: This parameter is ignored if used together with parameters /RD or /RF.

The parameter has another meaning on the Windows platform if the process is run as a service (see the parameter /X). It indicates the required service start time - from the start of the process to the successful connection to the  D2000 Server process. The historical default value was 10 seconds, therefore to keep the compatibility the start time is specified as 9 +<Time>. The default value may not be sufficient, for example, when a process is being run remotely and connects via a slow WAN network, so Windows will report a timeout starting the service.

/TI<Time>D2000 KOM

The delay (in seconds) between the completion of the process initialization (after the process has started or connected to the HOT D2000 Server) and the sending of the "process is ready" message. The wait is used to establish communication before other processes (e.g. D2000 Event Handler) start writing to the output I/O tags. The default value of the parameter is 1 second.

/TL:<portNr>

All system client processes of the D2000 system

Configuration of reverse connect. The client process listens on the specified TCP port and the D2000 Server connects to it. The reverse connection is used for remote processes (especially processes running in the DMZ or on a network with a lower security level) that are not started by the D2000 Server but have their own watchdog.

For the functionality of the reverse connection from the D2000 Server, it is necessary to configure the parameters of the reverse connection in the configuration of the appropriate process.

/TP
All client processes of the D2000 systemEnables the communication between the client process and the process D2000 Server through the protocol TCP/IP (this is the default value for a network client). If the parameter is not used, communication takes place via shared memory.

/TPP

All client processes of the D2000 systemEnables the communication between the client process D2000 Server through the protocol TCP/IP with on-the-fly compression of messages.

/TZ<timeZone>

D2000 HI

Ensures that D2000 HI process runs in different time zone as it is set in D2000 System. As a time zone name, it is possible to use any name from tz database or define fixed offset from UTC using the format "(+|-)hh[:mi[:ss]]", where hh defines the number of hours, mi defines the number of minutes, and ss defines the number of seconds. Sign as well as number of hours are mandatory parts of offset definition, number of minutes and seconds are optional and default to 0 (e.g. "+02:30" defines offset of 2 hours and 30 minutes from UTC).

/W<Workstation>
All client processes of the D2000 systemWorkstation is the name creating the first part of the name of a Process type object. If the parameter is not entered, there will be used the workstation name (computer name).

Some processes can be started multiple times as a form of redundancy in D2000 - they are called instance processes or shadow processes (D2000 Archiv, D2000 Kom, D2000 Calc, D2000 DBManager).
In that case the instance number must be written after the name of process as follows:
/WSELF,2

The system generates the process (object) name as follows:
[InstanceNr]_originalName.Suffix

Example:
[2]_SELF.ARC
Above mentioned object is dynamic and its name can be used within the structure SV._System_Proces.

Note: See the chapters Redundant archiving, Redundancy of communication process.

--WAIT-AFTER-RECONNECT=<seconds>D2000 HIIt defines how long (in seconds) is HI held after switching the redundancy. It is necessary for stabilization of system (e.g. to ensure so that the archives could be available, etc.) The default value is 7 seconds.
--WORKERTASKS=D2000 Event HandlerParameter changes the default setting of number of the scheduler threads that are used to perform ESL scripts. If not used then the number of threads is equal to the number of logical processors. It is handy to use the parameter when debugging the performance of ESL scripts.
/X[0,1,2,3]
All system client processes of the D2000 system
Definition of the process behavior:
  • 0 - optional parameter (default) - the process is to be running as console,
  • 1 - the process is to be running as Windows NT service without any interaction with user (desktop),
  • 2 - since version 10.0.37, /X2 is interpreted as /X1 (this is due to the producer's recommendation not to use Windows service in an interactive mode).
  • 3 - the process is to be running as Windows NT service under the user: D2000Admin/CondorD2000 (name/password).

The parameter is intended just for the processes of the D2000 system without a desktop for interaction with the user - D2000 Server, D2000 Calc, D2000 KOM, D2000 Archiv, D2000 Event Handler, D2000 Alarm, D2000 Topology, D2000 Switch.

Since version 12.2, /X parameter is not supported. Process run mode can be configured in process configuration dialog instead.

/X4<user>

All system client processes of the D2000 system

Defines the process behaviour. The process is to be running as Windows service under a defined "user". The user must be defined both in the application (D2000 system configuration) and in the operating system, on which the process is to be running. Name and password of the user must be equal in both the definitions.

We recommended checking whether the "user" is in the list of users according to policy "Log on as a service" (Control Panel -> Administrative Tools -> Local Security Policy -> Local Policies -> User Rights Assignment -> Log on as a service).

The parameter is intended just for the processes of D2000 system without desktop for interaction with user - D2000 Server, D2000 Calc, D2000 KOM, D2000 Archiv, D2000 Event Handler, D2000 Alarm, D2000 Topology, D2000 Switch.

Since version 12.2, /X parameter is not supported. Process run mode can be configured in process configuration dialog instead.

/XA<alias>

All system client processes of the D2000 system

Parameter /XA<alias> is meaningful only in conjunction with parameter /X4<user>. If parameter /XA is specified, then during the creation of Windows service <alias> will be used for specification of username instead of <user>. The parameter can be used e.g. in systems where names of Windows users contain special characters that are not permitted in D2000 usernames (e.g. dash).

Should a D2000 process run under a Windows user a-man, it could be done by specifying parameters /X4aman /XAa-man (provided that a password of Windows user a-man is stored in configuration of D2000 user aman).

Since version 12.2, /X parameter is not supported. Process run mode can be configured in process configuration dialog instead.



Note 1: Besides entering start parameters of processes in the configuration dialog box or on the command line during manual startup it is possible to create a file named default.arg and located in the current directory. D2000 Server as well as other processes first read start parameters from the file default.arg (if available) and afterward they process start parameters they have been run with. It implies that a parameter entered in the configuration dialog box or on command line during manual startup will override the parameter from the file default.arg.
If a process is started manually, current directory is the directory from which it was started. If it is started as a service (from the process D2000 Application Manager, automatically after Windows startup or from the process D2000 Server), current directory is %WINDIR%\System32.

Note 2:
The parameters for processes or a group of processes may be set in the registry on a computer running the D2000 Server to which the process is being connected.

Create a text value with optional name in registry HKEY_LOCAL_MACHINE\SOFTWARE\Ipesoft\D2000V70\cfg_application_name\process_name\CommandLineArguments. As "Data" write a start parameter.

Process_name can be a full name of process (e.g. "WS1SKOP2") or only the suffix (including the full stop, e.g. ".HIP"). In case that only the suffix is entered, the parameters will be used for all the processes containing this suffix.

If parameters exist for both the specific process (characterized by name) and for a category of processes (characterized by suffix), resultant parameters will be created by joining both groups of parameters. If there are parameters with the same name in both groups ("java heap size" on the picture), a parameter from the group characterized by whole name of process will be used ("WS1SKOP2.HIP" on the picture).

startovacie_parametre_nastavenie1.png 
startovacie_parametre_nastavenie2.png

Note 3: Maximum number of characters in parameters of the processes is 80. The parameters can be entered in quotation marks " ", however these quotes will be removed.

Write a comment...