CL Command Reference - CHGWTR

CL Command List > CHGWTR Reference

Description:

The Change Writer (CHGWTR) command allows you to change the following attributes of an active printer writer:
. Change the form type to be processed by this writer
. Change the number of file separators for this writer
. Change the output queue to be used for this writer

This command lets you process all files of a given form type together. Spooled files are not necessarily in form type sequence when they reside on the output queue, so this helps the operator to manage the output without continually having to change forms. It also lets you change and use another output queue for this printer without ending and starting the writer each time.

If changes are made while the writer is in hold (HLD) status, the changes do not take effect until after the writer is released. The changes are then made based on the value specified on the OPTION parameter.


Examples:

CHGWTR WTR(MYWTR) FORMTYPE(MYFORM *NOMSG) OPTION(*FILEEND)

This command changes writer MYWTR, which has been producing files of some other form type, to produce files with a form type of MYFORM at the end of the file now being produced. The writer is also prevented from sending an informational message when it runs out of eligible files with form type MYFORM.