The Scan Generic Source Description command provides a simple display
or listing of generic source members. An option exists to select by
source change date. One line per member appears. Either a single
source file, all source files, standard source files, or the QATT
source files in a library may be requested.
A typical command would be:
SCNGENSRCD GENNAME(ABC) SRCFILE(*STD)
Note that no * is needed for the generic name.
If the command is entered interactively, a display would appear with
all members beginning with ABC in the standard source files (QCMDSRC,
The default for the LIB parameter is *DFT.
The library to be searched when LIB(*DFT) is used is determined by
the following sequence of rules:
** A search is made for the STDSRCLIB *DTAARA on the library
list. If it is found, the library where the data area exists
** The current library is used if it is other than *NONE.
** The first library on the library list is used.
To use the STDSRCLIB *DTAARA technique, create a data area in your
normal source file library as:
CRTDTAARA DTAARA(xxx/STDSRCLIB) TYPE(*CHAR) LEN(10)
TEXT('Used by TAA SCNGENSRCD tool')
SCNGENSRCD escape messages you can monitor for
TAA9897 No source files exist
Escape messages from based on functions will be re-sent.
Command parameters *CMD
GENNAME The generic name of the member description to be
displayed or listed. The value need not contain an
* at the end for generic to be assumed.
Note that there is no method of specifying an
individual member unless there is only one matching
a generic name.
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
*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
*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.
LIB The library for the source files.
The default is *DFT. This causes the library to be
determined by the following sequence of rules:
1) A search is made for the STDSRCLIB *DTAARA
on the library list. If it is found, the
library where the data area exists is used.
2) The current library is used if it is other
3) The first library on the library list is
To use the STDSRCLIB *DTAARA technique, create a
data area in your normal source file library as:
TEXT('Used by TAA SCNGENSRCD tool')
A specific library or *LIBL may be used. *LIBL may
not be used if a special value is used for SRCFILE.
CHGDATE The source change date to select only those members
that have a source change date on or after the date
*NONE is the default meaning no selection occurs on
the change date.
*TODAY may be entered as a shorthand for today's
A date may be entered in job date format to select
only those members that have been changed on or
after the date.
OUTPUT The type of output. * is the default to display the
results if the command is entered interactively.
If the command is entered in batch or *PRINT is
specified, a listing is output.
Up to 999 source files may exist in a library.
The first 999 source members in a source file based on the generic
name given will be processed.
The following TAA Tools must be on your system:
CHKGENERC Check generic
CHKOBJ3 Check object 3
CVTTIM Convert time
EDTVAR Edit variable
RTVDAT Retrieve date
RTVLIBSRCF Retrieve library source files
RTVMBRLST Retrieve member list
RTVSYSVAL3 Retrieve system value 3
SNDCOMPMSG Send completion message
SNDDIAGMSG Send diagnostic message
SNDESCINF Send escape information
SNDESCMSG Send escape message
None, the tool is ready to use.
Objects used by the tool
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
SCNGENSRCD *CMD TAASREW QATTCMD
TAASREWC *PGM CLP TAASREWC QATTCL
TAASREWR *PGM RPG TAASREWR QATTRPG