2.28 COBOLUSEREXIT

Valid for

Extract, Replicat

Description

Use COBOLUSEREXIT to call a custom COBOL routine at different points during processing.

If COBOLUSEREXIT is specified in the parameter file, but a user exit is not bound to the Extract or Replicat object, the process will abend.

The paramfile syntax change for native mode Extract/Replicat is

COBOLUSEREXIT <DLL filename> [, DEBUG | VERBOSE]

Build a COBOL userexit as a DLL:

Syntax

#frame
#push _options
#set _options -l rld -l cob -unres_symbols warn
#set _options [_options] -export_all -b semi_globalized
<linker> -ul -o <DLL filename> <linkable COBOL userexit> [_options]
<linker>-change floattype tandem_float <DLL filename>
#unframe

In native mode the userexit code can be a DLL

When using a DLL there is no need to link the userexit into Extract or Replicat.

The DLL gets dynamically loaded when the parameter is seen.

Example

COBOLUSEREXIT [<DLL filename>] [,DEBUG] [,VERBOSE]
<DLL filename>  -- Native mode Userexit DLL
[,DEBUG]        -- sets dlopen() mode flag to RTLD_VERBOSE(8)
[,VERBOSE]      -- sets dlopen() mode flag to RTLD_VERBOSE(8)