Atom 条目的选择器值

Atom 条目的选择器值是 CICS 或服务例程可用于在包含 Atom 条目数据的文件、临时存储器队列或其他资源中查找记录的任何标识。合适的选择器值是始终适用于保存 Atom 条目数据的资源中的给定记录的任何唯一标识，例如，项编号或唯一键。

当 CICS 为响应 Web 客户机而发送 Atom 文档时，会使用个别 Atom 条目的选择器值来构造直接指向这些 Atom 条目的链接，并作为这些条目的已生成 Atom 标识的一部分。 Web 客户机可使用这些链接来对单个 Atom 条目发出请求。每个链接的选择器值可在包含 Atom 条目数据的资源中识别出正确的记录。来自 CICS 的 Atom 订阅源的 URL 说明了如何将选择器值追加到链接。

当 CICS 直接从文件或临时存储器队列提供 Atom 条目时，会根据资源类型来识别合适的选择器值。对于临时存储器队列，选择器值是用于识别临时存储器队列中记录的一个数字，CICS 假定该数字为十进制数。对于文件，选择器值是该文件的唯一键。 CICS 如下假定每种文件类型的选择器值的格式：

对于 RRDS 和 VRRDS 文件，格式为十进制数。
对于 ESDS 和扩展的 ESDS 文件，格式为二进制数。
对于其他类型的 VSAM 文件，格式为字符串。

If the key for your file is not in the format that CICS assumes, you can specify the correct format in the <cics:selector> element in the Atom configuration file.

当服务例程为 Atom 条目返回数据时，您可以选择相应的选择器值。选择器值可以是供程序在资源中查找正确记录以便为 Atom 条目提供数据的任何值。例如，如果该资源是一个数据库，那么可以使用为这些记录提供键的唯一标识。 If the key is not a character string, you must specify in the <cics:selector> element in the Atom configuration file that you are using a hexadecimal selector value.

当服务例程从订阅源或集合返回 Atom 条目时，您必须使用 DFHATOMPARMS 容器中的 ATMP_NEXTSEL 参数来为订阅源中可以使用的下一个 Atom 条目返回选择器值。如果 Web 客户机已请求大量条目，那么 CICS 会使用该选择器值再次链接到程序，这样，您的程序就可以识别并返回在资源中保存为记录的下一个 Atom 条目。该过程会一直持续，直到 CICS 具有足够的订阅源条目，或程序返回空值来表示资源中没有其他可用的 Atom 条目。

当服务例程从集合返回 Atom 条目时，您必须使用 DFHATOMPARMS 容器中的 ATMP_PREVSEL、ATMP_FIRSTSEL 和 ATMP_LASTSEL 参数来为集合中的上一个、第一个和最后一个 Atom 条目返回选择器值。 CICS uses these values to construct <atom:link> elements containing links to other partial lists of entries in the collection. 如果您认为某条目的这些值可供 Web 客户机用来从订阅源检索其他窗口的 Atom 条目，那么可以从订阅源返回这些值，但是对于订阅源，它们不是必需的。使用 ATMP_PREVSEL 生成链接的处理过程会增加响应时间，因此，如果 Web 客户机已设置为使用这种形式的导航，那么仅为订阅源指定该值。

订阅源或集合中的第一个、上一个、下一个和最后一个 Atom 条目的身份取决于您选择返回 Atom 条目的顺序。 Atom 条目序列说明 CICS 如何确定返回 Atom 条目的顺序，并建议服务例程可以返回 Atom 条目的顺序。