为 HTTP 消息生成实体主体

Web 感知应用程序可以生成由 CICS® 文档或数据缓冲区组成的实体主体。

关于此任务

CICS 文档可用作 HTTP 消息的实体主体。 使用 EXEC CICS DOCUMENT 命令可创建 CICS 文档。 它们可以由应用程序直接指定的数据填充,也可以由文档模板填充,这些文档是定义为 CICS 资源或由另一个 CICS 程序创建的部分文档。 您可以存储文档和文档模板以供复用。

您还可以指定应用程序创建的一缓冲区的数据。 您可能发现该选项对于简短或简单的实体主体更加方便,并且您必须对消息的分块传输编码使用该选项。 然而,以此方式创建的数据无法那么容易地存储以供再次使用。

过程

  1. 要创建 CICS 文档,请遵循 创建文档中的指示信息。
    使用 EXEC CICS DOCUMENT 应用程序编程接口 ( EXEC CICS DOCUMENT CREATE , INSERT 和 SET 命令) 来创建文档。 在 WEB SEND 命令上使用 DOCTOKEN 选项以指定已完成文档的文档令牌。 CICS 检索文档并执行相应的代码页转换,具体取决于您在 WEB SEND 命令上指定的选项。

    无法从 CICS 文档构成分块消息的主体。

  2. 或者,汇编应用程序中的消息体。
    在 WEB SEND 命令上使用 FROM 选项以指定数据缓冲区。

    数据缓冲区的大小并没有设置上限,但是您必须考虑以下在实践中可能会限制其大小的因素:

    • CICS 区域的 EDSA 限制。
    • 您可能同时在 CICS 区域中组装的其他消息体的数量。 调度约束可能由适用于 CICS Web Support 事务的任何事务类定义的 MAXACTIVE 设置强加。
    • 用于消息体的代码页转换类型。 对于从 EBCDIC 代码页 037 到 ASCII 代码页 ISO-8859-1的转换, CICS 会覆盖同一数据缓冲区,因此不会使用其他存储器。 对于任何其他类型的代码页转换, CICS 需要额外的存储器来包含转换后的消息体。 根据使用的字符集,此额外存储器区域的大小范围可以是:从与原始消息体相同的大小,到理论上最大为原始消息体大小的四倍(这不太可能)。 例如,使用 FROM 选项发送的 2 MB 数据缓冲区总共至少需要 4 MB 的存储空间。 双字节字符集 (DBCS) 或多字节字符集可能需要该范围内的更大存储器区域。