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
- Optional: If you
do not already have a project for the Atom configuration file, create
a new CICS bundle project
in the CICS Explorer.
- To switch to the Resource perspective, on the main menu
bar, click .
Choose Resource from the Open Perspective window,
and click OK.
- On the main menu bar, click . The Bundle Project wizard opens.
- In the Project name field, type
a name for your new project.
- Click Finish.
The new CICS bundle
project is listed in the Project Explorer view.
- Ensure that the Resource perspective is open.
- In the Project Explorer view, click the bundle project
that you want to contain the new Atom configuration file.
- Open the New wizard using one of the following methods:
- Click the down arrow on 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.
- 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. |
- 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.