Subtype selectivity for SMF records is an option of
the TYPE or NOTYPE option on the SYS and SUBSYS parameters used for
SMF recording. Subtype selectivity allows more flexibility in
post-processing records and helps control the amount of data stored
in SMF data sets.
The subtype selectivity function supports only those records which
use the standard SMF record header. The header requires the subtype
field is at offset 22 (decimal) and the ‘subtypes used’
bit (bit position 1), of the system indicator byte at offset 4 (decimal),
is set to X'1'. SMF processes the record for subtype selectivity
when both conditions are met. To see if subtypes are used, check the
individual records in SMF records.
The TYPE option of the SYS and SUBSYS parameter provides inner
parentheses to indicate the subtypes to be collected. If subtype selection
is not used, the default is all subtypes. The following is an example
of how the TYPE option should be used to record subtypes 1, 2, 3,
5, 6, 7, and 8 for the type 30.
SYS(TYPE(30(1:3,5:8))) or SUBSYS(STC,TYPE(30(1:3,5:8)))
The NOTYPE option provides inner parentheses to indicate
the subtypes
not to be collected. If subtype selection is used,
all subtypes except the ones specified are collected. The following
is an example of how the NOTYPE option should be used to record all
subtypes except subtype 4 for the type 30 record. If subtype selection
is not used, the default is to exclude all subtypes of the specified
record type.
SYS(NOTYPE(30(4))) or SUBSYS(STC,NOTYPE(30(4)))
When using the NOTYPE keyword, data is collected for all records except those
specified. In the preceding example, data is collected for record
types 0 through 29; all record 30 subtypes except subtype 4; and records
31 through 255.
Note: - If subtype selectivity is specified for a record type for which
subtypes are not supported, the specification of the subtype(s) is
ignored and the record type is recorded. No warning message is used.
- The specification of a subtype more than once is accepted. No
warning message is issued.
- If an incorrect range is specified (that is, the first value of
the range is greater than the second value) a message IEE948I is issued
(for more information, see z/OS MVS System Messages, Vol 7 (IEB-IEE).
The operator must then re-enter the valid range.