WEB STARTBROWSE FORMFIELD
发信号提示 HTML 表单字段浏览的开始。
语法
条件: INVREQ ， LENGERR 和 NOTFND
此命令是线程安全的。
NOHANDLE、RESP 和 RESP2是常用选项，可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项.
描述
WEB STARTBROWSE FORMFIELD 表示开始浏览一组名称和值对，这些名称和值对位于当前 CICS®正在处理的 HTTP正文中的 HTML 表单中。
选项
- CHARACTERSET (名称)
- 指定对表单数据进行编码所需的字符集的 40–character 名称。 此选项应与相应 HTML 表单所确定的表单编码相匹配 (请参阅 如何确定客户机编码 以获取更多信息)。 CICS 不支持 IANA 指定的所有字符集。 HTML 编码字符集 列出了 CICS 支持用于代码页转换的 IANA 字符集。
- CLNTCODEPAGE (名称)
- 仅出于升级目的支持此选项。 CHARACTERSET 替换了它。 对于这两个关键字， CICS 执行的操作相同。
- FORMFIELD (数据区)
- 是用于启动 STARTBROWSE FORMFIELD 命令的关键字。 (可选) 您可以通过在数据区中指定此字段并后跟 NAMELENGTH 选项来指定要在其中开始浏览的表单字段的名称，例如，
该名称是包含所请求字段的名称的文本字符串。 如果未指定名称，那么将从 HTML 表单中的第一个 "名称/值" 对开始浏览。WEB STARTBROWSE FORMFIELD(name) NAMELENGTH(len) - HOSTCODEPAGE (名称)
- 指定要将表单数据转换为的应用程序所需的 CICS (主机) 代码页的 8–character 名称。 此代码页通常是 EBCDIC 代码页。
主机代码页名称的标准 CICS 格式由使用 3 编写的代码页号 (或更一般的 CCSID) 组成，必要时使用 5 十进制数字，然后使用尾部空格填充到 8 个字符。 对于少于 3 位数字的代码页 37，标准格式是 037。 现在， CICS 还接受范围在 1 到 65535 之间的最多 8 位 (以尾随空格填充) 的任何十进制数作为代码页名称，即使它不是标准格式也是如此。
如果未指定代码页，那么将以 LOCALCCSID 系统初始化参数 (适用于本地 CICS 区域，缺省值为 037) 指定的 EBCDIC 代码页返回数据，前提是指定的代码页受 CICS Web 界面支持。 如果代码页是 CICS 识别为足够标准的 EBCDIC 代码页列表之一，以允许成功解析 Web 头 (这包括所有 SBCS CECP 和欧元代码页) ，那么支持该代码页。 否则， CICS 将改为返回缺省 EBCDIC 代码页 037 中的数据。
- NAMELENGTH (数据值)
- 指定格式字段名的长度 (作为全字二进制值)。 如果使用 FORMFIELD 选项指定了名称数据区，那么必须指定此字段。
条件
- 21 ILLOGIC
- RESP2 值为:
- 5
- 表单字段的浏览已在进行中。
- 16 INVREQ
- 针对以下情况发生。 RESP2 值有：
- 1
- 该命令在非 CICS Web Support 应用程序中发出。
- 3
- 正在为HTTP 请求发出命令。
- 11
- 找不到客户机代码页。
- 12
- 找不到主机代码页。
- 13
- HTTP中未提供任何表单数据。
- 14
- 客户机和服务器的代码页组合无效。
- 17 日
- 在输入消息中找到无效的表单数据。
- 153
- 表单类型未知。
- 154
- 表单数据中需要边界字符串，但找不到该字符串。
- 22 LENGERR
- 针对以下情况发生。 RESP2 值有：
- 1
- NAMELENGTH 或 VALUELENGTH 小于或等于零。
- 13 NOTFND
- 针对以下情况发生。 RESP2 值有：
- 1
- 找不到 FORMFIELD 参数中给定的表单字段名称。