SMFRTEST — Testing record recording

The SMFRTEST macro allows you to determine if a particular type, or subtype, of a record is being recorded. Issue this macro before collecting data for a particular record or subtype to avoid the overhead of data collection if it is not written.

When you invoke the SMFRTEST macro, you must include the IEESMCA mapping macro, which maps the SMCA.

[label] SMFRTEST RECTYPE={record}[,SUBTYPE={subtype}][,SUBSYS={name }]
                         {(reg) }[         {(reg)  }][        {(reg)}]

RECTYPE=record

RECTYPE=(reg)

specifies the SMF record type to be checked, where record can be any one to three decimal digits (0-255). If you use a register, the register (2-12) contains the record type. You must code the parentheses if you code a register, and you must right justify the record type within the register.

SUBTYPE=subtype

SUBTYPE=(reg)

specifies the SMF record subtype to be checked, where record can be any one to three decimal digits (0-255). If reg is specified, the register (2-12) contains the record subtype. You must code the parentheses if you code a register and you must right justify the record subtype within the register.

SUBSYS=name

SUBSYS=(reg)

specifies the name (or address in register 2-12) of the 4-byte field containing the subsystem name. The macro looks for the subsystem name in SMFPRMxx and uses the options for that subsystem to determine if the record is written. The subsystem name must be left-justified and padded with blanks. If you use a register, it must be enclosed in parentheses. If the subsystem name is not found, then the macro uses the options specified for the entire system on the SYS option in SMFPRMxx to determine if the record is written.

If you do not specify a SUBSYS, the macro uses the subsystem name for the current address space. For example, TSO for TSO/E users, ASCH for APPC/MVS transactions programs, STC for started tasks, or the name of the job entry subsystem (JES2 or JES3) for batch jobs. The macro uses the options specified in the corresponding SUBSYS parameter for that subsystem in SMFPRMxx to determine if the record is written. If there is no corresponding SUBSYS parameter or if the SUBSYS parameter contains no information about whether the record would or would not be written for that subsystem, then the macro uses the options specified in the SYS parameter to determine if the record is written.