The Check TAA Command checks for TAA commands in a source file or all
source files in a library or all libraries. The command is helpful
for determining what usage is being made of TAA commands. See also
the Determining TAA Tool usage option on HELPTAA.
A typical command would be:
CHKTAACMD SRCFILE(LIBA/*ALL)
All source files in LIBA would be checked. Only members of a CL type
(such as CLP, CL, CLP38, CLLE) are checked. Non-CL source types are
bypassed.
If a member is a CL type, the source is checked to determine if it
has any commands which do not exist in QSYS, but do exist in TAATOOL.
See the later discussion concerning commands in QSYS.
A spooled file is output with one line for each TAA command found in
a statement. A summary of one line per command and a total count is
also provided.
You may check a specific source file in a library, all source files
in a library, all source files in the system, or all source files in
libraries that do not start with the letter Q.
An option exists to omit named libraries.
If a command cannot be found or invalid syntax exists, it will be
flagged in the listing.
Comparison with the CHKUSRCMD command
-------------------------------------
The CHKUSRCMD checks for either user or TAA commands. CHKTAACMD is a
subset and checks only for TAA commands. The purpose of a separate
command is to assist users in finding the command name.
Identifying a Command
---------------------
Commands are found by searching the source and scanning for a command
name in valid CL syntax. Commands within variables (such as used in
QCMDEXC) are not found. Commands specified for parameters like CMD
on SBMJOB are found.
Identifying a TAA Command
-------------------------
From a system viewpoint, a TAA command is a user command. CHKTAACMD
identifies a TAA command if the command name exists in the TAA
Archive and the library value is:
- Blank (meaning the library list is used)
- Qualified to TAATOOL
- Qualified to the TAA Productivity Tool command library
(as specified on install or with DUPTAACMD)
TAA Source
----------
When the TAA Productivity Tools are shipped, there are some empty
source files in TAATOOL. The source for the tools is kept in an
archive which is not a standard source file. For this reason,
CHKTAACMD will not find any TAA commands within the source files of
TAATOOL unless you have copied out some of the source.
Commands in QSYS
----------------
The CHK400CMD TAA Tool is used to identify the user commands. It
does this by checking CL source for each command name found and then
checking against an array of command names within the tool programs.
The CHK400CMD tool is built using the commands for the current
release and a few program products. Most system program products
place their commands in QSYS as part of the install of the product.
If you re-create the CHK400CMD tool, it will use the commands from
your version of QSYS. You may also add or omit certain commands by
describing them in specific members within the TAASECURE library.
See the discussion with the CHK400CMD tool.
Command parameters *CMD
------------------
SRCFILE The qualified file name of the source file to be
checked. Either a specific source file may be named
or the special value *ALL for all source files.
You must have *ALLOBJ special authority to specify
LIB(*ALL) or LIB(*ALLUSR).
The library qualifier defaults to *LIBL. *LIBL may
only be used when a specific file is named.
If *ALL source files are requested, you may name a
specific library, *ALL for all libraries, or
*ALLUSR2 for all normal user libraries.
*ALLUSR2 includes all libraries that do not begin
with the letter Q plus the QGPL library and excludes
the S/36 libraries #LIBRARY, #CGULIB, #COBLIB,
#DFULIB, #RPGLIB, #SDALIB, #SEULIB, and #DSULIB.
OMITLIBS A list of up to 40 libraries to be omitted if the
qualified library name for the SRCFILE parameter is
*ALL or *ALLUSR2. The default is *NONE.
DETAIL A *YES/*NO option for whether a detail line will be
printed for each command found which includes the
member and sequence number.
*YES is the default to provide the detail listing.
*NO may be specified to provide the summary only.
Restrictions
------------
** The CHK400CMD tool is used to determine user commands. It has
restrictions relative to how a command is interpreted from
source.
** You must have *ALLOBJ special authority to specify LIB(*ALL)
or LIB(*ALLUSR).
** See also the previous comments in the documentation.
Prerequisites
-------------
The following TAA Tools must be on your system:
CHK400CMD Check 400 command
CVTLIBDBF Convert library data base files
EDTVAR Edit variable
EXTLST2 Extract list 2
RTVSYSVAL3 Retrieve system value 3
RTVTAALIC Retrieve TAA license
SNDCOMPMSG Send completion message
SNDESCINF Send escape information
SNDESCMSG Send escape message
SNDJLGMSG Send job log message
Implementation
--------------
None, the tool is ready to use.
Objects used by the tool
------------------------
Object Type Attribute Src member Src file
------ ---- --------- ---------- ----------
CHKTAACMD *CMD TAATOMJ QATTCMD
TAATOMJC *PGM CLP TAATOMJC QATTCL
TAATOMJR *PGM RPG TAATOMJR QATTRPG
|
