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 命令。