Porovnávané verzie

Stará verzia 22

changes.mady.by.user D2000 Dev Team

Uložené

porovnané s

Nová verzia 23

changes.mady.by.user D2000 Dev Team

Uložené

Kľúč

  • Tento riadok sa pridal
  • Riadok je odstránený.
  • Formátovanie sa zmenilo.

...

DYNAMIC_INFOTELL 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 - text identifying the next information
ESL name - script identification1

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

ACCESS - text identifying the next information
ESL name - script identification1
String - registered text string
time of GetAccess - time of string registration
bGlobal - flag defining the string to be global
userComment - comment
status - text "IN PROGRESS", if the global string has been registered, otherwise empty text ""

- list of all open XML documents (%XML_CreateDocument, %XML_OpenDocument)
Format: XML;ESL name;handle

XML - text identifying the next information
ESL name - script identification1
handle - unique numerical identifier of XML document; it is identical to handle which is used by functions %XML_* 

- list of objects that have been opened by function %OpenRefToObject
Format: REFOBJ;Esl Name;Synchro;Obj HOBJ;Obj Name;Open In Progress

REFOBJ - text identifying the next information
ESL name - script identification1
Synchro - value of parameter _bSynchro at calling of the function %OpenRefToObject
Obj HOBJ - unique identifier of opened object
Obj Name - unique name of opened object
Open In Progress - flag defining if the object is just being opened

- list of active database connections (by the DB_TRANS_OPEN, DB_CONNECT, PG_CONNECT, and SQL_CONNECT actions)
Format: DBCONNECT;ESL name;DB TRANS HANDLE;SUB CONNECT HANDLE;TYPE;OBJNAME;Prepared SQL Command;Last SQL Prepare; Comment

DBCONNECT - text identifying the next information
ESL name - script identification1
DB TRANS HANDLE - identifier of transaction connections (it is created by calling the 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 identification1
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 identification1
handle - unique numerical identifier of data container
NR - number of elements
valTyp - a type of key which identifies the items in the data container uniquely
is array - flag determining whether the action CNT_CNVTOARRAY is applied on the respective data container

1 - script identification: text string uniquely identifying the running ESL scrip. It contains the object name (HOBJ)[instance number] unique numerical identifier.
Example: E.Script(728)[105]1872
(%GetSelfInstanceId, %GetSelfHBJ)

SHOW_TRANS_LIST 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 command).
STATISTICS path+fileWrites data about the processor time consumption according to individual events into a file.
STDOUT outputThe 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+filenameWrites currently executed lines of all the script running in a specified process into a file (*.EVH or *.HIS). The command also supplies the information about whether the ESL script is currently executing the external function. If yes, the file will contain the name of the function and the line number of the script calling the function.

...

DP ON/OFFDebug Pipe - shows/hides the information about 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+fileWrites 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.

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 TELL command: CALCINFO ON P.OnSec

In the LOG file, there is a record  that that the information is about the calculation of the calculated P.OnSec object. The value of the object changed from HOBJ=20 (VALUE IN $20). Next, the individual attributes of the input value are displayed. Output value attributes are displayed after a row containing VALUE OUT content.

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


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 keywords from the list: Detail, Debug, Ignore_Time, ReCalc0s, ReCalc1m.
You may find the detailed information in the document Checking values of destination columns.

Note 1: This command is mainly used for diagnostic purposes in D2000 Systems.
Note 2: Command is supported only in version D2000 V8.0.5.
SHOW_DYN_INFO {Mask|HOBJ} [Row]It enables displaying a configuration and the current status of a particular eval tag. The eval tag is defined as an input parameter either through its ID (HOBJ) or mask. If several eval tags match the mask, the first 20 tags will be displayed. If Row parameter is different than 0, it must be the eval tag, the values of which are written to a destination column of structured variable. For common eval tags (those that have not a destination column) the Row parameter must be 0 or not specified.

The log format is identical with the format [Calc], which is stated in the article Checking values of destination columns, Example 3.

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

GET_SOURCE_VALUE HOBJ Row ColIt enables the displaying of the inputs into the calculation providing they are the inputs from the structured variables.

The log format is identical with the format [DestVal] Checking values of destination columns, Example 3.

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

...