runoff.chain Command/Runoff: Commands

runoff.chain

Command runoff.chain Command/Runoff: Commands
Applicable release versions: AP, R83
Category Runoff: Commands (93)
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.
Syntax .chain {file.reference} item-id
Options
Example
.chain next.doc
The item "next.doc" is processed at the end of the document which 
called it.
Purpose
Related runoff.read
runoff.commands
runoff.options.c
runoff.readnext