<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 条目的 Atom 标识 说明了标记 URI 格式以及使用 Atom 标识的需求。

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. 如果您使用备用 Atom 标识格式，请确保 Atom 标识是唯一的且符合 RFC 4287 中 Atom 格式规范的要求。

标记 URI 在一个 CICS 区域中是唯一的，但不能保证它们在不同的 CICS 区域中也是唯一的。 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. 即使所有其他信息都是相同的，具有不同日期的标记 URI 也互不相同。

如果用户编写的服务例程只处理一个 Atom 订阅源，那么标记 URI 对于该例程提供的 Atom 条目是唯一的，但如果用户编写的服务例程提供多个订阅源，标记 URI 就不是唯一的，因为服务例程的名称在标记 URI 中用作资源名称。 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.

包含于：

属性

name="authority-name"
权限名称。 为了符合 RFC 4151，权限名称必须是向您或您的公司注册的标准域名或电子邮件地址。 您不得使用其他人拥有的域名或电子邮件地址。 RFC 4151 建议您以小写字母指定权限名称，以不同大小写字母形式指定相同权限名称的标记 URI 各不相同。 您应确保已征得公司同意使用某域名，公司内的其他人可能也会使用该域名来生成标记 URI。
date="YYYY-MM-DD"
您或贵公司拥有该权限名称的日期。 您可以使用从首次拥有该权限名称的时间一直到至今为止这一期间内的任何日期，但是，RFC 4151 建议不要使用首次拥有之日或随后的几天。 您不得使用未来的日期。 CICS 会进行检查，确保该日期是有效的过去日期或当前日期。

示例

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