Viewing the component trace data

During diagnosis, the system programmer performs the tasks, using IPCS. See &ieac500t; for the COPYDUMP, COPYTRC, CTRACE, GTFTRACE, and MERGE subcommands.

1. If your trace is in a dump in a SYS1.DUMPxx data set, enter a COPYDUMP subcommand to move the dump to another data set. Use option 5.3 of the IPCS dialog to select the COPYDUMP subcommand.

2. For all traces on trace data sets, use a COPYTRC subcommand to reorder component trace records that are out of chronological sequence. Use option 5.3 of the IPCS dialog to select the COPYTRC subcommand.

3. If your trace is on multiple data sets, do one of the following to view the trace records in one chronological sequence, which is needed to understand what was happening when the problem occurred. The input data sets can be component trace data sets, SVC dumps, and stand-alone dumps.

Use the COPYTRC subcommand to combine the records on several data sets into a chronological sequence on one data set. Use this data set as input to the CTRACE subcommand, which formats the trace records. Use option 5.3 of the IPCS dialog to select the COPYTRC subcommand.
Use a MERGE subcommand to format trace records from one or more input data sets. MERGE lets you combine and format the following:
- Component traces
- GTF traces
- Sublevel traces from one component on one trace data set
- Sublevel traces from one component on separate trace data sets
For sublevel traces, MERGE groups together the trace records for each sublevel.

Use option 2.7 of the IPCS dialog to select the MERGE subcommand. MERGE allows you to issue individual CTRACE or GTFTRACE subcommands for each input data set.

4. Use the subcommands in Table 1 when formatting the component trace records. See z/OS MVS IPCS Commands for the SHORT, SUMMARY, FULL, and TALLY report type keywords and other keywords for the CTRACE subcommand.

Table 1. Subcommands that format component trace records
Trace	IPCS subcommand	CTRACE OPTIONS parameter
SYSAPPC	CTRACE COMP(SYSAPPC)	See Formatting a SYSAPPC trace
SYSAXR	CTRACE COMP(SYSAXR)	See Formatting a SYSAXR trace
SYSBCPII	CTRACE COMP(SYSBCPII)	See SYSBCPII component trace
SYSBHI	CTRACE COMP(SYSBHI)	See SYSBHI component trace
SYSCEA	CTRACE COMP(SYSCEA)	See Formatting a SYSCEA trace
SYSDLF	CTRACE COMP(SYSDLF)	None
SYSDSOM	CTRACE COMP(SYSDSOM)	See SYSDSOM component trace
SYSGRS	CTRACE COMP(SYSGRS)	None
SYSHZS	CTRACE COMP(SYSHZS)	See SYSHZS component trace
SYSIEFAL	CTRACE COMP(SYSIEFAL)	None
SYSIOS	CTRACE COMP(SYSIOS)	See Formatting a SYSIOS trace
SYSJES	CTRACE COMP(SYSJES)	See Formatting a SYSJES trace
SYSjes2	CTRACE COMP(SYSjes2)	None
SYSLLA	CTRACE COMP(SYSLLA)	None
SYSLOGR	CTRACE COMP(SYSLOGR)	See Formatting a SYSLOGR trace
SYSOMVS	CTRACE COMP(SYSOMVS)	See Formatting a SYSOMVS trace
SYSOPS	CTRACE COMP(SYSOPS)	See Formatting a SYSOPS trace
SYSRRS	CTRACE COMP(SYSRRS)	See Formatting a SYSRRS trace
SYSRSM	CTRACE COMP(SYSRSM)	None
SYSSPI	CTRACE COMP(SYSSPI)	None
SYSTTRC	CTRACE COMP(SYSTTRC)	None
SYSVLF	CTRACE COMP(SYSVLF)	None
SYSWLM	CTRACE COMP(SYSWLM)	None
SYSXCF	CTRACE COMP(SYSXCF)	See Formatting a SYSXCF trace
SYSXES	CTRACE COMP(SYSXES)	See Formatting a SYSXES trace

If some of the output in a combined or merged trace data set is for a GTF trace, use a GTFTRACE subcommand to format the GTF records and a CTRACE subcommand to format the component trace records. See The Generalized Trace Facility (GTF) for GTF tracing.

This example shows the CTRACE subcommand for a SYSXCF component trace, when the SERIAL and STATUS options are requested in the OPTIONS parameter.

ctrace comp(sysxcf) options((serial,status))