Sequence for Atom entries
CICS, or your service routine, must determine the order in which multiple Atom entries are arranged in an Atom feed document.
RFC 5023, The Atom Publishing Protocol, which is available from http://www.ietf.org/rfc/rfc5023.txt, states that entries in an Atom collection should be returned to a web client according to the order in which they were edited, as shown by the <app:edited> element in the entry. The Atom entry that was most recently edited should be returned first, so that it is the first Atom entry to appear in the Atom feed document. The next most recently edited Atom entry should be returned next, and so on, with the entry that was least recently edited being returned last. This function is a SHOULD requirement in RFC 5023 for a full list of Atom entries, where the whole collection is returned in a single feed document, but a MUST requirement for a partial list of Atom entries. RFC 5023 and RFC 4287 do not make any requirement for the ordering of Atom entries in an Atom feed that is not defined as a collection, so for entries in an Atom feed, servers can choose any order that is consistent and logical.
- For temporary storage queues, the Atom entry that has the highest record number is returned first.
- For ESDS and extended ESDS files, the Atom entry that has the highest RBA (relative byte address) or XRBA (extended relative byte address) is returned first.
- For RRDS and VRRDS files, the Atom entry that has the highest RRN (relative record number) is returned first.
- For KSDS and AIX files, which do not have a concept of the order of writing, the Atom entries are returned in order of their record key, and the Atom entry with the lowest record key is returned first.
- In your file, include a field in the records that contains a time stamp in ABSTIME format showing when the entry was last edited. You can output this information in your Atom entries as the <app:edited> element.
- Define the field containing the time stamp as an alternate index for the file.
- In your service routine, use the alternate index to locate the records containing the data for the Atom entries, and return them with the most recently edited entry first, as indicated by the most recent timestamp.
- The previous Atom entry is the Atom entry that was edited after the present entry was edited.
- The next Atom entry is the Atom entry that was edited just before the present entry was edited.
- The first Atom entry is the Atom entry that was edited the most recently.
- The last Atom entry is the Atom entry that was edited the least recently.
- The previous Atom entry is the Atom entry that was written after the present entry was written.
- The next Atom entry is the Atom entry that was written just before the present entry was written.
- The first Atom entry is the Atom entry that was written the most recently.
- The last Atom entry is the Atom entry that was written the least recently.