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.

Parameters

Keyword	Description	Choices	Notes
WTR	Writer	Name	Required, Positional 1
OPTION	Resume writing at	-32766-32766, *CURRENT, *BEGIN, *BYPASS	Optional
PAGE	Starting page	Integer	Optional

Top

Writer (WTR)

Specifies the spooling writer to release. After releasing the writer, you will be able to process the files on the output queue (provided the output queue is not held).

This is a required parameter.

name

Specify the name of the writer to be released.

Resume writing at (OPTION)

Specifies the point in the file where you want the writer to begin. Only the first option *CURRENT can be specified when the writer is not producing a file. The last three options (*BYPASS, +number, and -number) can be specified only if the writer was held while it was producing this file. Also, the only valid option for the diskette writer is *CURRENT.

*CURRENT

The writer is released at the point where it had been held by the Hold Writer (HLDWTR) command.

*BEGIN

The writer is released at the beginning of the current file.

*BYPASS

The writer is released at the beginning of the next file. The current file is to be implicitly held on the queue.

+number

The writer is released n number of pages past the point where it was held.

-number

The writer is to be released n number of pages before the point where it was held.

Starting page (PAGE)

Specifies the page where the writer starts printing. This parameter is mutually exclusive with the Resume writing at (OPTION) parameter and is only valid for a printer writer. This parameter can be specified only if the writer was held while producing the file.

integer

Specify the page number in this file where you want the writer to start printing.

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.

Error messages

*ESCAPE Messages

CPF1317

No response from subsystem for job &3/&2/&1.

CPF1340

Job control function not performed.

CPF1352

Function not done. &3/&2/&1 in transition condition.

CPF3313

Writer &1 not active nor on job queue.

CPF3314

PAGE parameter allowed only for print writers.

CPF3316

Writer &3/&2/&1 not released because writer not held.

CPF3317

OPTION parameter value not allowed for diskette writer.

CPF3330

Necessary resource not available.

CPF3331

Not authorized to control writer &3/&2/&1.

CPF3334

Previous hold to writer &3/&2/&1 pending.