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, FMNUMODU and FMNUMODH, to enable you to install High Level Assembler exits under the control of SMP/E. FMNUMODU installs a basic exit written in HLASM. FMNUMODH installs an exit written in HLASM, which enables File Manager 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 FMNUMODU or FMNUMODH:

  1. Change the USEIOX option in FMN0POPT. 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 FMNIOXEA or FMNIOXHF, 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 FMNIOXEA or FMNIOXHF in FMN.SFMNSAM1 as examples.
  3. Modify the FMNUMODU or FMNUMODH members in FMN.SFMNSAM1 to meet your site's requirements. Refer to the usermods for information about changes you may need to make.
  4. Install SMP/E usermods FMNUMODU or FMNUMODH. Your exit will be installed in FMN.SFMNMOD1 if you installed File Manager into the default libraries.

To provide further exits in HLASM:

  1. Code your own exit in your own source library. You can use FMNIOXEA or FMNIOXHF in FMN.SFMNSAM1 as examples.
  2. Assemble and link your exit into a load library available to File Manager, for example, FMN.SFMNMOD1.

JCL is provided in the job FMNIOXHA to help you to assemble and link your exit. Refer to the instructions in the job for changes you need to make. FMNIOXHA is distributed in FMN.SFMNSAM1.

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 FMN0POPT.
  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 FMNIOXEC or FMNIOXEP in FMN.SFMNSAM1 as examples.
  3. Compile and link your exit into a load library available to File Manager, for example, FMN.SFMNMOD1.

JCL is provided in the job FMNIOXCO to help you to compile and link your exit in COBOL. JCL is provided in the job FMNIOXPL 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. FMNIOXCO and FMNIOXPL are distributed in FMN.SFMNSAM1.