27.12.2012 Views

z/VM: CP Commands and Utilities Reference - z/VM - IBM

z/VM: CP Commands and Utilities Reference - z/VM - IBM

z/VM: CP Commands and Utilities Reference - z/VM - IBM

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

to define. FORMAT is the default value. Some products may provide only one<br />

format, that being either a short (HEX) or long (FORMAT) format for their guest<br />

trace data.<br />

The following records are supported for the format option:<br />

v <strong>CP</strong> trace table records<br />

v <strong>CP</strong> records of type DATA <strong>and</strong> IO<br />

v Guest trace records providing a formatting routine that is accessible by<br />

TRACERED.<br />

Other guest trace records will be formatted in hex output.<br />

HEX<br />

stipulates that the hexadecimal (or short) format should be used for the selected<br />

entries. <strong>CP</strong> trace table data output is one line per trace entry. The mixture of<br />

hexadecimal <strong>and</strong> interpreted output is determined by the exit routine for guest<br />

trace data. Some products may provide only one format, either a short (HEX) or<br />

a long (FORMAT) format for their guest trace data. You may want to use this<br />

option when you want output to go to a CMS file <strong>and</strong> limited DASD space<br />

precludes the use of the FORMAT option.<br />

The following records are supported for the format option:<br />

v <strong>CP</strong> trace table records<br />

v <strong>CP</strong> records of type DATA <strong>and</strong> I/O<br />

v Guest trace records providing a formatting routine that is accessible by<br />

TRACERED.<br />

Other Guest trace records will be formatted in hex output.<br />

SELECT<br />

signifies that you want selection criteria to be applied to the trace entries. You<br />

will be prompted for the selection criteria you want. This is the system default.<br />

ALL<br />

indicates that all trace entries from the specified input tape or system trace file<br />

are to be selected for output. You will not be prompted for selection criteria.<br />

LRECL 80<br />

LRECL 132<br />

specifies the record length maximum for the output file. When not specified,<br />

CMS files default to 80 bytes <strong>and</strong> print files default to 132 bytes.<br />

NOXEDIT<br />

avoids entering an XEDIT session when the CMS keyword is specified on<br />

TRACERED. This option may be useful if the CMS output file created is too<br />

large to XEDIT.<br />

Selection Criteria for the SELECT<br />

If you choose or let the system default to the SELECT option for the TRACERED<br />

comm<strong>and</strong>, you receive the following prompt:<br />

ENTER TRACE ENTRY SELECTION CRITERIA, NULL LINE TO END<br />

SELECTION, OR QUIT TO END TRACERED COMMAND<br />

TRACERED<br />

If you enter a null line, no selection criteria are applied. As a result, everything will<br />

be traced.<br />

Chapter 3. <strong>CP</strong> <strong>Utilities</strong> 1875

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!