Import
Imports resource definitions from an export file received from another CICS® Configuration Manager system. Optionally, if the export file contains change package details, also registers change packages in the importing CICS Configuration Manager repository.
Request format
<CCV530>
<Import>
<LocationCriteria>
<LocationType> CConfig </LocationType>
<LocationName> location_name </LocationName> 1
</LocationCriteria>
<SelectionCriteria> 2
<CPID> change_package_ID </CPID>
<EventID> event_ID </EventID> 3
</SelectionCriteria>
<ObjectCriteria> 2
<ObjName> resource_name </ObjName>
<ObjType> resource_type </ObjType>
<ObjGroup> resource_group </ObjGroup>
</ObjectCriteria>
<InputData>
<TargetLocationType> CConfig | Context | CSD </TargetLocationType>
<TargetLocationName> location_name </TargetLocationName>
</InputData>
<ProcessParms>
<RegisterCPID> No | Yes </RegisterCPID>
<PurgeImportedRecords> No | Yes </PurgeImportedRecords>
</ProcessParms>
</Import>
</CCV530>
- 1
- <LocationName> must specify a CICS configuration that refers to a CICS Configuration Manager export file.
- 2
- Specify either:
- <SelectionCriteria> to select resource
definitions to import based on which change packages they belong to.
or
- <ObjectCriteria> to select resource definitions to import based on filter criteria for name, group, and type. To import all resource definitions in the export file, specify an asterisk (*) for name, group, and type.
- <SelectionCriteria> to select resource
definitions to import based on which change packages they belong to.
- 3
- You can specify a change package ID with or without an event ID. Specifying an event ID selects a particular migration for the specified change package. This is relevant only when you have migrated the same change package ID to an export file more than once, and you have appended to the export file each time, not overwritten it.
Response format
<CCV530>
<Import>
<OutputData>
<ReturnCode> return_code </ReturnCode>
<ReasonCode> reason_code </ReasonCode>
<TaskNo> CICS_task_number </TaskNo>
</OutputData>
</Import>
</CCV530>
Security key
API command (READ access authority):
>>-prefix.IMP.target_CICS_configuration------------------------><
Resource definitions (ALTER access authority):
>>-prefix.target_CICS_config.group.type.name-------------------><
In this security key, the CICS configuration parameter refers to the target CICS configuration where the resource definition is to be imported (copied) to, not the source CICS configuration (that refers to the export file) where the resource definition is to be imported from.