Configuring and using the User Exits Workbench

Before you begin

The User Exits Workbench is available for download on Automation Hub.

About this task

To configure the User Exits Workbench, perform the following steps:
  1. From an ISPF command prompt, run the TSO command EQQEXWB to display the User Exits Workbench panel.
  2. Select option 0 (Config) to display the User Exits Workbench configuration panel.
  3. Specify the following values:
    Path USS
    Complete USS path to the /exitswb folder.
    Load Library
    Name of the APF-authorized library data set where the load modules are stored after compiling the user exit.
    Metal Include Path
    Complete USS path where the includes files are stored. The default is /usr/include/metal.
    Metal Compiler Library
    Name of the data set that contains the Metal C compiler libraries. The default is CBC.SSCNOBJ.
  4. Click End to save your changes.
To use the User Exits Workbench:
  1. From an ISPF command prompt, run the TSO command EQQEXWB to display the User Exits Workbench panel.
  2. Specify the EXIT NUMBER and EXIT NAME of the user exit that you want to create or with which you want to work, then select one of the following options:
    1 - Create User Exit
    To create the user exit.
    2 - Edit User Exit
    To display the Edit panel where you can modify the user exit specified.

    The Edit panel shows a Metal C module that contains the function exitNdo(struct exitNStruct *params), which you must implement. Ensure that you implement the exit with a reentrant code.

    3 - Compile User Exit
    To compile and link-edit the user exit specified. When the compilation completes, a load module with the same name as the exit is created in the Load Library.
    4 - Display User Exit Listing file
    To display the listing (.lst) file related to the user exit specified. The listing file stores all the information about the compilation, including the assembly code. To use option 4, the exit must have compiled successfully.
  3. You can also select the following options:
    5 - Display Util Routines
    To display the util (.h) header file, which contains the routines that can be used by any exit.
    6 - Display Header
    To display the header file of the user exit whose number you specify in the related EXIT NUM field. The header file shows the interface of the functions that you can use with the user exit and the data structure struct exitNStruct.
    7 - List User Exits
    To display the user exits with the number specified in the EXIT NUM field next to the option.
    8 - Delete User Exit
    To delete both the user exit and load module corresponding to the EXIT NUM and EXIT NAME that you specify.