The Display Source Members command displays or prints source member
information from one or more source files with various selection
criteria. The selection options include source type, generic member
name, create date, change date, last used date, a scan of the member
name or text, and the number of existing records. DSPSRCMBRS
simplifies searching for source member information.
The QUSLMBR API is used by a sub tool to provide faster access to
source members than the DSPFD outfile function.
A typical command would be:
DSPSRCMBRS SRCFILE(*STD) LIB(xxx) CHGDATE(*TODAY)
All source members in the named library that had been changed today
in the standard source files (QCMDSRC, QCLSRC ...) would be
displayed.
The selection criteria is 'anded' together. For example, if you
specified:
DSPSRCMBRS SRCFILE(*STD) LIB(xxx) MBR(ABC*)
CHGDATE(*TODAY)
Only the member names beginning with ABC that had been changed today
would be displayed.
Note that only the member level information is accessed. The source
data itself is not processed.
DSPSRCMBRS escape messages you can monitor for
----------------------------------------------
TAA9894 No members were found to match the selections
TAA9896 More than 999 source files exist in the library
TAA9897 No source files exist in the library
Escape messages from based on functions will be re-sent.
Command parameters *CMD
------------------
SRCFILE The source file to be used. If a name is entered,
only that source file will be searched.
*ALL may be entered to mean all source files in the
library.
*STD may be specified to mean the standard file
names associated with source types described in
system help text. Only those source files that
exist and match those described by the PRTSRCTYP
tool will be checked. See the discussion with
PRTSRCTYP.
*SRC1, *SRC2, and *SRC3 mean that a data area must
exist on the library list by the corresponding names
of SRCLST1, SRCLST2, and SRCLST3. These data areas
must contain the name of the source files to be
checked. Only source files that exist and match one
of those found in the data area will be checked.
See the discussion with the CRTSRCFLST tool.
*QATT or *QATT2 may be specified to mean the only
files checked must match those described in the
RTVQATTF TAA Tool. This is either a short or long
list of QATTxxx source file names. Use the PRTQATTF
command for a listing of the files.
Using *QATT requires that you must know the Tool ID
to specify as the generic name. The Tool ID can be
determined using DSPTAA and the name in the upper
right hand corner of the first page. For example,
the Tool ID for ADDDAT is TAADATA. The *QATT values
only work against normal source files and not the
TAA Archive.
LIB The library for the source files. A library must be
named or *LIBL.
If a special value is used for the SRCFILE
parameter, a specific library must be named.
MBR The member or members to display. The default is
*ALL for all members.
A specific member name or a generic member name may
be entered.
SRCTYPE The source type to select. The default is *ALL for
all source types.
A specific source type may be entered. No checking
occurs on the value.
CRTDATE The create date to select. The default is to select
all dates.
*TODAY may be entered to select all those created
today.
*LASTWEEK may be entered to select all those created
in the last week.
*LASTMTH may be entered to select all those created
in the last month (last 30 days).
A specific date may be entered in job date format to
select all those created on or after the date
entered.
CHGDATE The change date to select. The default is to select
all dates.
*TODAY may be entered to select all those changed
today.
*LASTWEEK may be entered to select all those changed
in the last week.
*LASTMTH may be entered to select all those changed
in the last month (last 30 days).
A specific date may be entered in job date format to
select all those changed on or after the date
entered.
USEDATE The last used date to select. The default is to
select all dates.
*TODAY may be entered to select all those used
today.
*LASTWEEK may be entered to select all those used in
the last week.
*LASTMTH may be entered to select all those used in
the last month (last 30 days).
A specific date may be entered in job date format to
select all those last used on or after the date
entered.
SCANMBR Whether to scan the member name for a value. The
default is *NOSCAN meaning no scan occurs.
A value may entered such XXX to scan for all member
names that contain the value XXX.
SCANTEXT Whether to scan the member text for a value. The
default is *NOSCAN meaning no scan occurs.
A value may entered such as 'update' to scan for all
member text descriptions that contain the value
'update'. Both the value entered and the member
text description are translated to upper case before
the scan occurs.
RCDCNT A two part parameter that determines whether to
select on the number of records that exist in a
member. The default is *NONE.
The parameter allows you to do typical searches such
as 1) all members with no records 2) all members
with more than 5000 records.
The first part is the 'record operator' that
determines the type of comparison. The default is
*NONE meaning no select occurs on the number of
records. The values *EQ, *NE, *GE, *GT, *LE, or *LT
may be entered.
The second part is the number of records associated
with the 'record operator'. The default is *NONE
meaning the number of records in a member will not
be considered for selection.
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
------------
None.
Prerequisites
-------------
The following TAA Tools must be on your system:
ADDDAT Add date
CHKGENERC Check generic
CHKOBJ3 Check object 3
EDTVAR Edit variable
MOVCHRDEC Move character to decimal
RTVDAT Retrieve date
RTVLIBSRCF Retrieve library source files
RTVMBRLST2 Retrieve member list 2
RTVSYSVAL3 Retrieve system value 3
SCNVAR Scan variable
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDSTSMSG Send status message
TRNVAL Translate value
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
DSPSRCMBRS *CMD TAADBKTC QATTCMD
TAADBKTC *PGM CLP TAADBKTC QATTCL
TAADBKTR *PGM RPG TAADBKTR QATTRPG
|
