How to use user exits

SUPEROPT provides the following user exits:

• Inbound Before Optimization
• Inbound After Optimization
• Outbound Before Optimization
• Outbound After Optimization
• Terminal Name Change (inbound and outbound)

For instructions on creating user exit programs, see Customizing-after-installation. A sample user exit program is also provided.

Activating a user exit

To activate your user exit program, type the name of your program in the appropriate Program ID field on the .

The library that contains the program must be available to CICS. In addition, the program must have an entry in the Program Processing Table (PPT) and must be enabled.

Deactivating a user exit

To stop a user exit program, blank out the name of the program in the appropriate Program ID field on the User Exits panel.

Inbound before optimization exit

This user exit lets you perform the following actions:

• Remove any non-3270 data from the data stream that was inserted by the hardware.
• Correct data stream errors before the Optimizer processes the data stream.

Inbound after optimization exit

This user exit lets you translate inbound data streams. Fields can be inserted or removed, as long as the data stream length does not exceed the size of the storage area that is provided.

Outbound before optimization exit

This user exit lets you further preprocess output data streams or include/exclude output data streams from optimization. Directions that are received from the user exit program override existing options as follows:

• If the program excludes a data stream, the Optimizer completely bypasses the data stream.
• If the program includes a data stream, all other selection criteria are bypassed, and the data stream is optimized.

This exit lets you change which optimization techniques are used or exclude a portion of the data stream from optimization.

Outbound after optimization exit

This user exit lets you insert or change data in the data stream that is being transmitted to the device. This exit is not recommended for data stream processing, because the optimized data stream will be much more complex than the original data stream, and the Optimizer will not detect data stream errors that are generated in the exit.

Terminal name change exit

This user exit lets you pass a terminal ID to the Optimizer that is different from the name found in the terminal control table (TCT). The terminal ID is used by the Optimizer for include and exclude control and for tracking statistics. No changes are made to any CICS control blocks by this exit.

SUPEROPT uses this exit for inbound and outbound data streams.

Displaying the user exits panel

Summary: All user exits are controlled from the User Exits panel. In this task, you will display the User Exits panel.

To display the User Exits panel, perform the following steps:

1. Select option 1 on the Monitor Primary Menu.
2. Press Enter.
   The Optimization Control Menu is displayed.
3. Select option 1.5.1.

4. Press Enter.
   The User Exits panel is displayed.

   (1.5.1)                      3270 SUPEROPTIMIZER/CICS                     February 25, 2001
   Option. . ______            User Exits 20:09:04
                               CICSID:CICSJXE
   
   Inbound User Exits
   
   Before optimization program ID. . . . ________
   After optimization program ID . . . . ________
   
   Outbound User Exits
   Before optimization program ID. . . . ________
   After optimization program ID . . . . ________
   
   Terminal Name Change Exit
   Exit program ID . . . . . . . . . . . ________
   
   F1=Help F2=Keys F3=End F4=Return F6=Case F9=Print 

Following table describes the fields on the User Exits panel.