TAA Tools
SCNOUTQA        SCAN OUTPUT QUEUE ATTRIBUTES           TAASPOV

The Scan  Output  Queue Attributes  command scans  one  or more  Output
Queues  for  attribute  values.    This  acts  as  a  simple  query  to
determine the value of attributes of Output Queue objects.

A typical command would be:

              SCNOUTQA  ATTR(DTAQ) OUTQ(QGPL/*ALL)
                         SCNVAL('*NONE') SCNOPR(*NE)

A  spooled file  would be  displayed of  all Output Queue  objects that
have a data queue specified.

SCNOUTQA escape messages you can monitor for
--------------------------------------------

      TAA9891    No Output Queue objects exist

Escape messages from based on functions will be re-sent.

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

   ATTR          The Output  Queue attribute to  be scanned  for.   The
                 value must be one of the following:

                 AUTCHK.   The authority  required to control  files in
                 the  output queue.   *OWNER or *DTAAUT  may be entered
                 for the scan value.

                 CNNTYPE.   The  connection type  to a  remote  system.
                 *SNA,  *IP, or  *USRDFN may  be entered  for the  scan
                 value.

                 DESTTYPE.    *OS400,  *OS400V2,  *PSF2,  *S390,  *NDS,
                 *NONE, or *OTHER  may be entered  for the scan  value.

                 DSPDTA.   Whether users  who can  display the list  of
                 spooled files  can also display the data  in a spooled
                 file.   *YES,  *NO, or *OWNER  may be  entered for the
                 scan value.

                 DTAQ.   A data  queue name  or blank  may entered  for
                 the scan value.

                 DTAQL.   A data  queue library name  or blanks  may be
                 entered for the scan value.

                 FCB.     The  forms  control  buffer  sent  to  VM/VMS
                 systems.   *USRDTA, *NONE,  *PRTF, or  a  name may  be
                 entered  for the  scan  value.   SCNOPR(*CT)  must  be
                 used if a name is entered.

                 IMGCFG.      The   image   configuration  to   control
                 transformations for a variety of requirements.

                 JOBSEP.  Whether job  separators should exist  between
                 spooled  files.   *MSG  may be  entered  for the  scan
                 value or a digit 0 to 9.

                 MFGTYPMDL.   The manufacturers  type and model  of the
                 printer device.  The scan operator must be *CT.

                 NBRFILES.   The number of  spooled files in the output
                 queue.  A number  must be entered for the  scan value.

                 NBRWTRS.    The  number  of writers  assigned  to  the
                 output  queue.  A number must  be entered for the scan
                 value.

                 OPRCTL.    Whether   a  user   with  *JOBCTL   special
                 authority can  manage the output  queue.  *YES  or *NO
                 may be entered for the scan value.

                 PRTDEV.    The print  device assigned  to  the spooled
                 file.

                 RMTSYT.  The remote  system type.  A  *YES or *NO  may
                 be  entered  (0  =  no  remote  system  name,  1  =  A
                 Passthru system  is used, 2  = the name  of the remote
                 system, 3 = an internet address.

                 RMTSYS.   The  remote system  name.   SCNVAL(*CT) must
                 be  used.     The  value  to   be  scanned  works   in
                 conjunction with RMTSYT.

                 SEPPAGE.     Whether  separator  pages   should  exist
                 between  spooled files.  A *YES,  *NO, or blank may be
                 entered for the  scan value.   A blank is  used for  a
                 connection type that is not *IP or *USRDFN.

                 SEQ.   The  sequence  of files  in  the output  queue.
                 *JOBNBR  or *FIFO may  be entered for  the scan value.

                 STATUS.  The  status of  the output  queue.   RELEASED
                 or HELD may be entered in the scan value.

                 TEXT.   A  string of  characters to  be  found in  the
                 text  description  may be  entered  with the  operator
                 *CT.

                 TRANSFORM.    Whether  to  make  use  of  host printer
                 transform  services.   *YES,  *NO,  or  blank  may  be
                 entered in  the scan value.   Blank is used  for *SNA.

                 WCCST.  Workstation customizing object name.

                 WCCSTL.  Workstation customizing object library.

                 WTRMQ.  Writer message queue.

                 WTRMQL.  Writer message queue library.

                 WTRNAM.  Writer name.

                 WTRUSR.  Writer user name.

                 WTRSTS.   Writer  status.  STR  or HLD  may be entered
                 for the scan value.

   OUTQ          The  qualified  name  of   the  Output  Queue  to   be
                 scanned.   A single output  queue, a generic  name, or
                 *ALL may be entered.

                 The  library qualifier  defaults to *LIBL.   *USRLIBL,
                 *CURLIB, *ALL,  *ALLUSR, *ALLUSR2,  *ALLNONQ, or  *IBM
                 may  be entered.    For a  full  description of  these
                 values, see the CVTLIBOBJD command.

   SCNVAL        The value  to be scanned for.   Up to 10  bytes may be
                 entered.

                 If  SCNOPR(*CT)  is  entered,  the  SCNVAL  should  be
                 entered   without   quotes   as   the    object   text
                 description  will  be  folded  to  upper  case  before
                 scanning.

   SCNOPR        The scan operator to be used.  *EQ is the default.

                 *NE,  *GT, *GE,  *LT,  *LE, or  *CT (contains)  may be
                 entered.   Non-meaningful functions  such as  scanning
                 the OPRCTL attribute  (supports only *YES or  *NO) for
                 a scan operator other than *EQ/*NE are rejected.

   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
------------

None.

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

The following TAA Tools must be on your system:

     CVTOUTQD        Convert output queue description
     CVTLIBOBJD      Convert library object description
     RTVVALA         Retrieve value attributes
     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
   ------        ----    ---------      ----------    ----------

   SCNOUTQA      *CMD                   TAASPOV       QATTCMD
   TAASPOVC      *PGM       CLP         TAASPOVC      QATTCL
   TAASPOVR      *PGM       RPG         TAASPOVR      QATTRPG
					

Added to TAA Productivity tools July 15, 2009


Home Page Up to Top