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:

     CHKJOBCTL       Check *JOBCTL special authority
     CHKGENERC       Check generic
     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