The Retrieve  Job Output  Queue command  returns the  job output  queue
and library that the current job is set to.

RTVJOBOUTQ  can be  very helpful  in determining  where a  job's output
will  be sent,  especially when  special values  are set as  the output
queue and  library  on the  job.   Special  values of  *SAME,  *USRPRF,
*DEV, and  *WRKSTN can be set  as output queue values,  which can cause
a  job's output  to be  sent to unexpected  places, depending  on other
system settings.

By using RTVJOBOUTQ, a programmer  can determine where the output  will
be sent and  return this information in  a message to the  user, saving
time  and  frustration in  trying  to find  output  by  hunting through
system settings, etc.

A typical series of commands would be:

             DCL        &OUTQ *CHAR LEN(10)
             DCL        &LIB *CHAR LEN(10)
              .
             RTVJOBOUTQ OUTQ(&OUTQ) LIB(&LIB)

Command parameters                                    *CMD
------------------

   OUTQ          The variable name for the  job output queue where  the
                 job's  output  will  be sent.    This  is  a  required
                 parameter.  It must be declared as a CHAR(10).

   LIB           The variable  name for the  library of the  job output
                 queue  where the job's  output will be  sent.  This is
                 a  required parameter.    It  must be  declared  as  a
                 CHAR(10).

Restrictions
------------

Because the  command returns  variables, it  may only be  used in  a CL
program.

Prerequisites
-------------

The following TAA Tools must be on your system:

     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   RTVJOBOUTQ    *CMD                   TAAJOCO       QATTCMD
   TAAJOCOC      *PGM       CLP         TAAJOCOC      QATTCL