Dynamically makes resource definitions available to an active CICS® region.
Change packages:
This format is identified by the presence of the <SelectionCriteria> element.
<CCV510>
<Install>
<SelectionCriteria>
<CPID> change_package_ID </CPID>
<Scheme> migration_scheme </Scheme>
</SelectionCriteria>
<ProcessParms>
<Quiesce> No | Yes </Quiesce> 1
<Discard> No | Yes </Discard> 2
<Force> No | Yes </Force> 3
CICSPlex SM parameters 3
</ProcessParms>
</Install>
</CCV510>
Ad hoc:
This format is identified by the absence of the <SelectionCriteria> element.
<CCV510>
<Install>
<LocationCriteria>
<LocationName> CICS_configuration </LocationName>
<LocationType> CConfig </LocationType>
</LocationCriteria>
<ObjectCriteria> 4
<ListCount> element_count </ListCount>
<ListElement>
<ObjName> resource_name </ObjName>
<ObjType> resource_type </ObjType>
<ObjGroup> resource_group </ObjGroup> 5
</ListElement>
More list elements…
</ObjectCriteria>
<ProcessParms>
<Quiesce> No | Yes </Quiesce> 1
<Discard> No | Yes </Discard> 2
<CSDParms> 7
<ConnectionCount> All | element_count | Local </ConnectionCount>
<ConnectionElement>
<ConnectionName> remote_system_connection </ConnectionName>
</ConnectionElement>
More connection elements…
</CSDParms>
<Force> No | Yes </Force> 3
CICSPlex SM parameters 3
</ProcessParms>
</Install>
</CCV510>
<CPSMParms>
<TargetScope> target_scope </TargetScope> 8
<ResGroupObjectType> * | resource_type </ResGroupObjectType> 6
<CONNDEF>
<RefAssign> resource_assignment </RefAssign>
</CONNDEF>
<FILEDEF>
<RelatedScope> related_scope </RelatedScope>
<Usage> LOCAL | REMOTE </Usage>
</FILEDEF>
<PROGDEF>
<RelatedScope> related_scope </RelatedScope>
<Usage> LOCAL | REMOTE </Usage>
<Mode> N/A | AUTO </Mode>
</PROGDEF>
<TDQDEF>
<RelatedScope> related_scope </RelatedScope>
<Usage> LOCAL | REMOTE </Usage>
<Mode> N/A | IND | INTRA | EXTRA </RelatedScope>
</TDQDEF>
<TRANDEF>
<RelatedScope> related_scope </RelatedScope>
<Usage> LOCAL | REMOTE </Usage>
<Mode> N/A | DYNAM | STAT </Mode>
</TRANDEF>
</CPSMParms>
These notes apply to both command formats:
These notes apply only to the ad hoc format:
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>
Context-based CICS configurations only: to select resource definitions of a particular type in the ResGroup, specify <ResGroupObjectType> in the CICSPlex SM parameters (see item 6 ).
This note applies only to the CICSPlex SM parameters:
<CCV510>
<Install>
<OutputData>
<ReturnCode> return_code </ReturnCode>
<ReasonCode> reason_code </ReasonCode>
<TaskNo> CICS_task_number </TaskNo>
<ListCount> element_count </ListCount>
<ListElement>
<ReturnCode> return_code </ReturnCode>
<ReasonCode> reason_code </ReasonCode>
<ObjName> resource_name </ObjName>
<ObjType> resource_type </ObjType>
<ObjGroup> resource_group </ObjGroup>
<Config> CICS_configuration </Config>
<LocationName> CSD_DSN | context </LocationName>
<CSDInfo> 1
<ConnectionCount> element_count </ConnectionCount>
<ConnectionElement>
<ConnectionName> remote_system_connection </ConnectionName>
<ReturnCode> return_code </ReturnCode>
<ReasonCode> reason_code </ReasonCode>
</ConnectionElement>
More connection elements…
</CSDInfo>
<CPSMInfo> 1
<ReturnCode> return_code </ReturnCode>
<ReasonCode> reason_code </ReasonCode>
</CPSMnfo>
</ListElement>
More list elements…
</OutputData>
</Install>
</CCV510>
The following example installs three programs into two active CSD-based CICS regions, via the selected remote system connections defined in the CICS configuration:
<CCV510>
<Install>
<LocationCriteria>
<LocationName> QAACSD22 </LocationName>
<LocationType> CCONFIG </LocationType>
</LocationCriteria>
<ObjectCriteria>
<Listcount> 3 </Listcount>
<ListElement>
<ObjName> DFH$AALL </ObjName>
<ObjGroup> DFH$AFLA </ObjGroup>
<ObjType> PROGDEF </ObjType>
</ListElement>
<ListElement>
<ObjName> ACCT00 </ObjName>
<ObjGroup> DFH$ACCT </ObjGroup>
<ObjType> PROGDEF </ObjType>
</ListElement>
<ListElement>
<ObjName> DFH$AREP </ObjName>
<ObjGroup> DFH$AFLA </ObjGroup>
<ObjType> PROGDEF </ObjType>
</ListElement>
</ObjectCriteria>
<ProcessParms>
<Quiesce> No </Quiesce>
<Discard> No </Discard>
<CSDPARMS>
<CONNECTIONCOUNT> 2 </CONNECTIONCOUNT>
<CONNECTIONELEMENT>
<CONNECTIONNAME> T22T </CONNECTIONNAME>
</CONNECTIONELEMENT>
<CONNECTIONELEMENT>
<CONNECTIONNAME> T13T </CONNECTIONNAME>
</CONNECTIONELEMENT>
</CSDPARMS>
</ProcessParms>
</Install>
</CCV510>
The following example installs a program via all of the remote system connections defined in the CICS configuration:
<CCV510>
<Install>
<LocationCriteria>
<LocationName> QAACSD22 </LocationName>
<LocationType> CCONFIG </LocationType>
</LocationCriteria>
<ObjectCriteria>
<Listcount> 1 </Listcount>
<ListElement>
<ObjName> DFH$SXP1 </ObjName>
<ObjGroup> DFH$SXP </ObjGroup>
<ObjType> PROGDEF </ObjType>
</ListElement>
</ObjectCriteria>
<ProcessParms>
<Quiesce> YES </Quiesce>
<Discard> NO </Discard>
</ProcessParms>
</Install>
</CCV510>