WSACONTEXT BUILD
使用 WSACONTEXT BUILD 命令在寻址上下文中插入或替换 WS-Addressing 消息寻址属性 (MAP)。
语法
条件: CCSIDERR ， CHANNELERR ， CODEPAGEERR ， INVREQ 和 LENGERR
此命令是线程安全的。
NOHANDLE、RESP 和 RESP2是常用选项，可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项.
描述
将 WSACONTEXT BUILD 命令用于下列任何操作:
- 插入或替换操作或消息标识 MAP
- 插入或替换收件人、发件人、ReplyTo, 或 FaultTo 端点引用 MAP。
- 要插入 RelatesTo MAP。
您可以重复使用该命令在每个调用上提供不同的数据，例如不同的端点引用 (EPRs)。 MAP 应用于 INVOKE SERVICE 或 INVOKE WEBSERVICE 命令创建的所有出站 SOAP 消息以及来自服务提供者的响应 SOAP 消息。
选项
- ACTION(data-value)
- 指定包含请求或响应 SOAP 消息的操作 MAP 的输入值; 例如，
http://example.ibm.com/namespace/bookingInterface/MakeBooking。 操作在 WSDL 中提供或由 Web Service 助手计算，但可以被此选项覆盖。 数据值的长度必须为 255 个字符。 如果操作 MAP 少于 255 个字符，那么必须使用尾部空格来填充数据值。 - CHANNEL(data-value)
- 指定保存寻址上下文的通道的名称。 通道的名称长度最多可以为 16 个字符。 如果通道名称少于 16 个字符，那么必须使用尾部空格来填充数据值。 如果未指定此选项，那么将隐含当前通道。
Acceptable characters for the channel name are A-Z a-z 0-9 $ @ # / % & ? ! : | " = , ; < > . - and _. Leading and embedded blank characters are not permitted. 通道名称的可接受字符集包括一些在所有 EBCDIC 代码页中不具有相同表示的字符。 It is therefore recommended that, if channels are to be shipped between regions, the characters used in naming them should be restricted to A-Z a-z 0-9 & : = , ; < > . - and _.
可以指定通道名称 DFHTRANSACTION 以使用事务通道。
- EPRFIELD(cvda)
- 指定端点引用字段。 您可以多次使用此选项来构建完整端点引用。
- ADDRESS
- 端点引用的 "地址" 字段在 EPRFROM 选项中指定为 URI。
- ALL
- 在 EPRFROM 选项中指定了 XML 中描述的完整端点引用。
- 元数据
- 在 EPRFROM 选项中指定了 XML 中描述的端点引用的 "元数据" 部分。
- REFPARMS
- 在 EPRFROM 选项中指定了 XML 中描述的端点引用的 ReferenceParameters 部分。
- EPRFROM(data-value)
- 包含要放置在寻址上下文中的完整或部分端点引用的输入数据值。 EPRFIELD 选项描述应用程序在此选项中指定端点引用的哪个部分。 端点引用可以由使用 WSAEPR CREATE 命令的 Web Service 应用程序提供，也可以从其他源 (例如服务注册表) 提供。
- EPRLENGTH(data-value)
- 用于包含所提供 EPR 的长度的全字二进制输入数据值。
- EPRTYPE(cvda)
- 指定正在构建的 EPR 的类型:
- TOEPR
- 将 SOAP 消息发送到的目标 EPR。
- 替换 TOEPR
- 返回 SOAP 响应消息的 EPR。
- 故障 TTOEPR
- 返回 SOAP 故障消息的 EPR。
- FROMEPR
- 表示 SOAP 消息发送方的 EPR。
- 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)
- 为要放入寻址上下文的字符数据的当前代码页指定 IANA 注册的字母数字字符集名称或编码字符集标识 (CCSID) ，最多使用 40 个字母数字字符，包括相应的标点符号。 如果您希望使用 IANA 注册的字符集名称，请使用此选项代替 CCSID 选项，如 HTTP Content-Type 标头中所述。 CICS 将IANA名称转换为CCSID，后续的数据转换过程完全相同。 如果您更希望以字母数字字符 (而不是全字二进制数) 指定 CCSID ，那么也请使用此选项。
如果存在代码页的 IANA 名称，并且 CICS 支持使用该名称，那么将在 CICS支持的转换中随 CCSID 一起列出该名称。
- MESSAGEID(data-value)
- 指定唯一标识 SOAP 消息的 URI 的数据值。 数据值的长度必须为 255 个字符。 如果 URI 少于 255 个字符，那么必须使用尾部空格来填充数据区。
- RELATESTYPE(data-value)
- 指定一个 URI ，该 URI 表示要发送的消息与另一条消息之间的关系类型。 该值的长度必须为 255 个字符。 如果 URI 少于 255 个字符，那么必须使用尾部空格来填充数据值。 允许您指定多个 RelatesTo MAP。 后续调用 RELATESTYPE 和 RELATESURI 选项将创建新的 RelatesTo MAP。
- RELATESURI(data-value)
- 指定表示要发送的消息与之相关的消息的消息标识的 URI。 该值的长度必须为 255 个字符。 如果 URI 长度小于 255 个字符，那么必须使用尾部空格来填充数据值。
条件
- 123 CCSIDERR
- RESP2 值：
- 1
- 在 FROMCCSID 选项上指定的 CCSID 超出有效 CCSID 值的范围。
- 2
- 在 FROMCCSID 选项上指定的 CCSID 和寻址上下文的 CCSID 是不受支持的组合。
- 4
- 无法转换一个或多个字符。 在转换后的数据中，每个未转换的字符都已替换为空白。
- 5
- 在寻址上下文数据的代码页转换中发生内部错误。
- 6
- 文本编码与 FROMCCSID 选项上指定的 CCSID 不兼容，或者一个或多个字符被截断。
- 122 CHANNELERR
- RESP2 值：
- 1
- 为 CHANNEL 选项指定的名称包含非法字符或字符组合。
- 2
- 找不到指定的通道。
- 125 CODEPAGEERR
- RESP2 值：
- 1
- 不支持在 FROMCODEPAGE 选项上指定的代码页。
- 2
- 在 FROMCODEPAGE 选项上指定的代码页与寻址上下文的 CCSID 是不受支持的组合。
- 4
- 无法转换一个或多个字符。 在转换后的数据中，每个未转换的字符都已替换为空白。
- 5
- 在容器的代码页转换中发生内部错误。
- 6
- 文本编码与 FROMCCSID 选项上指定的 CCSID 不兼容，或者一个或多个字符被截断。
- 16 INVREQ
- 下面显示 INVREQ RESP2 值和相应的消息。 对于此命令，如果 EIBRESP2 值大于 100 ，那么将全字 EIBRESP2 字段视为包含两个半字的结构。 低阶半字始终包含错误号。 高位半字包含发生解析错误的 XML 数据中的偏移量。
- 22 LENGERR
- RESP2 值：
- 20
- 当存储数据的长度大于 EPRLENGTH 选项指定的值时，会发生此情况。 此条件仅适用于 EPRINTO 选项，不能与 EPRSET 选项一起出现。