向文档添加更多数据

创建文档后，可以通过发出一个或多个 DOCUMENT INSERT 命令来扩展其内容。您可以插入文本，二进制数据，数据缓冲区，文档模板或符号值。您还可以在文档中插入书签，并使用这些书签来定位以后的插入。

关于此任务

可以在 DOCUMENT INSERT 命令上指定选项以:

插入字符串 (TEXT 选项)。
插入二进制数据块 (BINARY 选项)。
插入由其模板名称 (TEMPLATE 选项) 指定的文档模板。
插入数据缓冲区的内容 (FROM 选项)。
从符号表 (SYMBOL 选项) 插入指定符号的值。

缺省情况下，您指定的对象将添加到文档末尾。要在文档中间插入数据，您可以设置一个或多个书签。书签允许应用程序以任何顺序插入数据块，但仍控制文档中数据的顺序。

书签是放置在数据块之间的标签-不能放置在数据块的中间。您可以使用 DOCUMENT INSERT 命令在文档构造期间将书签放置在文档中，然后在插入后续对象时使用 AT 选项来指定书签。已定义 "TOP" 的特殊书签，可用于在文档顶部插入数据。

过程

使用 TEXT 选项可插入由应用程序指定的字符串。
例如：
```
EXEC CICS DOCUMENT INSERT
DOCTOKEN(MYDOC)
TEXT('Sample line 1.')
LENGTH(15)
```
此字符串将保持不变地添加到文档中，并且 CICS® 不会对其执行任何符号替换。
使用 BINARY 选项可插入二进制数据块，发送数据时不会进行代码页转换。
例如：
```
EXEC CICS DOCUMENT INSERT
DOCTOKEN(MYDOC)
BINARY(DATA-AREA)
```
CICS 不会对此数据执行任何符号替换，并标记数据，以便在将文档发送给收件人时不会将其转换为客户机代码页。
使用 TEMPLATE 选项可插入文档模板。
如果要为文档模板中的符号设置值，请在发出 DOCUMENT INSERT 命令之前使用 DOCUMENT SET 命令指定各个符号或符号列表。定义符号值说明如何执行此操作。
使用 FROM 选项可插入数据缓冲区。
数据缓冲区可以包含将以与文档模板中包含的符号引用相同的方式替换的符号引用。
使用 SYMBOL 选项可插入符号的值。
SYMBOL 指定其值已在符号表中设置的有效符号的名称 (使用 DOCUMENT SET 或 DOCUMENT CREATE 命令)。文档处理程序将与符号关联的值插入到文档中。

请注意，在将与符号关联的值插入到文档后，不能在要组成的文档中更改该值。如果您随后为符号设置了其他值，那么下次将该符号插入文档时将使用新值。您的更改不会影响已插入到文档中的值。
使用书签选项将书签插入到文档中。
书签在构建文档期间放置，它们为应用程序提供插入点，以便插入在稍后阶段获得的数据。

书签的名称长度必须为 16 个字符。它不得包含任何嵌入的空格，如果您选择的名称长度小于 16 个字符，那么必须在右边填充空格。
例如，此命令序列创建具有两个文本块和书签的文档:
```
EXEC CICS DOCUMENT CREATE
DOCTOKEN(MYDOCBOOK)
TEXT('Pre-bookmark text. ')
LENGTH(19)
```
```
EXEC CICS DOCUMENT INSERT
DOCTOKEN(MYDOCBOOK)
BOOKMARK('ABookmark ')
```
```
EXEC CICS DOCUMENT INSERT
DOCTOKEN(MYDOCBOOK)
TEXT('Post-bookmark text. ')
LENGTH(20)
```
将 AT 选项与任何其他插入选项配合使用，以将对象放置在先前插入的书签或特殊 TOP 书签上。
例如，此命令在示例书签 ABookmark 处插入文本:
```
EXEC CICS DOCUMENT INSERT
DOCTOKEN(MYDOCBOOK)
TEXT('Inserted at a bookmark. ')
LENGTH(25)
AT('ABookmark ')
```
已完成的文件如下:
```
Pre-bookmark text. Inserted at a bookmark. Post-bookmark
text.
```