Creating and installing the Atom collections resources

To expose the VSAM files as Atom collections you can use the CICS Explorer® to create a bundle project containing the XML binding, schema, and three Atom configuration files, one configuration file for each VSAM file.

About this task

Complete the tasks listed in the following procedure to set up CICS® definitions to expose the new orders, fulfilled orders, and unfulfilled orders VSAM files as Atom collections.

It is assumed that the new orders, fulfilled orders, and unfulfilled orders VSAM files exist in a CICS region with an associated copy book. For this scenario, the FILE resources associated with these files are called ORDERS, UNFULFIL, and FULFILL respectively. The copy book must have the file extension .cbl or .cpy with the following structure:
       01 ORDER-DETAILS.
        10 ORDER-NUMBER     PIC X(5).
        10 ITEM-ID          PIC X(5).
        10 ITEM-DESC        PIC X(50).
        10 ITEM-QUANT       PIC S9(8) BINARY.
        10 ITEM-PRICE       PIC X(6).
        10 FULFILLED        PIC X.
          88 COMPLETED      VALUE 'Y'.
          88 INCOMPLETE     VALUE 'N'.
      *71 BYTES IN LENGTH
      *KEY IS 5 BYTES FROM OFFSET 0
The copy book in this scenario is called OrdStruc.cbl

Procedure

  1. Optional: If you do not already have a CICS bundle project create one 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. Create an XMLTRANSFORM resource using the Import XML Transform Source wizard in CICS Explorer. The XMLTRAMSFORM is created using your copy book. For more information, see Creating an XML binding for the Atom feed using CICS Explorer.
  3. Create three basic Atom configuration files for the new orders, fulfilled orders, and unfulfilled orders VSAM files in the bundle project, using the Atom configuration wizard in CICS Explorer. For more information, see Creating an Atom configuration file. When you have created the Atom configuration file it is displayed in the Atom configuration editor. For this scenario no further editing of the configure files is required. If, however, you want to customize the Atom configuration file by adding additional XML elements or amending the existing data, see Editing an Atom configuration file. The Atom configuration file for the new order Atom collection must contain the same data displayed in Figure 1. The Atom configuration file for the fulfilled orders Atom collection must be the same as Figure 1, however, Resource Name is FULFILL and Feed Title is Fulfilled Orders. The Atom configuration file for the unfulfilled orders Atom collection must be the same as Figure 1, however Resource Name is UNFULFIL and Feed Title is Unfulfilled Orders.
    Figure 1. The Atom configuration file editor in CICS Explorer showing the configuration for the orders file.
    The figure shows Atom configuration file editor in CICS Explorer. The fields in the editor are populated with the result of creating a basic Atom configuration file for the new orders file using the Atom configuration wizard.

Results

An XML binding, schema, and three Atom configuration files are included into a bundle project.



CreatingAtomCollections.html | Timestamp icon Last updated: Sunday, 4 June 2017