<cics:authority> element

The <cics:authority> element in an Atom configuration file provides the authority name and associated date that CICS uses when creating tag URIs to use as Atom IDs for individual Atom entries.

The other elements of the tag URI are a prefix of "tag", and a specific consisting of the resource type and resource name that you specify in the <cics:resource> element in the Atom configuration file, and the selector value for the individual Atom entry. Atom IDs for Atom entries explains the tag URI format and the requirements for the use of Atom IDs.

If you prefer to use an alternative format for the Atom IDs, use the <atom:id> element in the prototype Atom entry to specify a prototype Atom ID, and omit the <cics:authority> element. If you use an alternative Atom ID format, make sure that the Atom IDs are unique and meet the requirements of the Atom format specification in RFC 4287.

The tag URIs are unique within a CICS region, but they are not guaranteed to be unique across different CICS regions. In the situation where you want to set up Atom feeds from resources that have the same name and type but reside on different CICS regions, specify a different authority name or a different date in the <cics:authority> element of the Atom configuration file for each of the feeds. Tag URIs that have different dates are not equivalent to each other, even if all the other information is the same.

The tag URIs are unique for Atom entries provided by a user-written service routine that deals with a single Atom feed, but they are not unique if the user-written service routine provides more than one feed, because the name of the service routine is used as the resource name in the tag URIs. If your user-written service routine provides multiple feeds, either choose an alternative format for your Atom IDs, or use a different authority name or a different date in the <cics:authority> element of the Atom configuration file for each of the feeds.

Contained by:

Attributes

name="authority-name"
The authority name. To comply with RFC 4151, the authority name must be a fully qualified domain name or email address that is registered to you or to your company. You must not use a domain name or email address owned by someone else. RFC 4151 recommends that you specify the authority name in lowercase, and tag URIs where the same authority name is specified in a different case are not equivalent to each other. You should ensure that you have your company's agreement to use a domain name that others in the company might also use to generate tag URIs.
date="YYYY-MM-DD"
A date on which the authority name was owned by you or your company. You can use any date between the time when you first owned the authority name and the present day, but RFC 4151 recommends that you do not use the first day of ownership or a few days immediately following it. You must not use a future date. CICS checks that your date is a valid past or present date.

Example

 <cics:authority name="example.com" date="2009-01-08"/>