| center | Index Level | chapter |
| Syntax | .chain {file.reference} item-id |
| Category | Runoff |
| Type | Command |
| Description |
transfers control to the specified item-id.
If the file.reference is not specified, the current file is used. Control does not return to the source item. This command is particularly useful for generating form letters. For example, it may be necessary to insert the name and address of each recipient of the letter from a separate file. A "sselect" statement is used to extract the relevant data from the file and save it in a list. A series of ."readnext" statements inserts the data into the text of the letter. At the end of the letter, a ".chain" command may be used to restart the next letter. When the list is exhausted, Runoff stops. |
| Options | |
| See Also | read Runoff Commands c readnext |
| Example |
.chain next.doc
The item "next.doc" is processed at the end of the document which called it. |
| Warnings | |
| Compatibility | D3 7.0 AP R83 |
| center | Index Level | chapter |