Using IRRADU00

The RACF® SMF data unload utility uses the SMF Dump Utilities (IFASMFDP or IFASMFDL) as the driver module to control its invocation. The RACF SMF data unload utility is invoked as USER2 and USER3 exits to IFASMFDP or IFASMFDL. To request RACF SMF data unload utility processing, enter the names of the RACF SMF data unload utility modules (IRRADU00 and IRRADU86) in the SYSIN data stream for IFASMFDP or IFASMFDL.

The following job control statements are necessary for executing IRRADU00:
JOB
Initiates the job.
EXEC
Specifies the program name (PGM=IFASMFDP or PGM=IFASMFDL) or, if the job control statements are in a procedure library, the procedure name.
SYSPRINT DD
Defines a sequential message data set for the messages produced by IFASMFDP or IFASMFDL.
SYSIN DD
Defines a sequential input data set for the SMF Dump Utility control statements. These statements must include the USER2(IRRADU00) and USER3(IRRADU86) statements for invoking the RACF SMF data unload utility. Additional IFASMFDP or IFASMFDL control statements can be used to select records based on date, time, and SMF system ID. IFASMFDP and IFASMFDL use defaults for control parameters that are allowed to default. In particular, the default value for the OPTIONS parameter is ALL, which causes the input data set to be reset so that it can be reused. See z/OS MVS System Management Facilities (SMF) for information on overriding defaults.
Note: IRRADU00 is called once for each IFASMFDP OUTDD or IFASMFDL OUTDD control statement that meets the specified selection criteria. This might result in multiple calls for the same SMF record, causing that record to appear more than once in the SMF unload output.
ADUPRINT DD
Defines a sequential message data set for the messages produced by the RACF SMF data unload utility.
DUMPIN DD
Defines the input SMF data stream.
Note: The ddname DUMPIN can be changed by the control statements that are contained in the SYSIN data stream.
DUMPOUT DD
Defines the output SMF data stream. After the RACF SMF data unload utility processes a record, it returns control to IFASMFDP or IFASMFDL and tells these utilities to continue its processing of the record. This causes IFASMFDP or IFASMFDL to write the record to DUMPOUT. If you do not want to retain these records, allocate DUMPOUT to DUMMY.
Note: The ddname DUMPOUT can be changed by the control statements that are contained in the SYSIN data stream.
OUTDD DD
Defines the single sequential output data set. The output of IRRADU00 is a set of variable length records. This data set must be allocated as a variable length data set, with a logical record length (LRECL) of at least 12288. If a shorter LRECL is supplied, IRRADU00 changes the LRECL to 12288.

IRRADU00 also changes the block size of the data set to be at least four more than the LRECL, unless the block size was set to zero to allow the system to choose the best block size.

XMLFORM DD
Creates an easily readable form of the report in XML. Each data tag appears on its own line. This file can be easily read in any editor, including displayed in a web browser. This data set must be allocated as a variable length data set, with a logical record length (LRECL) of at least 12288. If a shorter LRECL is supplied, IRRADU00 changes the LRECL to 12288. IRRADU00 also changes the block size of the data set to be at least four more than the LRECL, unless the block size was set to zero to allow the system to choose the best block size.
XMLOUT DD
Creates a compressed form of the report in XML. The resulting XML file will be small in filesize but will not be as easily readable as the output obtained by specifying XMLFORM DD. This data set must be allocated as a variable length data set, with a logical record length (LRECL) of at least 12288. If a shorter LRECL is supplied, IRRADU00 changes the LRECL to 12288. IRRADU00 also changes the block size of the data set to be at least four more than the LRECL, unless the block size was set to zero to allow the system to choose the best block size.
The output type generated is dependent on the statements incorporated in the JCL. Whichever output type is coded in the JCL is the only type that will be generated, according to the following rules:
  • Is XMLFORM DD specified in the JCL? If so, that is the only output written
  • If that is not specified, is XMLOUT DD specified in the JCL? If so, that is the only output written
  • If that is not specified, is OUTDD DD specified in the JCL? If so, that is the only output written
  • If none of these types are specified in the JCL, the utility issues message IRR67522I Open failed for OUTDD

If more than one DDname is placed in the JCL, the above order (XMLFORM, XMLOUT, OUTDD) is used to see which one is created. The actual order of DD statements in the JCL is irrelevant.

After the RACF SMF data unload utility has processed a record, control is returned to IFASMFDP or IFASMFDL, which writes the record to the ddname that was specified in the IFASMFDP SYSIN or IFASMFDL SYSIN control statement.