Defining a trace file externally

About the TRCFILE command

Trace files can be created and pre-formatted in their order of occurrence or externally with a utility, in particular for environments that cannot support such operations. The utility is integrated in CFTTRACE, with the command TRCFILE TYPE = TRACE.

Use this command to create a trace file, to destroy it or to reinitialize it with an empty useable content.

Syntax

TRCFILE  TYPE  = TRACE,
[MODE = { CREATE | REPLACE | DELETE},]
TRCFNAM =  filename,
TRCFTYP = { STANDARD | CIRCULAR},
 

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

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

Parameters

[MODE = { CREATE | REPLACE | DELETE},]

Type of operation to be carried out on the file:

  • CREATE: Create and initialize a trace file that does not yet exist.
    If the file already exists, this operation is refused
  • REPLACE: Reinitialize an existing trace file.
    If the file does not already exist, it is created
  • DELETE: Delete a trace file

TRCFNAM =  filename

Name of the trace file.

TRCFTYP = { STANDARD | CIRCULAR}

Type of trace file for which an operation is requested:

  • STANDARD: Sequential file (fixed record size)
  • CIRCULAR: Direct file (fixed record size)

[TRCLREC = { 0 | 1024 | n}]

Size of records contained in the trace file.

This parameter is:

  • Mandatory when TRCFTYP = CIRCULAR, with a default value of 0
  • Optional when TRCFTYP = STANDARD with a default value of 1024

[TRCNREC = n]

Number of useable records contained in the direct file.

This parameter is:

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

TYPE = TRACE

Operation on a trace file.

Related Links