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
useful.
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
removed.
ACTION The action to be taken.
*CHECK is the default which will produce a listing
of the members and flagging those that would be
removed.
*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.
Restrictions
------------
You must have *ALLOBJ authority to use RMVSRCMBR.
Prerequisites
-------------
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
Implementation
--------------
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
|
