Kernel domain functions, The start_purge_protection, The stop_purge_protection function – IBM SC33-1683-02 User Manual

Page 352: Response values for start_purge_protection, Response values for stop_purge_protection

Advertising
background image

Kernel domain functions

The START_PURGE_PROTECTION function

The START_PURGE_PROTECTION function is provided on the DFHKEDSX macro
call. It inhibits purge, but not force-purge, for the current task. This function can be
used by all global user exit programs if they want to inhibit purge during a global
user exit call.

In general, each START_PURGE_PROTECTION call should have a corresponding
STOP_PURGE_PROTECTION function call to end the purge protection period on
completion of any program logic that needs such protection.

START_PURGE_PROTECTION

DFHKEDSX [CALL,]

[CLEAR,]

[IN,

FUNCTION(START_PURGE_PROTECTION),]

[OUT,

RESPONSE (name1 | *)]

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

RESPONSE values for START_PURGE_PROTECTION:

RESPONSE

REASON

OK

None

DISASTER

None

INVALID

None

The STOP_PURGE_PROTECTION function

The STOP_PURGE_PROTECTION function is provided on the DFHKEDSX macro
call. It is re-enables purge for the current task after purge has been suspended by a
preceding START_PURGE_PROTECTION function call.

STOP_PURGE_PROTECTION

DFHKEDSX [CALL,]

[CLEAR,]

[IN,

FUNCTION(STOP_PURGE_PROTECTION),]

[OUT,

RESPONSE (name1 | *)]

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

kernel domain functions

320

CICS TS for OS/390: CICS Customization Guide

|

Advertising