...
| 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 does not execute the calculation of calculated archive objects, the values of which are calculated just 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 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:
| ||||||||||||||||||
| 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 defines 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 process 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:
|
...
| DYNAMIC_INFO | TELL command for the processes with the name *.EVH and *.HIS. This TELL command does not have any parameters. After receiving the command, the process writes, into its log file, information about: - list of all running instances of ESL scriptsFormat: ESL;ESL name ESL - text identifying the next information ESL name - script identification1 - registered text strings (GETACCESS action) Format: ACCESS;ESL name;String;time of GetAccess;bGlobal;userComment;status ACCESS - text identifying the next information XML - text identifying the next information REFOBJ - text identifying the next information DBCONNECT - text identifying the next information FIO - text identifying the next information CNT - text identifying the next information 1 - script identification: text string uniquely identifying the running ESL scrip. It contains the object name (HOBJ)[instance number] unique numerical identifier. |
| SHOW_TRANS_LIST idInstance | If idInstance = 0, the command shows both the list of all instances of events that are pending to finish the transaction and the list of transactions. If idInstance <> 0, the command shows the information about the particular instance (you can find the list of instances in the dialog window ESL Diagnostic Pack or by the tell command TASK_STATUS command). |
| STATISTICS path+file | Writes data about the processor time consumption according to individual events into a file. |
| STDOUT output | The command redirects the standard output to a new one. Example: |
| TASK_STATUS path+filename | Writes currently executed lines of all the script running in a specified process into a file (*.EVH or *.HIS). The command also supplies the information about whether the ESL script is currently executing the external function. If yes, the file will contain the name of the function and the line number of the script calling the function. |
...
| DP ON/OFF | Debug Pipe - shows/hides the information about communication with D2000 Calc (only if the process window is displayed on the desktop). | ||||||
| RESET_STATISTICS | Resets the counters for evaluating the statistical data. | ||||||
| STATISTICS path+file | Writes statistical data about individual I/O tags into a file. The file contains the following information: I/O tag name, number of recalculations and number of new values broadcasted into the system. The counters are reset while starting the process D2000 Calc or using the command RESET_STATISTICS. | ||||||
| STDOUT output | The command redirects the standard output to new one. Example: | ||||||
| CALCINFO ON|OFF clcName [row] | The command is used to determine the reason for calculating the eval tag that has the Calculation method parameter set to At change or Trigger value. The command ensures (CALCINFO ON) that into the LOG file of the process will be continually written information about the reason for the calculation of the eval tag. The CALCINFO OFF command terminates the continuous log to the LOG file. It is used for the eval tags that have the Calculation Method parameter set to At change or Trigger value. Record in the LOG file contains:
Parameters: clcName - the name of eval tag row - specifies a row number for a structured eval tag. If not specified, the replacement value is 0 and all rows will be tracked. Example (the content of LOG file): Tell TELL command: CALCINFO ON P.OnSec In the LOG file, there is a record that that the information is about the calculation of the calculated P.OnSec object. The value of the object changed from HOBJ=20 (VALUE IN $20). Next, the individual attributes of the input value are displayed. Output value attributes are displayed after a row containing VALUE OUT content.
| ||||||
| The command enables to compare the values of destination columns (of structured variables), configured in the eval tags, with the values that were calculated by D2000 Calc. When specifying the particular object of Structured variable type, for which the comparison should be done, the value of parameter DestId, or also ColIndex for the particular column, must be a non-zero. It is followed by the optional keywords from the list: Detail, Debug, Ignore_Time, ReCalc0s, ReCalc1m. You may find the detailed information in the document Checking values of destination columns. Note 1: This command is mainly used for diagnostic purposes in D2000 Systems. Note 2: Command is supported only in version D2000 V8.0.5. | ||||||
| SHOW_DYN_INFO {Mask|HOBJ} [Row] | It enables displaying a configuration and the current status of a particular eval tag. The eval tag is defined as an input parameter either through its ID (HOBJ) or mask. If several eval tags match the mask, the first 20 tags will be displayed. If Row parameter is different than 0, it must be the eval tag, the values of which are written to a destination column of structured variable. For common eval tags (those that have not a destination column) the Row parameter must be 0 or not specified. The log format is identical with the format [Calc], which is stated in the article Checking values of destination columns, Example 3. | ||||||
| GET_SOURCE_VALUE HOBJ Row Col | It enables the displaying of the inputs into the calculation providing they are the inputs from the structured variables. The log format is identical with the format [DestVal] Checking values of destination columns, Example 3. Note: This command is mainly used for diagnostic purposes in D2000 systems. |
...