Upgrading SMF user exit for collecting SMF records from Z Common Data Provider 2.1.0 to 5.1.0

Edit online

Z Common Data Provider 5.1 provides a new SMF user exit for IEFU86, which can collect both the standard SMF records (record type in the range 0 - 255) and the extended SMF records (record type in the range 256 - 2047). If you use the Z Common Data Provider SMF IEFU83, IEFU84, or IEFU85 user exits to collect SMF records, when you upgrade from Z Common Data Provider 1.1.0 to 5.1.0, you are recommended to use the SMF IEFU86 user exit.

Procedure

To use the Z Common Data Provider SMF IEFU86 user exit, complete the following steps:

Update the LPALSTxx member to use the SHBOLPA SMP/E target data set from the Z Common Data Provider 5.1. Ensure that the SHBOLPA data set is removed from Z Common Data Provider 2.1.0.
Update the PROGxx member to replace the SMF IEFU83, IEFU84, or IEFU85 user exits from Z Common Data Provider 2.1.0 with the SMF IEFU86 user exit.
For example, if there are EXIT ADD statements as follows in your PROGxx member,
```
EXIT ADD EXITNAME(SYS.IEFU83) MODNAME(HBOSMFEX)
EXIT ADD EXITNAME(SYS.IEFU84) MODNAME(HBOSMFEX)
EXIT ADD EXITNAME(SYS.IEFU85) MODNAME(HBOSMFEX)
```
Replace the EXIT ADD statements with the following single statement.
```
EXIT ADD EXITNAME(SYS.IEFU86) MODNAME(HBOSMF86)
```
Repeat this action if you have the IEFU83, IEFU84, or IEFU85 user exits that are coded for any subsystems, for example, SYSSTC.
Update the SMFPRMxx member to enable the SMF IEFU86 user exit:
1. In the SYS parameter of your existing SMFPRMxx member, you must ensure that IEFU86 exit is included in the EXITS parameter. If the EXITS parameter is not coded for the SYS parameter, you must code the EXITS parameter for the SYS parameter to include all the required SMF user exits including IEFU86.
2. If there are SUBSYS parameters in your existing SMFPRMxx member, and the EXITS parameter is coded for the SUBSYS parameter, you must ensure that IEFU86 exit is included in the EXITS parameter.
Perform system IPL. Or alternatively, complete the following steps to switch to the SMF IEFU86 user exit.
1. Remove the Z Common Data Provider SMF IEFU83, IEFU84, or IEFU85 user exits by running the following MVS™ commands:
```
SETPROG EXIT,DELETE,EXITNAME=SYS.IEFU83,MODNAME=HBOSMFEX
SETPROG EXIT,DELETE,EXITNAME=SYS.IEFU84,MODNAME=HBOSMFEX
SETPROG EXIT,DELETE,EXITNAME=SYS.IEFU85,MODNAME=HBOSMFEX
```
  Repeat this action if the Z Common Data Provider SMF IEFU83, IEFU84, or IEFU85 user exits are installed for any subsystems. For example, if the user exits are installed for SYSSTC, run the following MVS commands to remove the user exits.
```
SETPROG EXIT,DELETE,EXITNAME=SYSSTC.IEFU83,MODNAME=HBOSMFEX
SETPROG EXIT,DELETE,EXITNAME=SYSSTC.IEFU84,MODNAME=HBOSMFEX
SETPROG EXIT,DELETE,EXITNAME=SYSSTC.IEFU85,MODNAME=HBOSMFEX
```
2. Run the following command to make the SMF configuration in step 3 take effect.
```
SET SMF=xx
```
3. Run the following MVS command to add the SMF IEFU86 user exit load module to LPA.
```
SETPROG LPA,ADD,MODNAME=HBOSMF86,DSNAME=hlq.SHBOLPA
```
4. Run the following MVS commands to install the SMF IEFU86 user exit.
```
SETPROG EXIT,ADD,EXITNAME=SYS.IEFU86,MODNAME=HBOSMF86
```
  If you specified any subsystems in the SMFPRMxx member, you must also install the exit for those subsystems. For example, for the subsystem STC, you must run the following MVS commands:
```
SETPROG EXIT,ADD,EXITNAME=SYSSTC.IEFU86,MODNAME=HBOSMF86
```