TAA Tools

The Remove Source  Members command removes  members from a  source file
based on  a number of  retention days.   The comparison may  be made to
the  Create  Date,  the  Change  Date, or  the  Use  Date.    An ACTION
parameter exists and  defaults to *CHECK to  provide a listing of  what
would be removed.

For  typical source  files, RMVSRCMBR  would  rarely be  a good  choice
unless  a function like the SRCARC  tool was being used  to back up the
source and you  want to remove members  that have not  been used for  a
long time.

For source  files being used for  atypical functions, RMVSRCMBR  may be

You must have *ALLOBJ special authority to use RMVSRCMBR.

A typical command would be:

                  RMVSRCMBR    SRCFILE(xxx) DATTYP(*USEDAT)
                                 RTNDAYS(300) ACTION(*CHECK)

A  listing would  be displayed with  one line  per member and  the last
used date of each shown.   The members that have  not been used in  the
last  300   days  would  be   flagged.    Because   ACTION(*CHECK)  was
specified, no  members would be removed.   After reviewing the listing,
you may specify ACTION(*REMOVE) to remove the flagged members.

RMVSRCMBR escape messages you can monitor for

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

RMVSRCMBR Command parameters                          *CMD

   SRCFILE       The  qualified  name of  the source  file to  be used.
                 The  library value  defaults  to  *LIBL.   A  specific
                 library or *CURLIB may also be used.

   DATTYP        The  date type  to compare  against.   *CRTDAT (member
                 creation  date),  *CHGDAT  (last  change  date to  the
                 member), or *USEDAT  (last date  the member was  used)
                 may be specified.

   RTNDAYS       The  number of  days  to  retain the  source  members.
                 The  number  of days  is subtracted  from  the current
                 date and compared  against the type  of date for  each
                 member based on the DATTYP parameter.

                 For  example, if  RTNDAYS 7  is  specified along  with
                 DATTYP(*CRTDAT) and  the current date is  Jan 8, 2009,
                 any  members  created prior  to Jan  1, 2009  would be

   ACTION        The action to be taken.

                 *CHECK is  the default  which will  produce a  listing
                 of  the  members  and  flagging those  that  would  be

                 *REMOVE  may be specified  to remove  the members that
                 are flagged.

   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.


You must have *ALLOBJ authority to use RMVSRCMBR.


The following TAA Tools must be on your system:

     ADDDAT          Add date
     CHKALLOBJ       Check *ALLOBJ special authority
     CHKOBJ3         Check object 3
     CVTDAT          Convert date
     EDTVAR          Edit variable
     RSNLSTMSG       Resend last message
     RTVDBFA         Retrieve data base file attributes
     RTVDIAGMSG      Retrieve diagnostic message
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message


None, the tool is ready to use.

Objects used by the tool

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

   RMVSRCMBR     *CMD                   TAADBMF       QATTCMD
   TAADBMFC      *PGM       CLP         TAADBMFC      QATTCL
   TAADBMFC2     *PGM       CLP         TAADBMFC2     QATTCL
   TAADBMFR      *PGM       RPG         TAADBMFR      QATTRPG

Added to TAA Productivity tools April 15, 2009

Home Page Up to Top