Filter
Top Products
Assembler programs and LEASM
Assembler programs translated with the LEASM option cannot be used as global
user exit programs.
LEASM is used to produce Language Environment conforming main programs in
assembler. For information about the LEASM translator option, see the CICS
Application Programming Guide.
EDF and global user exits
If you use the Execution Diagnostic Facility (EDF) to debug your applications, you
must take care when compiling exit programs that issue EXEC CICS commands.
Normally, if an exit program issues EXEC CICS commands, these are displayed by
EDF, if the latter is active. They appear between the “Start of Command” and “End
of Command” screens for the command that caused the exit to be driven. If you
want to suppress the display of EXEC CICS commands issued by your exit
program, you must specify the NOEDF option when you translate the program. You
should always specify NOEDF for programs in a production environment.
If an exit program that may be invoked during recovery processing issues EXEC
CICS commands, you must translate it with the NOEDF option. Failure to do so
may cause EDF to abend.
The global work area
When you enable an exit program, you can ask CICS to provide a global work area
for the exit program. An exit program can have its own global work area, or it can
share a work area that is owned by another exit program.
The work area is associated with the exit program rather than with the exit point.
For ease of problem determination, the global work area should be shared only by
exit programs that are invoked from the same management module or domain. The
address and length of the global work area are addressed by parameters UEPGAA
and UEPGAL of the DFHUEPAR parameter list, which is described in “DFHUEPAR
standard parameters” on page 7. If a user exit program does not own a global work
area, UEPGAA is set to zero.
Application programs can communicate with user exit programs that use or share
the same global work area. The application program uses the EXEC CICS EXTRACT
EXIT command to obtain the address and length of the global work area.
A work area is freed only when all of the exit programs that use it are disabled. For
examples of how to use a global work area, see the sample global user exit
programs. They are listed in “Sample global user exit programs” on page 15.
Making trace entries
If tracing is active, you can specify that an entry in the CICS trace table is made
immediately before and immediately after the exit program runs.
v Use either of the following methods to create a trace entry before and after the
exit program runs:
– The UE option of the CETR transaction.
– The UE option of the EXEC CICS SET TRACETYPE command.
6 Customization Guide