TAA Tools
DSPEMTSAVF      DISPLAY EMPTY SAVE FILE                TAASAWP

The Display  Empty  Save File  command displays  or lists  one or  more
save files  that have no objects.   The default is to  bypass save file
names  beginning  with  Q  as  there may  be  many  PTF  save  files in
existence.

You must have *ALLOBJ special  authority to use DSPEMTSAVF for  *ALL or
*ALLUSR libraries.

A typical command would be:

             DSPEMTSAVF LIB(xxx)

A display would  appear with one line per save file  that does not have
any  objects.   Any save file  names beginning  with Q  are bypassed by
default.

DSPEMTSAVF escape messages you can monitor for
----------------------------------------------

      TAA9891    No save files exist

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

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

   SAVF          The save file to  be checked.   A generic name may  be
                 used.  The special value *ALL may be used.

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

   BYPQNAMES     A  *YES/NO  value  for  whether  to  bypass save  file
                 names beginning with Q.

                 *YES is  the  default.   This  will  bypass  PTF  save
                 files, but will  also bypass any save file  names that
                 you have created that start with Q.

                 *NO  may  be  specified  to  process  all  save  files
                 named.

   ASPDEV        Specifies  the  auxiliary  storage  pool  (ASP) device
                 name  where storage  for  the library  containing  the
                 object  is allocated.   If the  library resides  in an
                 ASP  that is  not  part of  the thread's  library name
                 space, this  parameter  must be  specified  to  ensure
                 the correct library is searched.

                 This  parameter can  be  specified as  a  list of  two
                 values  (elements)   or  as  a  single   value.    The
                 possible single values are:

                 * = The ASPs that  are currently part of the  thread's
                 library  name space  will be  searched  to locate  the
                 library.   This includes the  system ASP (ASP  1), all
                 defined  basic  user  ASPs (ASPs  2-32),  and,  if the
                 thread has  an ASP  group, the  primary and  secondary
                 ASPs in the thread's ASP group.

                 *ALLAVL =  All available ASPs will be  searched.  This
                 includes  the system  ASP (ASP  1), all  defined basic
                 user ASPs (ASPs 2-32),  and all available primary  and
                 secondary  ASPs,  (ASPs  33-255)   with  a  status  of
                 'Available'.

                 *CURASPGRP  =  If the  thread  has an  ASP  group, the
                 primary and secondary ASPs  in the thread's ASP  group
                 will be  searched to locate  the library.   The system
                 ASP (ASP  1) and defined  basic user ASPs  (ASPs 2-32)
                 will  not be searched.  If  no ASP group is associated
                 with the thread, an error will be issued.

                 *SYSBAS =  The  system ASP  (ASP  1) and  all  defined
                 basic  user  ASPs  (ASPs  2-32) will  be  searched  to
                 locate  the  library.   No primary  or  secondary ASPs
                 will be  searched  even  if  the  thread  has  an  ASP
                 group.

                 Element 1: Device

                 The device  name of  the primary  or secondary ASP  to
                 be searched.   The primary or  secondary ASP must have
                 been activated  (by varying  on  the ASP  device)  and
                 have a  status of  'Available'.   The system ASP  (ASP
                 1) and  defined user basic  ASPs (ASPs 2-32)  will not
                 be searched.

                 Element 2: Search type

                 Specifies   whether  the  single  ASP  device  or  the
                 entire  ASP  group  named  in  element  1  is   to  be
                 searched.

                 *ASP  =  Specifies  that  only  the  single  auxiliary
                 storage  pool (ASP)  device named  in element 1  is to
                 be searched.

                 *ASPGRP =  Specifies  that  the entire  group  of  the
                 primary auxiliary  storage pool (ASP) device  named in
                 element 1 is to be searched.

   OUTPUT        How  to  output the  results.   *  is  the  default to
                 display the  spooled file  if the  command is  entered
                 interactively.   If the display  is ended  with F3/F12
                 or the  Enter key, the  spooled file is  deleted after
                 it  is  displayed.   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
------------

You must  have  *ALLOBJ special  authority  to  use DSPEMTSAVF  with  a
library value of *ALL or *ALLUSR.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CHKOBJ3         Check object 3
     CVTOBJD6        Convert object description 6
     CVTOBJD6        Convert object description 6
     RSNLSTMSG       Resend last message
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   DSPEMTSAVF    *CMD                   TAASAWP       QATTCMD
   TAASAWPC      *PGM       CLP         TAASAWPC      QATTCL
   TAASAWPR      *PGM       RPG         TAASAWPR      QATTRPG
					

Added to TAA Productivity tools October 15, 2012


Home Page Up to Top