Discards the in-memory image of resource definitions from active CSD-based CICS® regions. This does not affect the CSD file where the resource definition is stored.
You can only use the Discard command with CSD-based CICS configurations, not context-based CICS configurations.
<CCV510>
<Discard>
<LocationCriteria>
<LocationName> CICS_configuration </LocationName> 1
<LocationType> CConfig </LocationType> 2
</LocationCriteria>
<ObjectCriteria> 3
<ListCount> element_count </ListCount>
<ListElement>
<ObjectData>
<ObjName> resource_name </ObjName>
<ObjGroup> resource_group </ObjGroup>
<ObjType> resource_type </ObjType>
</ObjectData>
</ListElement>
More list elements…
</ObjectCriteria>
<ProcessParms>
<Quiesce> No | Yes </Quiesce> 4
<CSDParms>
<ConnectionCount> All | element_count | Local </ConnectionCount> 5
<ConnectionElement>
<ConnectionName> remote_system_connection </ConnectionName>
</ConnectionElement>
More connection elements…
</CSDParms>
</ProcessParms>
</Discard>
</CCV510>
or
For example, to identify all program resource definitions beginning with the characters PAY, from all groups beginning with the characters FIN, specify:
<ObjectCriteria>
<ObjName>PAY*</ObjName>
<ObjGroup>FIN*</ObjGroup>
<ObjType>PROGDEF</ObjType>
</ObjectCriteria>
<CCV510>
<Discard>
<OutputData>
<ReturnCode> return_code </ReturnCode> 1
<ReasonCode> reason_code </ReasonCode>
<TaskNo> CICS_task_number </TaskNo>
<ListCount> element_count </ListCount>
<ListElement>
<ReturnCode> return_code </ReturnCode> 1
<ReasonCode> reason_code </ReasonCode>
<ObjName> resource_name </ObjName>
<ObjType> resource_type </ObjType>
<ObjGroup> resource_group </ObjGroup>
<Config> CICS_configuration </Config>
<LocationName> CSD_DSN </LocationName>
<CSDInfo>
<ConnectionCount> element_count </ConnectionCount>
<ConnectionElement>
<ConnectionName> remote_system_connection </ConnectionName>
<ReturnCode> return_code </ReturnCode> 1
<ReasonCode> reason_code </ReasonCode>
<ExceptionData> exception data </ExceptionData> 2
</ConnectionElement>
More connection elements…
</CSDInfo>
</ListElement>
More list elements…
</OutputData>
</Discard>
</CCV510>
The following example quiesces and then discards a map resource definition in two active CICS regions.
<CCV510>
<Discard>
<LocationCriteria>
<LocationName> CCVT22M </LocationName>
<LocationType> CCONFIG </LocationType>
</LocationCriteria>
<ObjectCriteria>
<Listcount> 1 </Listcount>
<ListElement>
<ObjName> JAMES </ObjName>
<ObjGroup> BINGLE </ObjGroup>
<ObjType> MAPDEF </ObjType>
</ListElement>
</ObjectCriteria>
<ProcessParms>
<Quiesce> YES </Quiesce>
<CSDPARMS>
<CONNECTIONCOUNT> 2 </CONNECTIONCOUNT>
<CONNECTIONELEMENT>
<CONNECTIONNAME> T22M </CONNECTIONNAME>
</CONNECTIONELEMENT>
<CONNECTIONELEMENT>
<CONNECTIONNAME> T23M </CONNECTIONNAME>
</CONNECTIONELEMENT>
</CSDPARMS>
</ProcessParms>
</Discard>
</CCV510>