Use this system macro to compute the address of the next available trace
entry for the entry control block (ECB) trace table, the TPF log table, and
the LDEVBK input/output (I/O) trace table.
Format
- ENTRY=Rx
- On return, the general register specified will contain the address of the
requested trace entry. R0 is not valid.
- BASE=Ry
- The specified general register will be used to get the base address of the
requested trace table. R0 is not valid.
- TYPE
- This parameter identifies the trace table whose entry is to be
computed.
- ECB
- Identifies the ECB macro trace table.
- IO
- Identifies the LDEVBK I/O trace table.
- LOG
- Identifies the system log table.
Entry Requirements
When TYPE=ECB:
- R9 must contain a valid ECB address for the current address space.
- R11 must contain X'1000'.
- R12 must contain X'2000'.
- When TYPE=IO the LDEVBK for the device being traced must be directly
addressable through a previously declared USING statement.
Return Conditions
- Control is returned to the next sequential instruction (NSI).
- Rx contains the address of the assigned trace entry.
- Ry contains the base address of the requested trace table.
- The contents of all other registers are preserved across this macro
call.
Programming Considerations
- This macro should only be used by the appropriate trace monitor
routines.
- This macro may be processed on any I-stream.
- When a register is selected as a parameter it must be in the range R1
through R15.
Examples
None.