The Print Generic Source command prints all of the source members for
a specified generic name. Either a single source file, all source
files, standard source files, or the QATT source files in a library
may be printed.
A typical command would be entered as:
PRTGENSRC GENNAME(PAYX) SRCFILE(*STD)
All of the members beginning with PAYX would be printed from the
standard source files (QCMDSRC, QCLSRC etc.). The TAA tool PRTSRCF
is used to print each member.
Note that no * is needed for the generic name.
If SRCFILE(*QATT) is used, you 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 this tool is TAASRCS.
Command parameters *CMD
------------------
GENNAME The generic name of the member to be printed. If
the value does not contain an * at the end, generic
is assumed.
Note that there is no method of specifying an
individual member unless there is only one matching
a generic name. (Use PRTSRCF directly).
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.
If *STD is specified and the QCMDSRC file exists,
any members are listed first.
*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.
If *QATT is specified and the QATTCMD file exists,
any members are listed first.
LIB The library for the source files. The default is
*LIBL.
If a special value is used for the SRCFILE
parameter, a specific library must be named.
OUTQ The output queue name where the output should be
spooled to. The default is *JOB.
CHGBARS If change bars are desired, this is a 6 digit date
field in job format to use for a comparison against
the source statement change date. A change bar will
print if the parameter date is less than or equal to
the source statement date.
CHGBARCHAR The change bar character that will be printed if
change bars are requested. An '*' is the default.
Restrictions
------------
There is a limit of 999 source files in a library and 900 that match
a generic name.
Prerequisites
-------------
The following TAA Tools must be on your system.
EDTVAR Edit variable
RTVLIBSRCF Retrieve library source file
RTVMBRLST Retrieve member list
PRTSRCF Print source file member
SNDCOMPMSG Send completion message
SNDESCMSG Send escape message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
PRTGENSRC *CMD TAASRCS QATTCMD
TAASRCSC *PGM CLP TAASRCSC QATTCL
|
