TAA Tools
SCNCMDA         SCAN COMMAND ATTRIBUTES                TAACMFF

The Scan Command Attributes  command scans one or more  Command Objects
for attribute  values.  This  acts as a  simple query to  determine the
value of attributes of Command objects.

A typical command would be:

              SCNCMDA   ATTR(SRCMBR) CMD(xxx/*ALL)
                         SCNVAL(ABC) SCNOPR(*EQ)

A  spooled  file  would be  displayed  of  all Command  objects  in the
specified library that have a SRCMBR named ABC.

SCNCMDA escape messages you can monitor for
-------------------------------------------

      TAA9891    No Command Objects exist

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

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

   ATTR          The Command attribute  to be scanned  for.  The  value
                 must be one the following:

                 ALLOW.    Where  to  allow  the  command  to  be  run.
                 SCNOPR(*CT)  must be entered  when ALLOW is specified.
                 *ALL, *BATCH, *INTERACT,  *BPGM, *IPGM, *BREX,  *IREX,
                 *EXEC, *BMOD,  and *IMOD may be  entered.  If  a value
                 such as  *BPGM is entered and  the command allows *ALL
                 environments, *ALL is described in the listing.

                 ALWLMTUSR.   Whether to  allow  limited users  to  use
                 the command.    A scan  value of  *YES or  *NO may  be
                 entered.

                 CPP.  The command processing program.

                 CPPLIB.    The   library  of  the  command  processing
                 program.

                 CURLIB.   The  current library that  the command uses.
                 A name,  *NOCHG, or  *CRTDFT  may be  entered for  the
                 scan value.

                 HLPID.  The help ID assigned to the command.

                 HLPPNL.  The panel group containing the help text.

                 HLPPNLLIB.    The  library  containing the  help  text
                 panel.

                 MAXPOS.   The maximum number of  positions that can be
                 specified at a  positional point for  the command.   A
                 value of  *NOMAX or a number  between 0 and 75  may be
                 entered for the scan value.

                 MODE.     The  mode   the  command  may   be  run  in.
                 SCNOPR(*CT) must  be used.   *ALL,  *PROD, *DEBUG,  or
                 *SERVICE may  be entered  for the  scan value.   If  a
                 value  such  as  *DEBUG  is  entered and  the  command
                 supports  all modes, *ALL will  appear on the listing.

                 MSGF.  The message file used by the command.

                 MSGFLIB.   The  library  containing the  message  file
                 used by the command.

                 PMTFILE.   The message file used for  the prompt text.
                 *NONE may be specified for SCNVAL.

                 PMTFILELIB.   The library  containing the message file
                 used for the prompt text.

                 PMTOVR.   The  name of  the prompt  override  program.
                 *NONE may be specified for the scan value.

                 PMTOVRLIB.     The  library   containing  the   prompt
                 override program used by the command.

                 PRDLIB.    The  product library  to  be  used for  the
                 command.  A  name, *NOCHG, or  *NONE may be  specified
                 for SCNVAL.

                 SRCFILE.    The source  file  containing  the  command
                 source.

                 SRCLIB.   The library  for the source  file containing
                 the command source.

                 SRCMBR.    The  source member  containing  the command
                 source.

                 SRHINX.  The search index to be used.

                 SRHINXLIB.   The library  containing the search  index
                 to be used.

                 TEXT.   A  string of  characters  to be  found in  the
                 text description may be entered with SCNOPR(*CT).

                 THDSAFE.    A *YES  or *NO  may  be specified  for the
                 scan value for whether the command is thread safe.

                 VLDCKR.  The validity checking program to be used.

                 VLDCKRLIB.    The  library  containing  the   validity
                 checking program.

   CMD           The  qualified  name  of  the  Command  object  to  be
                 scanned.   A single  command, a generic  name, or *ALL
                 may be entered.

                 The library qualifier  defaults to  *LIBL.   *USRLIBL,
                 *CURLIB, *ALL,  *ALLUSR, *ALLUSR2,  *ALLNONQ, or  *IBM
                 may  be  entered.   For  a full  description  of these
                 values, see the CVTLIBOBJD command.

   SCNVAL        The  value to be scanned  for.  Up to  10 bytes may be
                 entered.

                 If  SCNOPR(*CT)  is  entered,  the  SCNVAL  should  be
                 entered   without   quotes    as   the   object   text
                 description  will  be  folded  to  upper  case  before
                 scanning.

   SCNOPR        The scan operator to be used.  *EQ is the default.

                 *NE, *GT,  *GE, *LT,  *LE, or  *CT  (contains) may  be
                 entered.   Non-meaningful functions  such as  scanning
                 the  THDSAFE  attribute (supports  only  *YES  or *NO)
                 for a scan operator  other than *EQ/*NE are  rejected.

   OUTPUT        How  to output  the  results.   *  is the  default  to
                 display  the spooled  file if  the command  is entered
                 interactively.   The spooled file  is deleted after it
                 is displayed.

                 If  the command  is  entered  in batch  or  *PRINT  is
                 specified, the  spooled file  is output  and retained.


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

None.

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

The following TAA Tools must be on your system:

     CVTCMDA         Convert command attributes
     CVTLIBOBJD      Convert library object description
     RTVVALA         Retrieve value attributes
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

Implementation
--------------

None, the tool is ready to use.

Objects used by the tool
------------------------

   Object        Type    Attribute      Src member    Src file
   ------        ----    ---------      ----------    ----------

   SCNCMDA       *CMD                   TAACMFF       QATTCMD
   TAACMFFC      *PGM       CLP         TAACMFFC      QATTCL
   TAACMFFR      *PGM       RPG         TAACMFFR      QATTRPG
					

Added to TAA Productivity tools July 15, 2009


Home Page Up to Top