TAA Tools
SCNOUTQ         SCAN OUTPUT QUEUE                      TAASPNW

The Scan Output  Queue command scans  for a spooled file  name, generic
name, or  all spooled files in  an output queue for 1  to 20 arguments.
A  spooled file is  output with the results  including the spooled file
name, line number, and the data for each successful scan.

Only spooled files that can  be converted with CPYSPLF can  be scanned.
Spooled files  that are  open or cannot  be converted (such  as created
by  the  Advanced Print  Function)  will be  noted on  the  listing and
bypassed.

A typical command would be:

            SCNOUTQ      OUTQ(xxx) ARGUMENT(ABC)

All spooled files in the named  output queue would be scanned for  ABC.
By default,  the spooled file print  lines are converted to  upper case
before scanning.

If the argument is found, a line is printed with:

       - Spooled file name
       - Line number within the spooled file
       - Position within the line where the argument starts
       - Some of the print line

If the  full argument is found within the first  100 bytes of the print
line, the  first 100  are  printed.   Otherwise, ellipsis  are  printed
followed by the argument and any remaining data on the print line.

A second  form of output  format exists  by using the  OUTPUTFMT(*JOB).
This lists  one line for  every argument found and  identifies the job,
user, job number, spooled file, spooled file number, etc.

SCNOUTQ escape messages you can monitor for
-------------------------------------------

The  TAA9892 message  is sent  for a situation  such as  when a generic
spooled file name is entered  and no spooled files match the name.   No
spooled files were actually scanned.

The  TAA9893  message  is  sent  if  one or  more  spooled  files  were
scanned, but no arguments were found.

      TAA9891    No spooled files exist in the output queue
      TAA9892    No spooled file meets the criteria specified
      TAA9893    No spooled file found that has an argument

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

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

   OUTQ          The   qualified  name  of  the   output  queue  to  be
                 scanned.    The  library  value  defaults  to   *LIBL.
                 *CURLIB may also be used.

   ARGUMENT      A list of  1 to 20 arguments  to be scanned for.   The
                 argument  value  is folded  to upper  case  by command
                 processing.   By default  the print  lines are  folded
                 to upper case before scanning.

                 To  scan for  a  lower case  value  only, specify  the
                 argument in quotes and TRANSLATE(*NO).

   FILE          The spooled  file name to be scanned.   The default is
                 *ALL.

                 A  specific spooled file  name or generic  name may be
                 entered.

   TRANSLATE     A  *YES/*NO parameter  for  whether  the  print  lines
                 should  be translated to  upper case  before scanning.
                 *YES is the default.

                 *NO  may  be specified  when scanning  for  a specific
                 lower case value.  The argument must be in quotes.

   JOB           The job name to be scanned.   The default is *ALL.   A
                 name or a generic name may be entered.

   USER          The user  name to  be scanned.   The default  is *ALL.
                 A name or a generic name may be entered.

   OUTPUTFMT     The type of output format.

                 *DATA  is the  default to list  one line  per argument
                 found along with  the first  100 bytes  of print  line
                 data.

                 *JOB may  be specified to  list one line  per argument
                 found  along  with the  identification  of job,  user,
                 job number, spooled file name, number etc.

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

Only  spooled files that can be  converted with CPYSPLF can be scanned.
Spooled files  that are open  or cannot be  converted (such as  created
by  the Advanced  Print  Function) will  be  noted on  the listing  and
bypassed.

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

The following TAA Tools must be on your system:

     CHKGENERC       Check generic
     CHKSPLF         Check spooled file
     CVTDAT          Convert date
     CVTOUTQ         Convert output queue
     EDTVAR          Edit variable
     EXTLST2         Extract list 2
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   SCNOUTQ       *CMD                   TAASPNW       QATTCMD
   TAASPNWC      *PGM       CLP         TAASPNWC      QATTCL
   TAASPNWR      *PGM       RPG         TAASPNWR      QATTRPG
					

Added to TAA Productivity tools April 15, 2005


Home Page Up to Top