Implementing CA Gen User Exits in NonStop

CA Gen provides support for many system functions so that you do not have to consider them when you design and implement your application. Some of functions are delivered both in source and object form. These functions are called user exits because you can modify the source. Some common uses of user exits are retrieving user IDs, error handling, and site-specific security.

The IT must be installed on your target system before you can modify runtime user exits. The installation process copies the runtime user exits onto your target system and stores them within a source archive named UEXITSC. You can find the source archive in the subvolume where the IT is located.

For NonStop SQL/MX applications, a matching set of user exits are installed in the $IEFH/src directory.

Runtime User Exits

Runtime user exits are standard routines that allow all CA Gen generated applications to access system features. Runtime user exits reside on the target system and CA Gen can access the user exits without actually being coded as part of them. You can use these user exits to supply basic functionality or customize them to the needs of your target system.

In addition to the set of runtime user exits, there is an additional set of distributed processing server user exits. These additional user exits are used only within distributed processing server applications, and are used with distributed processing client user exits that are built into distributed processing client applications. For NonStop SQL/MP, the user exits are supplied in the same source archive UEXITSC. For NonStop SQL/MX, the user exits are supplied in the $IEFH/src directory.

All runtime user exits are provided in both source and object format (in the form of libraries called UEXITCO and DPSUECO) and are loaded onto the target system when the IT is installed. You can use these user exits without changing them because the object format runtime user exits are compiled and are ready to be linked into applications.

Customize User Exits

User exit source code is provided in C so that you can modify the source code to meet your site requirements.

NonStop SQL/MP

The TACL macro MKEXITS is provided to assist with the life cycle of user exits. You can find this macro in the subvolume where the IT is located. You can use MKEXITS to perform the following tasks:

Extract all user exit source files from the UEXITSC source archive
Edit a specific user exit source file
Compile a specific user exit source file
Rebuild the user exit libraries UEXITCO and DPSUECO

NonStop SQL/MX

The shell scripts $IEFH/make/mkexits and $IEFH/make/mkdpsexit are provided to assist with the life cycle of user exits. You can use these scripts to compile and rebuild the user exit libraries UEXITCO and DPSUECO.

Note: When working with user exits, link all the user exits for a particular library (the set of runtime user exits in UEXITCO or the set of distributed processing server user exits in DPSUECO) regardless of the number of changes as the linker program does not allow you to individually link one exit at a time. Therefore, track the source code changes across all user exits to prevent unwanted functionality to be included in the user exit libraries. If you fail to link all the user exits, unresolved externals show up at execution time.

Note: For more information about rebuilding these user exits, see the User Exit Reference Guide.

The following user exits are available in C:

Name	Description
TIRYYX	Date User Exit
TIRDCRYP	Decrypt User Exit
TIRDRTL	Default Retry Limit User Exit
TIRNCRYP	Encrypt User Exit
TIRHELP	Help Interface User Exit
TIRUPDB	MBCS Uppercase Translation User Exit
TIRMTQB	Message Table User Exit
TIRXLAT	National Language Translation User Exit
TIRSECR	Security Interface User Exit
TIRELOG	Server Error Logging User Exit
TIRSERRX	Server to Server Error User Exit
TIRSYSID	System ID User Exit
TIRUSRID	User ID User Exit
TIRURTL	Ultimate Retry Limit User Exit
TIRUPPR	Uppercase Translation User Exit
TIRDLCT	User Dialect User Exit
TIRTERMA	User Termination User Exit
TIRSECV	Server Security Validation User Exit
DPSUETDM	Server side user exits for distributed processing server
TIRXINFO	Locale Information User Exit

Note: For more information about the DPSUETDM and other runtime user exits, see the User Exit Reference Guide.