|
NAME : HCPTTABK
DESCRIPTION: Table of Trace Entry Codes
DSECT : TTABK
FUNCTION :
This control block maps the structure of the
table of trace entry codes as they exist either
in HCPTTATB data area, or in free storage created
by the SET CPTRACE command processor.
LOCATED BY :
PFXTTATB points to the non-explicit (default)
copy of the TTABK
VMDTTABK in every VMDBK
CREATED BY :
HCPCFASC - SET CPTRACE command processor
The HCPTTATB data area, also mapped by this block,
is part of the CP resident nucleus
DELETED BY :
HCPCFAFR - Fret TTABK's which SET CPTRACE acquired
HCPCFALG - Fret (if necessary) a VMDBK's TTABK
during LOGOFF processing
The HCPTTATB data area is never deleted
SERIALIZED :
TTALOCK - prevents concurrent changes via multiple
SET CPTRACE commands
MP Defer - TTABK's in free storage are only fretted
via the MP defer mechanism (HCPMPDFR).
RELOCATION CONSIDERATIONS : None
NOTES :
The trace entry codes below are ordered according
to their frequency of occurrence in the system
trace tables. As CP tracing evolves and changes,
so should the order, in order to provide the best
possible cache utilization.
The number of fullwords reserved for TTACODES and
TTACODEN must be equal or greater than the number
of codes defined in HCPTTABK. The CKMAINT macro is
used to ensure this by causing an assembly error
when too many codes are added and there is no room.
The size of HCPTTABK must not go over 1 page
since a base register is used to address it.
General Information -
Trace Codes x'C0xx' are reserved for VICOM.
Trace Codes x'7F00' to x'7FFF' are reserved for
installation use. See comments below.
Codes that are added in here, must also be added to
HCPTTA ASSEMBLE, at entry HCPTTATR. The only
exception would be if the trace code you add will
NOT be controlled by the SET CPTRACE command (which
should not be the norm). Note that the way you
specify the trace entry in HCPTTA must be reflected
in the CP Command and Utility Reference, under the
SET CPTRACE command. That is, with SET CPTRACE, a
system programmer can activate or deactivate the
trace function for a specific code, a category of
codes, or for all codes. Let's look at an example
from HCPTTA ASSEMBLE:
TCTGEN 1,ALLCODES,MINLEN=3
TCTGEN 2,EXT
TCTGEN 3,0100 External interruption
TCTGEN 3,PCDIAG
TCTGEN 4,3C00 Proc controller diagnose
TCTGEN 4,3C55 Proc controller diagnose
TCTGEN 3,PCSERVC
A system programmer could issue:
SET CPTRACE OFF ALLCODES * All tracing is off
SET CPTRACE OFF EXT * Turn off 0100, plus category
PCDIAG & PCSERVC, which
include 3C00 & 3C55, etc.
SET CPTRACE OFF PCDIAG * Turn off PCDIAG
SET CPTRACE OFF 3C00 * Turn off 3C00 only
Deleting a Trace Entry Code
Starting in V5.4.0, deleted trace entry codes can be
reused. Trace entry codes are not permanently assigned.
Do *not* simply remove the label from a trace entry
code. Every trace entry code must have a label.
| |