Dynamic parse and IRRDPI00

TSO parse macros can parse command keywords related to the base segments of profiles, but they cannot parse command keywords for other segments such as TSO, DFP, or OMVS. RACF® provides the dynamic parse function to parse keywords for non-base segments. IRRDPI00 builds the dynamic parse table from the dynamic-parse specification data (IRRDPSDS) and profiles in the CFIELD class, and then starts dynamic parse.

Rules: To ensure that commands work properly, follow these rules:

Run IRRDPI00 at every IPL. Otherwise, commands that allow information for non-base segments will not work properly.
Do not change the dynamic-parse specification data (IRRDPSDS).

Guidelines: For best performance and use, follow these guidelines:

Automate IRRDPI00, because you must run it after every IPL. For information about automating IRRDPI00, see Automating IRRDPI00.
To add installation-defined keywords to the CSDATA segment, create profiles in the CFIELD class. Refer to z/OS Security Server RACF Security Administrator's Guide for more information.

If dynamic parse is not active, commands that refer only to RACF base segment information will work if they do not contain any typing mistakes. If you make a mistake, RACF attempts to invoke dynamic parse, and issues a message saying that dynamic parse is not active.

If IBM® makes updates to the dynamic-parse specification data (IRRDPSDS) and the database templates (IRRTEMP2), you must apply the new templates to the RACF database and activate them on each system before you run IRRDPI00. To apply the new templates to the database, run IRRMIN00 with PARM=UPDATE from one system that uses the database. To activate the templates on a system, run IRRMIN00 with PARM=ACTIVATE, or re-IPL. The PTF containing the update will specify whether or not you should update your templates. For information on IRRMIN00, see RACF database initialization utility program (IRRMIN00). After you update your templates, run IRRDPI00 on each system if the PTF also changed the dynamic parse specifications. Each time that IRRDPI00 runs, RACF remembers the level of the IRRDPSDS data set. Each time you IPL, RACF activates the latest level of the RACF templates on the system. You can display the level of each that your system is using with the RACF operator command SET LIST. The level is an FMID, such as HRF2220, or an APAR number. For the templates, the level also includes an 8-digit release level, and an 8-digit APAR level. Figure 1 shows a sample of the SET LIST output.

If the CFIELD class is active, the IRRDPI00 command processes CFIELD profiles. CFIELD profiles define custom field names and attributes in their CFDEF segments. When UPDATE is specified, the IRRDPI00 command stores the custom field keyword and attributes in the dynamic parse table. Validity checking of the fields will occur for both CHECK and UPDATE processing.

If a large number of custom fields are defined in the CFIELD class, ensure that the region size used to run IRRDPI00 is large enough to handle the increased storage usage.