IBM SC34-6814-04 User Manual

DFHKEDSX

[CALL,]

[CLEAR,]
[IN,
FUNCTION(STOP_PURGE_PROTECTION),]
[OUT,
RESPONSE (name1 | *)]

This command is threadsafe.

There are no input or output parameters on this call, only a RESPONSE.

OK

None

DISASTER

None

INVALID

None

Note that the START_ and STOP_PURGE_PROTECTION functions can be nested.
You should ensure that, if multiple START_PURGE_PROTECTION calls are issued
for a task, that the correct number of STOP_PURGE_PROTECTION calls are
issued to cancel the purge protection. If you issue two starts and only one stop,
purge protection is left on for the current task.

For example, for any current task, more than one global user exit program may be
driven. You must design your exit programs to ensure that purge protection is
correctly cancelled. An example of nesting is shown as follows:

XEIIN:

EXIT_PROG1: Calls START_PURGE_PROTECTION

XFCREQ:

EXIT_PROG2: Calls START_PURGE_PROTECTION

XFCREQC:

EXIT_PROG3: Calls STOP_PURGE_PROTECTION

XEIOUT:

EXIT_PROG4: Calls STOP_PURGE_PROTECTION

There are four XPI loader functions. These are the DFHLDLDX calls
ACQUIRE_PROGRAM, RELEASE_PROGRAM, DEFINE_PROGRAM, and
DELETE_PROGRAM.

DFHLDLDX calls cannot be used in any exit program invoked from any global
user exit point in the:

v

Statistics domain

v

Monitor domain

v

Dump domain

v

Dispatcher domain

v

Transient data program.

Customization Guide