创建文档

您可以使用 DOCUMENT CREATE 命令来创建空文档或包含数据的文档。数据可以是字符串、二进制数据块、文档模板或数据缓冲区。

关于此任务

要创建包含数据的文档，可以在 EXEC CICS DOCUMENT CREATE 命令上指定选项以:

包含字符串 (TEXT 选项)。
包含二进制数据块 (BINARY 选项)。
使用由其模板名称 (TEMPLATE 选项) 指定的文档模板。
包含数据缓冲区的内容 (FROM 选项)。
为文档模板中的任何符号或 FROM 选项 (SYMBOL 列表选项) 指定的项提供值。

DOCUMENT CREATE 命令具有必需的 DOCTOKEN 选项，需要 16–byte 数据区。文档处理程序使用 DOCTOKEN 操作数来返回令牌，该令牌用于在后续调用时标识文档。

这些示例显示了应用程序可以使用 EXEC CICS DOCUMENT 命令来创建文档的不同方式。在 Java™ 应用程序中，可以使用 CICS® Java 类库 (JCICS) 来访问文档服务。 Document 类提供 EXEC CICS DOCUMENT 命令的 Java 实现。有关类文档，请参阅 JCICS 类参考中的 Javadoc。

过程

要创建空文档并返回其令牌，请使用带有 DOCTOKEN 选项的 EXEC CICS DOCUMENT CREATE 命令。
此示例创建一个空文档，并在 16 个字符的变量 MYDOC 中返回标记:
```
EXEC CICS DOCUMENT CREATE
DOCTOKEN(MYDOC)
```
使用 TEXT 选项可创建包含应用程序指定的字符串的文档。
例如，如果定义名为 DOCTEXT 的字符串变量并将其初始化为 这是要添加到文档的文本示例 ，那么可以使用以下命令来创建包含此文本字符串的文档:
```
EXEC CICS DOCUMENT CREATE
DOCTOKEN(MYDOC1)
TEXT(DOCTEXT)
LENGTH(53)
```
此字符串将保持不变地添加到文档中，并且 CICS 不会对其执行任何符号替换。
使用 BINARY 选项来创建包含二进制数据的文档，发送数据时不会进行代码页转换。
此示例将创建一个由数据区域的内容组成的文档作为二进制数据:
```
EXEC CICS DOCUMENT CREATE
DOCTOKEN(MYDOC2)
BINARY(DATA-AREA)
```
CICS 不会对此数据执行任何符号替换，并标记数据，以便在将文档发送给收件人时不会将其转换为客户机代码页。
使用 TEMPLATE 选项通过使用 DOCTEMPLATE 资源定义向 CICS 定义的文档模板来创建文档:
1. 定义 48 字节变量 (例如 TEMPLATENAME) ，并将其初始化为模板的 48 个字符名称的值，如其 DOCTEMPLATE 资源定义的 TEMPLATENAME 属性中所指定。
2. 如果文档模板不包含符号，或者您想要使用符号的缺省值，那么可以使用不带 SYMBOL 列表选项的 DOCUMENT CREATE 命令。
  例如：
```
EXEC CICS DOCUMENT CREATE
DOCTOKEN(MYDOC3)
TEMPLATE(TEMPLATENAME)
```
  需要注意的是，您只能在将文档模板放入文档之前或之时指定符号替换的值。在插入模板后，无法更改符号的替代值。
3. 如果要在文档模板中设置符号值，请使用带有 SYMBOL LIST 选项的 DOCUMENT CREATE 命令。
  例如：
```
EXEC CICS DOCUMENT CREATE
DOCTOKEN(MYDOC3)
TEMPLATE(TEMPLATENAME)
SYMBOLLIST('ORDER_NUMBER=0012345')
LISTLENGTH(20)
```
使用 FROM 选项可使用数据缓冲区创建文档。
数据缓冲区可以包含将以与文档模板中包含的符号引用相同的方式替换的符号引用。
例如：
```
EXEC CICS DOCUMENT CREATE
DOCTOKEN(MYDOC4)
FROM(BUFFER)
SYMBOLLIST('ORDER_NUMBER=0012345')
LENGTH(LEN)
```