Response values for stop_purge_protection, Nesting purge protection calls, Loader xpi functions – IBM SC34-6814-04 User Manual

Page 374

Advertising
background image

STOP_PURGE_PROTECTION

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.

RESPONSE values for STOP_PURGE_PROTECTION:

RESPONSE

REASON

OK

None

DISASTER

None

INVALID

None

Nesting purge protection calls

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

Loader XPI functions

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.

352

Customization Guide

Advertising