RLSWTR (Release Writer)

RLSWTR Command syntax diagram

 

Purpose

The Release Writer (RLSWTR) command releases a held writer for additional processing. The specified writer was held by a previously issued HLDWTR (Hold Writer) command. If the writer was writing a file when it was held, the writer can be released either to resume writing the file it was writing or to start writing the next file. In any case, data from the file that was being written when the HLDWTR command was issued is not lost.

 

Required Parameters

WTR

Specifies the name of the spooling writer being released to do additional processing.

 

Optional Parameters

OPTION

Specifies the point in the file where the writer is released. Also, a diskette writer can be released if *CURRENT is specified.

*CURRENT: The writer is released at the point where it was held by the HLDWTR (Hold Writer) command. This option may be specified when the writer is not producing a file.

*BEGIN: The writer is released at the beginning of the current file. This option may be specified only if the writer was held while producing the current file.

*BYPASS: The writer is released at the beginning of the next file. The current file is implicitly held on the queue. This option may be specified only if the writer was held while producing the current file.

+number: Specify the number of pages past the point where the writer was held that it is released. An error message is sent to the user if the specified value goes beyond the number of records or printed pages in the file. This option may be specified only if the writer was held while producing the file.

-number: Specify the number of pages preceding the point where the writer was held that it is released. An error message is sent to the user if the specified value is greater than the number of records or printed pages previously processed in the file before the writer was held. This option may be specified only if the writer was held while producing the file.

PAGE

Specifies the page where the writer starts printing. This parameter is mutually exclusive with the OPTION parameter and is only valid for a print writer. An error message is sent if the PAGE parameter is specified for a diskette writer. Specify the page number where the writer starts printing.

Examples for RLSWTR

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 for RLSWTR

*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.