<cics:selector> element

Contained by:

• <cics:feed> element

Attributes

style="style-type"

The styles are as follows:

"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. In this URL, the selector value is "25":

http://www.example.com/web20/sample_atom_feed/entry/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.

"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. In this URL, the selector value is "25":

http://www.example.com/web20/sample_atom_feed/entry?s=25

name="query-parm-name"

If you select style="query", you may use this attribute to specify the name of the query string keyword that identifies the selector value. If you omit the name attribute, the default keyword "s" is used. Do not use this attribute when you select style="segment".

format="format-name"

This attribute identifies the format of the selector value. If your selector value is in the format that CICS assumes for the type of resource that contains your Atom entries, do not specify this attribute. Specify the attribute only if your resource contains a nonstandard selector value. The formats are as follows:

"decimal"

The selector value is a decimal number. CICS assumes this format is used for temporary storage queues and for RRDS and VRRDS files. Specify this setting if you are using any other type of resource and it has a decimal number as the selector value.

"hexadecimal"

The selector value is a binary number. CICS assumes this format is used for ESDS and extended ESDS files. Specify this setting if you are using any other type of resource and it has a binary number as the selector value.

For any other type of VSAM file, CICS assumes that the format of the selector value is a character string. You cannot specify character string format explicitly using the attribute.

ccsid="nnnn"

This attribute specifies the coded character set identifier (CCSID, or code page) into which the selector value must be converted before being passed to the service routine. Do not specify this attribute if format="decimal" or format="hexadecimal" is specified, or if CICS assumes one of those formats for your resource. Specify the attribute only if your selector value is in character string format, and the selector value might contain non-alphanumeric characters that are percent-encoded in the request URL. "nnnn" is the number of an EBCDIC CCSID into which percent-encoded UTF-8 characters are to be converted. If CICS encounters percent-encoded characters in the selector value but the ccsid attribute is omitted, CICS uses the value specified in the LOCALCCSID system initialization parameter. The CCSIDs that CICS supports are referenced in LOCALCCSID system initialization parameter .