WEB READNEXT HTTPHEADER
检索下一个 HTTP 标头。
描述
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
- 无效的会话令牌。
