Formatting a USRn trace table entry

The following brief explanation describes the process involved in formatting a USRn trace table entry (TTE) using the IBM-supplied routines.

The system trace filter/formatter module, IEAVETEF, uses the home ASID in the TTE to determine if a particular trace table entry is selected for formatting. If so, the system formats the following system-supplied status information for the TTE in the trace output buffer.

Note: The labels in parentheses are those mapped by macro IHATROB.

The processor number (TROBPRID)
The HASID (TROBASID)
The current TCB address (TROBTCBA)
The USRn acronym for the TTE (TROBID)
The return address of the issuer of PTRACE (TROBRET)
The continuation information, if the TTE is part of a multi-part entry (TROBUNQ1, TROBUNQ2, and TROBUNQ3)
The PASID (TROBPASN)
The SASID (TROBSASN)
The time-of-day value for the TTE (TROBTIME)

The system then calls the appropriate USRn formatting routine (ITRF0n7F), which calls ITRFDEFU, the default formatting routine.

ITRFDEFU formats the user data, in hexadecimal, in the trace output buffer fields labelled TROBUNQ1, TROBUNQ2, and TROBUNQ3. These fields correspond to the columns headed by UNIQUE-1, UNIQUE-2, and UNIQUE-3 in the printed trace table. The system then calls the print buffer service routine to print the output line. A single USRn TTE can contain up to five fullwords of user data, which are formatted on two successive lines in the printed output.