PTrace Reference Manual

PTrace Commands
PTrace Reference Manual—526393-001
3-25
SELECT Command
determine whether the record is of a type that you want to display. PTrace also checks
many other session parameters, such as those established by FILTER and LIMIT.
You select specific records in two ways, depending on how your subsystem
implements PTrace:
1. Through a keyword that is translated into an enumerated value or through a
number that is saved as an enumerated value.
2. Through a 32-bit selection mask. If your subsystem supports record selection
through bit masks, you must use the SELMASK command to select records for
display. The SELECT command and DESELECT command do not accept
numbers representing bit masks. Refer to the SELMASK Command on page 3-28
for information about using the 32-bit mask to establish trace selection options.
Record Selection Through Keywords or Enumerated Values
If your subsystem supports record selection through enumerated values (either
keywords or numbers), you can use the SELECT command to specify them. Each
keyword supported by your subsystem has a numeric value associated with it and
represents a particular record type. Records can be selected by specifying either the
appropriate keyword or its numeric value in the SELECT command.
Each subsystem defines its set of keywords and their corresponding enumerated
values. Certain keywords actually represent bit mask positions—specifying a keyword
of this type results in a change of the record selection bit mask.
ALL
selects all trace-selection options.
CURRENT
selects the currently defined trace-selection options.
number
is an integer that specifies an enumerated value corresponding to a specific
keyword.
SELECT [ ALL ]
[ CURRENT ]
[ number ]
[ keyword ]
[ ( keyword [ , keyword ]... ) ]
Note. ALL and CURRENT are keywords and can be included in a list of keywords (see
Ta ble 3-4
).