TAA Tools
FNDSPLF         FIND SPOOLED FILE                      TAASPPG

The Find Spooled  File command can assist  when you are trying  to find
a spooled  file, but you  are not sure of  the name, the  job, the form
type,  etc.    FNDSPLF allows  you  to  identify one,  generic,  or all
output queues  that should  be  searched for  whatever information  you
have such  as the  form type  or some string  of characters  within the
form  type.  Most of  the selection options  supported by FNDSPLF allow
this type of searching.

You must have *ALLOBJ and *SPLCTL authority to use FNDSPLF.

The system provides a similar  function with WRKSPLF, but this is  only
effective if you  know the full (or for some  parameters generic) value
to be searched for.

Assume  you know a  spooled file exists  with a name  that contains the
letters ABC.  The  ABC value may  be at the beginning  of the name,  at
the end of the name,  or embedded in the name such as  DEFABCX.  Assume
you  want to  search all  output  queues.   The command  to  be entered
would be:

             FNDSPLF   OUTQ(*ALL/*ALL) SPLF(ABC)

If  there are too  many spooled files  that meet the  criteria, but you
know the  job name  contains the  characters PAY,  specify the  command
as:

             FNDSPLF   OUTQ(*ALL/*ALL) SPLF(ABC) JOB(PAY)

By  default,   the  QEZJOBLOG  and  QEZDEBUG  output   queues  are  not
searched.   If a  large number of  spooled files exist  to be searched,
the performance can be slow as  the attributes of each spooled file  in
a specified output queue  must be converted to an  output file and then
scanned.  If you know the output queue, it is better to specify it.

Sequence of output
------------------

The  sequence  of the  output  should  be the  same  as  that shown  by
WRKSPLF.  The files in a RDY status  appear first.  The files in a  HLD
status appear  last.   Within each  status value,  the output  priority
determines the order.

FNDSPLF escape messages you can monitor for
--------------------------------------------

      TAA9891    No output queues were found to be searched

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

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

   OUTQ          The  qualified name of  the output queue  be searched.
                 A  specific  output  queue,  a  generic  name,  or the
                 special value *ALL may be specified.

                 The qualified  library  name  defaults to  *LIBL.    A
                 specific  library  or  the   special  values  *ALL  or
                 *CURLIB  may be  entered.   Specifying OUTQ(LIB1/*ALL)
                 may be used  to search all spooled  files in the  LIB1
                 library.

                 See also the OMITOUTQ parameter.

   SPLF          The spooled  file name  to be searched  for.   *ALL is
                 the   default  for  all  spooled   file  names.    Any
                 characters of a valid name  may be entered to allow  a
                 scan.

   JOB           The  job  name  to be  searched  for.    *ALL  is  the
                 default  for  all job  names.    Any  characters of  a
                 valid name may be entered to allow a scan.

   USER          The  user  name  to  be searched  for.    *ALL  is the
                 default for  all  user names.    Any characters  of  a
                 valid name may be entered to allow a scan.

   FORMTYPE      The  form  type to  be  searched  for.   *ALL  is  the
                 default  for all  form types.   Any characters  may be
                 entered to allow a scan.

   USRDTA        The user  data  to  be  searched for.    *ALL  is  the
                 default  for all  user data.   Any  characters may  be
                 entered to allow a scan.

   STATUS        The  status of  the spooled file  to be  searched for.
                 *ALL is  the default  for all  status values.    *RDY,
                 *HLD, or *SAV may be entered.

   OUTPTY        The  output  priority  of  the   spooled  file  to  be
                 searched  for.   *ALL is  the  default for  all output
                 priorities.  A value of 1 to 9 may be entered.

   STRDATE       The  start date to  be used.   The STRDATE and ENDDATE
                 values  are  used  to  form  a  range  to  check  each
                 spooled file for when it was opened.

                 *START  is the  default  meaning any  date.   *CURRENT
                 (today's  date) or a  specific date may  be entered in
                 job format.

   ENDDATE       The end  date to  be used.   The  STRDATE and  ENDDATE
                 values  are  used  to  form  a  range  to  check  each
                 spooled file for when it was opened.

                 *END  is  the  default  meaning  any  date.   *CURRENT
                 (today's date) or  a specific date  may be entered  in
                 job format.

   USRDFNDTA     Up  to 20  bytes  to search  the  'user defined  data'
                 value  which is 255  bytes.   *ALL is the  default for
                 all  'user  defined  data'.    Any  characters  may be
                 entered to allow a scan.

   OMITOUTQ      A  list  of up  to  10  output  queues  that  will  be
                 omitted.   The default  is *DMPLOG meaning  any output
                 queues  named QEZDEBUG  or QEZJOBLOG will  be omitted.
                 *NONE  or  a  specific  output  queue  name   must  be
                 specified   if  you   want  to   search  QEZDEBUG   or
                 QEZJOBLOG.

                 Note  there  is  no  library  qualifier.   Any  output
                 queue name  entered  will be  bypassed  regardless  of
                 the library it is found in.

   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 *ALLOBJ special authority to use FNDSPLF.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CHKSPLCTL       Check *SPLCTL special authority
     CVTOBJD4        Convert object description 4
     CVTOUTQ         Convert output queue
     DUPTAADBF       Duplicate TAA data base file
     EDTVAR          Edit variable
     EXTLST          Extract list
     EXTLST2         Extract list 2
     RTVDAT          Retrieve date
     RTVVALA         Retrieve value attributes
     RTVSYSVAL3      Retrieve system value 3
     SCNVAR          Scan variable
     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
   ------        ----    ---------      ----------    ----------

   FNDSPLF       *CMD                   TAASPPG       QATTCMD
   TAASPPGC      *PGM       CLP         TAASPPGC      QATTCL
   TAASPPGC2     *PGM       CLP         TAASPPGC2     QATTCL
   TAASPPGR      *PGM       RPG         TAASPPGR      QATTRPG
					

Added to TAA Productivity tools January 15, 2012


Home Page Up to Top