WEB READNEXT HTTPHEADER

检索下一个 HTTP 标头。

WEB READNEXT HTTPHEADER

读取语法图跳过可视语法图WEBREADNEXTHTTPHEADER( data-area)NAMELENGTH( data-area)SESSTOKEN( data-value)VALUE( data-area)VALUELENGTH( data-area)

条件: ENDFILE , INVREQ , LENGERR 和 NOTOPEN

此命令是线程安全的。

描述

WEB READNEXT HTTPHEADER 从头信息列表中获取下一个 HTTP 头信息。 如果 HTTP是HTTP发送给 CICS®响应的一部分,则需要SESSTOKEN选项。

选项

HTTPHEADER(data-area)
指定缓冲区以保存提取HTTP名称。
NAMELENGTH(数据区)
指定 HTTPHEADER 选项上提供的缓冲区长度,作为全字二进制数据区,并设置为返回到应用程序的数据的实际长度。 如果数据超过缓冲区长度,那么将生成 LENGERR 条件并截断数据。
SESSTOKEN(数据值)
对于作为 HTTP CICS ,此选项是必需的。 它指定会话令牌,这是一个8字节的二进制值,用于唯一标识 CICS 与服务器之间的连接。 HTTP CICS WEB OPEN命令会返回该值。 会话令牌 说明如何使用会话令牌。
VALUE(数据区)
指定缓冲区以保存提取HTTP值。
VALUELENGTH(数据区)
指定 VALUE 选项上提供的缓冲区的长度,作为全字二进制数据区,并设置为返回到应用程序的数据的实际长度。 如果数据超过缓冲区长度,那么将生成 LENGERR 条件并截断数据。

条件

20 个 ENDFILE
HTTP头列表已结束。
16 INVREQ
RESP2 值有:
1
该命令在非 CICS Web Support 应用程序中发出。
3
正在为HTTP 请求发出命令。
4
在发出 WEB STARTBROWSE 之前,正在发出该命令。
6
已找到格式不为 NAME:VALUE 的头。
22 LENGERR
RESP2 值有:
1
NAMELENGTH或VALUELENGTH的长度小于或等于零 CICS 作为 HTTP )。
4
由于接收缓冲区太小 CICS 作为 HTTP ),标题名称被截断。
5
由于接收缓冲区太小 CICS 作为 HTTP ),标题值被截断。
35
NAMELENGTH的长度小于或等于零 CICS 作为 HTTP )。
51
由于接收缓冲区太小 CICS 作为 HTTP ),标题名称被截断。
52
由于接收缓冲区太小 CICS 作为 HTTP ),标题值被截断。
55
VALUELENGTH的长度小于或等于零 CICS 作为 HTTP )。
19 NOTOPEN
RESP2 值为:
27
无效的会话令牌。