The TRACE command causes the current trace table, or a portion of the trace table, to be printed. The trace table is generated by the trace facility, which is a general purpose operating system debugging aid available when the MCP compile-time option TRACE is set. The TRACE facility allows for trace table entries to be made at predefined points in the MCP, called CONDITIONALDUMP stops, each of which is associated with a particular statement in the MCP. Each stop has two parameters: a stop number and an information word. The stop number is a two digit number (in hex) that is different for each stop. A new set of CONDITIONALDUMP stops is in effect for each system software release level. Information about the conditions under which the stops are reached is given in the trace table entry. The trace table holds about 1650 entries in a circular queue; when the last slot has been filled, the next entry overwrites the first entry.

Syntax

                               ┌◄────────────────────────────┐
── TRACE ─┬──────────────────┬─┴─┬─────────────────────────┬─┴─────────┤
          └─<entries number>─┘   ├─ CD ─┬──────────────────┤
                                 │      │ ┌◄────────────┐  │
                                 │      └─┴─<CD number>─┴──┤
                                 ├─ CPM ──<CPM number>─────┤
                                 ├─ SHOW ──────────────────┤
                                 └─ STACK ──<stack number>─┘

Explanation

The following text describes the meaning of each construct. Refer to “Basic Constructs” earlier in this section for information about the <number> construct. Each of the following constructs are considered to be <number> constructs.

TRACE

Prints the entire trace table.

TRACE <entries number>

Prints the specified number of recent entries in the trace table.

TRACE CD <CD number>

Prints the trace table entries with the specified conditional dump (CD) number.

TRACE CPM <CPM number>

Prints the trace table entries with the specified central processing module (CPM) number.

TRACE SHOW

Prints all SHOW messages. SHOW messages appear in EBCDIC format. DEADSTOP information appears in hexadecimal format.

TRACE STACK <stack number>

Prints trace table entries in the specified process stack.

TRACE <entries number> CD <CD number>

TRACE <entries number> CPM <CPM number>

TRACE <entries number> SHOW

TRACE <entries number> STACK <stack number>

Searches the specified number of most recent entries to the trace table and prints the entries meeting the specified CD, CPM, SHOW, or STACK criteria.

Example

The following example shows the output from the TRACE command.