IBM SC34-6814-04 User Manual

Page 30

Advertising
background image

*

(ZERO = NO WORK AREA)

UEPGAL

DS

A

ADDRESS OF GLOBAL WORK AREA LENGTH

UEPCRCA

DS

A

ADDRESS OF CURRENT RETURN-CODE

UEPTCA

DS

A

RESERVED

UEPCSA

DS

A

RESERVED

UEPEPSA

DS

A

ADDRESS OF REGISTER SAVE AREA

*

FOR USE BY EXIT PROGRAM

UEPHMSA

DS

A

ADDRESS OF SAVE AREA USED FOR

*

HOST MODULE’S REGISTERS

UEPGIND

DS

A

ADDRESS OF CALLER’S TASK INDICATORS

UEPSTACK DS

A

ADDRESS OF KERNEL STACK ENTRY

UEPXSTOR DS

A

ADDRESS OF STORAGE FOR XPI PARAMETERS

UEPTRACE DS

A

ADDRESS OF TRACE FLAG

UEPEXN

points to a 1-byte binary field whose contents identify the global user exit point
from which the exit program is being invoked. You need this information if your
exit program can be invoked from more than one exit point.

DFHUEXIT TYPE=EP generates a list of equated values that relate the exit
names (exitids) to the exit numbers used internally by CICS to identify the exits.
You should always use the exitids, because the exit numbers may change in
any future releases of CICS.

UEPGAA

points to the global work area that was provided for the exit program when it
was enabled. This is set to zero if no global work area is provided.

UEPGAL

points to a halfword that contains the length of the global work area.

UEPCRCA

points to a halfword that is to contain the return code value from the exit
program. When more than one program is called at a user exit, this field
contains (on entry to the second and subsequent programs) the return code
that was set by the previously invoked program.

For an example of how an exit program can set a different return code from that
returned by a previous exit program at the same exit point, see the code
snippet in “Invoking more than one exit program at a single exit” on page 13.

UEPTCA

points to fetch-protect storage. Use of this field results in an abend ASRD at
execution time.

UEPCSA

points to fetch-protect storage. Use of this field results in an abend ASRD at
execution time.

UEPEPSA

points to a save area in which the exit program should store its own registers
on entry. When the exit program is entered, register 13 is also pointing to this
area. The convention is to save registers 14, 15, 0–12 at offset 12 (decimal)
onward.

UEPHMSA

points to the save area containing the registers of the calling module. Values for
registers 14, 15, 0–13 are stored in this order from offset 12 (decimal) in this
area.

8

Customization Guide

Advertising