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 Explorer > 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 project.