Setting up a resource to supply Atom entry data

An Atom feed or collection consists of a series of Atom entries, which are items of data together with suitable metadata. For an Atom feed served by CICS, the data for the Atom entries is taken from the records in a resource, which could be a file, a temporary storage queue, or another resource such as a database table. A single record provides a single Atom entry.

About this task

A record in your resource might hold items of metadata for the Atom entry as well as the content for the Atom entry, or it might hold only the content for the Atom entry. When you set up your Atom feed, you can make CICS supply any required items of metadata that are not held in your resource records.

You can use any of these resources to supply the data for the Atom entries in your Atom feed:
  • A new VSAM file or temporary storage queue that you create to contain Atom entries.
  • An existing VSAM file or temporary storage queue that is defined to CICS, from which CICS can extract data directly to produce the Atom feed. CICS can extract data for Atom feeds from any type of VSAM file, except for an alternate index file that has been defined with the NONUNIQUEKEY attribute. The file must have a unique key for its records. CICS cannot extract data for Atom feeds directly from BDAM files.
  • Any other resource that you can access from a CICS application program. You can deliver a CICS or non-CICS resource using a CICS application program known as a service routine, which extracts data for Atom entries from the resource and supplies it to CICS in containers.

Procedure

Follow the appropriate procedure for the resource you want to supply Atom feed data:

What to do next

When you have chosen the resource that holds your Atom entry data, and created an XML binding or a service routine to support the delivery of this data, set up your Atom feed by following the instructions in Setting up CICS definitions for an Atom feed. If you created and installed a BUNDLE resource to create an XMLTRANSFORM resource, which defines the location of the XML binding file, it is possible to reuse this XMLTRANSFORM resource in other Atom feeds.


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