TAA Tools
CHKTAACMD       CHECK TAA COMMAND                      TAATOMJ

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
					

Added to TAA Productivity tools February 1, 2005


Home Page Up to Top