Installing your exit

You can provide more than one user I/O exit. For example, you might want to provide a different exit for each user, or different exits for use with different data sets. You can only specify one exit name for the option USEIOX, so you could make this your site-specific or default exit. Individual users can specify different exits interactively or in batch.

Two usermods are provided, HFMUMODU and HFMUMODH, to enable you to install High Level Assembler exits under the control of SMP/E. HFMUMODU installs a basic exit written in HLASM. HFMUMODH installs an exit written in HLASM, which enables Z Data Tools to process data in an HFS. Other exits written in HLASM, and exits written in other high level languages must be provided outside of SMP/E.

To provide a site-specific exit in HLASM, using HFMUMODU or HFMUMODH:

  1. Change the USEIOX option in HFM0POPT. For more information on how to change the default options, see Changing the default options. For information about the USEIOX option, see USEIOX.
  2. Code your own version of HFMIOXEA or HFMIOXHF, in your own source library. Refer to the information in Exit control block data names and Using the I/O exit control block. You can use HFMIOXEA or HFMIOXHF in HFM.SHFMSAM1 as examples.
  3. Modify the HFMUMODU or HFMUMODH members in HFM.SHFMSAM1 to meet your site's requirements. Refer to the usermods for information about changes you may need to make.
  4. Install SMP/E usermods HFMUMODU or HFMUMODH. Your exit will be installed in HFM.SHFMMOD1 if you installed Z Data Tools into the default libraries.

To provide further exits in HLASM:

  1. Code your own exit in your own source library. You can use HFMIOXEA or HFMIOXHF in HFM.SHFMSAM1 as examples.
  2. Assemble and link your exit into a load library available to Z Data Tools, for example, HFM.SHFMMOD1.

JCL is provided in the job HFMIOXHA to help you to assemble and link your exit. Refer to the instructions in the job for changes you need to make. HFMIOXHA is distributed in HFM.SHFMSAM1.

To provide your own exit in COBOL or PL/I:

  1. If you plan to use this exit as your site-specific or default exit, change the USEIOX option in HFM0POPT.
  2. Code your own exit in your own source library. Refer to the information in Exit control block data names and Using the I/O exit control block. You can use HFMIOXEC or HFMIOXEP in HFM.SHFMSAM1 as examples.
  3. Compile and link your exit into a load library available to Z Data Tools, for example, HFM.SHFMMOD1.

JCL is provided in the job HFMIOXCO to help you to compile and link your exit in COBOL. JCL is provided in the job HFMIOXPL to help you to compile and link your exit in PL/I. Refer to the instructions in the jobs for changes you need to make. HFMIOXCO and HFMIOXPL are distributed in HFM.SHFMSAM1.