Loader domain exits xldload and xldelete, Exit xldload – IBM SC33-1683-02 User Manual

Page 179

Advertising
background image

Loader domain exits XLDLOAD and XLDELETE

There are two global user exits in the loader domain. XLDLOAD is invoked when a
new instance of a program is loaded into storage, before the program is made
available for use.

XLDELETE is invoked after an instance of a program is released by CICS and
before the program is freed from storage.

For LPA-resident programs, the exits are still invoked when a program is acquired
or released, even though the program is not physically loaded or freed.

These are both information-only exits. Any changes made to the exit parameters by
the exit program are ignored by CICS, as is any return code which it sets.

Exit XLDLOAD

When invoked

After an instance of a program is brought into storage, and before the
program is made available for use.

Exit-specific parameters

UEPPROGN

Address of an 8-character field containing the name of the program
that is being loaded.

UEPPROGL

Address of a 4-byte field containing the length, in bytes, of the
program that is being loaded.

UEPLDPT

Address of a 4-byte field containing the address at which the
program has been loaded.

UEPENTRY

Address of a 4-byte field containing the address of the program’s
entry point.

UEPTRANID

Zero, or the address of a 4-byte field containing the transaction ID
which applied when the exit was invoked.

UEPUSER

Zero, or the address of an 8-byte field containing the userid in
control at the time the exit was invoked.

UEPTERM

Zero, or the address of a 4-byte field containing the terminal name
associated with the transaction under which the exit was invoked.

UEPPROG

Zero, or the address of an 8-character field containing the name of
the program that was in control at the time the exit was invoked.

Return codes

UERCNORM

Continue processing.

loader domain exits

Chapter 1. Global user exit programs

147

|
|

|
|
|

|
|

|
|

|
|

|

|
|
|

|

|
|
|

|
|
|

|
|
|

|
|
|

|
|
|

|
|
|

|
|
|

|
|
|

|

|
|

Advertising