Spooling writer commands
Last Updated: 2021-04-14
Here are the commands that you can use to control spooling writers.
•
•
•
•
•
•
•
Start Diskette Writer (STRDKTWTR): Starts a spooling writer to a specified diskette
device to process spooled files on that device.
Start Printer Writer (STRPRTWTR): Starts a spooling writer to a specified printer
device to process spooled files on that device.
Start Remote Writer (STRRMTWTR): Starts a spooling writer that sends spooled
files from an output queue to a remote system.
Change Writer (CHGWTR): Changes some writer attributes, such as form type,
number of file separator pages, or output queue attributes.
Hold Writer (HLDWTR): Stops a writer at the end of a record, at the end of a spooled
file, or at the end of a page.
Release Writer (RLSWTR): Releases a previously held writer for additional
processing.
End Writer (ENDWTR): Ends a spooling writer and makes the associated output
device available to the server.
Start Printer Writer (STRPRTWTR)
Last Updated: 2021-04-14
Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages
The Start Printer Writer (STRPRTWTR) command starts a spooling writer to the specified
printer. The writer, which is a system job, takes spooled files from an output queue and
produces (writes) the output on the printer device. This command specifies the name of the
printer, the names of the output and message queues used, and the name of the writer.
More than one writer can be active at the same time (as determined by the spooling
subsystem description), and up to 10 writers can be active to the same output queue. Each
writer must have a unique writer name, its own device, and only one type of writer (print,
remote, or diskette) can be active to a single output queue. A writer that has been started
can be actively writing output or waiting for a file entry to be put on the output queue. The
writer can be changed, held, or canceled if the Change Writer (CHGWTR), Hold Writer
(HLDWTR), or End Writer (ENDWTR) command is used. Because each writer runs
independently of the job that started it, you can continue doing other work on the system
after you start a writer.
Start Remote Writer (STRRMTWTR)
Last Updated: 2021-04-14
Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages
The Start Remote Writer (STRRMTWTR) command starts a spooling writer that sends
spooled files from an output queue to a remote system. The writer, which is a system job,
takes spooled files from an output queue and sends them to a remote system using SNADS
or TCP/IP.
After the spooled file is successfully sent to a remote system, the spooled file will be deleted
or saved, as specified by the SAVE spooled file attribute.
More than one writer can be active at the same time (as determined by the spooling
subsystem description), and up to 10 writers can be active to the same output queue. Each
writer must have a unique writer name, and only one type (print, remote, or diskette) of
writer can be active to a single output queue. A writer that has been started can be actively
sending output or waiting for a file to be put on the output queue. Optionally, the writer can
end automatically when it has processed all the files on the output queue. You can also
change, hold, or cancel the writer.
You can continue with other work after starting a writer because each job runs
independently. The writer is owned by the user who issues the STRRMTWTR command.