Creating an Atom configuration file

Use the Atom configuration wizard in CICS Explorer® to create an Atom configuration file. You enter the basic details to create the file using the New wizard and then add additional information using the editor.

Before you begin

You must have an XML transform on z/OS® UNIX. The XML transform describes the mapping between the language structures of the data source and the XML of the Atom feed. This XML transform can already exist or you can create one using the File Import Wizard in CICS Explorer. For further information on using the File Import Wizard, see Creating an XML transform using the File Import Wizard

Procedure

  1. Optional: If you do not already have a project for the Atom configuration file, 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 File > 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. Ensure that the Resource perspective is open.
  3. In the Project Explorer view, click the bundle project that you want to contain the new Atom configuration file.
  4. Open the New wizard using one of the following methods:
    • Click the down arrow on the New wizard icon The New wizard icon on the CICS Explorer toolbar and click Other . Expand the CICS Resources folder and click Atom Configuration file.
    • Click File > New Wizards and click Other . Expand the CICS Resources folder and click Atom Configuration file.
    • Right-click the project in the Project Explorer view and click New > Other. Expand the CICS Resources folder and click Atom Configuration file.
  5. Complete the fields in the wizard. The following table describes the fields in the Atom configuration wizard.
    Field Description
    Parent Folder The name of the project containing the Atom configuration file. You can overtype this field to change the project.
    File Name The name of the Atom configuration file that you want to create.
    Service Type There are two service types: collection and feed. A collection supplies data that the web client can edit or delete. A feed supplies read-only data to the web client.
    Feed Title The title for the Atom feed that is displayed in the web client. CICS only supports plain text for titles.
    Entry Title The title for the Atom entry. CICS supports only plain text for titles. You must specify an entry title even if your CICS resource always provides a title for Atom entries. Use a suitable default title that could apply to any of your Atom entries, or use an empty element if your Atom entries all have a title and no default would be suitable.
    Resource Type The type of resource that you want to use for your feed.
    Resource Name The name of resource that you want to use for your feed.
    Default URI The partial URI for the Atom feed. You can omit the scheme and host components of the URI, and specify only the path component. The path must be unique to the Atom feed.
    XML Transform Name The name of an existing XMLTRANSFORM resource in the CICS region that points to the XML binding and schema associated with the data source.
  6. Click Finish.

Results

The Atom configuration file is created. The attributes of this file are displayed in the Atom configuration editor.

What to do next

You can edit the configuration file to modify or add additional attributes. For more information, see Editing an Atom configuration file. If no further editing is required, 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 or the following related links.