HTTP 客户机发送出口 XWBSNDO

通过 XWBSNDO,您可以为作为 HTTP 客户机的 CICS® 发出的 HTTP 请求指定安全策略。 在处理 EXEC CICS WEB SEND 或 EXEC CICS WEB CONVERSE 命令期间调用 XWBSNDO。 主机名和路径信息将传递到出口,并且可将安全策略应用于这两个组件之一或全部。

CICS 不会将 CICS 作为 HTTP 客户机对 HTTP 请求应用任何安全策略; 如果系统或组织需要此工具,那么必须设置此工具。

您可以在 WEB OPEN 命令上使用 XWBOPEN 出口来阻止对整个主机的访问。 使用 XWBSNDO 出口执行同样的操作或阻止对主机中特定路径的访问。 要阻止对整个主机的访问,使用 XWBOPEN 出口可节省时间,因为应用程序无法打开连接,因此不会浪费使用来创建必须发送的请求。 向 XWBSNDO 出口提供主机名以便您可以区分不同主机使用的相同路径。

如果针对 HTTP 请求使用分块的传输编码,那么 XWBSNDO 仅在分块的消息的第一个 WEB SEND 命令中调用。

XWBSNDO 用户出口不支持使用 EXEC CICS 命令。

主机作为 UEPHOST 参数传递到用户出口程序,而路径作为 UEPPATH 参数传递。 返回码 UERCNORM 表明路径是允许的,而返回码 UERCBARR 表明该路径是不允许的。 如果不允许该路径,那么将 NOTAUTH 响应返回给 WEB SEND 或 WEB CONVERSE 命令,而应用程序员通过 WEB CLOSE 命令来关闭连接以处理此响应。

出口 XWBSNDO

调用时机
在 CICS 作为 HTTP 客户机处理 HTTP 请求的 EXEC CICS WEB SEND 或 EXEC CICS WEB CONVERSE 命令期间。 在 WEB SEND 命令中使用 SESSTOKEN 参数来表示客户机请求。
特定于出口的参数
UEPHOST
字段的地址,该字段包含在用于连接的 WEB OPEN 命令的 HOST 选项中指定的主机名、IPv4 或 IPv6 地址
注: 在此字段中保存主机名时,会将其转换为小写。 在匹配主机名时,您的用户出口程序必须执行该转换。
UEPHOSTL
字段的地址,该字段包含主机名的半字长度。
UEPPATH
字段的地址,该字段包含 WEB SEND 命令的 PATH 选项中指定的路径。 该路径是大小写混合的,如同指定它的方式一样。
UEPPATHL
字段的地址,包含路径的半字长度。
UEPHOSTT
表示 UEPHOST 参数中包含的主机类型的 1 字节代码的地址。
注: 二进制 01 指示主机名,二进制 02 指示 IPv4 地址,二进制 03 指示 IPv6 地址。
返回码
UERCNORM
允许路径。
UERCBARR
不允许路径。
XPI 调用
可以使用所有 XPI 调用。
API 和 SPI 命令
不能使用 EXEC CICS 命令。