TRACE

TRACE selects the trace or traces to be evaluated. An input file must be allocated before trace is called. The time of the first and last entries and the total number of entries is output by default for the specified trace name. In the same way all the trace entries for this trace name are edited. An OR connection by means of repeated use of the TRACE command with the ADD parameter is possible. Optionally, search strings with distance can be specified. Several strings mean an AND connection of the trace. Letters are changed to upper case. With the TIM1 and TIM2 operands it is possible to view only the trace entries of a particular time period.
TRACE without parameters outputs all the names of the traces involved in the evaluation and the time stamp for the first and last entries if the TRACE command has already been used.

TRACE                                                                                              

<trace-name,...>

[ , <string> , [ <distance> ] ,.. ]

[ , TIM1 = <time>] [ , TIM2 = <time> ]

[ , ADD = <Y / N> ]

<trace-name>
Fully or partly qualified trace name of the trace to be edited

• DCM.BCAM can be omitted and TEDDY completes the trace name if it does not begin with '$' or 'DCM',

• * (Wildcard) stands for all names,

• Several trace names can be specified,

• Time shifts of the time stamp of the trace entries possible using "+hhmmssttt" or "hhmmssttt" (after selection),

• All left-justified time specifications are optional. This shift is cut from the trace name again before selection,
  e.g. TRACE CON+05001 (shift of 5 seconds, 1 millisecond "in the future").

<string>
Specification of a hexadecimal (x=‘13c47f3d‘) or char search string (c‘abc‘)

<distance>
A distance behind the string can be specified in the form of a hexadecimal or decimal number.

TIM1=...
Lower time limit. If this information is not specified, the beginning is the starting point. Trace entries with TIM1 as the time stamp are also edited.

TIM2=...
Upper time limit. If this information is not specified, the editing continues to the end. Trace entries with TIM2 as the time stamp are also not edited.

<time> = <yyyymmddhhmmss>

1950 <= yyyy <= 20nn 00 <= mm <= 12 01 <= dd <= 31 00 <= hh <= 24 00 <= mm,ss <= 60

(year)                                                                 (month) (day) (hour) (minute/second)

If desired, only the entries for hours, minutes and seconds may be specified.

ADD=...
ADD=YES mixes the selected and already existing data of the last intermediate files. If the entry ADD or ADD=NO has not been entered, the intermediate files are recreated (OR connection of search criteria).

Error messages for the command TRACE

Message	Meaning
NO TRACE-FILE SPECIFIED USE DATIN FIRST	DATIN<filename> must be entered before the command TRACE
ENTRY NOT FOUND IN LIST	the specified trace name is not present in the trace file
NO LEGAL TRACENAME SPECIFIED	none of the trace names was entered correctly
ERROR WHILE OPENING: <filename>	file error when opening the file <filename>
IILEGAL ADD-PARAMETER	YES / Y / NO / N does not follow ADD=
ILLEGAL HEX-CONSTANT	wrong format on entering a hexadecimal constant
ERROR WHILE WRITING - FILE INVALID VOLUME FULL? <filename>	error writing a record into a <filename>, your volume is probably full

Error messages for the command TRACE

Example of a trace evaluation

1. Allocation of an input file dctrac.sav

   DATIN dctrac.sav or DATIN dc*

2. List of all entries

   LIST
   DCM.BCAM.CON        1 2015-01-22 13-59-14
   .
   .
   .
   .
   

3. Selection of trace records:

   TRACE DCM.BCAM.CON,C='reclt',0x1c,C='hugo',
                     TIM1=093010,TIM2=093100
   TRACE DCM.BCAM.LOC,X='a5c35ff6',ADD=YES
   

Result

The intermediate file contains all CON trace records with “reclt” string at distance 1c and records with the character string 'hugo'.
The selection still occurs between the time stamp 09:30:10 and 09:31:00.
In addition, all LOC trace records which contain the hexadecimal entry 'a5c35ff6' are added onto the end of the file.

The following are also possible:

TRACE CON+1000000,TIM1=19980718000000,TIM2=19980719000000

All CON trace records of 1998/07/18, where 10 minutes are added to the time stamps of all selected records after the selection.

    TRACE ADM,CON,TRANS,...
TRACE *,DCM.DCAM*

All left-justified time stamp entries are optional, i.e.

TRACE CON,TIM1=3000,TIM2=3500 TRACE CON,TIM1=10,TIM2=20

(Selection in minutes)                                          (Selection in seconds)

Selection by specifying milliseconds is not possible.