CL Command Reference - RLSWTR

CL Command List > RLSWTR Reference

Description:

The Release Writer (RLSWTR) command releases a held writer so that files on the output queue can now be processed. If the writer was writing a file when it was held, the writer can be released to resume writing this same file or it can be released to start writing the next file. In any case, data from the file that was being written when the Hold Writer (HLDWTR) command was issued is not lost.

Note: You must specify a value for either the Resume writing at (OPTION) parameter or the Starting page (PAGE) parameter. You cannot specify both.


Examples:

Example 1: Releasing a Writer at Beginning of File

RLSWTR WTR(PRINTER) OPTION(*BEGIN)

This command releases writer PRINTER to begin producing the current file at its beginning.



Example 2: Releasing Writer at Specified Point

RLSWTR WTR(PRTR) OPTION(-3)

This command releases writer PRTR to begin printing again at a point three pages before the point where the writer was held. That is, the last three pages previously printed are the first three pages printed this time.



Example 3: Starting Printing on Page Ten

RLSWTR WTR(PRTR) PAGE(10)

This command releases writer PRTR to start printing again at page ten.