# Using the start trace command

This command, which is associated with a unique identifier, performs the following tasks:

• Defines and describes the conditions for starting and selecting traced data
• Associates a file identifier, already defined by the SETTRC command, with this trace which designated the file in which the traces will be stored

### Syntax

START    TRC  ID =  identifier,
TID =  identifier
[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}]

### Parameters

ID =  identifier

Identifier which makes the trace vector defined by this parameter set uniquely identifiable.

This parameter is a character string, maximum length 8.

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

Checks the level 1 traces for Transfer CFT file tasks.

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

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

Checks the level 1 traces for Transfer CFT scheduler tasks.

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.

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/deregister)
• 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.

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.

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

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

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

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.

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

TID =   identifier

Identifier of the SETTRC or CFTTRACE command which defines the collection’s output trace file.

This identifier should exist, in that it should have been initialized by a SETTRC or CFTTRACE command .

This parameter is a character string, maximum length 8.

[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 passed by Transfer CFT to the exit executive
• 2: Trace of the user work field
• 4: Trace of the data field