Start of change

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

Read syntax diagramSkip visual syntax diagram
>>-DISCARD--+-CPID=change_package-------+----------------------->
            '-EXTREF=external_reference-'   

>--,-SCHEME=migration_scheme------------------------------------>

>--+-------------------------------------+---------------------->
   |  (1)                                |   
   '-----,DATA=(qualification_exit_data)-'   

>--+-------------------+--+-------------------------------+----><
   |           .-NO--. |  |  (2)                          |   
   '-,QUIESCE=-+-YES-+-'  '-----,TARGETSCOPE=target_scope-'   

Notes:
  1. 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.
  2. If the change package contains candidates for context-based target CICS configurations, target_scope is required.
End of change