Previous Topic: Generalized Trace FacilityNext Topic: Stop the GTF

SCS Address Space Administration › Generalized Trace Facility › Start the GTF

Start the GTF

To start the GTF, enter a START GTF command. You can start the GTF by using the IBM-supplied procedure or your internal procedure for starting GTF.

Note: Multiple instances of GTF can be active simultaneously. Each instance operates as a system task in its own address space.

Each instance of GTF can be assigned a unique identifier that is specified on the START GTF command. The identifier lets you recognize and control specific instances of GTF. If a unique identifier is not specified, the operating system assigns the device number of the device where the trace data set resides.

The events that GTF traces are specified as options. You specify the USRP and JOBNAMEP options for the SCS address space.

After you specify the USRP GTF option, GTF prompts you for the list of event identifiers (EIDs).

The SCS address space uses the following EIDs:

301

Captures diagnostic data for the infrastructure component of the SCS address space.

302

Captures diagnostic data for the communications server component of the SCS address space.

303

Captures diagnostic data for the communications server event API component of the SCS address space

304

Captures diagnostic data for the container section component of the SCS address space.

305

Captures diagnostic data for the implementation engine component of the SCS address space.

306

Captures diagnostic data for the services section component of the SCS address space.

307

Captures diagnostic data for the system information agent component of the SCS address space.

Note: To avoid unwanted information, limit the GTF trace output using the USRP option.

If the JOBNAMEP GTF option is specified, you are prompted for the list of job names that trace output is captured for. Specify the names of the SCS address space, both main and auxiliary. The common names are MSMCPROC and MSMCAUX (in this order).

Example

CA CSM includes the MSMCGTFP sample member that contains the following GTF trace options:

TRACE=USRP,JOBNAMEP
USR=(301,302,303,304,305,306,307)
JOBNAME=(MSMCPROC,MSMCAUX)
END