Printing
Stopping
The data is unblocked into logical records and printed in hexadecimal. Each logical
record starts on a new line. The interface data, the only data that can be longer
than one print line, is indented to improve its readability. The program,
TRAPRED, is a CP module shipped with the CMS modules, and exists on the CMS
S disk with an S2 filemode. TRAP RED writes CP error messages to the terminal,
and writes line mode data to the terminal, and to the printer. Although TRAPRED issues CP messages, the program runs in the CMS user area. I TRAPRED I filenum
In CMS mode enter: . TRAPRED filenum
where:
TRAP RED
is the name of the CPTRAP data reduction program.
filenum
is the number of the READER file that is the output of CPTRAP processing.
The filename and filetype are 'CPTRAP FILE'.
The spool file specified must belong to the user invoking the program, and must be
of a class which can be read and must not be held.
After you enter 'TRAPRED filenum', the CPTRAP READER file is accessed and
interactive processing may begin. The CMS immediate commands HT and HX
work with this program.
There are three categories of interactive subcommands:
All [ON ]
All [OFF] typenum [Vrnblok nnnnnn]
[DEVaddr nnnn ] [COde nnnn ] [OFF ]
These subcommands control which trace table types are to be viewed on the termi­
nal or spooled to the printer. The specification of X'3F' or X'3E' for typenum
causes selectivity of CP or virtual machine interface records respectively. Remem­
ber that the records on the file were selectively chosen at CPTRAP invocation, so
this may be looked at as a second level of selectivity.
All [ON] All selectivity is desired at this time (data reduction time). All
records on the READER file are processed. This is the default
setting at invocation time if selectivity is not modified. OFF turns off all selectivity definitions. ALL or ALL ON turns on
all typenum general selectivity.
Performance Observation and Analysis 65

File Processor Subcommands
All [OFF] No selectivity, no records will be processed.
typenum Vmblok nnnnnnnn DEVaddr nnnn COde nnnn OFF These have the same meaning as during CPTRAP selectivity definition. In
addition, typenums X'3F' and X'3E' may be specified for CP interface data and
virtual machine interface data, respectively.
When the first typenum is entered after invoking the program or "ALL[ON]", all
other typenums are reset to off.
When the TRAPRED program is invoked, the message 'ENTER SELECTIVITY OPTION(S) OR SUBCOMMAND' is issued. TOP BOTtom Up DOwn Type
TYPEBack Printer nnnnnnnn
nnnnnnnn
nnnnnnnn
nnnnnnnn
nnnnnnnn TOP /BOTtom Use these commands for positioning within the CPTRAP READER
file. TOP positions to the first record of the file; BOTtom at the last
record. Up/Down nnnnnnnn Use these commands to move data around within the READER file.
The amount of movement is controlled by the number following the
command. The number indicates how many logical records are to be
skipped; counting is selective. DOWN is toward the end of the file, UP is toward the start of the file. The nnnnnnnn may be any decimal
value between 1 and 99999999. Wrapping of the file is not allowed,
and the subcommand ends prematurely if either the end of file or start
of file is encountered.
Type nnnnnnnn
Type indicates that selective output is to be displayed on the terminal.
nnnnnnnn is the number of selective lines desired. If unspecified, one
line, the current line, is displayed. nnnnnnnn may be any decimal val­
ue between 1 and 99999999. The command ends prematurely if the
end of file is encountered.
For CP and virtual machine interface records (types X'3F' and X'3E'
respectively), the indicated number of logical records is displayed.
Each logical record may be more than one line.
66 VM/SP System Programmer's Guide /