Adds objects to a container object.
You can use the Add command to:
See the related Remove command.
Adding resource definitions to a ResGroup:
<CCV510>
<Add>
<LocationCriteria>
<LocationName> location_name </LocationName>
<LocationType> CConfig | Context | CSD </LocationType>
</LocationCriteria>
<ObjectCriteria> 1
<ListCount> element_count </ListCount>
<ListElement>
<DefA>
<ObjGroup> resource_group </ObjGroup>
<ObjType> resource_type </ObjType>
<ObjName> resource_name </ObjName>
<ObjDefVer> definition_version </ObjDefVer> 2
</DefA>
</ListElement>
</ObjectCriteria>
<InputData> 3
<ContainerName> object_name </ContainerName>
<ContainerType> ResGroup </ContainerType>
</InputData>
</Add>
</CCV510>
Adding ResGroups to a ResDesc:
<CCV510>
<Add>
<LocationCriteria>
<LocationName> location_name </LocationName>
<LocationType> CConfig | Context | CSD </LocationType>
</LocationCriteria>
<ObjectCriteria> 1
<ListCount> element_count </ListCount>
<ListElement>
<GrpA>
<ObjType> ResGroup </ObjType>
<ObjName> resource_name </ObjName>
</GrpA>
</ListElement>
</ObjectCriteria>
<InputData> 3
<ContainerName> object_name </ContainerName>
<ContainerType> ResDesc </ContainerType>
</InputData>
</Add>
</CCV510>
Packaging resource definitions:
<CCV510>
<Add>
<LocationCriteria>
<LocationType> Repository </LocationType>
</LocationCriteria>
<ObjectCriteria> 1
<CConfig> CICS_configuration </CConfig> 4
<ListCount> element_count </ListCount>
<ListElement>
<KeyA>
<ObjGroup> resource_group </ObjGroup>
<ObjType> resource_type </ObjType>
<ObjName> resource_name </ObjName>
</KeyA>
</ListElement>
More list elements…
</ObjectCriteria>
<InputData> 3
<ContainerName> change_package_ID </ContainerName>
<ContainerType> ChgPkg </ContainerType>
</InputData>
</Add>
</CCV510>
Packaging commands:
<CCV510>
<Add>
<LocationCriteria>
<LocationType> Repository </LocationType>
</LocationCriteria>
<ObjectCriteria> 1
<CConfig> CICS_configuration </CConfig> 4
<ListCount> element_count </ListCount>
<ListElement>
<CmdAPost>
<Command> Add | Remove | Delete </Command>
<ObjGroup> resource_group </ObjGroup>
<ObjType> resource_type </ObjType>
<ObjName> resource_name </ObjName>
<ObjDefVer> definition_version </ObjDefVer> 2
<TContainer> resource_group </TContainer> 5
</CmdAPost>
</ListElement>
More list elements…
</ObjectCriteria>
<InputData> 3
<ContainerName> change_package_ID </ContainerName>
<ContainerType> ChgPkg </ContainerType>
</InputData>
</Add>
</CCV510>
or
When adding to a ResGroup or a ResDesc, <LocationCriteria> refers to the location of the resource definitions. However, when packaging resource definitions or commands, <LocationCriteria> refers to the CICS® Configuration Manager repository, which is where the change package is stored. To specify the location of the resource definitions, or the CICS configuration associated with the commands, you use <CConfig> in <ObjectCriteria>.
<CCV510>
<Add>
<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>
<Command> Add | Remove | Delete </Command> 1
<ObjName> resource_name </ObjName>
<ObjType> resource_type </ObjType>
<ObjGroup> resource_group </ObjGroup> 2
<ObjDefVer> definition_version </ObjDefVer>
<Config> CICS_configuration </Config>
<TContainer> resource_group </TContainer> 3
<LocationName> CSD_DSN | context </LocationName>
</ListElement>
More list elements…
</OutputData>
</Add>
</CCV510>
API command (READ access authority):
The following example adds a CONNDEF resource definition to a RESGROUP. The CONNDEF and the RESGROUP are stored in a context.
<CCV510>
<ADD>
<LocationCriteria>
<LocationName> CCVPLEXA </LocationName>
<LocationType> CONTEXT </LocationType>
</LocationCriteria>
<ObjectCriteria>
<ObjName> M001 </ObjName>
<ObjGroup> QAAADDPR </ObjGroup>
<ObjType> CONNDEF </ObjType>
</ObjectCriteria>
<InputData>
<ContainerName> QAAADD01 </ContainerName>
<ContainerType> RESGROUP </ContainerType>
</InputData>
</ADD>
</CCV510>
The following example adds a RESGROUP to a RESDESC.
<CCV510>
<ADD>
<LocationCriteria>
<LocationName> CCVPLEXA </LocationName>
<LocationType> CONTEXT </LocationType>
</LocationCriteria>
<ObjectCriteria>
<ObjType> RESGROUP </ObjType>
<ObjName> QAAADDPR </ObjName>
</ObjectCriteria>
<InputData>
<ContainerName> QAACONNA </ContainerName>
<ContainerType> RESDESC </ContainerType>
</InputData>
</ADD>
</CCV510>