Creating USERMODs for Roof Exits

A roof exit (or driver exit) is used to activate as many as nine other sample exits. Each sample exit activates a different function. The driver exit calls each sample exit in turn. The ICE Automatic Exit Installation tool fully supports the creation of USERMODs for roof exits.

Note: Installing a version of an exit is different from installing the same version under its corresponding roof exit. The load module name that is created for the same exit version is different. If the exit version is installed as a stand-alone exit version, the load module name is the default (for example, CTMX001). If the exit version is installed under the roof exit, the load module name is the full eight-character version name (for example, CTMX001A).

To install the roof version of an exit:

1. When using the roof version of an exit, you must first install all the versions of the exit that you need, one by one, by following the instructions in the USERMOD installation job. (Follow steps 1a through 1c for each exit in the roof exit.)
   1. Start the ICE Automatic Exit Installation tool.
   2. Specify the exit you want to install.
   3. Make the changes in the USERMOD installation job that was built by the automatic exit installation tool as specified in the following lines. (Do not modify lines that are not listed below!)

   Table 272 Changes to the USERMOD Installation Job

   from: INCLUDE AIOALOAD(<defaultexit>)  to: INCLUDE AIOALOAD(<roofexit>)

   from: NAME <defaultexit>(R)            to:  NAME <roofexit>(R)

   from: ++SRC(<defaultexit>) DISTLIB(ASAMPEXT) DISTMOD(AIOALOAD) .  

   to:   ++SRC(<roofexit>) DISTLIB(ASAMPEXT) DISTMOD(AIOALOAD) .  

   where <defaultexit> is the name of the default exit and <roofexit> is the full, eight-character name of this exit when run under the roof.

2. Install the roof version of the exit with the ICE Automatic Exit Installation tool. To do this, specify the versions of the exit that you want to implement in the source of the roof exit, as follows:

   &MODULE1 SETC   'CTMX001A'      FIRST EXIT TO BE CALLED

   &MODULE2 SETC   'CTMX001B'      2'ND EXIT TO BE CALLED

   &MODULE3 SETC   '        '      3'RD EXIT TO BE CALLED

   &MODULE4 SETC   '        '      4'TH EXIT TO BE CALLED

   &MODULE5 SETC   '        '      5'TH EXIT TO BE CALLED

   &MODULE6 SETC   '        '      6'TH EXIT TO BE CALLED

INCONTROL products that currently contain roof exits include IOA, Control-M, and Control-M/Restart.