TAA Tools
SCNSAVFA        SCAN SAVE FILE ATTRIBUTES              TAASAWR

The Scan  Save File  Attributes command  scans one or  more save  files
for attribute  values.  For example, you could  scan for all save files
that  have  more than  100 records.   This  acts as  a simple  query to
determine the value of attributes of save files.

A typical command would be:

              SCNSAVFA  ATTR(NBRRCD) FILE(xxx/*ALL)
                         SCNVAL(500) SCNOPR(*GT)

A spooled  file would  be  displayed of  all save  files  in the  named
library that have more than 500 records.

SCNSAVFA escape messages you can monitor for
--------------------------------------------

      TAA9891    No save files were found for the specified parameters

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

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

   ATTR          The  Save  File attribute  to  be  scanned  for.   The
                 value must be one of the following:

                 ASP.   The ASP where the save  file exists.  A numeric
                 scan value must be used.

                 MAXRCD.   The  maximum  number  of  records  that  may
                 exist in  the save  file.  A  numeric scan  value must
                 be used or the special value *NOMAX.

                 NBRRCD.    The number  of  records that  exist  in the
                 save file.  A numeric scan value must be used.

                 SHARE.   Whether  the  file  open  data  path  may  be
                 shared.  The scan value must be *YES or *NO.

                 TEXT.   The member text.   The  scan operator must  be
                 *CT.    The scan  value  should  be  entered in  upper
                 case.    The  object  text  is  folded  to  upper case
                 before  scanning.   Trailing  blanks are  trimmed  off
                 the scan value.

                 WAITFILE.   The number of  seconds to wait for  a lock
                 to  be satisfied  when opening  a save  file.   If the
                 scan value is *IMMED or  *CLS, the scan operator  must
                 be *EQ or *NE.  A numeric value may be entered.

   FILE          The qualified  name of  the save  file to be  scanned.
                 A  single  file,  a  generic  name,  or  *ALL  may  be
                 entered.

                 The library  qualifier defaults  to *LIBL.    *CURLIB,
                 *USRLIBL, *ALL, *ALLUSR, or *IBM may be entered.

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

                 To scan for blank entries, leave the value blank.

                 If   SCNOPR(*CT)   is  entered   when   ATTR(TEXT)  is
                 specified,   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 SHARE 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 it  is ended with F3/F12 or  the Enter
                 key.   To  retain the  spooled file,  you may  use the
                 the  System Request 'Cancel'  function and the spooled
                 file will exist in a HLD status.

                 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:

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

   SCNSAVFA      *CMD                   TAASAWR       QATTCMD
   TAASAWRC      *PGM       CLP         TAASAWRC      QATTCL
   TAASAWRR      *PGM       RPG         TAASAWRR      QATTRPG
					

Added to TAA Productivity tools October 15, 2013


Home Page Up to Top