The Work with Writers (WRKWTR) command gives the status of printers and writers. This can be the overall status of all writers, the overall status of all printers (along with writer information for these printers), or the detailed status of a specific writer. The status of the writers may change while the command is running.

Parameters

Keyword	Description	Choices	Notes
WTR	Writer	Generic name, name, *PRT, *ALL	Optional, Positional 1
OUTQ	Output queue	Single values: *ALL Other values: Qualified object name	Optional, Positional 2
	Qualifier 1: Output queue	Name
	Qualifier 2: Library	Name, *LIBL, *CURLIB
OUTPUT	Output	*, *PRINT	Optional
DSPFMT	Display format	*INLENV, *S36FMT, *NORMAL	Optional
ASTLVL	Assistance level	*PRV, *USRPRF, *BASIC, *INTERMED	Optional

Top

Writer (WTR)

Specifies the spooling writer for which detailed information is displayed, or specifies that the main attributes and status of all spooling writers or all printers are to be displayed.

*PRT

A list of all printers is displayed along with information about the writers started to the printers.

*ALL

The attributes and the current status of all spooling writers are displayed.

name

Specify the name of the spooled writer for which the detailed information is shown.

Output queue (OUTQ)

Specifies the output queue from which writers have been started. Writers that are started from this output queue are shown.

This parameter is valid only if WTR(*ALL) is specified.

Single values

*ALL

Work with writers started to all output queues.

Qualifier 1: Output queue

name

Specify the name of the output queue from which writers have been started. Writers that are started from this output queue are shown.

Qualifier 2: Library

*LIBL

All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB

The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is searched.

name

Specify the name of the library to be searched.

Output (OUTPUT)

Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output on a printer. If the System/36 display format is selected through the Display format (DSPFMT) parameter, this parameter is ignored. The data is presented at your terminal.

*

The output is displayed (if requested by an interactive job) or printed with the job's spooled output (if requested by a batch job).

*PRINT

The output is printed with the job's spooled output.

Note: *PRINT cannot be specified if you are using an S/36 environment. If the command is run interactively, the output will be displayed but not printed. If the command is run in batch, an error message will be sent and no output will be produced.

Display format (DSPFMT)

Specifies the format and terminology to be used on the displays that result from entering this command. This parameter is valid only if *PRT was specified on the Writer prompt (WTR parameter).

*INLENV

The format and terminology to be used is determined by the SPCENV (special environment) value specified in your user profile. If the SPCENV value is *S36, the System/36 terminology is used. All other values will result in this system's terminology being used.

*S36FMT

System/36 terminology is used to present the information.

*NORMAL

This system's terminology is used to present the information.

Assistance level (ASTLVL)

Specifies which user interface to use.

*PRV

The previous user interface used is shown.

*USRPRF

The user interface specified on the Assistance level (ASTLVL) parameter of your user profile is used.

*BASIC

The Operational Assistant user interface is used.

*INTERMED

The system user interface is used.

Examples

Example 1: Working With the Status of All Printers and Writers

WRKWTR   WTR(*ALL)

This command displays the Work with All Printers panel. From this panel, you can work with the status of all printers and writers.

Example 2: Working With the Status of One Writer

WRKWTR   WTR(DISKWRITE)

This command allows you to work with detailed information about writer DISKWRITE.

Error messages

*ESCAPE Messages

CPF0941

Job &3/&2/&1 no longer in system.

CPF1E99

Unexpected error occurred.

CPF1070

Job &3/&2/&1 not found.

CPF1071

No authority to job &3/&2/&1.

CPF3302

Override of print file &1 to file &2 not valid.

CPF3313

Writer &1 not active nor on job queue.

CPF3330

Necessary resource not available.

CPF3336

Job &5/&4/&3 no longer in the system.

CPF3388

System/36 display format not allowed in batch.

CPF3357

Output queue &1 in library &2 not found.

CPF34B6

More than one printer was selected

CPF34B7

Printer must be selected from list of printers.

CPF9845

Error occurred while opening file &1.

CPF9846

Error while processing file &1 in library &2.

CPF9871

Error occurred while processing.