
DISCARD
Purpose
Discards the in-memory image of resource definitions from active CICS® regions. The Discard API command does not affect the CSD file or CICSPlex® SM context where the resource definition is stored.
Format
>>-DISCARD--+-CPID=change_package-------+-----------------------> '-EXTREF=external_reference-' >--,-SCHEME=migration_scheme------------------------------------> >--+-------------------------------------+----------------------> | (1) | '-----,DATA=(qualification_exit_data)-' >--+-------------------+--+-------------------------------+---->< | .-NO--. | | (2) | '-,QUIESCE=-+-YES-+-' '-----,TARGETSCOPE=target_scope-'
Notes:
- The DATA parameter is used only if your site has developed an exit program for the operations qualification exit point for a discard action (OPQADS01), and that exit point is active. CICS Configuration Manager passes the qualification_exit_data (a freeform text string) to your exit program. Your exit program can use the value to decide whether to allow or disallow each instance of a discard action.
- If the change package contains candidates for context-based target CICS configurations, target_scope is required.
