SMFWTM — Writing SMF records

The SMFWTM macro is used to write records to the SMF data set. You can use this macro in any exit routine that is supervisor state except for IEFU83, IEFU84, IEFU85, and IEFU29, and in any application program that is APF-authorized.

All SMF records are given to installation exits before they are written to the SMF data set. If you use SMFWTM, installation exit IEFU83 is invoked.

Note that you can also write SMF records without using a macro. See smf_record (BPX1SMF, BPX4SMF) -- Write an SMF record in z/OS UNIX System Services Programming: Assembler Callable Services Reference.

[label] SMFWTM {record address|(r)}

record address

is the symbolic address of the record to be written.

(r)

is a register containing the address of the record to be written. The value for (r) can be either the absolute register number or a symbol for the register. In either case, you must code the parentheses, for example, (2) or (REG2).

Record types 0 through 127, which are SMF-formatted records, are reserved for IBM® products. For record types 0 through 127, you must supply the record descriptor word (RDW) and the record type field in the standard SMF record header. The SMFWTM macro supplies the remaining header information.

Record types 128 through 255 are available for user-written records. When using the SMFWTM macro to write user records, you must provide the standard SMF record header, which includes a RDW for the record. You must fill in the date, time, and system identifier in the record header. While the system identifier can be any four character identifier, specifying the value of the SID parameter is consistent with the system records SMF produces. For a description of the standard SMF record header, see ‘SMF Records’ in z/OS MVS System Management Facilities (SMF).

All SMF records are given to installation exit IEFU83 before they are written to the SMF data set.