The Hold All Writers command holds all writers by using generated
HLDWTR system commands. A single writer, a generic name, or all
writers may be held. An ACTION parameter allows either *CHECK or
*HOLD. HLDALLWTR can assist when a full or partial shutdown of the
system is needed. You must have *JOBCTL special authority to use
HLDALLWTR. See the companion tool RLSALLWTR.
A typical command would be:
HLDALLWTR WTR(*ALL) ACTION(*HOLD)
All writers on the system would be held. A spooled file would be
displayed with the results.
HLDALLWTR escape messages you can monitor for
---------------------------------------------
TAA9893 No writer jobs exist.
Escape messages from based on functions will be re-sent.
HLDALLWTR Command parameters *CMD
----------------------------
WTR The name or generic name of the writer to be held.
*ALL is the default which means hold all writers on
the system.
OPTION The option to be taken for how to end the writers.
*IMMED is the default to end immediately.
*CNTRLD may be specified to end at the current copy.
*PAGEEND may be specified to end at the end of the
current page.
ACTION The action to be taken.
*CHECK is the default which does not cause any
changes. The listing describes what would have
happened if *HOLD had been specified.
*HOLD may be entered to hold the specified writers.
OUTPUT How to output the results. * is the default to
display the spooled file if the command is entered
interactively. The spooled file is deleted after it
is displayed.
If the command is entered in batch or *PRINT is
specified, the spooled file is output and retained.
Restrictions
------------
You must have *JOBCTL special authority to use HLDALLWTR.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHKALLOBJ Check *ALLOBJ special authority
CHKJOBCTL Check *JOBCTL special authority
CVTPRTSTS Convert printer status
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
HLDALLWTR *CMD TAAPRTK QATTCMD
TAAPRTKC *PGM CLP TAAPRTKC QATTCL
TAAPRTKR *PGM RPG TAAPRTKR QATTRPG
|
