Previous Topic: TRACE Command: Activate Trace FacilityNext Topic: TRACEPRT Command: Print Trace Data


TRACEDEF Command: Identify Data Sets

To identify data sets to record the information the trace facility collects, use the TRACEDEF command.

Type: OPER command

Authority: To issue the TRACEDEF command, you require OPER authority.

This command has the following format:

TRACEDEF DSN(dsname[,dsname]...)
         [BUF(size,count)]
dsname

Indicates the name of one or more data sets used as trace data sets. Separate the data set names with a blank or comma. Specifying multiple trace data sets allows you to use the SWITCH operand with TRACE to free up one trace data set and switch to another.

size, count

Indicates the buffers that you want to use for the trace data sets you define. Size specifies the buffer size and count identifies how many buffers are required. This defaults to (4096,4)—(four buffers, each one 4096 bytes).

Before you use the trace facility, allocate one or more trace data sets. Identify these data sets to z/OS Agent with the TRACEDEF command.

You do not have to specify any DCB attributes when you initially allocate the data sets, because z/OS Agent does this task automatically.

Trace data sets use the following attributes: DCB=(RECFM=VB, LRECL=4096, BLKSIZE=4100).

The buffers that you define continue to hold trace data until each one becomes full. Once full, the data is written automatically to the trace data set and another buffer is used.

Related Information

For information on defining a trace data set at the initialization parameter level, see the Installation and Configuration Guide.

For information on activating the trace facility, see the TRACE Command.

Example: Define Two Trace Data Sets

This example shows how to define two trace data sets that each have three 23400-byte buffers.

TRACEDEF DSN('ZAGCYB.TRACE1', 'ZAGCYB.TRACE2') BUF(23400,3)