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:
- From an ISPF command prompt, run the TSO command
EQQEXWB
to display the User Exits Workbench panel. - Select option 0 (Config) to display the User Exits Workbench configuration panel.
- 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
.
- Click End to save your changes.
To use the User Exits Workbench:
- From an ISPF command prompt, run the TSO command
EQQEXWB
to display the User Exits Workbench panel. - 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.
- 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.