WSAEPR CREATE
使用 WSAEPR CREATE 命令可创建端点引用 (EPR) 以表示 Web Service 或 Web Service 资源。
描述
WSAEPR CREATE 命令创建端点引用，该端点引用可以表示 Web Service 或 Web Service 资源。 您可以将此 EPR 发送到客户机，以便将寻址上下文用于对服务的请求。
选项
- ADDRESS(data-value)
- 指定构成端点引用地址的 URI。 此选项的值的长度必须为 255 个字符。 如果 URI 少于 255 个字符，那么必须使用尾部空格来填充数据值。
- EPRINTO(数据区)
- 指定用于包含生成的端点引用的数据区。 EPRINTO 和 EPRSET 选项互斥。
- EPRLENGTH(数据区)
- 指定端点引用的长度 (作为半字二进制值)。
- EPRSET(ptr-ref)
- 指定设置为用于包含完整或部分端点引用的输出数据区地址的指针引用。 除非被其他命令或语句更改，否则指针引用在下一个 WSACONTEXT GET 命令或任务结束之前有效。 EPRINTO 和 EPRSET 选项互斥。
- FROMCCSID(data-value)
- 指定要作为全字二进制数读取或写入的字符数据的当前编码字符集标识 (CCSID)。 如果您希望为代码页指定 IANA 名称，或者如果您希望将 CCSID 指定为字母数字字符，请改为使用 FROMCODEPAGE 选项。
对于 CICS® Transaction Server for z/OS® 应用程序， CCSID 通常是 EBCDIC CCSID。
在 LOCALCCSID 系统初始化选项上指定区域的缺省 CCSID。
有关 CCSID 的说明以及 CICS支持的 CCSID 的列表，请参阅 CICS支持的转换。
- FROMCODEPAGE(data-value)
- 为要使用最多 40 个字母数字字符 (包括相应的标点符号) 读取或写入的字符数据的当前代码页指定 IANA 注册的字母数字字符集名称或编码字符集标识 (CCSID)。 如果您希望使用 HTTP 请求的 Content-Type 头中指定的 IANA 注册字符集名称，请使用此选项而不是 CCSID 选项。 CICS 将 IANA 名称转换为 CCSID ，并且后续数据转换过程完全相同。 如果您更希望以字母数字字符 (而不是全字二进制数) 指定 CCSID ，那么也请使用此选项。
如果存在代码页的 IANA 名称，并且 CICS 支持使用该名称，那么将在 CICS支持的转换中随 CCSID 一起列出该名称。
- METADATA(data-value)
- 指定用于描述端点引用所针对的端点的行为，策略和功能的元数据。 元数据必须以 XML 描述。
- METADATALEN(data-value)
- 指定 METADATA 选项的长度 (作为全字二进制)。
- REFPARMS(data-value)
- 指定构成端点引用的一部分的应用程序引用选项。 这些选项在 XML 中进行了描述。
- REFPARMSLEN(data-value)
- 指定引用选项的长度 (作为全字二进制)。
条件
- 123 CCSIDERR
- RESP2 值：
- 1
- 在 FROMCCSID 选项上指定的 CCSID 超出有效 CCSID 值的范围。
- 2
- 在 FROMCCSID 选项上指定的 CCSID 和容器的 CCSID 是不受支持的组合。
- 5
- 在容器的代码页转换中发生内部错误。
- 6
- 文本编码与 FROMCCSID 选项上指定的 CCSID 不兼容，或者一个或多个字符被截断。
- 125 CODEPAGEERR
- RESP2 值：
- 1
- 不支持在 FROMCODEPAGE 选项上指定的代码页。
- 2
- 在 FROMCODEPAGE 选项上指定的代码页与容器的 CCSID 是不受支持的组合。
- 5
- 在容器的代码页转换中发生内部错误。
- 6
- 文本编码与 FROMCODEPAGE 选项上指定的 CODEPAGE 不兼容，或者一个或多个字符被截断。
- 16 INVREQ
- 下面显示 INVREQ RESP2 值和相应的消息。 对于此命令，如果 EIBRESP2 值大于 100 ，那么将全字 EIBRESP2 字段视为包含两个半字的结构。 低阶半字始终包含错误号。 高位半字包含发生解析错误的 XML 数据中的偏移量。
- 22 LENGERR
- RESP2 值：
- 20
- 当存储数据的长度大于 EPRLENGTH 选项指定的值时，会发生此情况。 此条件仅适用于 EPRINTO 选项，不能与 EPRSET 选项一起出现。