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

<CCV210>
  <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>
</CCV210>
 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.
 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

<CCV210>
  <Import>
    <OutputData>
      <ReturnCode> return_code </ReturnCode>
      <ReasonCode> reason_code </ReasonCode>
      <TaskNo> CICS_task_number </TaskNo>
    </OutputData>
  </Import>
</CCV210>

Security key

API command (READ access authority):

Read syntax diagramSkip visual syntax diagram
>>-prefix.IMP.target_CICS_configuration------------------------><

Resource definitions (ALTER access authority):

Read syntax diagramSkip visual syntax diagram
>>-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.