Using the CA Repository Universal XML Exchange Control File Builder › Create a Control File

Create a Control File

Control files let you map objects in XML document to objects in the repository. You can create a control file in multiple ways. One of them is using the CA Repository Universal XML Exchange Control File Builder. You can also manually create a control file using any XML editor.

The processes, task, and examples discussed here assume that you are using the CA Repository Universal XML Exchange Control File Builder to create a control file.

To create a control file

1. Click Start, Programs, CA, Repository for zOS, Universal XML Exchange, and Control File Builder.

   The CA Repository Universal XML Exchange Control File Builder-CA dialog opens.

2. Complete the following fields in the Control File Option area:
   • New Control File

     Creates a new control file.

   • Edit Existing Control File

     Edits an existing control file.

3. Enter the following information in the Default window area of the CA Repository Universal XML Exchange Control File Builder dialog:
   • Root Element Name

     Defines the root element name of the input XML file.

     Note: For more information, see Specify the Root Element Name and Id Attr in the Control File Builder help.

4. Enter the name of the XML attribute that contains the unique value of an XML object in the XML file in the Id Attr field.

   Note: For more information, see Specify the Root Element Name and Id Attr in the CA Repository Universal XML Exchange Control File Builder help.

5. Click Add in the Link Rules area to add a new link attribute.

   Note: For more information about adding a new link, see Add a New Link Attribute in the CA Repository Universal XML Exchange Control File Builder help.

6. Map the input XML file objects to repository entities by using the Object Map, Relationship, and Mapping area.

   Note: For more information about mapping input XML file objects to repository entities, see Map XML Objects to Repository Entities in the CA Repository Universal XML Exchange Control File Builder help.

7. Complete the following fields in the Log Option area:
   • Enable Logging

     Enables CA Repository Universal XML Exchange Control File Builder to log your activities.

     Default: Yes

   • Log Level

     Specifies the level at which you want the activities logged.

     Default: Yes

     Values:

     • CRITICAL—Only critical messages are written to the log.
     • ERROR—All errors including critical errors are written to the log.
     • WARNING—Both error and warning messages are written to the log.
     • INFO—All messages are written to the log.
8. Click Save.

   Your new control file is created.