The Scan Command  Usage command uses  the output from  CVTCMDUSG (which
uses the  system PRTCMDUSG information) to determine  which CL programs
are  using a  specific command.   The  source is  checked to see  if it
still exists and is flagged if  it does not.  An option exists  to scan
the source for a specific keyword used on the command.

The library  parameter allows  for a single  library or  special values
*ALL  or *ALLUSR.   An *ALLOBJ user  is required if  specifying *ALL or
*ALLUSR.

A typical  command  to scan  for  all programs  in  LIB1 that  use  the
FMTOPT parameter of CPYF would be:

             SCNCMDUSG     LIB(LIB1) CMD(CPYF) KWD(FMTOPT)

A listing would  be produced with one  line for each program  that uses
CPYF.   An indication would exist if the  source exists and whether the
keyword has been used on the command.

Considerations
--------------

  **   Because the  dependent  command CVTCMDUSG  reads  the  PRTCMDUSG
       spooled file listing, it  is release dependent.  Only  the lower
       and  upper case  English language  versions  are supported.   If
       the  format  of  the  PRTCMDUSG spooled  file  is  changed  on a
       subsequent release, the program must be modified.

  **   Scanning for  a keyword is  done using a  program which is  part
       of  the SCNCMDKWD  tool.   See  the  Considerations section  for
       this tool.

SCNCMDUSG escape messages you can monitor for
---------------------------------------------

None.  Escape messages from based on functions will be re-sent.

Command parameters                                    *CMD
------------------

   LIB           The  library to be scanned for  CL program objects.  A
                 specific library may be named or special values.

                 *USRLIBL may  be specified  to  scan for  programs  in
                 the user portion of the library list.

                 *ALL  may be  specified to  scan for  all programs  on
                 the  system.    You  must  have  *ALLOBJ authority  to
                 specify *ALL.

                 *ALLUSR may be specified to  scan for all programs  in
                 user libraries.   You must  have *ALLOBJ  authority to
                 specify *ALLUSR.

   CMD           The command to be scanned for.

   KWD           The  keyword on the  command to  be scanned for.   The
                 default  is  *NONE,  meaning  the  listing  will  only
                 describe the  programs that  contain  the command  and
                 whether the source used for the program exists.

                 If  a keyword  is  named, all  programs  that use  the
                 specified  command (if  the source still  exists where
                 the program  was created  from) will  have the  source
                 scanned for  use of  the keyword.   If the  keyword is
                 used on the command, the program is flagged.

   OMITLIB       A  list of up  to 40 libraries  to be omitted.   *NONE
                 is the default meaning no libraries are omitted.

Restrictions
------------

See the Considerations section.

Prerequisites
-------------

The following TAA Tools must be on your system:

     CHKALLOBJ       Check *ALLOBJ special authority
     CVTCMDUSG       Convert command usage
     CVTLIBOBJD      Convert library object description
     EXTLST2         Extract list 2
     FILEFDBCK       File feedback
     HLRMVMSG        HLL Remove message
     RTVSYSVAL3      Retrieve system value 3
     SCNCMDKWD       Scan command keyword
     SNDCOMPMSG      Send completion message
     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
   ------        ----    ---------      ----------    ----------

   SCNCMDUSG     *CMD                   TAACMEJ       QATTCMD
   TAACMEJC      *PGM       CLP         TAACMEJC      QATTCL
   TAACMEJC11    *PGM       CLP         TAACMEJC11    QATTCL
   TAACMEJC21    *PGM       CLP         TAACMEJC21    QATTCL
   TAACMEJR21    *PGM       RPG         TAACMEJR21    QATTRPG

Structure
---------

SCNCMDUSG   Cmd
   TAACMEJC   CL pgm
     TAACMEJC11  CL pgm  - Does CVTCMDUSG for each library
   TAACMEJR21  RPG pgm  - Read CVTCMDUSG file and prints
     TAACMEJC21  CL pgm  - Checks src existence - Calls SCNCMDKWD
       TAACMEIR12  RPG pgm - Scan source if kwd required