D2000 Tell - command syntax
D2000 Server
D2000 Archiv
D2000 Kom
D2000 Event
D2000 Calc
D2000 DBManager
D2000 Alarm
D2000 Topology
D2000 GateWay
D2000 WorkBook
...
D2000 SERVER (KERNEL)
AUDIT_INFO [REINIT [USER|RESGROUP]] | The |
process 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 |
type types of objects will be written into the monitoring database. |
BACKUP SYSCFG path | Creates a configuration database backup in a directory specified by |
the parameter paththe path parameter (Sybase SQL Anywhere and PostgreSQL platforms). Note |
1: The backup can be influenced by the setting |
of parameter Note 2: This functionality can not be used for databases built on PostgreSQL. Such databases can be backed up according to this instruction. BACKUP VALUES path | Creates the backup of the database VALUES. DB in the directory specified by the parameter path. |
BACKUP LOGFILE path | Creates a log database backup in the directory specified |
by the parameter path. Note 1: This functionality can not be used for databases built on PostgreSQL. Such databases can be backed up according to this instruction. by the path parameter (Sybase SQL Anywhere and PostgreSQL platforms). |
CFGSYNCHROAUTO ON/OFF | Enables/disables the automatic |
synchronisation synchronization of configuration databases after a new SBS ( |
stand-by 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 parameter ConfigSynchroTimeout. |
CHECK_ARCHIVE | Checks a value type consistency between the primary archive object and the |
archival 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 |
than the archival objecthistorical value. |
Kotva |
---|
| deploy_java_shared |
---|
| deploy_java_shared |
---|
| DEPLOY_JAVA_SHARED | 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 ( |
only if is displayed on the desktop). 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 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. INSTANCE GET PREFERRED process_name | Shows the number of the preferred process instance. | Kotva |
---|
| set_pref_inst |
---|
| set_pref_inst |
---|
| INSTANCE SET PREFERRED process_name instance_number | Sets a preferred process instance. It is used to set the preferred archive if the archives run as an instance (for more information see the chapter Redundant archiving). By default, the instance with a minimal number is active. This parameter can be used also for setting up the D2000 KOM process (for more information see the chapter Redundancy of communication process KOM). The command writes the number of the preferred instance into the system registers: HKEY_LOCAL_MACHINE\Software\Ipesoft\D2000V70\cfg_Meno_Aplikacie\Kernel\SELF.ARC_PreferredActiveInstance Warning: If the preferred value is 0, the process instances are not switched actively while the terminated active instance is started. I.e. when some active instance is finished, other existing instance will be a new active instance. If there are more process instances, the active one will be that with the minimum instance number. This process instance remains active even if |
|
other another one is started (it had to be active before termination). Incorrect termination of the active and preferred instances may change the preferred process instance. If the active instance crashes while |
|
other another instance is operating, it becomes a new preferred active instance (with the minimum number). | INSTANCE GET ACTIVE process_name | Enables to display the number of the active process instance. | INSTANCE SET ACTIVE process_name instance_number | Sets the active instance of a given process. The parameter is used for setting up the active instance of the archive process |
|
, if all the instances are running as instances (for more information see the chapter Redundant archiving). By default, the instance with a minimal instance number is active. This parameter can be used also for setting up the D2000 KOM process (for more information see the chapter Redundancy of communication process KOM). The command switches the active instance of the process. | INSTANCE GET USABLE process_name instance_number | Enables to display '1' if a process of a given instance is active in load-balancing mode. If not, then '0'. | Kotva |
---|
| set_inst_usable |
---|
| set_inst_usable |
---|
| INSTANCE SET USABLE process_name instance_number 1|0 | Sets the instance of the process as active or passive in Load balancing mode (see the chapter Redundant archiving - Load balancing). |
|
|
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 |
to connect 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 HOT server in the redundant system. The parameter serverName is the name of the server within |
the frame of the redundant group. |
Kotva |
---|
| refresh_licence |
---|
| refresh_licence |
---|
| REFRESH_LICENCE | On-line refresh of the information about the |
licence license range (from file LicenceRun.code or LicenceDev.code) and information about the network clients (from file ConsolesInfo.txt). It enables |
to change licence 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 |
licence license is sent to the client processes when connecting to D2000 Server. For that reason, if the change of |
licence license affects even other processes than D2000 Server, they must be restarted. For example, when a user |
add 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 |
Loads Reloads all parameters for |
kernel D2000 Server (except the parameters for saving the monitoring database to the depository |
). The D2000 System may not be restarted) from the registry (Windows) or from the configuration file (Linux) without restarting the D2000 system. |
RELOAD_SECURITY | Sets the new configuration of Security Policy |
with no need to restart without restarting the D2000 System. |
REPAIR_ARCHIVE | Checks |
a the consistency of value type |
consistency primary archive and archival onebeing archived and the historical value. If some error occurs, it will |
repair it be repaired immediately and |
write information will be written into the log. The error is if the value type of the |
primary archive object being archived is different |
than the archival object.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 |
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. |
Kotva |
---|
| set_load_bal_mode |
---|
| set_load_bal_mode |
---|
| SET_LOAD_BAL_MODEprocess_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. |
Kotva |
---|
| show_access_list |
---|
| show_access_list |
---|
| SHOW_ACCESS_LIST | The command writes the list of the names registered by the GETACCESS action |
GETACCESS within the application (with the keyword PUBLIC) into the text console and to the log file (kernel.log) of the |
process register Kotva |
---|
tcp_no_delay | tcp_no_delay | TCP_NO_DELAY process_name|process_mask [FALSE|TRUE|QUERY] Enables, disables or queries the delay of data transfer between the process D2000 Server and the client connected via TCP/IP protocol. Setting the parameter TCP_NO_DELAY to TRUE disables TCP delay before sending TCP packets (function setsockopt with parameter TCP_NODELAY - see Nagle's algorithm). The delay improves 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 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 client, which also changes TCP_NODELAY parameter of its TCP connection to server. Warning: In current implementation the tell command TCP_NO_DELAY does not cause any change in the setting on client's side! Note 2: Besides the parameter TCP_NO_DELAY, there is also another parameter which 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 TCP_NODELAY parameter. Kotva |
---|
xml_export0 | xml_export0 | XML_EXPORTWarning: 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 registered name as follows: computer_name;process_name;event_name/activepicture_name Example: ACCESS LIST BEGIN GETACCESS : "RegisteredName" is locked by : ComputerName;SELF.EVH;E.EventName GETACCESS : "RegisteredName2" is locked by : ComputerName;ComputerName.HIP;S.PictureName ACCESS LIST END |
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: |
Note: By comparing the information, obtained by this tell command, it is possible to find out whether D2000 Server processes in redundant group are configured identically, resp. if any parameter was omitted during migration of application server. Kotva |
---|
show_dyn_info | show_dyn_info | SHOW_DYN_INFO object_name or HOBJ Shows dynamic information on the specified object (list of objects that dynamically or statically use the object) on the text console of the process D2000 Server. Note: The command is intended to be used mainly for D2000 System diagnostic purposes. SHOW_DYNO_LIST idFirst idLast | The command dumps the list of current dynamic objects (ID and object name) to the text console of 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 D2000 System. |
SHUTDOWN RESTART | Stops D2000 System and restarts the operating system. |
SHUTDOWN SHUTDOWN | Stop D2000 system and shutdown operating system. |
SHUTDOWN WINNT | Stops D2000 System and restarts the operating system. |
START process_name | Starts specified process. |
STDOUT output | The command redirects the standard output to new output specified by output. Example: D2000 on OpenVMS platform: STDOUT "_TNA2:" (output is redirected to the terminal _TNA2:) D2000 on Windows platform: STDOUT C:\output.txt (output is redirected to the file output.txt) Note: If a D2000 process is run on Windows platform as a service, console output is disabled. STOP process_name [FORCE] | It stops a process. When using the optional parameter FORCE, the termination of process will be forced. |
*SUSPEND* SLEEP [WAKEUP yyyy-mm-ddThh:mi:ssZ]|HIBERNATE | It causes, that operating system switches into sleep mode (SLEEP) or hibernation (HIBERNATE). If OS switches into sleep mode, 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).Note: By comparing the information, obtained by this TELL command, it is possible to find out whether D2000 Server processes in a redundant group are configured identically, resp. if any parameter was omitted during the migration of the application server. |
Kotva |
---|
| show_dyn_info |
---|
| show_dyn_info |
---|
| SHOW_DYN_INFO object_name or HOBJ | 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.
Note: The command is intended to be used mainly for D2000 system diagnostic purposes. |
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: D2000 on OpenVMS platform: STDOUT "_TNA2:" (output is redirected to the terminal _TNA2:) D2000 on Windows platform: STDOUT C:\output.txt (output is redirected to the file output.txt)
Note: If a D2000 process is run on the Windows platform as a service, the console output is disabled. |
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). |
TCP_NO_DELAY process_name|process_mask [FALSE|TRUE|QUERY] | 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: |
- Path – defines the directory where the objects will be exported; required parameter.
It must contain the complete path, e.g. c:\XML. The path must exist. If it does not exist, the export is not allowed. Instead of a fixed path, the user can select the default directory - by entering the value "*" into the parameter. The default directory is placed in "[APP_DIR]\XML_EXPORT", where APP_DIR defines the application directory, e.g. c:\D2000\D2000.APP\application_name\XML_EXPORT" ". - Mask – defines the mask, which
|
correspond - corresponds to the list of objects that are to be exported; the required parameter.
- optional settings of XML_SETTINGS
The path for the file export on VMS must be written in Unix format.
Correct syntax: /DKB0/d2000/d2000-app/RIS_ROVE/XML/ mask Incorrect syntax: DKB0:[d2000.d2000-app.RIS_ROVE.XML] mask - this syntax is not supported, export ends with an error. |
Kotva |
---|
| xml_export_table |
---|
| xml_export_table |
---|
| XML_EXPORT_TABLE | The configuration parts export to the XML files, which is not |
the part of the object configuration. The parameters: [Path, FileName, TableName].- Path - defines the path for saving the configuration.
- FileName - defines the name of the output file. E.g. for the
|
file there is created the - a file with the name "systemtxt.xml" is created.
- TableName - defines the table of the database, from which the configuration is to be exported
|
from- .
TableName can acquire the following values: SYS_COLORS, SYSTEM_TEXT, TRANS_MASKA, DICTIONARY, LANGUAGES, LOGDEF, NAME_RULES.
Warning: Extension ".xml" is added automatically, do not |
write explicitly specify it. |
| Warning: This command is not supported for OpenVMS. XML file(s) import |
from the directory, which is defined by the parameter Path.
The parameter:[ 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] The initialization of tell command is conditioned by using a configuration keyfile - 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. Correct syntax: /DKB0/d2000/d2000-app/RIS_ROVE/XML/ Incorrect syntax: DKB0:[d2000.d2000-app.RIS_ROVE.XML] - this syntax is not supported, import of directory containing XML files ends with an error
The import of one file supports |
the both records: Correct syntax: /DKB0/d2000/d2000-app/RIS_ROVE/XML/file.xml Correct syntax: DKB0:[d2000.d2000-app.RIS_ROVE.XML]file.xml 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. |
Kotva |
---|
| xml_import_table |
---|
| xml_import_table |
---|
| XML_IMPORT_TABLE | Import of the configuration parts that |
is the part of the object configuration from XML files. The parameter [Path, FileName, TableName[, CleanTable]]- Path - defines the path from which the configuration will be read.
- FileName - defines the name of the input file without
|
xml - XML extension. For example, "systemtxt" for the file with the name "systemtxt.xml".
- TableName - defines the table of the database to which the configuration is to be imported.
TableName can acquire the following values: SYS_COLORS, SYSTEM_TEXT, TRANS_MASKA, DICTIONARY, LANGUAGES, LOGDEF, NAME_RULES. - CleanTable - defines whether the table in the database will be cleaned before import.
This parameter is optional, the default value is FALSE.
|
Parameter - The parameter can acquire two values: TRUE - clean table, FALSE - the table is updated.
The initialization of |
tell 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 |
TELL commands a 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. |
D2000 ARCHIV
BACKUP [path] | Creates an archive database backup. If the parameter path is not specified, the backup will be performed into the directory, which is set in the archive configuration. Note: this command is supported for Sybase SQL Anywhere only. To back up Oracle/PostgreSQL/MsSql databases, use their respective utilities. |
Kotva |
---|
| calc_old_requests |
---|
| calc_old_requests |
---|
| CALC_OLD_REQUESTS [path+filename] | Executes recalcs of old values, which were redirected to the auxiliary calc task (see |
the archive RecalcImmediateDepth), and then instead of being performed, they were stored to the file (see the DropOldRequests archive parameter |
DropOldRequests). If path+filename is not specified, the file name_ARCHIV_DROPPED_CALCS.DAT will be processed by name.ARC and then renamed to name_ARCHIV_DROPPED_CALCS.DONE (if such a file exists, it will be deleted). Note: This command fails if the archive parameter DropOldRequests has value 1 |
, because in this case the recalcs would be again stored to the file after being read. |
Kotva |
---|
| cleanup_slices |
---|
| cleanup_slices |
---|
| CLEANUP_SLICES | A command that must be run after the change of DataTableSlices parameter |
DataTableSlices from value 1 to value 2 (i.e. after changing the time slices mode to time slices for structured archives only).
|
Archive The archive will transfer the archived values from time slices of simple archives to the original data tables and these time slices will be deleted. Note: for simple archives, from the start of the |
the archiv archive till the transfer of archived values to the original data tables, the |
archiv archive will provide only data which are located in original data tables. Therefore this conversion is recommended only for systems with redundant archives and the archive performing conversion should be set as a passive instance. |
CRC path\filename mask from to [step] [PO] | Parameter checks the identity of data |
identity in instance archives. Creating the file with a CRC (checking sum) for archive objects that correspond to the mask for the entered time period.
|
Optional The optional parameter step (in hours) allows |
to divide dividing the calculation for time period into intervals. The PO parameter |
PO ensures the calculation will be executed only for primary archive data.
Note: Values entering the CRC calculation can be "truncated" - in a 64-bit floating-point value complying with the IEEE 754 standard, the two lowest bytes will be zeroed, if a debug category DBG.ARCHIV.CRC.Z2LB is enabled. The truncation can be used to ignore minor differences (16. and higher decimal point), which can occur in floating-point calculations in archives running on different processors. |
CRC_TREE path\filename name row col from to [step] | Parameter checks the identity of data |
identity in instance archives. Creating the file with CRC (checking sum) for archive objects that correspond to the mask for the entered time period. The calculation will be realized for the object that has been defined by parameter "name row col" and for all objects that influence its value.
|
Optional The optional parameter step (in hours) allows |
to divide dividing the calculation for time period into intervals. See the note to the CRC command. |
DEL mask [before] | Deletes data from the archive database as follows:- the parameter before is not defined - for individual archive objects, there will be deleted all data that are older than the history depth (the parameter History depth) defined in the configuration of the objects,
- the parameter before is defined - there will be deleted all data with the timestamps older than defined by the parameter before.
|
DELETE_DATA mask from [to] | Deletes data from the archive database without activation of dependent statistics evaluation (similar to the action DELETEARCHDATA). Time format is dd-mm-rrrr hh:mi:ss.mss. |
DI ON/OFF | Debug Info - shows/hides internal debug information of the |
process only if is displayed on the desktopand in the D2000 Sysconsole process). |
DI ON/OFF [HOBJ/mask [ROW [COL]]] | Debug Info for values - enables/disables displaying information about the evaluation of historical values with specified HOBJ or with the name matching given mask. For structured historical values, you can specify the required structure item - column (if ROW=0) or row (if COL=0). Example: DP ON H.Test1 3 4 - enables debug information for the item of structured historical value H.Test1 on row 3 and column 4 DP ON H.Test2 - enables debug information for historical value H.Test2 (for all items if the object is a structure) DP OFF 1234 0 4 - disables debug information for the whole column 4 in the structured historical value with HOBJ=1234
By default, debug information shows just the time and the value of historical value. Enabling the debug category DBG.ARCHIV.DATA (in the process D2000 System Console or using the start parameter /E+DBG.ARCHIV.DATA when starting the process D2000 Archiv), allows to show the complete stored data designed for the D2000 System developers: Time (archive value time) Value (value) Status (a True/False array containing Valid, ProcAlarm, NoAckPAlarm, PrAlSilent, Weak, NoAckValue, Transient, Default, Manual, AlCrit, Unknown values) Limits (one of the value of InLimit, VL_Limit, L_Limit, H_Limit, VH_Limit, LimitsProblem) ArchFlags (a True/False array containing Start, Stop, Block, UnBlock, Deleted, UserModify, OldVal, ProcesModify, LoadData, MONO_TIME, K, L, M, N, O, Ver1 values) |
DI ONREC/OFFREC HOBJ/mask [ROW [COL]] | Debug Info for values - recursive. The command extends the functionality of the previous commands with the possibility of showing / hiding the debug information for historical values that depend on specified historical values (e.g. minute averages). |
Kotva |
---|
| dismount_trezor0 |
---|
| dismount_trezor0 |
---|
| DISMOUNT_TREZOR path+trezor_name | Sybase platform: The parameter path+trezor_name specifies the path and the name of the depository database to dismount. The * and ? characters for mask definition can be used in the depository database name. If more files match to entered mask, all these ones will be dismounted.
For more information see the topic On-line access to data from depository databases. |
Kotva |
---|
| dismount_trezor_ora0 |
---|
| dismount_trezor_ora0 |
---|
| DISMOUNT_TREZOR Id [SEGMENT seg]DISMOUNT_TREZOR trezor_name [SEGMENT seg]DISMOUNT_TREZOR IdFrom IdTo [SEGMENT seg] | Oracle platform: The parameter Id or trezor_name defines the number (name) of the depository database to dismount.
|
Name The name of the depository database is the name of depository tablespace (e.g. MYAPP_TS_TREZOR15 or MYAPP_TS_TREZOR15_02) or the name of tablespace's datafile (e.g. MYAPP_TS_TREZOR0015_S02_20040801.ORA). You can also dismount all depository databases (except the ones that are currently being filled) by using the parameter all. The parameters IdFrom and IdTo allow |
to dismount dismounting a sequence of depository databases. The parameter SEGMENT seg (where seg is the number |
of to dismount command DISMOUNT_TREZOR command is used without |
the parameter the SEGMENT Seg parameter for depository database with segments enabled, the process D2000 Archiv attempts to dismount all segments of specified depository database/s.
For more information see the topic On-line access to data from depository databases. |
Kotva |
---|
| dismount_trezor_pg |
---|
| dismount_trezor_pg |
---|
| DISMOUNT_TREZOR Id [SEGMENT seg]DISMOUNT_TREZOR IdFrom IdTo [SEGMENT seg] | PostgreSQL platform: The parameter |
Id Id defines the number of depository database to dismount. You can also dismount all depository databases (except the ones that are currently being filled) by using the parameter all. The parameters IdFrom and IdTo allow |
to dismount dismounting a sequence of depository databases. The parameter SEGMENT seg (where seg is the number |
of to dismount dismounting just the segment. Seg is the number between 0 and TrezorCountSegments. If the command DISMOUNT |
is _TREZOR is used without the parameter SEGMENT Seg for depository database segments enabled, the process D2000 Archiv attempts to dismount all segments of specified depository database/s.
For more information see the topic On-line access to data from depository databases. |
DP ON/OFF | Debug Pipe - shows/hides the course of communication with D2000 Server (only if the process window is displayed on the desktop). |
DROP_LIST path+filename | Creates the file (defined by the parameter path+filename) containing SQL commands to delete tables, which are not used by the archive configuration. If the time slices are enabled, the file will contain also the commands to delete respective rows of the table ARC_SLICE, which contain information about the time slices corresponding to tables that are to be deleted. |
| Manual loading of archive cache (only available for isochronous cache mode) by reading values from the archive database. Archive cache loading can be also automatic after startup - for more information see description of parameter IsoCacheAutoFill. |
| For the selected object(s), their ClearTime is set to a value of several hours in the past, which means that a periodic delete of object's data should occur shortly - within a minute (unless it is disabled for some reason, e.g. if the time slices are enabled, it can depend on parameters DeleteInSlice0 and DeleteInSlices). |
FREEZE freeze_seconds [report_seconds]UNFREEZE | FREEZE command causes the writing and calculating tasks of archive stop processing the requests for a period freeze_seconds. Within this time, |
the next another task (deleting) will list the number of requests (primary and calculated) in the queues. After the elapsing of the |
time freeze_seconds time, the processing of values will be restored. If |
the parameter the report_seconds parameter is entered, the deleting task continues to list the number of |
request requests in the queues for this period. FREEZE command is primarily used for performance tests (testing the maximum speed for processing the requests under load). Before its |
usinguse, you should realize that it does not influence reading from the archive, but during its execution, the writing to the archive (so the newest values are not available when reading) and the calculations are not executed for the |
period secondsseconds period. In the redundant systems with 2 and more archives, we recommend |
to execute executing the FREEZE command on a passive instance, so that the functionality of the archiving subsystem will not be affected. UNFREEZE command (without parameters) is used for aborting |
an inactivity that was caused by the FREEZE command. |
| Activates the |
process to shows depends depend on the used platform - Sybase, PostgreSQL, or Oracle. Parameter id: |
LOAD_TREZOR path+filename [mask] [from] [to] | On- |
line . (Sybase only) |
Kotva |
---|
| mount_trezor0 |
---|
| mount_trezor0 |
---|
| MOUNT_TREZOR path+trezor_name | Sybase platform: The |
parameter path+depository_name parameter defines the path and name of the depository database to be mounted. The name may contain "*" and "?" characters to define a mask. If more files match the specified mask, all these will be mounted.
For more information see the topic On-line access to data from depository databases. |
Kotva |
---|
| mount_trezor_ora |
---|
| mount_trezor_ora |
---|
| MOUNT_TREZOR Id [SEGMENT seg] [WRITE] MOUNT_TREZOR trezor_name [SEGMENT seg] [WRITE]MOUNT_TREZOR IdFrom IdTo [SEGMENT seg] [WRITE] | Oracle platform: The parameter Id (trezor_name) defines the number (name) of a depository database to be mounted.
|
Name The name of the depository database is the name of depository tablespace (e.g. MYAPP_TS_TREZOR15 or MYAPP_TS_TREZOR15_02) or the name of tablespace's datafile (e.g. MYAPP_TS_TREZOR0015_S02_20040801.ORA). The |
parameters IdFrom and IdTo parametersallow |
to mount the mounting a sequence of depository databases.
|
The parameter The SEGMENT Seg parameter (where Seg is the number of |
the to mount on just one mounting a single depository database segment. If the MOUNT_TREZOR command |
MOUNT the parameter the SEGMENT Seg parameter for depository database with segments enabled, the process D2000 Archiv attempts to mount on all segments of specified depository database/s. The parameter Write can be used to mount the depository database (s) for writing (for depository |
databases database synchronization through the Arcsynchro tool).
For more information see the topic On-line access to data from depository databases. |
Kotva |
---|
| mount_trezor_pg |
---|
| mount_trezor_pg |
---|
| MOUNT_TREZOR Id [SEGMENT seg] [WRITE] MOUNT_TREZOR IdFrom IdTo [SEGMENT seg] [WRITE] | PostgreSQL platform: The parameter Id specifies the number of a depository database to be mounted. The parameter SEGMENT Seg (where Seg is the number of the depository database segment) allows |
to mount on just one mounting a single depository database segment. If the MOUNT_TREZOR command |
MOUNT parameter SEGMENT Seg parameter for depository database with segments enabled, the process D2000 Archiv attempts to mount on all segments of specified depository database/s. The parameter Write can be used to mount the depository database (s) for writing (for depository |
databases PENDING_REQUESTS OPTIMIZE_QUEUE | Reduction of the number of calc requests in the archive queue. If for some reason, the number of requests in the archive queue has increased (for example, due to the arrival of old values from the communication), this TELL command can reduce duplicate requests. |
PENDING_REQUESTS path+filename | Creates a file containing the descriptions of pending requests. |
RECALC Mask [Row [Col]] From [To] [BACKGROUND] | Recalculates the values in the statistical archive. Mask - defines the list of objects, which are to be recalculated. If the specific row and/or column of the structured archive |
is is recalculated, it is possible to specify parameters Row and Col (if unspecified, their default value is 0, meaning "whole row/column"). The parameters <From, To> define a time interval to be recalculated. If the end time is not entered, the current time will be used. Time format is dd-mm-yyyy [hh[:mi[:ss[.mss]]]]. Optional parameter BACKGROUND (implemented in version 7.02.006) puts the recalculation to the auxiliary calc task (see the archive parameter RecalcImmediateDepth). The parameter is recommended for long-lasting recalculation of historical values |
which that are supposed to be performed |
on in the background while the archive still continues archiving real-time data.
Note: If the parameter RecalcTimeIntervalLimit has a non-zero value and the time interval <From, To> is longer than RecalcTimeIntervalLimit hours, the parameter BACKGROUND is mandatory, to ensure that the recalculation will be performed by auxiliary calc. This |
behaviour stated implemented as a protection against overloading the main task by recalculations. |
Kotva |
---|
| release_trezor |
---|
| release_trezor |
---|
| RELEASE_TREZOR |
Early Premature disconnection of the current depository database. |
Kotva |
---|
| rem_empty_slices |
---|
| rem_empty_slices |
---|
| REM_EMPTY_SLICES HOBJ|mask | If the time slices are activated, the command causes |
that will all all time slices of simple archive objects according to the defined HOBJ or mask and |
deletes to delete the time slices without data. The command is used to |
purify clean up the archive database from empty time slices that were created due to the error of the archive. This error was repaired in the supported versions |
in line line reorganization of archive database. The command compacts all archive tables (same as the Oracle command ALTER TABLE MOVE or the Sybase command REORGANIZE TABLE INDEX or the PostgreSQL command VACUUM - see the PG_ReorganizeSlice parameter). Note: For Oracle, PostgreSQL, and Sybase 8.0 (and above) platforms |
or later only. |
Kotva |
---|
| reorganize_slice |
---|
| reorganize_slice |
---|
| REORGANIZE HOBJ|mask [SLICE slice] [tablespace] | On- |
line line reorganization of archive table of an object with specified HOBJ or with a name matching the specified mask. If the parameter tablespace is also defined, the given archive table will be moved to the specified tablespace. If time slices are on, all slices of one archive object will be reorganized/moved unless a slice number slice is specified. Note 1: The parameter tablespace can be used on |
Oracle platform Oracle and PostgreSQL platforms only. Note 2: The slice number, except for ordinary values, supports special values: - value -1 means "all slices"
- value -2 means "slice for current time"
- value -3 means "previous time slice"
- value -4 means "all slices older than current time slice"
|
REORGANIZE ON | Enables |
the the the the tell command the REORGANIZE MOVE command . |
REORGANIZE TableRowLimit rowLimit | On-line change of the parameter ReorganizeTableRowLimit |
used Tell command The SET_OPTION command controls the following configuration and start-up parameters of the process D2000 Archiv:
|
WorkingHoursStartWORKINGHOURSSTART which that are stored in the Registry database the |
tell command SET_OPTION command will change the value of configuration parameters not only in the archive but also in the Registry database. |
Kotva |
---|
| show_dyn_info_archiv |
---|
| show_dyn_info_archiv |
---|
| SHOW_DYN_INFO HOBJ/name [ROW [COL]] | Shows dynamic information on the specified object (current value, last sent value, time of next calculation for |
periodic periodically archived objects, time of periodic deleting, parameters, and content of cache) on the text console of the |
process D2000 Archiv process. Note: The command is mainly intended for D2000 |
System system diagnostic purposes. |
| If archive cache is enabled, the result is a list of top count historical values having the most values in archive cache. For every value, the following properties are displayed: HOBJ, name, number of items, and time interval of values in archive cache. |
Kotva |
---|
| show_config_arc |
---|
| show_config_arc |
---|
| SHOW_CONFIG | Shows configuration information of the process D2000 Archiv and archive database. This information covers:- start parameters of the process specified in the configuration of archive process (if the archive process is run by process D2000 Server ), or archive service (if the archive process is run by its own watchdog), or command-line parameters (if the archive process is run manually),
- parameters for archive specified in Windows registry,
- parameters stored directly in the archive database in LOG_DATA table (see the parameter /CLD of arcsynchro utility),
- specific parameters of the database (currently only for Oracle platform).
Note: By comparing information, obtained by this |
tell there it is possible to find out whether the redundant archives are configured identically or if any parameter was omitted during the migration of archive, database, etc. |
| Shows various information about |
the process the D2000 Archiv process and the archive database. |
STATISTICS path+filename hours | Creates the file path+filename with statistical information, i.e. number of values for individual historical values from the last n-hours. The path+filename file will be created by the D2000 Archiv process, so its naming is OS-dependent (e.g. D:\stat.txt on Windows, /tmp/stat.txt on Linux). |
| The command redirects the standard output to a new output. Example: D2000 on OpenVMS platform: STDOUT "_TNA2:" (output is redirected to the terminal _TNA2:) D2000 on Windows platform: STDOUT C:\output.txt (output is redirected to the file output.txt) Note: If a D2000 process is |
runing running on the Windows platform as a service, the console output is disabled. Therefore if this functionality is required, it is necessary for a D2000 process to be started by D2000 Server without /X parameter. |
Kotva |
---|
| stop_import_data |
---|
| stop_import_data |
---|
| STOP_IMPORT_DATA | Deactivates a feature of the process D2000 - import of external data. |
STOP [NOQUEUE] | Stops the process D2000 Archiv. All unsaved values from the request queue are to be automatically stored on the disk and during the next starting the process, the values will be read from the disk. The current values of historical values are to be stored in the table SAVED_LAST_ROWS to quicken the next start of the process. If theNOQUEUE parameter |
NOQUEUE is used, the unsaved values from the request queue will not be stored in the file (it |
quickens speeds up stopping the process with a large |
amount number of unprocessed values). |
TIMESTAT START TIMESTAT RESTART TIMESTAT SHOW TIMESTAT SHOWLONG TIMESTAT SHOWSTART TIMESTAT STOP | Starts (START), stops (STOP), restarts (RESTART), shows (SHOW), shows and restarts (SHOWSTART) or shows the time statistics of reading task(s) in long time format, including the days (SHOWLONG). After starting the statistics, the database reading task(s) will start the measuring time, spent in various parts of the reading procedure. These values can be used for tuning by system specialists. Time statistics are displayed per reading task and if ReadThreadsCount > 1, also totals for all read tasks are shown. Note: When time statistics are on, reading from archive may be several percent slower due to time measuring. |
D2000 KOM
DEBUGWIN DEBUG/REQ/KOMARC | The Debug window of the process D2000 KOM displays: - DEBUG - trace communications with devices (implicit setting),
- REQ - current processed communication request + requests in queue,
- KOMARC - trace readings/writings into the archive file of KOM Archiv.
|
Kotva |
---|
kom_di | | Debug Info for values - enables/disables displaying information about the evaluation of:- I/O tag with specified HOBJ,
- all I/O tags on the station with specified HOBJ,
- I/O tags with the name matching the given mask,
- all I/O tags on the stations with the names matching the given mask.
|
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. |
GETOLDVAL StationName [M:PointMask] [NORECALC] "BeginTime" ["EndTime"] | Reads historical values from a device - StationName station |
StationName defined 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 |
tell command there can be used of mask "M:" can be used, which is used to read the archive values only for selected I/O tags |
from the station StationName, which match the mask, from the StationName station. |
LNSTAT OPEN/CLOSE LineName | The command can be used only for the lines of Serial |
category (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. |
Default The default format is hexadecimal. |
READKOMARC ["BeginTime"] ["EndTime"] | Reads the values from KOM Archiv. There are transferred all old values from |
given 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 |
given the specified interval. Return codes: - SUCCESS - transaction successful, data transfer to the system finished,
- IGNORED - the process D2000 KOM is not running in the mode of KOM Archiv,
- ERROR - invalid parameters (time format: dd-mm-yyyy hh:mi:ss), wrong sequence of entered times - BeginTime > EndTime.
|
RESETPERF LineName/StationName | 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 every 10 seconds). |
SETPTADDR name "address1" "address2" | 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 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: - SUCCESS - changed address (the value of the I/O tag is invalid
|
till - until it is read from the new address).
- IGNORED -
|
process - D2000 KOM process does not support dynamic address change
|
- licence limitation- for the specified protocol.
- ERROR
- duplicate address
- point not found
- bad address format
Dynamic change of the I/O tag address is implemented only for a limited group of communication protocols: |
SETSTADDR |
name StationName|StationHOBJ "address" | Dynamic change of station address. The first parameter |
name specifies the station. It can be entered as the object name StationName (e.g. " |
SStanicaStation") or station ID StationHOBJ. |
Parameter The "address" parameter defines its new address. Change of station address will |
become evident 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: - SUCCESS - changed address,
- IGNORED - D2000 KOM does not support a dynamic change of address for
|
given - the specified protocol,
- ERROR
- object not found
- invalid number of parameters
Dynamic change of address is implemented only for a limited group of communication protocols: |
SHOW TAG TagName/TagHOBJ SHOW NAN | Enables debug information for |
given 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). |
START_RECORD dir_name_only [begin_time] end_time | |
STALTERPATH StationName ON|OFF | 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"). |
START_RECORD dir_name_only [begin_time] end_time | Starts a data recording into a |
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 firstIf this TELL command is run from the D2000 Server, firstly, the file dodm_values.dat containing the initialization values of DODM objects |
dodm_values.dat 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: Data files, recorded by |
tell the TELL command: START_RECORD DirName "01-12-2008 08:22:27" "01-12-2008 11:02:07" These four data files (it relates to four hourly intervals) are the result of |
recordrecording: KOM-SELF_2008_12_01_08.dat < 01-12-2008 08:22:27 ; 01-12-2008 09:00:00 > KOM-SELF_2008_12_01_09.dat < 01-12-2008 09:00:00 ; 01-12-2008 10:00:00 > KOM-SELF_2008_12_01_10.dat < 01-12-2008 10:00:00 ; 01-12-2008 11:00:00 > KOM-SELF_2008_12_01_11.dat < 01-12-2008 11:00:00 ; 01-12-2008 11:02:07 > Note: |
Tell the format "dd-mm-rrrr hh:mm:ss" format for the parameters of |
datetime DateTime type. It is possible to |
start up this tell initialize this TELL command from the D2000 Server, as well as directly from the clients (currently only from |
KOM client chosen the specified subdirectory in the application directory, |
in the form of data files representing where a separate data file is created for every hourly time period. |
| Stops a data recording immediately, it is not necessary to wait for end_time. If the recording |
does work the occurbe returned. Note: It is possible to start up this |
tell command TELL command from the D2000 Server, as well as directly from the clients (currently only from |
KOM client).the D2000 KOM and Gateway Client processes). |
START_REPLAY dir_name_only [begin_time [/NOW]] or START_REPLAY dir_name_only /LOOP | Starts a data replaying from a subdirectory (of application directory) with the name dir_name_only. If the directory does not exist, |
the occur The start of tell command from If the command is run from the D2000 Server - at first, the dodm_values.dat file containing the initialization values of DODM objects |
dodm_values.dat is recorded will be recorded by the D2000 Server, and then the D2000 Server will send this command to the clients with /NOW parameter |
/NOW. It replays all data (in data files) with the time stamp >= begin_time. |
Time stamp The timestamp of data represents |
the a particular time from the recorded time period. |
Time The time of data replaying must be from the range of the recorded time period. Example of data replaying:
|
begin_timeTime Stamp (TS) - blue color, current time (CT) - red color begin_time | /NOW | Description | no | no | - data are replayed immediately
- if CT = 02-12-2008 14:11:02, data are replayed from TS >= 01-12-2008 09:11:02
- if CT = 02-12-2008 14:33:55, data are replayed from TS >= 01-12-2008 08:33:55
| yes | no | - if begin_time = 01-12-2008 08:27:27, data are replayed from time so that this time corresponds with a shift from hour
- if CT = 02-12-2008 14:11:02, data are replayed from TS >= 01-12-2008 08:27:27, when CT = 02-12-2008 14:27:27
- if CT = 02-12-2008 14:33:55, data are replayed from TS >= 01-12-2008 08:27:27, when CT = 02-12-2008 15:27:27
| yes | yes | - if begin_time = 01-12-2008 08:27:27, the command finds the nearest time (time stamp) so that data could be replayed immediately
- if CT = 02-12-2008 14:11:02, data are replayed from TS >= 01-12-2008 09:11:02
- if CT = 02-12-2008 14:33:55, data are replayed from TS >= 01-12-2008 08:33:55
In this situation, also data, recorded before TS, are replayed. This data are replayed at the beginning. |
|
Time Stamp (TS) - blue color, current time (CT) - red color If /LOOP is used, data replaying will be again started automatically. It can be stopped by the
|
Tell command REPLAY Tell the format the "dd-mm-rrrr hh:mm:ss" format for the parameters of |
datetime DateTime type. It is possible to start |
up tell command TELL command from the D2000 Server, as well as directly from the clients (currently only from KOM client). Process D2000 KOM can be started up in replay mode only with the start parameter /Replay. It causes, the process D2000KOM does not communicate with devices. |
| 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 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: D2000 on OpenVMS platform: STDOUT "_TNA2:" (output is redirected to the terminal _TNA2:) D2000 on Windows platform: STDOUT C:\output.txt (output is redirected to the file output.txt) Note: See a note for STDOUT command for D2000 Archiv. |
STOP | Stops the |
process D2000 KOM process. |
STSTAT START/STOP StationName | Enables the communication (the parameter START) or |
disable disables the communication (parameter STOP) |
on with the StationName station |
StationName. The station will get the |
value StON (START) or StOFF (STOP) value. |
STWATCH StationName ["Number"] |
The 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 |
given station. It can be used only for some communication protocols (of request-response type). The parameter Number defines a specified station. The Number parameter defines the number of requests, possible value is within 1...5. If the parameter is not |
defined just one 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: - BACnet (sends ReadProperty, ReadPropertyMultiple, and Subscribe messages depending on the configuration of I/O tags)
- DNP3 (sends requests for reading of all configured Poll Classes specified in configuration of station parameters and for reading of values of all objects with "Explicit read" enabled)
- IEC 60870-6 ICCP/TASE.2 (sends requests for reading values of all I/O tags)
- IEC 61850 (sends requests for reading values of all I/O tags)
- IEC 870-5-101 (sends Interrogation Command/Counter Interrogation Command depending on station protocol parameters)
- IEC 870-5-104 (sends Interrogation Command/Counter Interrogation Command depending on station protocol parameters)
- IEC 870-5-104 Server (sends Interrogation Command/Counter Interrogation Command depending on station protocol parameters)
- IEC 870-5-104 Sinaut (sends Interrogation Command/Counter Interrogation Command depending on station protocol parameters)
- OPC Data Access (sends requests for synchronous reading values of all I/O tags)
- OPC UA (sends requests for reading values of all I/O tags)
|
D2000 EVENT
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 scripts Format: ESL;ESL name
ESL |
DYNAMIC_INFO | Tell command for the processes with the name *.EVH and *.HIS. Tell command does not contain any parameters.After receiving the command, the process writes, into proper log file, information about:
- list of all running instances of ESL scripts Format: 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 ESL name - script identification1
String - registered text string time of GetAccess - time of string registration bGlobal - flag defining the string to be global userComment - comment status - text "IN PROGRESS", if the global string has been registered, otherwise empty text "" - list of all open XML documents (%XML_CreateDocument, %XML_OpenDocument) Format: XML;ESL name;handleXML - text identifying the next information ESL name - script identification1
|
handle - unique numerical identifier of XML document; it is identical to handle - registered text strings (GETACCESS action) Format: ACCESS;ESL name;String;time of GetAccess;bGlobal;userComment;statusACCESS - text identifying the next information ESL name - script identification1 String - registered text string time of GetAccess - time of string registration bGlobal - flag defining the string to be global userComment - comment status - text "IN PROGRESS", if the global string has been registered, otherwise empty text ""
- list of all open XML documents (%XML_CreateDocument, %XML_OpenDocument) Format: XML;ESL name;handle XML - text identifying the next information ESL name - script identification1 handle - unique numerical identifier of XML document; it is identical to handle which is used by functions %XML_*
- list of objects that have been opened by function %OpenRefToObject Format: REFOBJ;Esl Name;Synchro;Obj HOBJ;Obj Name;Open In Progress REFOBJ - text identifying the next information ESL name - script identification1 Synchro - value of parameter _bSynchro at calling of the function %OpenRefToObject Obj HOBJ - unique identifier of opened object Obj Name - unique name of opened object Open In Progress - flag defining if the object is just being opened
- list of active database connections (by |
the actions the DB_TRANS_OPEN, DB_CONNECT, PG_CONNECT, and SQL_CONNECT actions) Format: DBCONNECT;ESL name;DB TRANS HANDLE;SUB CONNECT HANDLE;TYPE;OBJNAME;Prepared SQL Command;Last SQL Prepare; Comment DBCONNECT - text identifying the next information ESL name - script identification1 DB TRANS HANDLE - identifier of transaction connections (it is created by calling the |
action implemented transactional SUB CONNECT HANDLE - identifier of connection (it is created by calling the |
actions DB_CONNECT, PG_CONNECT, or SQL_CONNECT actions) TYPE - type of connection (SUB CONNECT HANDLE) OBJNAME - object name, on which the connection is joining Prepared SQL Command - flag of the existence of prepared SQL command Last SQL Prepare - |
form format of the last SQL command which has been prepared by calling the |
action action SQL_PREPARE action was called
- list of files which have been opened by functions %FIO_* Format: FIO;ESL name;file name FIO - text identifying the next information ESL name - script identification1 file name - |
file namefilename
- list of created data containers (CNT_CREATE action) Format: CNT;ESL name;handle;NR;valTyp;is array CNT - text identifying the next information ESL name - script identification1 handle - unique numerical identifier of data container NR - number of elements valTyp - a type of key which identifies the items in the data container uniquely is array - flag determining whether the action CNT_CNVTOARRAY is applied on |
proper the respective data container
1 - script identification: text string uniquely identifying the running ESL scrip. It contains the object name (HOBJ)[instance number] unique numerical identifier. Example: E.Script(728)[105]1872 (%GetSelfInstanceId, %GetSelfHBJ) |
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: D2000 on OpenVMS platform: STDOUT "_TNA2:" (output is redirected to the terminal _TNA2:) D2000 on Windows platform: STDOUT C:\output.txt (output is redirected to the file output.txt) Note: See a note for STDOUT command for D2000 Archiv. |
TASK_STATUS path+filename | Writes |
just line lines of all the script running in |
given 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. |
D2000 CALC
DP ON/OFF | Debug Pipe - shows/hides the |
course of 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. : 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: D2000 on OpenVMS platform: STDOUT "_TNA2:" (output is redirected to the terminal _TNA2:). D2000 on Windows platform: STDOUT C:\output.txt (output is redirected to the file output.txt). Note: See a note for STDOUT command for D2000 Archiv. |
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: - the identification of the object that caused the conversion and its value
- the output value of the eval tag that was sent to the server
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 command: CALCINFO ON P.OnSec In the LOG file, there is a record 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. Blok kódu |
---|
CALCINFO: P.OnSec[ 0]
VALUE IN $20
GValTyp : INT (Integer)
Status : VALID
LimitStatus : INLIMIT
ProcAlarmStatus : NOALARM
ValTyp : INT
Flags : F,F,F,F,F,F,F,F,F,F,F,F,F,F,F,F
ValTime : 20.11.2017 16:39:59.000
AlarmTime : (null)
Value : 59
VALUE OUT
GValTyp : INT (Integer)
Status : VALID, NOACKVALUE
LimitStatus : INLIMIT
ProcAlarmStatus : NOALARM
ValTyp : CE
Flags : F,F,F,F,F,F,F,F,F,F,F,F,F,F,F,F
ValTime : 20.11.2017 16:39:59.001
AlarmTime : (null)
Value : 60 |
|
STDOUT output | The command redirects the standard output to new one.Example: D2000 on OpenVMS platform: STDOUT "_TNA2:" (output is redirected to the terminal _TNA2:). D2000 on Windows platform: STDOUT C:\output.txt (output is redirected to the file output.txt). Note: See a note for STDOUT command for D2000 Archiv. |
Kotva |
---|
| check_destid_values |
---|
| check_destid_values |
---|
| CHECK_DESTID_VALUES [DestId [ColIndex]] [FlagList] | 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 |
key words 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 |
the 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 |
to display 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) 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.
Note: This command is mainly used for diagnostic purposes in D2000 systems. |
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 |
[Calc], which is stated in the article Checking values of destination columns, Example 3. Note: This command is mainly used for the diagnostic purposes in D2000 Systems.GET_SOURCE_VALUE HOBJ Row Col | It enables to display 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 the diagnostic purposes in D2000 Systems....
D2000 DBMANAGER
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 the profiling of applications and for the 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 that 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>] MONITOR_TRANS ON <history_depth_sec> MONITOR_TRANS OFF MONITOR_TRANS RESET | The mechanism for monitoring of 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 switched off. |
MONITOR_CONNECTS |
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 | 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. 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 | 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. More information can be found in chapter D2000 DBManager - debugging. |
MONITOR_TRANS SHOW {ALL/<id>} [<file_path>] |
/ ON <historyMONITOR_CONNECTS ON <history_depth_sec> |
/ OFF / MONITOR_CONNECTS OFF MONITOR_CONNECTS RESET | Monitoring the |
transactionsconnections.
ON - activates the monitoring. <history_depth_sec> |
means a represents the time-depth history of closed |
transactionsconnections. OFF - deactivates the monitoring RESET - resets the list of |
transactions connections (including the opened ones) SHOW - shows either the list of |
transactions connections including the history (ALL), or the particular |
transaction connection (<id>) to a console or file <file_path> in |
csv CSV format separated by ";" Columns in the list: - ID ( |
transaction auxiliary identifier of connection) - logon_time, logon_task, logon_traceback ( |
time the last operation within the group of identical onestime of connection, task and traceback in internal code) - logoff_time, logoff_task, logoff_traceback (time of disconnection, task, and traceback in |
the , count 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. |
...
SHOW_TOPOLOGY HOBJ or topology_name [DETAIL] | Shows the information about topology. For more information - see the chapter Topology - Topology debugging. |
DEBUG_TOPOLOGY HOBJ or topology_mask ON/OFF | Turns on / off writing out detailed information on topology evaluation. For more information - see the chapter Topology - Topology debugging. |
SHOW_ASYMETRIC TERMINALS or TRANSFORMERS [topology_mask] | Lists asymmetric Terminals or Transformers in the topology. For more information - see the chapter Topology - Topology debugging. |
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 DETAIL parameter is specified). For more information see the chapter DBManager - debugging. |
D2000 ALARM
DI ON/OFF [HOBJ/mask] | Debug Info for alarm objects - enables/disables displaying the information about the evaluation of alarm objects with specified HOBJ or with the name matching given mask. If neither HOBJ nor mask is specified, all alarm objects will be affected. |
Kotva |
---|
| show_dyn_info |
---|
| show_dyn_info |
---|
| SHOW_DYN_INFO HOBJ / mask | Shows dynamic information on the specified alarm object(s) on the text console of the process D2000 Alarm. Note: The command is mainly used for D2000 system diagnostic purposes. |
D2000 TOPOLOGY
SHOW_TOPOLOGY HOBJ or topology_name [DETAIL] | Shows the information about topology. For more information - see Topology - Topology debugging chapter. |
DEBUG_TOPOLOGY HOBJ or topology_mask ON/OFF | Turns on/off writing out detailed information on topology evaluation. For more information - see the chapter Topology - Topology debugging. |
SHOW_ASYMETRIC TERMINALS or TRANSFORMERS [topology_mask] | Lists asymmetric Terminals or Transformers in the topology. For more information - see Topology - Topology debugging chapter. |
D2000 GateWay Client
Kotva |
---|
| getoldval_gtw |
---|
| getoldval_gtw |
---|
| GETOLDVAL remoteTagName "BeginTime" ["EndTime"] ["NORECALC"]GETOLDVAL "remoteTagName[row]^item "BeginTime" ["EndTime"] ["NORECALC"] | Reads the values of the remote tag within a specified interval. If the EndTime parameter is not specified, the current time will be used as the default value. Time format ("BeginTime", "EndTime") is "dd-mm-yyyy hh:mi:ss".The command may be used for example after a failure or stoppage of the application, which the D2000 GateWay Client process belongs to. It allows transferring the values from the archive of the remote application to the archive of the application. The only requirement of the value transfer is that the values of corresponding objects have been stored in the archive of the remote application. The first form of the command reads all values transferred by specified remote tags (as well as structured objects).
The second declaration reads the values of structured objects partially. The parameter item specifies a column of the destination structure (see the Destination structure parameter in the configuration of the remote tag). When a single row (column) must be read, use the following: - reading row 10 - GETOLDVAL RemoteTagName[10], …
- reading the column named Values - GETOLDVAL RemoteTagName[0]^Values, …
The TELL command must always be executed in the transaction mode - the COMMAND action (within the D2000 System Console process, the command is automatically executed in the transaction mode). After the command is executed, the values that were transferred will be stored in the archive and the D2000 Archive automatically recalculates corresponding statistics.
The NORECALC parameter can be set at the end of the GETOLDVAL. In this case, the statistic calculations will not be executed by the D2000 Archiv process. |
DI ON/OFF [HOBJ/mask] | Debug Info for remote objects - enables/disables displaying the information about processing the values of objects with specified HOBJ or with the name matching given mask. Note:if the gateway client is run in a transparent gateway mode, use the TRGTW command to display debug information. |
Kotva |
---|
| show_dyn_info |
---|
| show_dyn_info |
---|
| SHOW_DYN_INFO HOBJ / mask | Shows dynamic information on the specified remote object(s) on the text console of the process D2000 Gateway. Note: The command is mainly used for D2000 system diagnostic purposes. |
TRGTW | Debug command for transparent gateway mode. The command lists the names of objects and their HOBJ on the local and remote systems. |
START_RECORD dir_name_only [begin_time] end_time | Starts recording of values read from theGateWay Server. For details see the command description for the D2000 KOM process. Note: Replaying of recorded values by the D2000 KOM process is possible if the GateWay Client was running in a transparent gateway mode during the recording. |
STOP_RECORD | Instantly stops recording of values read from the GateWay Server. For details see the command description for the D2000 KOM process. |
START_REPLAY dir_name_only [begin_time [/NOW]] or START_REPLAY dir_name_only /LOOP | Starts replaying of data recorded by command START_RECORD. For details see the command description for the D2000 KOM process. |
STOP_REPLAY | Instantly stops the replaying of data. For details see the command description for the D2000 KOM process |
...
Kotva |
---|
getoldval_gtw | getoldval_gtw | GETOLDVAL remoteTagName "BeginTime" ["EndTime"] ["NORECALC"]GETOLDVAL "remoteTagName[row]^item "BeginTime" ["EndTime"] ["NORECALC"]
Reads the values of the remote tag within specified interval. If the parameter EndTime is not specified, current time will be used as the default value. Time format ("BeginTime", "EndTime") is "dd-mm-yyyy hh:mi:ss".The command may be used for example after a failure or stoppage of the application, which the process D2000 GateWay Client belongs to. It allows user to transfer values from the archive of remote application to the archive of the application. The only requirements of the value transfer is that the values of corresponding objects have been stored in the archive of the remote application.
The first declaration of the command reads all values transferred by given remote tag (as well as structured objects). The second declaration reads the values of structured objects partially. The parameter item specifies a column of the destination structure (see the parameter Destination structure in the configuration of the remote tag). When just one row (column) must be read, use the following:- reading row 10 - GETOLDVAL RemoteTagName[10], …
- reading the column named Values - GETOLDVAL RemoteTagName[0]^ Values, …
The Tell command must always be executed in the transaction mode - the action COMMAND (within the process D2000 System Console, the command is automatically executed in the transaction mode). After the command is executed, the values that was transferred, are to be stored in the archive and the D2000 System automatically recalculates corresponding statistics.The parameter NORECALC can be set at the end of the GETOLDVAL. In this case, the possible statistic calculations will not be backward executed by the process D2000 Archiv.
DI ON/OFF [HOBJ/mask] | Debug Info for remote objects - enables / disables displaying the information about processing the values of objects with specified HOBJ or with the name matching given mask. |
Kotva |
---|
show_dyn_info | show_dyn_info | SHOW_DYN_INFO HOBJ / mask Shows dynamic information on the specified remote object(s) on the text console of the process D2000 Gateway. Note: The command is mainly used for D2000 system diagnostic purposes
D2000 WorkBook
OBJECTS_INFO | The process writes the list of all objects that are or |
was were used in reports into its .log file. |
...