1 – Install SMF Exit IEFU83

Installation of Connector IEFU83 exits creates the IEFU83 load module in the system LPA library.

The following members in the INSTALL library involved in this installation procedure:

Member Description

RCFU83A

Connector IEFU83 SMF exit source code

ASMU83A

Sample job to assemble and link CTSU83A

CPYU83A

Sample job to copy CTSU83A module to the system library as IEFU83A

To Install SMF exit IEFU83:

  1. Create the CTSU83A exit module.

    Member ASMU83A in the Connector INSTALL library is a sample member to assemble and link Connector exit IEFU83.

    Review the JCL carefully and submit the job to create the CTSU83A load module in the Connector LOAD library. All job steps must end with a condition code of 0, except for the following:

    • CHECRCF – Ends with the condition code 4.

    • ACFU83A – This step is not executed.

  2. (Optional) If you wish to have the exit module reside permanently in the LPA, copy CTSU83A to your LPA system library; otherwise proceed directly to step 3.

    Edit member CPYU83A in the Connector INSTALL library. The job copies load module CTSU83A to your system LPA library. Review the job carefully and submit the job. All job steps must end with a condition code of 0.

  3. Define the SMF exit in the MVS dynamic exits facility.

    Edit member PROGnn in SYS1.PARMLIB to define the new SMF exit module for all SMF sub-systems.

    • If you copied CTSU83A to the LPA system library, add the following statements to the member:

      Copy 
      EXIT ADD EXITNAME(SYS.IEFU83) MODNAME(CTSU83A)
      EXIT ADD EXITNAME(SYSSTC.IEFU83) MODNAME(CTSU83A)
      EXIT ADD EXITNAME(SYSTSO.IEFU83) MODNAME(CTSU83A)

      Save the member.

    • If you did not copy CTSU83A to the LPA system library, add the following statements to the member:

      Copy 
      EXIT DELETE EXITNAME(SYS.IEFU83) MODNAME(CTSU83A)
      EXIT ADD EXITNAME(SYS.IEFU83) MODNAME(CTSU83A)
      DSNAME(CTSA Load Library)
      EXIT DELETE EXITNAME(SYSSTC.IEFU83) MODNAME(CTSU83A)
      EXIT ADD EXITNAME(SYSSTC.IEFU83) MODNAME(CTSU83A)
      DSNAME(CTSA Load Library)
      EXIT DELETE EXITNAME(SYSTSO.IEFU83) MODNAME(CTSU83A)
      EXIT ADD EXITNAME(SYSTSO.IEFU83) MODNAME(CTSU83A)
      DSNAME(CTSA Load Library)

    • If you have more subsystems defined in your SMFPRMnn (see step 5), other than STC and TSO like (JES2), add a proper definition for it, similar to the definitions for TSO and STC.

      If JES3 is active in your environment, add the following line as well:

      EXIT ADD EXITNAME(SYSJES2.IEFU83) MODNAME(CTSU83A)

      DSNAME(CTSA Load library)

      Save the member.

  4. If you performed the optional step 2, activate the exit module CTSU83A in LPA system library, otherwise proceed directly to step 5.

    Once the exit module resides in your LPA library, activate the module. This is usually performed by the next IPL with the CLPA option.

    If you have a product which can dynamically load modules to the LPA (for example, RESOLVE, LOOK, OMEGAMON) you can use it to add the exit to the LPA. However, when loaded in this manner, the exit remains active only until the next IPL.

  5. Set SMF parameters.

    Member SMFPRMnn in SYS1.PARMLIB defines the SMF exits that are used by SMF.

    Make sure that the exit IEFU83 is defined for all SMF subsystems, and record type 80 is defined to all subsystems.

    Save the member.

  6. Activate the SMF exit.

    • If the new IEFU83 exit was dynamically loaded to the LPA (as described in step 5), refresh the SMF definitions by issuing the following operator command:

      SET SMF=nn

      where nn is the suffix of the SMFPRMnn member that is updated.

    • Otherwise, an IPL should be executed with the CLPA option to activate the new exit. Activate the exit by issuing the following operator command:

      SET PROG=nn

      where nn is the suffix of the PROGnn member which was updated in step 3

Note
Installation of the SMF exit IEFU83 is complete.