Create

Creates a resource definition or a CICS® Configuration Manager repository object.

To create key association or command association repository objects, use the Add command, not Create.

Request format

<CCV510>
  <Create>
    <LocationCriteria>  1 
      <LocationName> location_name </LocationName>
      <LocationType> CConfig | Context | CSD | Repository </LocationType>
    </LocationCriteria>
 
    <ObjectCriteria>
      <ObjType> object_type </ObjType>
 
      Criteria for this object type
 
    </ObjectCriteria>
 
    <InputData>
      <object_type>  2 
        <ObjectData>
 
          Data for this object type
 
        </ObjectData>
      </object_type>
    </InputData>
  </Create>
</CCV510>

If the object already exists, the request fails.

When creating a resource definition in a context, if you specify a resource group that does not exist, then, in addition to creating the resource definition, the Create command creates the resource group.

 1 
When creating a CICS Configuration Manager repository object, specify Repository as the location type and omit <LocationName>.
 2 
<object_type> and its end tag are optional. Specifying this "wrapper" element allows you to use the supplied schema to validate the contents of the <ObjectData> element for that object type. For details, see Using the supplied schema to write API commands.

Response format

<CCV510>
  <Create>
    <OutputData>
      <ReturnCode> return_code </ReturnCode>
      <ReasonCode> reason_code </ReasonCode>
      <TaskNo> CICS_task_number </TaskNo>
      <CPID> change_package_ID </CPID>  1 
      <ChangeTime> time_stamp </ChangeTime>  2 
      <IntegrityToken> integrity_token </IntegrityToken>  3 
    </OutputData>
  </Create>
</CCV510>
 1 
<CPID> is returned only for a change package.
 2 
<ChangeTime> identifies the time that CICSPlex® SM, DFHEDAP, or a CICS SPI command (invoked by the CICS Configuration Manager server) created the object.
 3 
The response includes an integrity token in case you want to update the object soon after creating it. You can supply this integrity token to the Update command, ensuring that you do not overwrite changes by another user.

Security key

API command (READ access authority):

Read syntax diagramSkip visual syntax diagram
>>-prefix.CRE.object_type.location_type.-+-location_name-+-----><
                                         '-NONE----------'   

Resource definitions (ALTER access authority):

Read syntax diagramSkip visual syntax diagram
>>-prefix.target_CICS_config.group.type.name-------------------><

Examples

The following example creates a TRANDEF (TRANSACTION) resource definition in a CSD file.

 
<CCV510>
<CREATE>
 
  <LocationCriteria>
    <LocationName> CCV120.QAAUTO.CCVT22T.DFHCSD </LocationName>
    <LocationType> CSD </LocationType>
  </LocationCriteria>
 
  <ObjectCriteria>
    <ObjName> Q001 </ObjName>
    <ObjGroup> QAAUPD01 </ObjGroup>
    <ObjType> TRANDEF </ObjType>
  </ObjectCriteria>
 
  <InputData>
  <ObjectData>
    <ALIAS>  </ALIAS>
    <PROGRAM> QAADFLTC </PROGRAM>
    <REMOTENAME>  </REMOTENAME>
    <REMOTESYSTEM>  </REMOTESYSTEM>
    <PROFILE> DFHCICST </PROFILE>
    <FAILACTION> BACKOUT </FAILACTION>
    <INDOUBT> BACKOUT </INDOUBT>
    <CMDSEC> NO </CMDSEC>
    <SHUTDOWN> DISABLED </SHUTDOWN>
    <STATUS> ENABLED </STATUS>
    <TASKDATAKEY> USER </TASKDATAKEY>
    <TASKDATALOC> BELOW </TASKDATALOC>
    <TASKREQ>  </TASKREQ>
    <LOCALQ> N_A </LOCALQ>
    <RESSEC> NO </RESSEC>
    <STORAGECLEAR> NO </STORAGECLEAR>
    <RESTART> NO </RESTART>
    <SPURGE> NO </SPURGE>
    <TPURGE> NO </TPURGE>
    <WAIT> YES </WAIT>
    <TRACE> YES </TRACE>
    <TRPROF> DFHCICSS </TRPROF>
    <TRANCLASS> DFHTCL00 </TRANCLASS>
    <TCLASS> NO </TCLASS>
    <TWASIZE> 0 </TWASIZE>
    <PARTITIONSET>  </PARTITIONSET>
    <XTRANID>  </XTRANID>
    <ISOLATE> YES </ISOLATE>
    <DUMP> YES </DUMP>
    <DYNAMIC> NO </DYNAMIC>
    <PRIORITY> 1 </PRIORITY>
    <RUNAWAY> SYSTEM </RUNAWAY>
    <DTIMOUT> NO </DTIMOUT>
    <WAITTIMEDD> 0 </WAITTIMEDD>
    <WAITTIMEHH> 0 </WAITTIMEHH>
    <WAITTIMEMM> 0 </WAITTIMEMM>
    <TPNAME>  </TPNAME>
    <XTPNAME>  </XTPNAME>
    <TRANSEC> 1 </TRANSEC>
    <PRIMEDSIZE> 0 </PRIMEDSIZE>
    <EXTSEC> NO </EXTSEC>
    <RSL> 0 </RSL>
    <CONFDATA> NO </CONFDATA>
    <USERDATA1>  </USERDATA1>
    <USERDATA2>  </USERDATA2>
    <USERDATA3>  </USERDATA3>
    <DESCRIPTION>  </DESCRIPTION>
    <BREXIT>  </BREXIT>
    <ROUTABLE> NO </ROUTABLE>
    <OTSTIMEOUT> NO </OTSTIMEOUT>
  </ObjectData>
  </InputData>
 
</CREATE>
</CCV510>

The following example creates a PROGDEF (PROGRAM) resource definition in a context.

 
<CCV510>
   <CREATE>
 
  <LocationCriteria>
    <LocationName> CCVPLEXA </LocationName>
    <LocationType> CONTEXT </LocationType>
  </LocationCriteria>
 
  <ObjectCriteria>
    <ObjName> Q038 </ObjName>
    <ObjGroup> QAACRE01 </ObjGroup>
    <ObjType> PROGDEF </ObjType>
  </ObjectCriteria>
 
  <InputData>
  <ObjectData>
    <CEDF> YES </CEDF>
    <DATALOCATION> BELOW </DATALOCATION>
    <EXECKEY> USER </EXECKEY>
    <EXECUTIONSET> FULLAPI </EXECUTIONSET>
    <LANGUAGE> ASSEMBLER </LANGUAGE>
    <RELOAD> NO </RELOAD>
    <STATUS> ENABLED </STATUS>
    <USELPACOPY> NO </USELPACOPY>
    <USAGE> NORMAL </USAGE>
    <RESIDENT> NO </RESIDENT>
    <REMOTENAME>  </REMOTENAME>
    <REMOTESYSTEM>  </REMOTESYSTEM>
    <TRANSID>  </TRANSID>
    <RSL> 0 </RSL>
    <USERDATA1>  </USERDATA1>
    <USERDATA2>  </USERDATA2>
    <USERDATA3>  </USERDATA3>
    <DESCRIPTION>  </DESCRIPTION>
    <DYNAMIC> NO </DYNAMIC>
    <CONCURRENCY> QUASIRENT </CONCURRENCY>
    <JVM> NO </JVM>
    <JVMCLASS>  </JVMCLASS>
    <HOTPOOL> NO </HOTPOOL>
    <JVMPROFILE> DFHJVMPR </JVMPROFILE>
  </ObjectData>
  </InputData>
 
   </CREATE>
</CCV510>

The following example creates a RESDESC in a context.

 

<CCV510>
   <CREATE>
 
  <LOCATIONCRITERIA>
    <LOCATIONNAME> CCVPLEXA </LOCATIONNAME>
    <LOCATIONTYPE> CCONFIG </LOCATIONTYPE>
  </LOCATIONCRITERIA>
 
  <OBJECTCRITERIA>
    <OBJTYPE> RESDESC </OBJTYPE>
    <OBJNAME> QAACONNA </OBJNAME>
  </OBJECTCRITERIA>
 
  <INPUTDATA>
  <OBJECTDATA>
  <RESDESC> QAACONNA </RESDESC>
  <DESCRIPTION> THIS IS A TEMPORAY ADD LIST </DESCRIPTION>
  <LSREGSTR> NO </LSREGSTR>
  <AUTOINST> NO </AUTOINST>
  </OBJECTDATA>
  </INPUTDATA>
 
   </CREATE>
</CCV510>

The following example creates a RESGROUP in a context.

 

<CCV510>
   <CREATE>
 
  <LocationCriteria>
    <LocationName> CCVPLEXA </LocationName>
    <LocationType> CONTEXT </LocationType>
  </LocationCriteria>
 
  <ObjectCriteria>
    <ObjType> RESGROUP </ObjType>
    <ObjName> QAAADD05 </ObjName>
  </ObjectCriteria>
 
  <InputData>
  <ObjectData>
  <Description> This is a temporay ADD Group </Description>
  </ObjectData>
  </InputData>
 
   </CREATE>
</CCV510>

The following example creates a CICS configuration.

 
<CCV510>
   <CREATE>
 
 <LocationCriteria>
  <LocationType>
   REPOSITORY
  </LocationType>
 </LocationCriteria>
 
 <ObjectCriteria>
  <ObjType> CCONFIG </ObjType>
  <ObjName> QAACSD13 </ObjName>
 </ObjectCriteria>
 
 <InputData>
  <ObjectData>
   <CSDNAME> CCV000.QAAUTO.CCVT13T.DFHCSD </CSDNAME>
   <Description> CONFIG for 1.3 CSD </Description>
 
     <RGroup>
       <MROCount> 2 </MROCount>
       <RGroupElement>
         <MROLink> T13T </MROLink>
       </RGroupElement>
       <RGroupElement>
         <MROLink> T23T </MROLink>
       </RGroupElement>
     </RGroup>
 
     <RGroup>
       <LTVCount> 1 </LTVCount>
       <RGroupElement>
         <XName> APPLID </XName>
         <XValue> CCVT13T </XValue>
       </RGroupElement>
     </RGroup>
  </ObjectData>
 </InputData>
 
   </CREATE>
</CCV510>

The following example creates a migration scheme.

 
<CCV510>
   <CREATE>
 
 <LocationCriteria>
   <LocationType> Repository </LocationType>
 </LocationCriteria>
 
 <ObjectCriteria>
   <ObjType> SCHEME </ObjType>
   <Scheme> QAAMIG12 </Scheme>
 </ObjectCriteria>
 
 <InputData>
   <ObjectData>
     <Description> Create Migration Scheme - 2.3 to 3.1 </Description>
     <Appoption> Yes </Appoption>
 
     <RGroup>
       <STCCount> 1 </STCCount>
       <RGroupElement>
         <S_CCONFIG> QAACSD23 </S_CCONFIG>
         <T_CCONFIG> QAACSD31 </T_CCONFIG>
         <XFORMrSet>  </XFORMrSet>
       </RGroupElement>
     </RGroup>
 
     <RGroup>
       <STVCount> 0 </STVCount>
       <RGroupElement>
       </RGroupElement>
     </RGroup>
 
   </ObjectData>
 </InputData>
 
   </CREATE>
</CCV510>

The following example creates an approval profile.

 
<CCV510>
   <Create>
 
 <LocationCriteria>
   <LocationType> Repository </LocationType>
 </LocationCriteria>
 
 <ObjectCriteria>
   <ObjName> QAAAPP03 </ObjName>
   <ObjType> AProfile </ObjType>
 </ObjectCriteria>
 
 <InputData>
   <ObjectData>
     <Description> Approval Profile 3 for QAA </Description>
 
     <RGroup>
       <MSCount> 2 </MSCount>
       <RGroupElement>
         <Scheme> QAAMIG03 </Scheme>
         <Auth01> QAAALL </Auth01>
         <Auth02>  </Auth02>
         <Auth03>  </Auth03>
         <Auth04>  </Auth04>
         <Auth05>  </Auth05>
       </RGroupElement>
       <RGroupElement>
         <Scheme> QAAMIG12 </Scheme>
         <Auth01> QAAALL </Auth01>
         <Auth02> QAATEST </Auth02>
         <Auth03>  </Auth03>
         <Auth04>  </Auth04>
         <Auth05>  </Auth05>
       </RGroupElement>
     </RGroup>
 
   </ObjectData>
 </InputData>
 
   </Create>
</CCV510>

The following example creates a change package.

 
<CCV510>
   <CREATE>
 
 <LocationCriteria>
   <LocationType> Repository </LocationType>
 </LocationCriteria>
 
 <ObjectCriteria>
   <ObjType> CHGPKG </ObjType>
   <CPID> QAACPK05 </CPID>
 </ObjectCriteria>
 
 <InputData>
   <ObjectData>
     <Description> Change Package 05 for RJA </Description>
     <AppProf> ANYONE </AppProf>
   </ObjectData>
 </InputData>
 
   </CREATE>
</CCV510>

Reference Reference

Feedback


Timestamp icon Last updated: Friday, 1 November 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//ccv-api-cmd-create.htm