WEB READ HTTPHEADER
抽取 HTTP 头信息。
语法
条件: INVREQ ， LENGERR ， NOTFND 和 NOTOPEN
此命令是线程安全的。
NOHANDLE、RESP 和 RESP2是常用选项，可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项.
描述
WEB READ HTTPHEADER 允许应用程序从消息中提取 HTTP 报头信息。 当 CICS® 是 HTTP时，消息是来自Web客户端的请求。 当 CICS 是 HTTP时，消息是服务器的响应，并且指定了SESSTOKEN选项。
对于HTTP CICS ，您可以在使用WEB RECEIVE命令接收消息正文之前或之后使用WEB READ HTTPHEADER命令。 对于HTTP CICS ，您必须首先使用WEB RECEIVE命令接收消息，然后才能使用WEB READ HTTPHEADER命令读取报头。
CICS 网页支持HTTP参考列出了您可能收到的 HTTP/1.1 头，并指导您如何应对。
HTTP浏览命令（WEB STARTBROWSE HTTPHEADER、WEB READNEXT HTTPHEADER、WEB ENDBROWSE HTTPHEADER）可用于浏览一条消息的所有 HTTP信息。
选项
- HTTPHEADER（data-area）
- 指定要提取HTTP名称。
- NAMELENGTH（data-value）
- 以全字二进制值的形式指定 HTTP 头名称的长度。
- SESSTOKEN(数据值)
- 对于作为 HTTP CICS ，此选项是必需的。 它指定会话令牌，这是一个8字节的二进制值，用于唯一标识 CICS 与服务器之间的连接。 HTTP CICS WEB OPEN命令会返回该值。 会话令牌 说明如何使用会话令牌。
- VALUE(数据区)
- 指定缓冲区以保存提取HTTP值。
- VALUELENGTH(数据区)
- 指定 VALUE 选项上提供的缓冲区的长度 (作为全字二进制变量) ，并设置为返回到应用程序的数据的实际长度。 如果数据超过缓冲区长度，那么将生成 LENGERR 条件并截断数据。
条件
- 16 INVREQ
- RESP2 值有：
- 1
- 该命令在非 CICS Web Support 应用程序中发出。
- 3
- 正在为HTTP 请求发出命令。
- 43
- 未找到 HTTP 标头。
- 22 LENGERR
- RESP2 值有：
- 1
- VALUELENGTH的长度不能大于零 CICS 作为 HTTP ）。
- 2
- 由于接收缓冲区太小 CICS 作为 HTTP ），标题值被截断。
- 35
- NAMELENGTH的长度不能大于零 CICS 作为 HTTP ）。
- 52
- 由于接收缓冲区太小 CICS 作为 HTTP ），标题值被截断。
- 55
- VALUELENGTH的长度不能大于零 CICS 作为 HTTP ）。
- 13 NOTFND
- RESP2 值为:
- 1
- 找不到具有给定名称的头。
- 19 NOTOPEN
- RESP2 值为:
- 27
- 无效的会话令牌。