<cics:selector> element
Atom 配置文件中的 <cics:selector> 元素用于标识某个 Atom 条目的选择器值的 URL 中的特征和位置。 CICS 使用该信息在 HTTP 请求中找到并抽取特定 Atom 条目的选择器值,并在将某个 Atom 条目作为 Atom 订阅源文档或集合的一部分发出时生成正确格式的 URL。
包含于:
属性
- style="style-type"
- 样式如下所示:
- "segment"
- <cics:selector style="segment"/> represents a standard URL style for individual Atom entries, where the selector value for the Atom entry is placed as the final segment of the path component of the URL. 在该 URL 中,选择器值是“25”:
"segment" is the default style, so if you require this style and your selector value is in the format that CICS assumes for the resource type, you may omit the <cics:selector> element from your Atom configuration file.http://www.example.com/web20/sample_atom_feed/entry/25 - "query"
- <cics:selector style="query"/> represents a URL style that is compatible with applications developed using the CA8K SupportPac, where the selector value for the Atom entry is placed in a query string. 在该 URL 中,选择器值是“25”:
http://www.example.com/web20/sample_atom_feed/entry?s=25
- name="query-parm-name"
- 如果您选择 style="query",那么可以使用该属性来指定用于标识选择器值的查询字符串关键字的名称。 如果忽略该名称属性,那么使用缺省关键字“s”。 当您选择 style="segment" 时,请勿使用该属性。
- format="format-name"
- 该属性标识选择器值的格式。 如果您的选择器值采用的格式与 CICS 假定该包含 Atom 条目的资源的类型所用格式相同,请勿指定该属性。 仅当资源包含非标准的选择器值时才指定该属性。 格式如下所示:
- "decimal"
- 选择器值是十进制数。 CICS 假定该格式用于临时存储器队列以及 RRDS 和 VRRDS 文件。 如果您正在使用其他任何类型的资源,并且该资源将十进制数作为选择器值,请指定该设置。
- "hexadecimal"
- 选择器值是二进制数。 CICS 假定该格式用于 ESDS 和扩展的 ESDS 文件。 如果您正在使用其他任何类型的资源,并且该资源将二进制数作为选择器值,请指定该设置。
- ccsid="nnnn"
- 该属性指定选择器值在传递到服务例程之前必须转换成的编码字符集标识(CCSID,即代码页)。 如果指定 format="decimal" 或 format="hexadecimal",或 CICS 假定您的资源使用这两种格式之一,请勿指定该属性。 仅当选择器值为字符串格式,并且该选择器值可能包含在请求 URL 中用百分号编码的非字母数字字符时才指定该属性。 "nnnn" 是用百分号编码的 UTF-8 字符将转换成的 EBCDIC CCSID 的编号。 如果 CICS 在选择器值中遇到用百分号编码的字符,但省略了 ccsid 属性,CICS 将使用在 LOCALCCSID 系统初始化参数中指定的值。 CICS 支持的 CCSID 在 LOCALCCSID 系统初始化参数 中引用。
示例
<cics:selector style="query" name="sel" format="hexadecimal"/>