Installing the SMF user exit

If your System Management Facilities (SMF) is in data set recording mode, you can configure the System Data Engine to collect SMF data by using SMF user exit code that is provided with the Z Common Data Provider.

About this task

If you want to use the user exit to collect SMF data, install HBOSMF86 to the IEFU86 MVS installation exit. The SMF user exit code provided by the Z Common Data Provider is in the SHBOLPA library.

For more information about MVS installation exits, see the z/OS® MVS installation exits documentation.

Procedure

To install the SMF user exit, complete the following steps:

  1. Verify that the SMF IEFU86 exit is configured in the existing SMFPRMxx member.
    Action Instruction
    Verify that the IEFU86 exit is enabled in the SMFPRMxx member
    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.
      Important: The exits that you define on the SYS parameter in z/OS SYS1.PARMLIB member SMFPRMxx (or its equivalent) do not take effect if you also have SUBSYS parameter definitions. Therefore, if you define any subsystems, you must define theMVS installation exit IEFU86, for each subsystem that is specified by a SUBSYS parameter.
  2. To install the exit, complete one of the following actions:
    Action Instruction
    Install the user exit on an MVS installation exit at system IPL Add the following statements to a PROGxx member of the library SYS1.PARMLIB:
    EXIT ADD EXITNAME(SYS.IEFU86) MODNAME(HBOSMF86)
    If you specified any subsystems in an SMFPRMxx member, you must add the exit to those subsystems. For example, for the subsystem JES2, you must add the following statements:
    EXIT ADD EXITNAME(SYSJES2.IEFU86) MODNAME(HBOSMF86)
    Dynamically install the user exit after the system IPL Run the following MVS commands:
    SETPROG EXIT,ADD,EXITNAME=SYS.IEFU86,MODNAME=HBOSMF86
    If you specified any subsystems in an SMFPRMxx member, you must define the exit to those subsystems. For example, for the subsystem JES2, you must run the following commands:
    SETPROG EXIT,ADD,EXITNAME=SYSJES2.IEFU86,MODNAME=HBOSMF86
    Troubleshooting tips:
    • To verify that the SMF user exits are included in the SYS parameter and SUBYS parameter, use the following command:
      D SMF,O
    • To display the status of the SMF user exit, use the following commands:
      D PROG,EXIT,EXITNAME=SYS.IEFU86
    • If you need to uninstall the user exit, see Uninstalling the SMF user exit.