WEB READNEXT FORMFIELD
在 HTML 表单中检索下一个“名称/值”对。
语法
条件: ENDFILE ， INVREQ 和 LENGERR
此命令是线程安全的。
NOHANDLE、RESP 和 RESP2是常用选项，可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项.
描述
WEB READNEXT FORMFIELD 检索 HTML 表单中的下一个 "名称/值" 对。
将以未转义的形式返回数据 (请参阅 保留和排除的字符 以获取对此的说明)。
选项
- FORMFIELD (数据区)
- 指定要包含要检索的表单字段的名称的缓冲区。 名称的大小写与存储在表单中的大小写相同。
- NAMELENGTH (数据区)
- 指定格式字段名的长度 (作为全字二进制值)。 在此数据区中返回名称的实际长度。
如果表单字段名称的长度小于缓冲区的大小，那么表单字段名称将放在最左边的字节位置。
如果表单字段名称超过缓冲区，那么将产生 LENGERR 条件并截断该名称。 WEB READNEXT FORMFIELD 的下一次执行将返回导致 LENGERR 条件的相同字段。 确保使用足够大的缓冲区来包含名称。
- VALUE (数据区)
- 指定缓冲区以包含对应于 FORMFIELD 数据区中返回的名称的值。 在将任何转义字符放入缓冲区之前， CICS® 会将这些字符取消转义。
- VALUELENGTH (数据区)
- 指定格式字段值的长度 (作为全字二进制值)。 此数据区中返回值的实际长度。
如果表单字段值的长度小于缓冲区的大小，那么表单字段值将放在最左边的字节位置。
如果该值超过缓冲区，那么会产生 LENGERR 条件并截断该值。 WEB READNEXT FORMFIELD 的下一次执行将返回导致 LENGERR 条件的相同字段。 请确保使用足够大的缓冲区来包含值。
条件
- 20 个 ENDFILE
- 已到达 "名称/值" 对列表的末尾。
- 16 INVREQ
- RESP2 值有：
- 1
- 该命令在非 CICS Web Support 应用程序中发出。
- 3
- 正在为HTTP 请求发出命令。
- 4
- 在发出 WEB STARTBROWSE FORMFIELD 之前，正在发出该命令。
- 6
- 已找到格式不为 NAME:VALUE 的表单字段。
- 153
- 表单类型未知。
- 154
- 表单数据中需要边界字符串，但找不到该字符串。
- 22 LENGERR
- RESP2 值有：
- 1
- NAMELENGTH 或 VALUELENGTH 小于或等于零。
- 4
- 在浏览操作期间，表单字段名称已被截断，因为接收缓冲区太小。
下次执行 WEB READNEXT FORMFIELD 时，将返回导致 LENGERR 条件的相同字段。 因此 LENGERR 条件将持续存在，直到使用足够大的缓冲区来包含该名称。
- 5
- 表单字段值已被截断，因为接收缓冲区太小。
下次执行 WEB READNEXT FORMFIELD 时，将返回导致 LENGERR 条件的相同字段。 因此， LENGERR 条件将一直存在，直到使用足够大的缓冲区来包含该值为止。