The command enables to compare comparison of the values of target columns (of structured variables), configured in the eval tags, with the values that were calculated by D2000 Calc. The calculation is done by calling the Tell command CHECK_DESTID_VALUES [DestId [ColIndex]] [DETAIL] [FlagList] in D2000 Calc.
Warning: Tell command CHECK_DESTID_VALUES is supported only in the version D2000 V8.0.5.
When specifying the particular object of the Structured variable type, for which the comparison should be done, the value of the parameter DestId, or also ColIndex for the particular column, must be non-zero. These parameters are followed by the optional keywords (named as FlagList parameter) that enable to organize the organization of the final output.
Note: The term "value of eval tag" (or abbreviated "value") will be used below in terms of the value that is intended for calculation for a row of a target column in the structured variable. One eval tag has several values. It depends on the number of rows of target columns in the structured variable.
...
At the beginning of the log, there is always a TELL command name and the time when it was started. This is followed by the specific record, which contains a header of CSV data. Just one row with data in CSV format is assigned to each eval tag with the defined target column. This row represents either debugging information (green color) or an error message (red color).
Each eval tag contains a consecutive number for row (the number of rows is equal to the number of eval tags with the defined target column of structured variable), the ID of the eval tag, its name, type, and filled target column in the format $^ColIndex $HOBJ^ColIndex. The special counters come after this column in this order:
- COUNT - total number of values for given structured eval tag,
- NoEval - value that has not been calculated yet,
- ReCalc - value that was calculated before less than n seconds (default is n=10s, it can be changed to 60s by ReCalc1m or disabled by ReCalc0s),
- ErrInv - any information about the given value has never been received from the D2000 Server yet,
- ErrCnv - the recalculated value is invalid because there does not exist the conversion from the value that is calculated by the D2000 Calc to the value that is filled in a structured variable does not exist because it is of a different type,
- ErrDiff - the value that has been calculated by the D2000 Calc is compared with the value which that is registered in the D000 Calc from the D2000 System.
...
- none of the counters can be greater than the value in COUNT,
- the flags are evaluated sequentially from top to bottom,
- if the value has a NoEval flag, it is also compared with the value from the D2000 System (the value may have still an ErrCnv flag or ErrDiff),
- if the value has a ReCalc flag, other flags will not be evaluated,
- if the value has an ErrInv flag, other flags will not be evaluated,
- if the value has an ErrCnv flag, it compares the value registered in the D2000 System and the invalid value (the value can even acquire an ErrDiff flag),
- if the value has an ErrDiff flag, it means that the values differ and it is the main debugging error
- when comparing the values, there are ignored these flags:
- whether the value is manual,
- value for indirect,
- if it is SBS or Ignore_Time has been entered, it ignores also the value time;
- the row in the log represents the debugging information if ErrInv, ErrCnv, and ErrDiff are null, otherwise, it represents the error message.
At the end of the log, there is a summary. Before starting the tell command with other parameters, you should check the error flags (cumulative ErrInv, ErrCnv, and ErrDiff) and special flags (cumulatively NoEval and ReCalc). If there are the eval tags that fill the same destination column of the structure variable, a warning occurs even before this log.
...
Tell command without the parameters allowed to find out the number of error flags and special flags (see the summary at the end of a log of 1. example). If their sum is convenient because it defines the maximum number of rows of the next log, the tell command without DestID can be called for the structured variable. In the output, the one row will correspond to each value of the structured eval tag, which contains error flags or special flags. If it contains special flags only, it will be in the form of a warning, but if it contains both error and special flags, the row will represent the error message.
...
At the beginning of the log, there is always the called TELL command and time, when it was started. This is followed by the specific record, which contains the header of CSV data. A one-row record, which starts with a flag that was evaluated as the last (it is the most important and starts with the CALC- prefix) corresponds to each value that contains the error or special flags. This is followed by the destination value of a structured variable in the format $[RowNumber]^ColIndex, the information about the first evaluation of the I/O tag (FIRST_EVAL: on SBS it is still True), its ID, name and type, whether the value is recalculated (CV_REDEF: on SBS it is still True after the first recalculation), type, value and date of recalculation, whether the destination value has never been received from the D2000 System (DV_UNDEF), its type, value and time stamp.
...
The output file will contain either the detailed information for each value of the structured I/O tag, which contains the error flags if the Detail parameter is specified, or detailed information about all values if the Debug parameter is entered.
...