Work with Writers (WRKWTR)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

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.

Top

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

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

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.

Top

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

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

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.

Top

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