...
DEBUGWIN DEBUG/REQ/KOMARC | The Debug window of the process D2000 KOM displays:
| ||||||||||||||||||
| 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 oldest data stored in the KOM Archive. | ||||||||||||||||||
| Reads historical values from a device - station StationName. The values from defined 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 tell command. For some protocols (OPC DA, OPC HDA and IEC 870-5-104), there can be used a parameter of mask "M:", which is used to read the archive values only for selected I/O tags from the station StationName, which match the mask. | ||||||||||||||||||
LNSTAT OPEN/CLOSE LineName | The command can be used only for the lines of Serial category (asynchronous serial lines). 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. Default format is hexadecimal. | ||||||||||||||||||
READKOMARC ["BeginTime"] ["EndTime"] | Reads the values from KOM Archiv. There are transferred all old values from given 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 given 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 in each 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 become evident only in internal data structures of KOM process. It is not sent, in a centralized way, to server, i.e. changed address is valid until restart of 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 limited group of communication protocols: | ||||||||||||||||||
SETSTADDR name "address" | Dynamic change of station address. The parameter name specifies station. It can be entered as the object name (e.g. "S.Stanica"). Parameter "address" defines its new address. Change of station address will become evident only in internal data structures of KOM process. It is not sent, in a centralized way, to server, i.e. changed address is valid until restart of process. After this, the value from the initial configuration will be used again. Return codes:
Dynamic change of address is implemented only for limited group of communication protocols: | ||||||||||||||||||
SHOW TAG TagName/TagHOBJ | Enables debug information for given I/O tag. The command requires either the name or HOBJ of I/O tag. The debug information is usable for D2000 System developers. | ||||||||||||||||||
SHUTDOWN WINNT | Restarts the computer with the process D2000 KOM (the process must be running). | ||||||||||||||||||
| Starts a data recording into subdirectory (application directory) with the name dir_name_only. If the directory does not exist, it will be created. The start of tell command from D2000 Server - at first, the file containing the initialization values of DODM objects dodm_values.dat is recorded and then 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 record: Note: Tell command uses the format "dd-mm-rrrr hh:mm:ss" for the parameters of datetime type. | ||||||||||||||||||
| Stops a data recording immediately, it is not necessary to wait for end_time. If the recording does not work, the error will occur. Note: It is possible to start up this tell command from D2000 Server, as well as directly from the clients (currently only from KOM client). | ||||||||||||||||||
| Starts a data replaying from subdirectory (application directory) with the name dir_name_only. If the directory does not exist, the error will occur. The start of tell command from D2000 Server - at first, the file containing the initialization values of DODM objects dodm_values.dat is recorded and then D2000 Server will send this command to the clients with parameter /NOW. It replays all data (in data files) with the time stamp >= begin_time. Time stamp of data represents the particular time from the recorded time period. Time of data replaying must be from the range of the recorded time period. Example of data replaying:
Time Stamp (TS) - blue color, current time (CT) - red color Note: Tell command uses the format "dd-mm-rrrr hh:mm:ss" 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 D2000 Server, as well as directly from the clients (currently only from KOM client). | ||||||||||||||||||
STDOUT output | The command redirects the standard output to new one. Example: | ||||||||||||||||||
STOP | Stops the process D2000 KOM. | ||||||||||||||||||
| Enables the communication (the parameter START) or disable the communication (parameter STOP) on the station StationName. The station will get the value StON (START) or StOFF (STOP). | ||||||||||||||||||
STWATCH StationName ["Number"] | The command generates one or several requests for priority reading of all I/O tags on given station. It can be used only for some communication protocols (of request-response type). The parameter Number defines the number of requests, possible value is within 1...5. If the parameter is not defined, just one request will be generated. |
...
SHOW_HANDLE [table/database/structure_definition HOBJ] or [table mask] | Shows information on open descriptors. For more information see the chapter DBManager - debugging. |
SHOW_CONNECT [database HOBJ [connect/transaction ID]] or [database mask [connect ID]] [DETAIL] | Shows information on open connections. For more information see the chapter DBManager - debugging. |
SET_WATCHDOG database_mask seconds [NONTRANS] | Switches on the monitoring of connections that perform SQL commands longer than the specified time seconds. This information can be used for profiling of applications and and for detection of slow SQL commands. If a NONTRANS clause is specified, transactional connections are not monitored. Starting with version 10.1.39, after the long running SQL is finished, detailed info about it is written to a log file. More information can be found in chapter D2000 DBManager - debugging. |
SET_WATCHDOG_QUEUE database_mask seconds [NONTRANS] | Switches on the monitoring of database actions which take longer to be processed (including waiting in queues of DBManager) than the specified time seconds. After such a database action is finished, detailed info about it is written to a log file. If a NONTRANS clause is specified, transactional connections are not monitored. More information can be found in chapter D2000 DBManager - debugging. |
MONITOR_TRANS SHOW {ALL/<id>} [<file_path>] / ON <history_depth_sec> / OFF / RESET | Monitoring the transactions. ON - activates the monitoring. <history_depth_sec> means a time-depth history of closed transactions. OFF - deactivates the monitoring RESET - resets the list of transactions (including the opened ones) SHOW - shows either the list of transactions including the history (ALL), or the particular transaction (<id>) to a console or file <file_path> in csv format separated by ";" Columns in the list: - ID (transaction identifier) - time, task, traceback (time the last operation within the group of identical ones, task, traceback in the internal code) - comment, count (the last comment and the number of consecutive identical operations) (the identical operations has the same task and traceback) Note: After starting DBManager, the monitoring is switch off. |
MONITOR_CONNECTS SHOW {ALL/<id>} [<file_path>] / ON <history_depth_sec> / OFF / RESET | Monitoring the connections. ON - activates the monitoring. <history_depth_sec> represents the time-depth history of closed connections. OFF - deactivates the monitoring RESET - resets the list of connections (including the opened ones) SHOW - shows either the list of connections including the history (ALL), or the particular connection (<id>) to a console or file <file_path> in csv format separated by ";" Columns in the list: - ID (auxiliary identifier of connection) - logon_time, logon_task, logon_traceback (time of connection, task and traceback in internal code) - logoff_time, logoff_task, logoff_traceback (time of disconnection, task and traceback in internal code) - comment (the last written comment for the given connection, e.g. traceback in ESL code) Note: After starting DBManager, the monitoring is activated with the time-depth history of closed connections which is 3 hours (10 800 seconds). |
TIME_STATISTICS database_mask [DETAIL] | Displays statistics of execution of individual database action types per-database or per-table (if a parameter DETAIL is specified). For more information see the chapter DBManager - debugging. |
...