Defining the internal trace file

About the CFTTRACE command

Depending on how the trace is started, the file defined is available:

  • When Transfer CFT starts up, with the possibility of tracing an initialization sequence
  • During Transfer CFT operations

Syntax

CFTTRACE [FTRACE = { 0 | 0..15},]
[MTRACE = { 0 | 0..31},]
[PTRACE = { 0 | 0..31},]
[XTRACE = { 0 | 0..7},]
[S2TRACE = { 0 | 0..255},]
[S3TRACE = { 0 | 0..255},]
[N2TRACE = { 0 | 0..63},]
[N3TRACE = { 0 | 0..255},]
ID =  identifier,
[TRCFNAM = " " | filename,]
[TRCFTYP = { STANDARD | CIRCULAR},]
[TRCLREC = n,]
[TRCNREC = n,]
[MODE = { CREATE | REPLACE | DELETE},]
START = { CFT | DELAYED}

Parameters

[FTRACE = {0 | 0..15}]

Checks the level 1 traces for Transfer CFT file tasks (CFTTFIL).

This parameter is only relevant if the parameter START = CFT.

The chosen value is a mask (logical OR) combination of the desired values. These values are:

  • 1: transfer controller trace
  • 2: security controller trace
  • 4: file access controller trace
  • 8: trace of flagged messages

ID = identifier

Character string, maximum length: 8; uniquely identifies the trace file defined by the set of parameters TRCFNAM, TRCFTYP, TRCLREC, TRCNREC.

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

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

  • CREATE: Create an entry
  • REPLACE: Replace an entry
  • DELETE: Delete an entry

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

[MTRACE = {0 | 0..31}]

Checks the level 1 traces to be collected for the Transfer CFT "scheduler" task (CFTMAIN).

This parameter is only relevant if the parameter START = CFT.

The chosen value is a mask (logical OR) combination of the desired values. These values are:

  • 1: Trace of catalog access events
  • 2: Trace of ‘‘process" events (begin and end tasks)
  • 4: Trace of ‘‘protocol" events
  • 8: Trace of ‘‘operator" events
  • 16: Trace of ‘‘file" events

[N2TRACE = {0 | 0..63}]

Checks the level 2 network traces to be collected for all Transfer CFT tasks.

This parameter is only relevant if the parameter START = CFT.

The chosen value is a mask (logical OR) combination of the desired values. These values are:

  • 1: Trace of definition requests (define/undefine resource, register/unregister)
  • 2: Trace of definition indications (future use)
  • 4: Trace of connect / disconnect requests
  • 8: Trace of connect / disconnect indications
  • 16: Trace of requests during data exchange phase
  • 32: Trace of indications during data exchange phase

[N3TRACE = { 0 | 0..255}]

Checks level 3 network traces to be collected for all Transfer CFT tasks.

This parameter is only relevant if the parameter START = CFT.

The chosen value is a mask (logical OR) combination of the desired values. These values are determined by each environment.

[PTRACE = { 0 | 0..31}]

Checks the level 1 traces to be collected for the Transfer CFT protocol task (CFTTPRO).

This parameter is only relevant if the parameter START = CFT.

The chosen value is a mask (logical OR) combination of the desired values. These values are:

  • 1: Trace of flagged messages
  • 2: Trace of flagged messages
  • 4: Trace messages sent to CFTTFIL
  • 8: Trace of the controller motor
  • 16: Trace of FPDUs

START = { CFT | DELAYED}

Starting the trace:

  • CFT: at Transfer CFT start-up
  • DELAYED: during Transfer CFT operations

If START = CFT, a trace vector is created with the identifier defined in the ID parameter. This identifier is used in the STOPTRC command to stop collection.

[S2TRACE =  { 0 | 0..255}]

Checks the level 2 system traces to be collected for all Transfer CFT tasks.

This parameter is only relevant if the parameter START = CFT.

The chosen value is a mask (logical OR) combination of the desired values. These values are:

  • 1: SAM network interface trace
  • 2: SMM system interface trace
  • 4: SFM system interface trace
  • 8: SDM system interface trace
  • 16: SSM system interface trace
  • 32: STM system interface trace
  • 64: SSY system interface trace
  • 128: Memory space allocation trace

[S3TRACE = { 0 | 0..255}]

Checks the level 3 system traces to be collected for all Transfer CFT tasks.

This parameter is only relevant if the parameter START = CFT.

The chosen value is a mask (logical OR) combination of the desired values. These values are determined by each environment.

[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 over-writing the old ones

[TRCLREC = n]

Trace file physical records (fixed) length.

This parameter is:

  • Mandatory if TRCFTYP = CIRCULAR
  • Optional if TRCFTYP = STANDARD

[TRCNREC = n]

Number of trace file records.

This parameter is mandatory if TRCFTYP = CIRCULAR.

[XTRACE = { 0 | 0..7}]

Checks the level 1 traces for Transfer CFT EXIT type operations.

This parameter is only relevant if the parameter START = CFT.

The chosen value is a mask (logical OR) combination of the desired values. These values are:

  • 1: Trace of the request field sent by Transfer CFT to the "EXIT" executive
  • 2: Trace of the user work field
  • 4: Trace of the data field

Back to top

Related Links