...
| The command without parameters writes out the status of monitoring or storing of auditing information (see also Object Group - monitoring changes in configuration). Parameter REINIT USERS causes the writing of the current configuration of all objects of *User* type into the monitoring database. Parameter REINIT RES_GROUP causes the writing of the current configuration of necessary objects of *Object group* type into the monitoring database. In any object type is not stated in the command, both types of objects will be written into the monitoring database. | ||||||||||||||||||||||||||||||
| BACKUP SYSCFG path | Creates a configuration database backup in a directory specified by the path parameter (Sybase SQL Anywhere and PostgreSQL platforms). Note: The backup can be influenced by the setting of ConfigBackUpTimeout parameter. | ||||||||||||||||||||||||||||||
| BACKUP LOGFILE path | Creates a log database backup in the directory specified by the path parameter (Sybase SQL Anywhere and PostgreSQL platforms). | ||||||||||||||||||||||||||||||
| CFGSYNCHROAUTO ON/OFF | Enables/disables the automatic synchronization of configuration databases after a new SBS (standby server) is connected. Note 1: The command can be applied to the HOT server only. Note 2: The synchronization can be influenced by the setting of the parameter ConfigSynchroTimeout. | ||||||||||||||||||||||||||||||
| CHECK_ARCHIVE | Checks a value type consistency between the primary archive object and the archive one and shows the errors (writes it into the log). The error is if the value type of the primary archive object is different from the value type of historical value. | ||||||||||||||||||||||||||||||
| If some files - the external and user libraries for Java, placed in directory %lt;appldirgt;/java/shared are changed, the D2000 Server will send these files to all running clients. | ||||||||||||||||||||||||||||||
DI ON/OFF DI /E+dbginfo DI /E-dbginfo | Debug Info - shows (DI ON)/ hides (DI OFF) internal debug information of D2000 Server (in the process window and in the process D2000 Sysconsole). The command allows show/hide viewing debug information by category as the SysConsole user interface allows. Example 1: Show debug information DI /E+DBG.CFG_RQ Example 2: Hide debug information DI /E-DBG.CFG_RQ | ||||||||||||||||||||||||||||||
| DP ON/OFF | Debug Pipe - enables/disables the displaying of the communication of the D2000 Server with client processes (only if the D2000 Server's window is displayed on the desktop). | ||||||||||||||||||||||||||||||
| INSTANCE SET|GET ACTIVE|PREFERRED|USABLE ... | It is used to determine and set the active instance, preferred instance, and instance mode in a load-balancing mode.
| ||||||||||||||||||||||||||||||
| MESSAGE Message_Text process_name | Broadcasts (sends) a text message to client processes. The process name can be entered as a mask (e.g. *.HIP - for all processes D2000 HI). If the return code is Success, it contains the number of clients, the message from the D2000 Server was sent to. | ||||||||||||||||||||||||||||||
| LIC_PostponeLicWrnToUsers 0 až 240 [hod], default 24 | Delay of license warnings for common users. The administrators of D2000 will get the license warning always and immediately. | ||||||||||||||||||||||||||||||
| LIC_DoNotAllowConsoleOverLimit 0|1, default 0 | When setting 1, the system will not allow connecting consoles (HI) over the scope of the license. | ||||||||||||||||||||||||||||||
| LIC_DoNotAllowSysProcOverLimit 0|1, default 0 | When setting 1, the system will not allow the system processes (CALC, EVENT, KOM,...) over the scope of the license. | ||||||||||||||||||||||||||||||
| RD_SET_HOT serverName | Sets the HOT server in the redundant system. The parameter serverName is the name of the server within the redundant group. | ||||||||||||||||||||||||||||||
| On-line refresh of the information about the license range (from file LicenceRun.code or LicenceDev.code) and information about the network clients (from file ConsolesInfo.txt). It enables changing the license range without any need to stop the system - as well as re-reading the list of network clients after it has been manually edited. Note 1: In redundant systems, it is necessary to replace the files LicenceRun.code or LicenceDev.code on all redundant servers. Note 2: In redundant systems, it is necessary to modify the file ConsolesInfo.txt only on the active (HOT) server. The changes will be transferred to all SBS servers. Note 3: The information about the license is sent to the client processes when connecting to D2000 Server. For that reason, if the change of license affects even other processes than D2000 Server, they must be restarted. For example, when a user adds a new communication protocol, it influences the D2000 CNF process. To enable this protocol in D2000 CNF, it must be restarted. Also, when adding a new communication station and I/O tags with the given protocol to the D2000 KOM process, it must be restarted. | ||||||||||||||||||||||||||||||
| RELOAD_PARAMS | Reloads all parameters for D2000 Server (except the parameters for saving the monitoring database to the depository) from the registry (Windows) or from the configuration file (Linux) without restarting the D2000 system. | ||||||||||||||||||||||||||||||
| RELOAD_SECURITY | Sets the new configuration of Security Policy without restarting the D2000 System. | ||||||||||||||||||||||||||||||
| REPAIR_ARCHIVE | Checks the consistency of value type between the object being archived and the historical value. If some error occurs, it will be repaired immediately and information will be written into the log. The error is if the value type of the object being archived is different from the value type of historical value. | ||||||||||||||||||||||||||||||
| Initialize the path to the repository. If the directory does not exist, a new one will be created. If there is a repository on a given path, this one will be used for storing object history. History capturing must be disabled. | ||||||||||||||||||||||||||||||
REPOSITORY DISCONNECT | Remove setup path to the repository. History capturing must be disabled. | ||||||||||||||||||||||||||||||
REPOSITORY ON|OFF | Enable/disable history capturing. A path to the repository must be set. | ||||||||||||||||||||||||||||||
| RESTART process_name | Stops the given process and then starts it correctly. Note: If the process is stopped (Stop or Crash status), the command just starts it. | ||||||||||||||||||||||||||||||
process_name mode | Activates/deactivates Load balancing mode (see the chapter Redundant archiving - Load balancing). Example: SET_LOAD_BAL_MODE SELF.ARC 1 - activates Load balancing mode for SELF.ARC process. | ||||||||||||||||||||||||||||||
| The command writes the list of the names registered by the GETACCESS action within the application (with the keyword PUBLIC) into the text console and to the log file (kernel.log) of the D2000 Server process. Example: | ||||||||||||||||||||||||||||||
| SHOW_ARC_STAT process_name | Shows the statistical information about the running instances of the archive - the maximum number and sum of the read requests that are being processed. | ||||||||||||||||||||||||||||||
| Shows configuration information of the process D2000 Server. This information covers:
| ||||||||||||||||||||||||||||||
| Shows dynamic information on the specified object (list of objects that dynamically or statically use the object) on the text console of the D2000 Server process. | ||||||||||||||||||||||||||||||
| SHOW_DYNO_LIST idFirst idLast | The command dumps the list of current dynamic objects (ID and object name) to the text console of the process based on the defined interval. Note: The command is mainly intended for diagnostic purposes. | ||||||||||||||||||||||||||||||
| SHOW_TRANS_LIST | Lists internal transactions of the D2000 system. Note: The command is intended to be used mainly for D2000 System diagnostic purposes. | ||||||||||||||||||||||||||||||
| SHUTDOWN D2000 | Stops the D2000 system. | ||||||||||||||||||||||||||||||
| SHUTDOWN RESTART | Stops the D2000 system and restarts the operating system. | ||||||||||||||||||||||||||||||
| SHUTDOWN SHUTDOWN | Stop the D2000 system and shutdowns the operating system. | ||||||||||||||||||||||||||||||
| SHUTDOWN WINNT | Stops D2000 System and restarts the operating system. | ||||||||||||||||||||||||||||||
| START process_name | Starts the specified process. | ||||||||||||||||||||||||||||||
| STDOUT output | The command redirects the standard output to a new output specified by output. Example: | ||||||||||||||||||||||||||||||
| STOP process_name [FORCE] | It stops a process. When using the optional parameter FORCE, the termination of the process will be forced. | ||||||||||||||||||||||||||||||
| *SUSPEND* SLEEP [WAKEUP yyyy-mm-ddThh:mi:ssZ]|HIBERNATE | It causes the operating system to switch into sleep mode (SLEEP) or hibernation (HIBERNATE). If the OS switches into sleep mode, the user may define a time of its automatic awakening by the parameter WAKEUP yyyy-mm-ddThh:mi:ssZ, where yyyy-mm-ddThh:mi:ssZ defines UTC time of awakening. The string must be in ISO 8601 format (http://sk.wikipedia.org/wiki/ISO_8601). Example: *SUSPEND SLEEP WAKEUP 2015-02-11T12:00Z* - causes putting the computer to sleep and automatic awakening at noon, February 11th, 2015 (UTC). | ||||||||||||||||||||||||||||||
| It enables, disables, or queries the delay of data transfer between the D2000 Server process and the client connected via TCP/IP protocol. Setting the parameter TCP_NO_DELAY to TRUE disables TCP delay before sending TCP packets (setsockopt function with parameter TCP_NODELAY - see Nagle's algorithm). The delay improves the efficiency of TCP/IP networks by reducing the number of packets that need to be sent over the network. On the other hand, if the communicating partners wait for each other's response (e.g. remote procedure calls between two EVENT processes or between HI and EVENT), this delay can significantly slow down the execution of scripts and other interactions. By default, TCP delay is on (TCP_NO_DELAY = FALSE). This TELL command is intended only for tuning and debugging purposes. Note 1: When registering a TCP/IP client, the process D2000 Server queries the value of parameter TCP_NO_DELAY, and, depending on this value, it does or does not change the parameter TCP_NO_DELAY for client connection. This value is then sent to the client, which also changes the TCP_NODELAY parameter of its TCP connection to the server. Warning: In the current implementation, the TCP_NO_DELAY command does not cause any change in the setting on the client's side! Note 2: Besides the TCP_NO_DELAY parameter, there is also another parameter that influences sending TCP delayed acknowledgments (it can be set on OpenVMS and *nix system by calling sysconfig -r inet tcpnodelack). This parameter induces a 200 ms delay before sending TCP acknowledgments and it can interact with the TCP_NODELAY parameter. | ||||||||||||||||||||||||||||||
| Warning: Since the version V8.00.001, the command is not supported. XML file(s) export from the directory, which is defined by the parameter path, together with the following parameters:
The path for the file export on VMS must be written in Unix format. | ||||||||||||||||||||||||||||||
| The configuration parts export to the XML files, which is not part of the object configuration. The parameters: [Path, FileName, TableName].
Warning: Extension ".xml" is added automatically, do not explicitly specify it. | ||||||||||||||||||||||||||||||
| Warning: This command is not supported for OpenVMS. XML file(s) import of a specific file or of all XML files from specified directory, depending on path_to_dir / path_to_file parameter: path_to_dir - directory name with XML files (eg D:\temp). Note - the directory is searched for xml files recursively. path_to_file - absolute path to the XML file (eg D:\temp\H.Sec.xml) For this TELL command to be executed, a configuration key must be present!. The path for the file import on VMS should be entered in Unix format. Note: The command belongs to the "security" TELL commands. I.e., it can be activated only from interactive processes with configuration key or from process D2000 Event Handler. | ||||||||||||||||||||||||||||||
| Import of the configuration parts that are not part of the object configuration from XML files. The parameter [Path, FileName, TableName[, CleanTable]]
The initialization of the TELL command is conditioned by using the configuration key. Note: The command belongs to the "security" TELL commands. I.e., it can be activated only from interactive processes with configuration key or from process D2000 Event Handler. | ||||||||||||||||||||||||||||||
| Warning: Since the version V8.00.001, the command is not supported. Sets the parameters for XML_IMPORT and XML_EXPORT commands. The command without parameter displays the default parameters of the D2000 Server. | ||||||||||||||||||||||||||||||
| Partial update of the objects by XML from the directory, which is defined by parameter Path. The parameter: [path_to_dir / path_to_file] Note: The command belongs to the "security" TELL commands. I.e., it can be activated only from interactive processes with configuration key or from process D2000 Event Handler. |
...
| Debug Info for values - enables/disables displaying information about the evaluation of:
| ||||||||||||||||||
| DP ON/OFF | Debug Pipe - shows/hides the course of communication with D2000 KOM (only if the process window is displayed on the desktop). | ||||||||||||||||||
| GETKOMARCDEPTH | Gets the timestamp of the oldest data stored in the KOM Archive. | ||||||||||||||||||
| Reads historical values from a device - StationName station. The values from the specified interval will be read. The parameter EndTime is optional and if is not entered, the current time will be used. Time format ("BeginTime", "EndTime") is "dd-mm-yyyy hh:mi:ss". This feature is supported only by some communication protocols (Datalogger ESC8800, ESC8816, UNIP_TS ...). Warning: This is not a function of KOM Archiv but it is the reading values directly from a device! NORECALC parameter causes the archive to not execute the calculation of calculated archive objects, the values of which are calculated from the values acquired by this calling of a TELL command. For some protocols (OPC DA, OPC HDA, and IEC 870-5-104), a parameter mask "M:" can be used, which is used to read the archive values only for selected I/O tags which match the mask, from the StationName station. | ||||||||||||||||||
| The command allows switching between the primary (OFF) and backup (ON) devices for the "SerialOverUDP Device Redundant", "SerialOverUDP Line Redundant" and "SerialOverUDP System&Line Redundant" line categories. The active device is used to write UDP packets and packets received from it are processed. Data received from the inactive device is ignored. The third parameter (numbers 1-4) specifies the subline. For a line of category "SerialOverUDP Device Redundant", it need not be specified or can be equal to 1. For a line of category "SerialOverUDP Line Redundant", it can be equal to 1 (the device on the Primary line is set) or 2 (the device on the Secondary line is set). For a "SerialOverUDP System&Line Redundant" category line, it can be equal to 1 - 4 (the device on the Primary/Secondary line of the system A/B is set). Example of use: LNALTERPATH L.MyLine ON 3 | ||||||||||||||||||
| The command can be used only for the lines of Serial (asynchronous serial lines) and RFC2217 Client categories. The command stops the communication (CLOSE) and disconnects the communication port. Then the port can be used by other programs, e.g. diagnostic or configuration tools. Stations on the line are to be in the Communication error state. The communication will be recovered either using the command LNSTAT OPEN or after restarting the whole communication process. | ||||||||||||||||||
| LNTRACE DEC/HEX | Enables the decimal/hexadecimal format of line listening. The default format is hexadecimal. | ||||||||||||||||||
| READKOMARC ["BeginTime"] ["EndTime"] | Reads the values from KOM Archiv. There are transferred all old values from the specified interval. The parameter BeginTime is optional and if it is not entered, the data from all history depth of KOM Archiv will be read there. The parameter EndTime is optional and if it is not entered, the current time will be used. If the parameters BeginTime and EndTime are not defined, there will be sent just the values, which have not been sent. If at least the parameter BeginTime is defined, there will be sent all values within the specified interval. Return codes:
| ||||||||||||||||||
| The command de-configures the object (line or station) and its descendants (stations, I/O tags) and reloads them. The command can be used to apply configuration changes that would otherwise require restarting the KOM process. The command is currently implemented for protocols:
| ||||||||||||||||||
| Resets the statistics of given line / station - the system structured variable SV._System_LinePerformance / SV._System_LinePerformance. It is executed immediately but it will be visible after the process D2000 KOM sends new statistics to the process D2000 Server (periodically every 10 seconds). | ||||||||||||||||||
| Dynamic change of the I/O tag address. The parameter name specifies the I/O tag. It can be entered as the object name (e.g. "M.CoolantTemperature") or the object HOBJ (the syntax requires the character '$' before HOBJ, e.g. "$278"). The parameters address1 and address2 define the new I/O tag address. Change of address will be performed only in internal data structures of the KOM process. It is not sent, in a centralized way, to the server, i.e. changed address is valid until the restart of the KOM process. After this, the value from the initial configuration will be used again. Return codes:
Dynamic change of the I/O tag address is implemented only for a limited group of communication protocols: | ||||||||||||||||||
| SETSTADDR StationName|StationHOBJ "address" | Dynamic change of station address. The first parameter specifies the station. It can be entered as the object name StationName (e.g. "B.Station") or station ID StationHOBJ. The "address" parameter defines its new address. Change of station address will be performed only in internal data structures of the KOM process. It is not sent, in a centralized way, to the server, i.e. changed address is valid until the restart of the KOM process. After this, the value from the initial configuration will be used again. Return codes:
Dynamic change of address is implemented only for a limited group of communication protocols: | ||||||||||||||||||
| SHOW TAG TagName/TagHOBJ SHOW NAN | Enables debug information for the specified I/O tag. The command requires either the name or HOBJ of the I/O tag. The debug information is usable for D2000 System developers. The SHOW NAN command displays all I/O tags whose value (current, last telemetry, or last valid) is NaN (unspecified type). | ||||||||||||||||||
| SHUTDOWN WINNT | Restarts the computer with the D2000 KOM process (the process must be running). | ||||||||||||||||||
| For the Microtel 700 protocol, it explicitly activates (ON) or deactivates (OFF) an alternative communication route for a station named StationName (e.g., "B.Station"). | ||||||||||||||||||
| Starts a data recording into a subdirectory (application directory) with the name dir_name_only. If the directory does not exist, it will be created. If this TELL command is run from the D2000 Server, firstly, the file dodm_values.dat containing the initialization values of DODM objects is recorded and then the D2000 Server will send this command to clients. Data are recorded within the time period <begin_time, end_time>. If <begin_time> is not set, data are recorded immediately. Example: These four data files (it relates to four hourly intervals) are the result of recording: Note: The TELL command uses "dd-mm-rrrr hh:mm:ss" format for the parameters of DateTime type. | ||||||||||||||||||
| Stops a data recording immediately, it is not necessary to wait for end_time. If the recording is not in progress, an error will be returned. Note: It is possible to start up this TELL command from the D2000 Server, as well as directly from the clients (currently only from the D2000 KOM and Gateway Client processes). | ||||||||||||||||||
| Starts a data replaying from a subdirectory (of application directory) with the name dir_name_only. If the directory does not exist, an error will be returned. If the command is run from the D2000 Server - at first, the dodm_values.dat file containing the initialization values of DODM objects will be recorded by the D2000 Server, and then the D2000 Server will send this command to the clients with /NOW parameter. It replays all data (in data files) with the time stamp >= begin_time. The timestamp of data represents a particular time from the recorded time period. The time of data replaying must be from the range of the recorded time period. Example of data replaying:
Note: This TELL command uses the "dd-mm-rrrr hh:mm:ss" format for the parameters of DateTime type. | ||||||||||||||||||
| Stops a data replaying immediately. If the replaying does not work, the error will occur. Note: There is possible to start up this TELL command from the D2000 Server, as well as directly from the clients (currently only from KOM client). | ||||||||||||||||||
| STDOUT output | The command redirects the standard output to a new one. Example: | ||||||||||||||||||
| STOP | Stops the D2000 KOM process. | ||||||||||||||||||
| Enables the communication (the parameter START) or disables the communication (parameter STOP) with the StationName station. The station will get the StON (START) or StOFF (STOP) value. | ||||||||||||||||||
| For protocols based on periodic polling of I/O tags (request-response protocols): the command generates one or several requests for priority reading of all I/O tags on a specified station. The Number parameter defines the number of requests, possible value is within 1...5. If the parameter is not specified, a single request will be generated. For protocols based on sending of changes (change-based protocols): the command generates one or several requests for the reading of all data. The command is implemented for a selected set of communication protocols:
|
...