Creating an XML transform using the File Import Wizard

Use the File Import Wizard to import a source language file into a CICS bundle project to create an XML binding and an associated schema for Atom feeds. This bundle project can then be deployed into your CICS system as an XML transform.

Before you begin

You must have the source language file that you want to associate with the XML transform.

About this task

The wizard can use a COBOL, C/C++, or PL/I language structure to generate an XML binding and an associated schema. The wizard imports the XML binding and schema into a bundle project. This bundle project can be exported as a .zip file to the local file system for deployment to a CICS system, or you can export the project directly to z/OS UNIX. The exported bundle project is the XML transform that can be used in an Atom feed.

Procedure

  1. Optional: If you do not already have a project for the XML transform import, create a new CICS bundle project in the CICS Explorer™.
    1. To switch to the Resource perspective, on the main menu bar, click Window > Open Perspective > Other. Choose Resource from the Open Perspective window, and click OK.
    2. On the main menu bar, click Explorer > New Wizards > Other > CICS Resources > CICS Bundle project. The Bundle Project wizard opens.
    3. In the Project name field, type a name for your new project.
    4. Click Finish.
    The new CICS® bundle project is listed in the Project Explorer view.
  2. Right-click the bundle project in the Project Explorer view of the Resource perspective and click Import.
  3. Expand the General folder and click Import XML Transform Source. The File Import Wizard opens.
  4. Click Browse to locate the source language file that you want to associate with the XML transform. Then navigate to the file that you want to use. This file can be one of the following file types:
    File type Programming language
    .c C/C++ source code file
    .cpp C/C++ source code file
    .h C/C++ header file
    .cbl COBOL source code
    .cob COBOL source code
    .cpy COBOL copybooks data file
    .pli PL/I data description file
  5. In the Enter or select the parent folder field, overtype the name of the bundle project into which you want to import the XML binding and schema, or select a bundle project from the list.
  6. Specify the name of the XML binding and associated schema in the XML Transform source name in bundle field. This field is populated with the name of the source language file you specified earlier, however you can overtype this field with a different name provided that the file extension is maintained.
  7. Set the mapping level. The mapping level defines how much information is converted between the source language file and the XML schema. To benefit from the most sophisticated mappings available, set the mapping level to the latest level. For more information on mapping levels, see Mapping levels for the CICS assistants
  8. Click Finish to create the XML binding (.xsdbind) and schema (.xsd) and import them into the bundle project. These files are imported into the xsdbind folder of the bundle project. A copy of the source language file is also imported into the bundle project for reference and the manifest file (cics.xml) in the META-INF folder is updated with the new XML transform definition.

Results

An XML binding and schema are imported into a bundle project.

What to do next

You can either export the bundle project as a .zip file to the local file system for deployment to a CICS system, or you can export the project directly to z/OS UNIX. For more information see Deploying a CICS bundle project