Creating an XML binding for the Atom feed using CICS Explorer

Use the File Import Wizard in CICS Explorer® to include 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 to create an XMLTRANSFORM resource.

Before you begin

You must have a language structure that defines each record in the data source for the Atom feed. For example, this might be a COBOL copybook that defines the structure of the records stored within a VSAM file.

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.

Procedure

  1. Optional: If you do not already have a project for the XML binding and an associated schema, create a new CICS bundle project in CICS Explorer.
    1. Switch to the Resource perspective by clicking Window > Open Perspective > Other on the main menu bar. 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 include 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 include them in the bundle project. These files are included in the xsdbind folder of the bundle project. A copy of the source language file is also included into the bundle project for reference and the manifest file (cics.xml) in the META-INF folder is updated with the new XMLTRANSFORM resource.

Results

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

What to do next

You must deploy the bundle project to a CICS region. When the bundle project has been deployed, CICS automatically generates the XMLTRANSFORM resource for you. For more information about deploying a bundle project, see Deploying a CICS bundle project from CICS Explorer.