TAA Tools
RTVJOBOUTQ      RETRIEVE JOB OUTPUT QUEUE              TAAJOCO

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
					

Added to TAA Productivity tools April 15, 2018


Home Page Up to Top