编写分析器程序
您可以用汇编程序、C®、 COBOL 或 PL/I 编写分析程序。
注意: 本主题包含产品敏感的编程接口和关联的指导信息。
关于此任务
分析器程序的输入和输出参数在 COMMAREA 中传递。 分析器程序的参考信息中描述了映射 COMMAREA 的依赖于语言的头文件，包含文件和副本。
分析器程序可以执行的完整范围的功能如下：
- 确定是否应该继续处理请求，或者 CICS® 是否应该向 Web 客户机返回错误响应。
- 分析请求的内容以及从 URIMAP 定义传递到转换器程序的任何参数，以确定需要哪些后续处理阶段以及需要哪些 CICS 资源来执行每个阶段。 (在此分析期间可以使用 EXEC CICS WEB API 命令。)
- 在请求传递到应用程序之前，指定要处理请求的转换器程序名。 转换器程序通常与非 Web 感知应用程序一起使用。 需要的话，提供用户令牌以使分析器程序与转换器程序通信。 Web 客户机请求将传递到一个 32K 存储器块（由参数列表中的一个指针指示）中的转换器程序。 转换器程序 说明转换器程序的功能。
- 指定要处理请求并提供响应的用户编写的应用程序名。
- 指定处理剩余处理阶段的别名事务的事务标识。
- 指定要与别名事务关联的用户标识。
- 指定或禁止传递到存储器块中转换器程序的请求的代码页转换，以及转换器程序在存储器中手动构建的任何响应的代码页转换。 这不会影响转换器程序或用户编写的应用程序，这些应用程序使用 EXEC CICS WEB API 命令来查看 HTTP 请求并生成响应; 它们直接从 CICS请求代码页转换。 CICS Web Support 的代码页转换 说明代码页转换过程。
- 指定为升级目的提供的标志 wbra_commarea，该标志指示非 Web 感知应用程序需要兼容性处理的位置。 这不会影响转换器程序或用户编写的应用程序，这些应用程序使用 EXEC CICS WEB API 命令来查看 HTTP 请求并生成响应。
- 修改请求主体。 在传递到存储器块中的转换器程序的数据中显示所做的任何更改，但 不 显示到 EXEC CICS WEB API 命令中。
CICS 提供缺省分析器程序 DFHWBAAX (在 CICS提供的缺省分析器程序 DFHWBAAX中描述) 和样本分析器程序 DFHWBADX (在 CICS提供的样本分析器程序 DFHWBADX中描述)。 如果这些分析器不符合您的需求，那么需要编写您自己的分析器。 您可能可以将 DFHWBADX 作为示例使用。
所有用户可替换程序都必须是运行 CICS Web Support 的系统的本地程序。 如果不将自动安装用于程序，那么必须为 CICS Web Support 使用的所有用户可替换程序 (包括分析器和转换器程序) 定义和安装程序定义。 如果使用程序的自动安装，那么必须确保用正确的属性安装了用户可替换程序。 请注意，必须使用 EXECKEY(CICS)定义分析器程序。
有关编写用户可替换程序的更多信息，请参阅 使用用户可替换程序进行定制。