The sorted data can be evaluated with KDCEVAL. The evaluation can be carried out interactively and in batch mode. KDCEVAL requires you to enter parameters for control purposes.
Only data from one application can be evaluated in a run. The user can restrict the evaluation to part of the recorded data by specifying a desired time interval (parameter TIME=). If data entry was activated and deactivated several times for the application within the evaluation time limits, a separate evaluation is carried out for each entry period (from KDCMON=ON to KDCMON=OFF), whereby a maximum of 10 such entry periods are possible.
The evaluation tool KDCEVAL is started with:
/SET-FILE-LINK LINK-NAME=KDCMON,FILE-NAME=samfile -
/ ,BUFFER-LENGTH=BY-CATALOG -
/ ,BLOCK-CONTROL-INFO=BY-CATALOG
/ START-EXECUTABLE-PROGRAM -
/ FROM-FILE = *LIBRARY-ELEMENT( -
/ LIBRARY = SYSLNK.UTM. .UTIL -
/ ,ELEMENT-OR-SYMBOL = KDCEVAL -
/ ,TYPE = L )
070
Meaning of parameter
samfile
Name of the output file of PAMSAM, i.e. the SAM file with the sorted data records.
After the evaluation program has been started interactively, KDCEVAL outputs the following message to request the input of control parameters:
PLEASE ENTER COMMANDS OR 'HELP' OR 'END'
KDCEVAL control parameters
The program reads the SYSDTA parameters from SYSDTA. The individual commands you can use to control the evaluation have the following format:
APPLINAME applicationname
Name of the application for which the evaluation is to be carried out. If the file contains data from several applications, a separate evaluation must be implemented for each application. It is not possible to carry out an evaluation for more than one application during one KDCEVAL run.
TIME FROM={ t1 | START }, TO={ t2 | STOP }
Time specification for defining the evaluation time limits.
FROM=t1
Start time of the evaluation in seconds.
The time is specified relative to the start of KDCMON in seconds.
FROM=START
The evaluation starts at the beginning of the file.
TO=t2
End time of the evaluation.
The time is specified relative to the start of KDCMON in seconds.
TO=STOP
The evaluation continues until the end of the file.
The following apply for t1 and t2:
Minimum value: 0
Maximum value: 99999999
LIST { (list1, list2,...,listn [ ,TABLE ] ) | ( STD [ ,TABLE ] ) | ( ALL [ ,TABLE ] ) }
list1, list2,...,listn
Names of the individual lists to be prepared. The names that you can specify here are indicated on "Evaluation lists". The TRACE and TRACE2 lists must not be specified at the same time.
STD
This evaluation covers the lists TASKS, SUMM, TIMES and TCLASS.
ALL
The evaluation covers all lists apart from TRACE and TRACE2.
If TRACE or TRACE2 is also to be evaluated, you must specify LIST (ALL, TRACE) or LIST (ALL, TRACE2).
If ALL or STD is specified without TABLE, the round brackets can be omitted.
TABLE
If TABLE is specified in addition, the lists are created in a table format that can be further processed on PC with Excel or another spreadsheet program, see "Processing evaluation data on the PC". TABLE only works on the segregated lists TASKS, TIMES, TCLASS, TACCL, TACPT and TACLIST.
OPTION DECIMAL-SEPARATOR={ COMMA | POINT }, SHOW-TSN={ FIRST | ALL }
DECIMAL-SEPARATOR=COMMA
The comma is used as the decimal separator.
DECIMAL-SEPARATOR=POINT
The period is used as the decimal separator; this is the default value.
SHOW-TSN=FIRST
In the TRACE2 list, in successive records with identical TSN, the TSN is only output in the first record in the sequence. The subsequent records in this kind of sequence of records with identical ID contain quotation marks (") in the TSN field.
This is the default value.
SHOW-TSN=ALL
In the TRACE2 list, the TSN is output in each record. This can be useful if the output list is to be edited or analyzed using a program.
END
This command terminates parameter input.
The HELP command can also be entered with interactive evaluations. The syntax of the commands and the possible list names are output in this case.
Errors and messages
If KDCEVAL is terminated incorrectly, process switch 3 is set to ‘on’.
If one of the commands APPLINAME, TIME or LIST is missing, the evaluation is aborted with the following error message:
MANDATORY COMMAND MISSINGIn the case of a syntax error, the following message and the incorrect command are displayed:
ERROR IN COMMANDIf the time specifications t1 and t2 are inconsistent, the following message is output:
KDCEVAL: WRONG TIME INPUTIf no records are found in the file for the application or if no data exists within the evaluation time limits, one of the following messages is output:
NO EVALUATION : NO RECORD WITH APPLINAME FOUND
or
NO EVALUATION : NO RECORD IN TIME_INTERVAL
If a DMS error occurs, the following messages are output:
KDCEVAL: DMS-ERROR Dxxx FOR INPUT FILEKDCEVAL: NO EVALUATION(Dxxx = DMS error code)
Version check:
It is only possible to evaluate KDCMON data using KDCEVAL if KDCEVAL has the same openUTM version as the UTM system code. KDCEVAL checks the version of the KDCMON data. If KDCEVAL identifies an illegal version, KDCEVAL aborts the evaluation with the following message:
NO EVALUATION: INPUT FILE FROM INVALID UTM VERSION
Result of the KDCEVAL evaluation
KDCEVAL writes the result of the evaluation into the files of a file generation group (FGG) with the name:
KDCMON.appliname
The FGG contains a maximum of 10 generations. When the evaluation is started, any existing file generation of this name is deleted.
If data entry was deactivated several times during a KDCMON run, then KDCEVAL writes the evaluation data of each interval to a separate file of the FGG.