Web 错误程序 DFHWBEP 的参考信息
DFHWBEP 会从 CICS® 接收一个参数列表，提供有关出错情况的信息，并接收一个存储块，其中包含 CICS 计划发送给网络客户端的默认 HTTP 响应，包括状态代码和状态文本。 程序可以使用或修改缺省响应，或者使用 EXEC CICS WEB 和 DOCUMENT API 命令创建并发送其自己的响应。
| 语言 | 参数文件 |
|---|---|
| 汇编语言 | DFHWBEPD |
| C | DFHWBEPH |
| COBOL | DFHWBEPO |
| PL/I | DFHWBEPL |
参数
wbep_response_ptr 和 wbep_response_len 既可输入又可输出， 而 wbep_suppress_abend 和 wbep_close_conn 只可输出，除了它们以外的所有 DFHWBEP 参数都只可输入。
- wbep_abend_code
- （仅输入）
与该异常关联的 8 字符异常终止代码。
- wbep_activity
- （仅输入）
发生错误时进行的处理类型。 0 表明服务器处理，而 2 表明管道处理。
- wbep_analyzer_reason
- （仅输入）
分析器程序返回的原因码 - 如果调用了分析器程序。
- wbep_analyzer_response
- （仅输入）
分析器程序返回的响应码 - 如果调用了分析器程序。
- wbep_client_address
- （仅输入）
如果未指定 wbep_client_ipv6_address，必须设置为客户机的二进制 IPv4 地址的 15 字符字段。 wbep_client_address 不支持 IPv6 地址。
如果 wbep_client_address 中的值为非零，那么会使用该值，并会忽略 wbep_client_ipv6_address 中的任何值。 因此，如果您正在使用 IPv6 寻址，那么必须清除 wbep_client_address 中的内容，以便使用 wbep_client_ipv6_address 中的值。
- wbep_client_ipv6_address
- （仅输入）
客户机的冒号十六进制 IPv6 地址或点分十进制 IPv4 地址。 该字段的最大长度可为 39 个字符。
正在使用 IPv6 寻址时，或正在使用 IPv4 寻址且未指定 wbep_client_address 时，必须设置该字段。 该字段支持 IPv4 和 IPv6 地址，并可设置为客户机的二进制 IPv6 地址或者客户机的 IPv6 格式的 IPv4 地址。 有关 IP 地址格式的更多信息，请参阅 IP 地址。
- wbep_client_address_len
- （仅输入）
wbep_client_address 中包含的点分十进制 IP 地址的长度。 如果该地址为 IPv6 格式，那么该字段将包含零。
- wbep_client_ipv6_address_len
- （仅输入）
wbep_client_ipv6_address 或 wbep_client_address 中包含的 IP 地址的长度。
- wbep_close_conn
- （仅输出）
单字符字段（Y 或 N），表明在将响应发送给客户机之后，连接是否关闭。 缺省值 N 表明连接未关闭。
- wbep_converter_program
- （仅输入）
用于失败请求的转换器程序名称 - 如果使用了转换器程序。
- wbep_converter_reason
- （仅输入）
转换器程序返回的原因码（如果调用了转换器程序）。
- wbep_converter_response
- （仅输入）
转换器程序返回的响应码（如果调用了转换器程序）。
- wbep_error_code
- （仅输入）
错误代码，标识检测到的错误。
- wbep_eyecatcher
- （仅输入）
包含有助于诊断的 eyecatcher 的单字符字段。 DFHWBA 在调用 Web 错误程序之前会将它设置为
>wbepca。 - wbep_failing_program
- （仅输入）
包含发生错误的程序名称的 8 字符字段。
- wbep_http_response_code
- （仅输入）
CICS 对此错误返回的默认 HTTP 状态代码。
- wbep_length
- （仅输入）
DFHWBEPC 副本的长度。
- wbep_message_len
- （仅输入）
由 wbep_message_ptr寻址的 CICS 消息文本的长度。
- wbep_message_number
- （仅输入）
与错误关联的 CICS WB 域消息的全字号。
- wbep_message_ptr
- （仅输入）
指向与此错误关联的 CICS 消息文本的指针。
- wbep_response_len
- （输入和输出）
在输入时，该字段是该错误的缺省 HTTP 响应的全字长度。 CICS 仅为 HTTP 请求提供缺省响应; 对于非HTTP 请求，此字段为零。 在输出时，该字段包含缺省 HTTP 响应的长度、同一存储器块中已修改响应的长度，或新存储器块中替换响应的长度。
- wbep_response_ptr
- （输入和输出）
在输入时，这是指向包含该错误的缺省 HTTP 响应的存储器块的指针。 CICS 仅为 HTTP 请求提供缺省响应。 缺省响应是一个完整的 HTTP 响应，包括状态行、HTTP 头和消息体。 在输出时，这是指向包含原始或已修改的缺省响应的同一存储器块的指针，或者是指向包含替换响应的新存储器块的指针。 如果 DFHWBEP 成功使用 EXEC CICS WEB SEND 命令来创建新响应并将其发送到 Web 客户机，那么 CICS 将忽略并废弃存储器块中的 HTTP 响应。 否则，会将存储器块中的响应发送到 Web 客户机。
- wbep_server_address
- （仅输入）
必须设置的服务器 (作为 HTTP 服务器的CICS ) 的 15 个字符的 IPv4 地址 (如果未指定 wbep_server_ipv6_address )。 wbep_server_address 不支持 IPv6 地址。
如果 wbep_server_address 中的值为非零，那么会使用该值，并会忽略 wbep_server_ipv6_address 中的任何值。 因此，如果您正在使用 IPv6 寻址，那么必须清除 wbep_server_address 中的内容，以便使用 wbep_server_ipv6_address 中的值。
- wbep_server_ipv6_address
- （仅输入）
正在使用 IPv6 寻址时，或正在使用 IPv4 寻址且未指定 wbep_server_address 时必须设置的 16 字节字段。 此字段支持 IPv4 和 IPv6 地址，并设置为服务器的二进制 IPv6 地址 (CICS 作为 HTTP 服务器) 或服务器的 IPv4 地址 ( IPv6 格式)。 有关 IP 地址格式的更多信息，请参阅 IP 地址。
- wbep_server_address_len
- （仅输入）
wbep_server_address 中包含的点分十进制 IPv4 地址的长度。 如果该地址为 IPv6 格式，那么该字段将包含零。
- wbep_server_ipv6_address_len
- （仅输入）
wbep_server_ipv6_address 或 wbep_server_address 中包含的 IP 地址的长度。
- wbep_target_program
- （仅输入）
被指定用来处理 Web 客户机请求的用户编写的目标应用程序。
- wbep_tcpipservice_name
- （仅输入）
接收请求的端口的 TCPIPSERVICE 定义名。
- wbep_version
- （仅输入）
表明当前使用的参数列表的版本的半字二进制数。 使用常量值 wbep_current_version 来设置该值。
- wbep_suppress_abend
- （仅输出）
1 位标志，当设置为 on 时表示禁止异常终止 AWBM。