Start Parameters (Processes)

Start Parameters (Processes)

Start parameters of processes

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

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

Parameter

Parameter validity

Meaning

Parameter

Parameter validity

Meaning

/?

/h

All client processes of the D2000 system

Displays 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 end.

/AF<Method>

D2000 HI, D2000 GrEditor, D2000 CNF, D2000 Application Manager, D2000 DDE Server, D2000 System Console, D2000 Tell, D2000 Browser

Forces another authentication method for verification of a user's identity than the authentication method required by the process D2000 Server.
The value of <Method> parameter can be

To use a specific authentication method, it must be permitted in the user's configuration (parameter Authentication methods).

/AN<Name>

D2000 HI, D2000 GrEditor, D2000 CNF

Name 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 entered into the login window, and a password will be required.

--ANONYMIZEPERIOD=<seconds>

D2000 DBManager

The parameter sets the time period in seconds of anonymization and table row deletion. The default value is 3600 seconds (1 hour).

--ANSI

D2000 GateWay Client, D2000 GateWay Server

The parameter enforces the Windows 1250 encoding for transmitted texts. If it is not entered, the texts use UTF-8 encoding. The parameter must be used, providing that the communication partner is of an older version than 9.X, and the text values are transmitted.

/AO<NameOfPicture>

D2000 HI, D2000 GrEditor

NameOfPicture is the name of the picture opened after +1. login in to the process

/AP<Password>

D2000 HI, D2000 GrEditor, D2000 CNF

The 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 GrEditor

Disables the synchronization of bitmaps when starting the process.

/ASE

D2000 System Console

Enables switching the HOT (Active) server (manual or automatic).

/ASG<group>

D2000 System Console

Automatic HOT (Active) server switching. The parameter group defines the name of a redundant group.

/ASI<interval>

D2000 System Console

Automatic HOT (Active) server switching. The parameter interval defines the time interval after the lapse of which the HOT server is to be switched.

/B<BkpNr>

D2000 Server

BkpNr is the number of configuration database backups. Database backup 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, the default value /B0 is used.

--batch_mode

D2000 Event Handler

The parameter modifies an interpretation of DB_SET_PROCESS_PARAMS.

/C<ApplName>

D2000 Server

Application name.

/CT

All client processes of the D2000 system

The process will use the time of the computer on which it is started. If the parameter is not entered (Default), the process will use the D2000 Server's time.
Note: In redundant systems, if the D2000 Server process is started with the /CT parameter, it will not synchronize its time with the active (Master) D2000 Server process. This can be useful if the active D2000 Server has the wrong time (e.g. due to NTP problems).

/DBCA

D2000 Archiv

The process D2000 Archiv deletes old data from the archive database and reorganizes it only if it is in the active mode (in redundant systems, the process must also be connected to the HOT Server).

/DBCP

D2000 Archiv

The process D2000 Archiv deletes old data from the archive database and reorganizes it only if it is in the passive mode (or in active mode in a redundant system as long as it is connected to the SBS Server).

/DBCS

D2000 Archiv (only for Oracle database)

The process D2000 Archiv will use ALTER TABLE SHRINK SPACE instead of the SQL command ALTER TABLE MOVE for reorganization (this command is available only for Oracle 10g and above).

/DBCY

D2000 Archiv

Enables 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 only for dbmanager_ora.exe.

/DBCP

D2000 Archiv

Only in passive mode, the process D2000 Archiv can delete old data from the archive database and reorganize it (ORACLE).

/DBD<number_of_days>

D2000 Archiv

The 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 the Historical value type, 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 DBManager

The process D2000 DBManager will log performance warnings when a number of requests queued for a non-transactional connection exceeds the value number_of_requests. This parameter can be used for performance tuning. More...

/DBIV<flag>

D2000 Archiv

The 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 time (e.g., the process started with the parameter /DBIVI /DBIVG ignores all values with the flags of I or G).

/DBPO

D2000 Archiv

Activates the archive attribute (Archiv keeps only primary data). Requests for recalcs of the statistics and calculated archive objects are ignored.
The parameter can be controlled by the SET_OPTION DBPO ON/OFF command.

/DBS<size>

D2000 DBManager

Support for long strings (e.g., for working with CLOB columns of the 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 Archiv

The D2000 Archiv process shares the archive database with another process  D2000 Archiv (e.g., working with a database cluster). There are 2 possible configurations:

  1. Two (or more) archive processes (SELF.ARC instances), where one is connected to the HS Server, and the others are connected to SBS Server (s). If SELF.ARC is connected to the SBS Server, it works in read-only mode. If it is connected to the HS Server, it 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 ones work in read-only mode.

Note: The recommended configuration is to use 2 or more instances of archive processes that are connected to a HOT (Active) server, with each instance having its own archive database. In this configuration, the /DBSH parameter is not used.

/DBSH

D2000 DBManager

The parameter is meaningful only in redundant systems.
The process D2000 DBManager will close all database connections if

  • its D2000 server changes its state to SBS (Passive)

  • DbManager is run as an instance, 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 the 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 HI

Disables the cache for pictures. The aim is to decrease the memory requirements of the process at the expense of slowing down the picture opening.

/DC

D2000 KOM

Disables trust checking of server TLS certificates on TCP/IP-TCP and TCP/IP-TCP Redundant lines.

--DEFAULT-TOOLBAR-COLOR

D2000 HI

Paint toolbars using the default grey color. If not specified, toolbars are painted white.

/DG

D2000 HI

Decreases the memory requirements of the process at work with graphs at the expense of slowing down the drawing of graphs that contain a lot of data.

/DI

D2000 HI, D2000 GrEditor, D2000 Archiv

Shows specialized information (debug info) when starting the process.

/DL

D2000 HI, D2000 GrEditor

Enables writing the contents of the 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 the text console window of the D2000 Server process (if the console window is visible, see the parameter /X), and it will also be added to the name of shared memory used for interprocess communication.
To avoid collision and change the standard number of TCP port (3119), all D2000 Server processes (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:10001 /CApp1 /DMThisIsApp1
ServerB: kernel.exe /P:10002 /CApp2 /DMThisIsApp2

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

local connection to ServerA via TCP/IP: hi.exe /P:10001 /TP
local connection to ServerB via TCP/IP: hi.exe /P:10002 /TP

remote connection to ServerA: hi.exe /Sserver_name /P:10001 /TP
remote connection to ServerB: hi.exe /Sserver_name /P:10002 /TP

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

/DP

Processes with a text console

(Debug Pipe) – The process will display the course of communication with the D2000 Server.

/DPA
/DPP
/DPR

D2000 HI, D2000 GrEditor

Mode 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 the D2000 system

The 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.
The size of the dump file and its contents depend on the used parameter:

  • /DUMP - generates a 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 a 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 the /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 exceptional situations!

/DW

Processes with a text console

Not 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 Server

After the process D2000 Server has been started, it executes the check of the configuration of all objects.

/E+DBG/E+RTM.USELOCALCACHE

D2000 HI

It activates the use of the cache data that is 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 in 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 system

The 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. The default value is /F60.

/FCI<Period>

All client processes of the D2000 system

The period is the sending period of ClientInfo messages from the client process to the D2000 Server process. It is set in seconds, where zero means not sending the message. If not set, the default value is period of WatchDog (parameter /F, see above); if the WatchDog period is 0, the default value is /FCI60.

/FI

D2000 Event Handler

Timeout for processing a request. It is given in seconds.
The default value is /FI120.
More...

/FM

D2000 Topology

Using this parameter, the topology will use complete calculation instead of partial.
More...

/FS

D2000 HI, D2000 GrEditor, D2000 CNF

Time to display the error report if attempting to establish a connection with the 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 HI

Switches to full-screen mode - it hides the header and toolbars of the main window and maximizes 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 Client

IP address and port of the D2000 Gateway Server, to which the D2000 Gateway Client connects. The parameter may be specified several times (in systems with redundant networks and/or redundant D2000 Gateway Servers).

/GTWL<portNr>  

D2000 Gateway Server

TCP port to listen for incoming D2000 Gateway Clients.

/H

D2000 Server

Increases the priority for D2000 Server. The result is to get a better response during communication with network client processes.

/HW

All client processes of the D2000 system

The parameter allows the process to log on to the WDDemon application, which 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 KOM

The parameter enables a function of the KOM Archiv. <ArchivSize> is the size of the archive file buffer within the range of 1...400 megabytes.
Note: The /KA parameter automatically activates /KX (process operation in offline mode).

/KC<ApplName>

D2000 KOM

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