Initializing the trace

Overview SETTRC

This command:

  • Defines and describes a trace file which can be available to store captured information
  • Associates an identifier with this file and description, which allows it to be identified uniquely, if the user wishes to distribute several trace types into several different files

Syntax

SETTRC   ID =  identifier,
TRCFNAM = { " " | filename},
[TRCFTYP = { STANDARD | CIRCULAR},
[MODE = { CREATE | REPLACE | CLOSE},]
 

TRCFTYP = STANDARD
[TRCLREC = { 0 | n}]

TRCFTYP = CIRCULAR
TRCLREC = { 0 | n},
TRCNREC  = n

Parameters

[ID =  identifier]

Character string, maximum length: 8; uniquely identifies the trace file descriptor defined by this set of parameters.

[MODE = { CREATE | REPLACE | CLOSE}]

Operation to be performed on the ‘‘trace file" entry designated by the ID
parameter:

  • CREATE: Create an entry, and possibly the file
  • REPLACE: Replace the file with another one for the same entry
  • CLOSE: Delete an entry, the file will then be closed

Where MODE = CLOSE, only the ID parameter is useful.

TRCFNAM = { " " | filename}

Name of trace file to be fed by traces.

Character string maximum length: 64 characters.

[TRCFTYP =  {STANDARD | CIRCULAR}]

Trace file type:

  • STANDARD: Sequential file written in "extend".
    The new records are written after the old ones
  • CIRCULAR: Direct access file, with a set number of fixed-length records.
    This file is accessed through a circular up-date, the new records overwriting the old ones

[TRCLREC = { 0 | n}]

Length of trace file’s physical records.

This parameter is:

  • Mandatory if TRCFTYP = CIRCULAR.
    Concatenation and segmentation algorithms make it possible to manage the real - essentially variable - size of data to be written to this file
  • Optional if TRCFTYP = STANDARD (sequential file, with fixed-size records)

[TRCNREC = n]

Number of trace file records.

This parameter is:

  • Mandatory if TRCFTYP = CIRCULAR
  • Not applicable if TRCFTYP = STANDARD

Related Links