D2000 Tell - command syntax

D2000 Server
D2000 Archiv
D2000 Kom
D2000 Event
D2000 Calc
D2000 DBManager
D2000 Alarm
D2000 Topology
D2000 GateWay
D2000 WorkBook

...

Kotva
server
server
D2000 SERVER (KERNEL)

Kotva

	audit_info
	audit_info

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 path

the path parameter (Sybase SQL Anywhere and PostgreSQL platforms).
Note

1

: The backup can be influenced by the setting

of parameter

of ConfigBackUpTimeout 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 pathCreates 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

from the value type of

the archival object

historical 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

in the process window

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.

Kotva

	set_act_inst
	set_act_inst

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

changing the

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

between

primary archive

the object

and archival one

being 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

from the value type of

the archival object.

historical value.

Kotva

	repository
	repository

REPOSITORY INIT [path]

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_MODE
process_name mode

Activates/deactivates Load balancing mode (see the chapter Redundant archiving - Load balancing).

Example:
SET_LOAD_BAL_MODE SELF.ARC 1 - activates Load balancing mode for SELF.ARC process.

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

D2000 Server process.
The list contains the owner of

register Kotvatcp_no_delaytcp_no_delayTCP_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. Kotvaxml_export0xml_export0XML_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.

Kotva

	show_config
	show_config

SHOW_CONFIG

Shows configuration information of the process D2000 Server.
This information covers:

start parameters of process D2000 Server,
configuration parameters of D2000 system installation common for all applications,
parameters of process D2000 Server specified in Windows registry (specific for running application),
in redundant systems parameters of redundancy specified in Windows registry (specific for running application),
parameters specific for ODBC and OCI versions of process D2000 Server.

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. Kotvashow_dyn_infoshow_dyn_infoSHOW_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 idLastThe 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 D2000Stops D2000 System.SHUTDOWN RESTARTStops D2000 System and restarts the operating system.SHUTDOWN SHUTDOWNStop D2000 system and shutdown operating system.SHUTDOWN WINNTStops D2000 System and restarts the operating system.START process_nameStarts 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]|HIBERNATEIt 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).

detailed information on the number and structure of the tags
For Structured Variables: Object Name; the number of tags; the number of tags according to the methodology into the version D2000 V11
;D2RECORD;SV.DaE_Export_Head; 0; 11
For Structured Eval Tags: Object Name; the number of tags;
;CLC_VAL Struct;P.TASK_SUM_Pending; 13

Summary information on the contribution to the total number of tags for each object types:
Number of tags for structured variables from V11 and to V11
;D2RECORD;Summary V11+; 9126
;D2RECORD;Summary OLD; 49044
Number of tags for structured eval tags
;CLC_VAL Struct;Summary; 314

Number of tags for eval variables
;CLC_VAL;; 98
Number of tags for I/O tags
;POINT;; 25
Number of tags for user variables
;USER_VAR;; 2095
Number of tags for remote objects
;REM_OBJ;; 2
The total number of application tags
;TOTAL TAGS;; 11510

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

Kotva

	tcp_no_delay
	tcp_no_delay

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.

Kotva

	xml_export0
	xml_export0

XML_EXPORT

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

"systemtxt" 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.

Kotva

	xml_import0
	xml_import0

XML_IMPORT

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 key

file - absolute path to the XML file (eg D:\temp\H.Sec.xml)

For this TELL command to be executed, a configuration key must be present!.

The path for the file import on VMS should be entered in Unix format.
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

are not

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.

Kotva

	xml_settings
	xml_settings

XML_SETTINGS

Warning: Since the version V8.00.001, the command is not supported.

Sets the parameters for

TELL commands

XML_IMPORT

a

and XML_EXPORT commands.

The command without parameter displays the default parameters of the D2000 Server.

Kotva

	xml_update
	xml_update

XML_Update

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.

Kotva
archiv
archiv
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

the RecalcImmediateDepth archive parameter

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.

Kotva

	crc_poznamka
	crc_poznamka

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.

Kotva

	delete_data
	delete_data

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

D2000 Archiv process (

only if

in the process window

is displayed on the desktop

and 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

of depository database segment) allows

to dismount

dismounting just the segment. Seg is the number between 0 and TrezorCountSegments. If the

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

of depository database segment) allows

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.

Kotva

	fill_cache
	fill_cache

FILL_CACHE

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.

Kotva

	force_clear
	force_clear

FORCE_CLEAR HOBJ/mask

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

Kotva

	freeze
	freeze

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

using

use, 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

freeze_

seconds

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

Kotva

	import_data
	import_data

IMPORT_DATA

Activates the

process

D2000 Archiv process to import external data, e.g. Importing archive databases from D2000 V3.65 (OS/2).

Kotva
list_trezor
list_trezor
LIST_TREZOR [all]
LIST_TREZOR id

The parameter allows

to shows

showing the list of depository databases used by the process D2000 Archiv. The contents of the list

depends

depend on the used platform - Sybase, PostgreSQL, or Oracle. Parameter id: for Sybase - name of a depository database for Oracle - number of depository tablespace for PostgreSQL - number of a depository database
LOAD_TREZOR path+filename [mask] [from] [to]	On-

line

line depository database import

.

(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

the depository database segment) allows

to mount on just one

mounting a single depository database segment. If the MOUNT_TREZOR command

MOUNT

is used without

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

is used without the

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

database synchronization through the Arcsynchro tool).

For more information see the topic On-line access to data from 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.

Kotva

	recalc
	recalc

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

behavior is

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

the archive

will

to review

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

on June 8, 2015.

Kotva
reorganize
reorganize
REORGANIZE

On-

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 reorganization of the archive database (same as running the process D2000 Archiv with the /DBCY parameter).
REORGANIZE OFF	Enables

the

the reorganization of the archive database (same as running the process D2000 Archiv without the /DBCY parameter).
REORGANIZE ACTIVE	Enables

the

the reorganization of the archive database in the active mode only (same as running the process D2000 Archiv with the /DBCA parameter).
REORGANIZE PASSIVE	Enables

the

the reorganization of the archive database in the passive mode only (same as running the process D2000 Archiv with the /DBCP parameter).
REORGANIZE SHRINK	Enables the alternate mode of the reorganization of the archive database - only for Oracle 10g and above (dame as running the process D2000 Archiv with the /DBCS parameter). Note: To enable the original mode, use

tell command

the REORGANIZE MOVE command .
REORGANIZE TableRowLimit rowLimit	On-line change of the parameter ReorganizeTableRowLimit

used

used for the automatic reorganization of the archive database.

REORGANIZE TableTimeLimit timeLimit

On-line change of the parameter ReorganizeTableTimeLimit used for the automatic reorganization of the archive database.

Kotva

	set_cache
	set_cache

SET_CACHE size [MB]

The command allows the user to change the dynamic cache size to speed-up the calculation of statistical historical values while the process D2000 Archiv is still running.

Note 1: The initial cache size can be specified by the parameter MaxCacheSize in the process D2000 Application Manager.
Note 2: The command SET_CACHE also changes the value of the parameter MaxCacheSize in the registry.

Kotva

	set_option
	set_option

SET_OPTION
name_parameter
value_parameter

Tell command

The SET_OPTION command controls the following configuration and start-up parameters of the process D2000 Archiv:

name_parameter

value_parameter

description

AlmostZero
ALMOST_ZERO

positive real number (e.g. 1e-10)

See the description of the parameter AlmostZero.

CommitCountActive
COMMIT_COUNT_ACTIVE

positive number

See the description of the parameter CommitCountActive.

CommitCountPassive
COMMIT_COUNT_PASSIVE

positive number

See the description of the parameter CommitCountPassive.

CommitTimeActive
COMMIT_TIME_ACTIVE

positive number

See the description of the parameter CommitTimeActive.

CommitTimePassive
COMMIT_TIME_PASSIVE

positive number

See the description of the parameter CommitTimePassive.

DBPO

ON/OFF

Only primary data processing.

RX

ON/OFF

No delete.

RO

ON/OFF

Read-only.

RS

ON/OFF>

Backup by copying.

DBRT

ON/OFF

Calculation of the computed historical values in real-time.

Kotva

	read_archive_depth
	read_archive_depth

READ_ARCHIVE_DEPTH

"dd-mm-yyyy hh-mi-ss"

OFF

Limitation of the reading depth from the archive.

If the saving to the depository is ON the older data than the specified date will be read from the depository databases. This parameter can be used for checking if the depositories truly contain all data (e.g. after the patching by arcsynchro).
The value OFF deactivates the limitation.
When the limitation is active, every reading from the archive (in which the limitation is applied) produces the following note in the archive log file:
Start time for reading values from archive is before READ_ARCHIVE_DEPTH, limiting

DiskUsageWarning
DISK_USAGE_WARNING

ON/OFF

See the description of the parameter DiskUsageWarning.

DropOldRequests
DROP_OLD_REQUESTS

ON/OFF

See the description of the parameter DropOldRequests.

IsochronousCache
ISOCHRONOUS_CACHE

ON/OFF

See the description of the parameter IsochronousCache.

IsoCacheFullDepth
ISOCACHE_FULL_DEPTH

ON/OFF

See the description of the parameter IsoCacheFullDepth.

IsoCacheDepth
ISOCACHE_DEPTH

a positive number (seconds)

See the description of the parameter IsoCacheDepth.

OldValIgnoreAge

a positive number (hours)

See the description of the parameter OldValIgnoreAge.

OldValOnAuxTask
OLD_VAL_ON_AUX_TASK

ON/OFF

See the description of the parameter OldValOnAuxTask.

OneThreadForGraph
ONE_THREAD_FOR_GRAPH

ON/OFF

See the description of the parameter OneThreadForGraph.

PG_ReorganizeSlice
PG_REORGANIZE_SLICE

0-2

See the description of the parameter PG_ReorganizeSlice.

PG_ReorgSliceTime
PG_REORGSLICE_TIME

seconds

See the description of the parameter PG_ReorgSliceTime.

PG_TrezorFileMulti
PG_TREZORFILEMULTI

number

See the description of the parameter PG_TrezorFileMulti.

RecalcImmediateDepth
RECALC_IMMEDIATE_DEPTH

seconds/OFF

See the description of the parameter RecalcImmediateDepth.

RecalcParallelInterval
RECALC_PARALLEL_INTERVAL

seconds/OFF

See the description of the parameter RecalcParallelInterval.

RecalcTimeIntervalLimit
RECALC_TIME_INTERVAL_LIMIT

hours/OFF

See the description of the parameter RecalcTimeIntervalLimit.

RecalcUseTrezor
RECALC_USE_TREZOR

ON/OFF

See the description of the parameter RecalcUseTrezor.

ReadTimeBeforeStart
READ_TIME_BEFORE_START

seconds/OFF

See the description of the parameter ReadTimeBeforeStart.

ReorganizeOffset
REORGANIZE_OFFSET

hh:mi

See the description of the parameter ReorganizeOffset.

ReorganizePeriode
REORGANIZE_PERIODE

hours

See the description of the parameter ReorganizePeriode.

ReorganizeTableRowLimit
REORGANIZE_TABLE_ROW_LIMIT

rows

See the description of the parameter ReorganizeTableRowLimit.

ReorganizeTableTimeLimit
REORGANIZE_TABLE_TIME_LIMIT

hours

See the description of the parameter ReorganizeTableTimeLimit.

Tablespace_Name
TABLESPACE_NAME

name_of_tablespace

See the description of the parameter Tablespace_Name (only on the Oracle platform).

TrezorReadSegment0
TREZOR_READ_SEGMENT0

ON/OFF

See the description of the parameter TrezorReadSegment0.

Note: Tell command SET_OPTION will change the configuration parameters placed in registry not only in archive but also in Registry


TrezorReadSinceCreate TREZOR_READ_SINCE_CREATE	ON/OFF	See the description of the parameter TrezorReadSinceCreate.
WorkingHoursStart WORKING_HOURS_START	non-negative integer number	See the description of the parameter WorkingHoursStart.
WorkingHoursEnd WORKING_HOURS_END	non-negative integer number	See the description of the parameter WorkingHoursEnd.

Note: For parameters that are stored in the Registry database the 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.

Kotva

	show_cache
	show_cache

SHOW_CACHE count

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

TELL command,

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.

Kotva

	show_info
	show_info

SHOW_INFO

Shows various information about

the process arc_stdout

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.

Kotva

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

Kotva


	arc_stdout

arc_stdout

STDOUT output

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.

Kotva
kom
kom

...

D2000 KOM

...

REQ - current processed communication request + requests in queue,
KOMARC - trace readings/writings into the archive file of KOM Archiv.
Kotva
kom_di
kom_di
DI ON/OFF HOBJ/mask
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.
Kotva
getoldval
getoldval
GETOLDVAL StationName [M:PointMask] [NORECALC] "BeginTime" ["EndTime"]
Reads historical values from a device - StationName station
StationName
. The values from
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
a TELL command. For some protocols (OPC DA, OPC HDA, and IEC 870-5-104),
there can be used
a parameter
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.
Kotva
lnstat
lnstat
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.
Kotva
resetperf
resetperf
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).
Kotva
setptaddr
setptaddr
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:
AMiT ATOUCH32 DB-Net
BACnet
General Electric SRTP protocol
Honeywell C-Bus
L&G TOCCATA
L&G TOCCATA via UNIP2
MODBUS Client
OPC Data Access 2.05 & 3.0 Client
Siemens SAPHIR
SNMP
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. "
S
B.
Stanica
Station") 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:
ALYA Lubrikacie
MODBUS Client
MODBUS Server
MODBUS Telemecanique TSX
MODBUS Valmet Damatic RTU
MODBUS RTU Quad2000
MODBUS SCT PPU
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).
Kotva
stalterpath
stalterpath
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").
Kotva
start_record
start_record
START_RECORD dir_name_only [begin_time] end_time
Starts a data recording into a subdirectory (application directory) with the name dir_name_only. If the directory does not exist, it will be created.
The start of tell command from D2000 Server - at first
If 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
record
recording:
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 TELL command uses
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
the D2000 KOM and Gateway Client processes).
Data are recorded into
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.
Kotva
stop_record
stop_record
STOP_RECORD
Stops a data recording immediately, it is not necessary to wait for end_time. If the recording
does
is not
work
in progress,
the
an error will
occur
be 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).
Kotva
start_replay
start_replay
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
an error will
occur
be returned.
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:
Time 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
STOP_
REPLAY
REPLAY command.
Note:
Tell
This TELL command uses
the format
the "dd-mm-rrrr hh:mm:ss" format for the parameters of
datetime
DateTime type.
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).
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.
Kotva
stop_replay
stop_replay
STOP_REPLAY
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.
Kotva
ststat
ststat
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.
Kotva
stwatch
stwatch
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 the
a specified station. The Number parameter defines the number of requests, possible value is within 1...5. If the parameter is not
defined
specified,
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)

Kotva
event
event
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_INFOTell 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 identification¹
- 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 identification¹
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 identification¹

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

- registered text strings (GETACCESS action)
Format: ACCESS;ESL name;String;time of GetAccess;bGlobal;userComment;status

ACCESS

REFOBJ

- text identifying the next information
ESL name - script identification¹

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 DB_TRANS_OPEN, DB_CONNECT, PG_CONNECT, SQL_CONNECT)
Format: DBCONNECT;ESL name;DB TRANS HANDLE;SUB CONNECT HANDLE;TYPE;OBJNAME;Prepared SQL Command;Last SQL Prepare; CommentDBCONNECT

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 identification¹

DB TRANS HANDLE

handle - unique numerical identifier of

transaction connections (it is created by calling the action DB_TRANS_OPEN), or 0, if the connection is not implemented transactional
SUB CONNECT HANDLE - identifier of connection (it is created by calling the actions DB_CONNECT, PG_CONNECT, SQL_CONNECT)
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 of the last SQL command which has been prepared by calling the action SQL_PREPARE
Comment - position where the action SQL_PREPARE was called
- list of files which have been opened by functions %FIO_*
Format: FIO;ESL name;file name

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

FIO

- text identifying the next information
ESL name - script identification¹

file name - file name
- list of created data containers (CNT_CREATE action

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 DB_TRANS_OPEN, DB_CONNECT, PG_CONNECT, and SQL_CONNECT actions)
Format:

CNT

DBCONNECT;ESL name

;handle;NR;valTyp;is arrayCNT

;DB TRANS HANDLE;SUB CONNECT HANDLE;TYPE;OBJNAME;Prepared SQL Command;Last SQL Prepare; Comment

DBCONNECT - text identifying the next information
ESL name - script identification¹

handle

DB TRANS HANDLE -

unique numerical identifier of data container
NR - number of elements
valTyp - type of key which identifies the items in data container uniquely
is array - flag determining whether the action CNT_CNVTOARRAY is applied on proper data container

¹ - 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 idInstanceIf 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).STATISTICS path+fileWrites data about the processor time consumption according to individual events into a file.STDOUT outputThe 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.

TASK_STATUS path+filenameWrites just executed line of all the script running in given 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.

...

identifier of transaction connections (it is created by calling the DB_TRANS_OPEN action), or 0, if the connection is not transactional SUB CONNECT HANDLE - identifier of connection (it is created by calling the 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 - format of the last SQL command which has been prepared by calling the SQL_PREPARE action Comment - the position where the 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 identification¹ file name - filename - 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 identification¹ 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 the respective data container ¹ - 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 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 currently executed lines of all the script running in a specified process into a file (.EVH or .HIS). The command also supplies the information about whether the ESL script is currently executing the external function. If yes, the file will contain the name of the function and the line number of the script calling the function.

Kotva
calc
calc
D2000 CALC

DP ON/OFF

Debug Pipe - shows/hides the information about communication with D2000 Calc (only if the process window is displayed on the desktop).

RESET_STATISTICS

Resets the counters for evaluating the statistical data.

STATISTICS path+file

Writes statistical data about individual I/O tags into a file. The file contains the following information: I/O tag name, number of recalculations and number of new values broadcasted into the system. The counters are reset while starting the process D2000 Calc or using the command RESET_STATISTICS.

STDOUT output

The command redirects the standard output to new one.

Example:
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

DP ON/OFFDebug Pipe - shows / hides the course of communication with D2000 Calc (only if the process window is displayed on the desktop).RESET_STATISTICSResets the counters for evaluating the statistical data.STATISTICS path+file Writes statistical data about individual I/O tags into a file. The file contains the following information: I/O tag name, number of recalculations and number of new values broadcasted into the system. The counters are reset while starting the process D2000 Calc or using the command RESET_STATISTICS. STDOUT outputThe 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 ColIt 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.

...

[DestVal] Checking values of destination columns, Example 3.

Note: This command is mainly used for diagnostic purposes in D2000 systems.

Kotva
dbmanager
dbmanager
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 secondsSwitches 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 secondsSwitches 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 <history

MONITOR_CONNECTS ON <history_depth_sec>

/ OFF /

MONITOR_CONNECTS OFF

MONITOR_CONNECTS RESET

Monitoring the

transactions

connections.

ON - activates the monitoring. <history_depth_sec>

means a

represents the time-depth history of closed

transactions

connections.
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 ones

time of connection, task and traceback in internal code)
- logoff_time, logoff_task, logoff_traceback (time of disconnection, task, and 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 / RESETMonitoring 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.

Kotva
alarm
alarm
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.

Kotva
topology
topology
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.

Kotva
gateway
gateway
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

...

Kotvagetoldval_gtwgetoldval_gtwGETOLDVAL 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. Kotvashow_dyn_infoshow_dyn_infoSHOW_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

.

Kotva
workbook
workbook
D2000 WorkBook

OBJECTS_INFO

The process writes the list of all objects that are or

was

were used in reports into its .log file.

Info

title	Related pages:

D2000 Tell
Work with D2000 Tell

...

Strom stránky

Porovnávané verzie

Stará verzia 1

Nová verzia Aktuálny

Kľúč

D2000 Tell - command syntax

Kotva
server
server
D2000 SERVER (KERNEL)

Kotva
archiv
archiv
D2000 ARCHIV

Kotva
kom
kom

D2000 KOM

Kotva
event
event
D2000 EVENT

Kotva
calc
calc
D2000 CALC

Kotva
dbmanager
dbmanager
D2000 DBMANAGER

Kotva
alarm
alarm
D2000 ALARM

Kotva
topology
topology
D2000 TOPOLOGY

Kotva
gateway
gateway
D2000 GateWay Client

Kotva
workbook
workbook
D2000 WorkBook

The default format is hexadecimal.
READKOMARC ["BeginTime"] ["EndTime"]	Reads the values from KOM Archiv. There are transferred all old values from

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

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

Strom stránky

História stránky

Porovnávané verzie

Stará verzia 1

Nová verzia Aktuálny

Kľúč

D2000 Tell - command syntax

KotvaserverserverD2000 SERVER (KERNEL)

KotvaarchivarchivD2000 ARCHIV

Kotvakomkom

D2000 KOM

KotvaeventeventD2000 EVENT

KotvacalccalcD2000 CALC

KotvadbmanagerdbmanagerD2000 DBMANAGER

KotvaalarmalarmD2000 ALARM

KotvatopologytopologyD2000 TOPOLOGY

KotvagatewaygatewayD2000 GateWay Client

Kotvaworkbookworkbook D2000 WorkBook

Kotva
server
server
D2000 SERVER (KERNEL)

Kotva
archiv
archiv
D2000 ARCHIV

Kotva
kom
kom

Kotva
event
event
D2000 EVENT

Kotva
calc
calc
D2000 CALC

Kotva
dbmanager
dbmanager
D2000 DBMANAGER

Kotva
alarm
alarm
D2000 ALARM

Kotva
topology
topology
D2000 TOPOLOGY

Kotva
gateway
gateway
D2000 GateWay Client

Kotva
workbook
workbook
D2000 WorkBook