Evaluating data with KDCEVAL

The data recorded with KDCMON is evaluated with the KDCEVAL tool. Only the data from one application can be evaluated in an evaluation run. KDCEVAL requires several parameters to control the evaluation run. You must enter these parameters after KDCEVAL has been started.

Starting KDCEVAL

You must copy the file that you want to evaluate (nnnn.pid in the KDCMON directory, see above) and save it in a file named evalin before you start KDCEVAL.

You then call KDCEVAL as follows:

utmpath/ex/kdceval (Unix and Linux systems) or

utmpath\ex\kdceval (Windows systems)

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

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 is relative to the time that the data collection was activated (e.g. with the KDCDIAG command).

FROM=START

The evaluation starts at the beginning of the file.

TO=t2

End time of the evaluation.
The time is specified is relative to the time that the data collection was activated (e.g. with the KDCDIAG command).

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 { (list₁, list₂,...,listn [ ,TABLE ] )  | ( STD [ ,TABLE ] ) | ( ALL [ ,TABLE ] ) }

list₁, list₂,...,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 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 }

Defines the decimal separator.

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 PID, the PID 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 PID field.

This is the default value.

SHOW-TSN=ALL

In the TRACE2 list, the PID 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 one of the commands APPLINAME, TIME or LIST is missing, the evaluation is aborted with the following error message:

  MANDATORY COMMAND MISSING

• In the case of a syntax error, the following message and the incorrect command are displayed:

  ERROR IN COMMAND

• If the time specifications t1 and t2 are inconsistent, the following message is output:

  KDCEVAL: WRONG TIME INPUT

• If 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:

  • If KDCEVAL cannot find the evalin file:

    KDCEVAL: NO KDCMON FILE

    KDCEVAL: NO EVALUATION

  • If the evalin file could not be created by KDCMON:

    NO EVALUATION: NO VALID KDCMON FILE

• 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 evaluation to the file

kdcmon.appliname

This file is stored in the current directory.