TAA Tools
FNDOBJTXT       FIND OBJECT TEXT                       TAAOBKS

The Find  Object Text command  searches for a  string of characters  in
the  object descriptions in  a single  library, multiple  libraries, or
all  libraries.  Either messages are sent  or a spooled file is output.
The intent of FNDOBJTXT is  to assist you when you cannot  remember the
object  name, but  you do  remember some  string of  characters  in the
object text.

You  must have *ALLOBJ special authority to  specify a library value of
*ALL, *ALLUSR, *ALLUSR2, or *IBM.

A typical command would be:

         FNDOBJTXT   STRING(xxx) LIB(LIBA)

Messages would  be  produced  for  all objects  that  have  the  string
within  the  text description  of  any  object  in  the library.    For
example the string might be 'save' or 'copy'.

If  the string  contains a  blank, it  must be  quoted such  as 'search
technique'.

Both the string and the text  description of the object are  translated
to upper case before scanning the text.

FNDOBJTXT escape messages you can monitor for
---------------------------------------------

      TAA9892    No objects exist in the library
      TAA9893    The string is not found in any object text
      TAA9894    The library does not exist

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

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

   STRING        The string  to  be searched  for in  the object  text.
                 Up to 30 bytes may be entered.

                 If  the string  contains a  blank,  it must  be quoted
                 such as 'search technique'.

                 Both  the string  entered and the  text description of
                 the  object  are  translated  to  upper   case  before
                 scanning the text.

   LIB           The  library containing  the object  to be  checked or
                 the   special   values   *LIBL,   *USRLIBL,   *CURLIB,
                 *ALLUSR, *ALLUSR2, *IBM, or *ALL.

                 A generic library name may  also be entered.  The  API
                 used does  not support  a generic  library name.   The
                 function  occurs  by using  *ALL for  the  library and
                 then selecting the individual  objects to see if  they
                 exist in  the generic library  name.  Because  of this
                 approach, if  a short generic object  name is entered,
                 the  performance can be slow  as many objects may need
                 to be  accessed and  checked for  the generic  library
                 name.

                 For *LIBL  and *USRLIBL, if a  current library exists,
                 it will also be searched.

                 *ALLUSR  means  any library  that was  not  created by
                 the system according to the CHKIBMLIB command.

                 *ALLUSR2 means  any library  that meets  the  criteria
                 specified  for   the  SAVLIB   LIB(*ALLUSR)  function.
                 This   excludes  #  libraries  such   as  #SEULIB  and
                 includes QUSRSYS, QGPL,  etc.  See  the help text  for
                 the SAVLIB LIB  parameter for a  complete description.

                 An entry  of *IBM causes all libraries  to be included
                 as per the definition of the CHKIBMLIB tool.

                 Product libraries are never included.

   OBJTYPE       The  object type to  be searched for.   The default is
                 *ALL.  See the command prompt for a complete list.

   OUTPUT        How  the  output  should  be  presented.    *  is  the
                 default and  means that messages  will be sent  if the
                 command  is executed  interactively.   If  the command
                 is executed in batch, a spooled file is created.

                 *PRINT may be specified to cause a spooled file.

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

You must have  *ALLOBJ authority to  specify a library  value of  *ALL,
*ALLUSR, *ALLUSR2, or *IBM.

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

The following TAA Tools must be on your system:

     CHKALLOBJ    Check *ALLOBJ special authority
     CHKOBJ3      Check object 3
     CVTLIBOBJD   Convert library object description
     EDTVAR       Edit variable
     PRINT        Print from a CL program
     RTVOBJLST    Retrieve object list
     RTVVALA      Retrieve variable attributes
     SNDCOMPMSG   Send completion message
     SNDESCMSG    Send escape message
     SNDSTSMSG    Send status message
     TRNVAL       Translate value

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

None, the tool is ready to use.

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

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

   FNDOBJTXT     *CMD                   TAAOBKS       QATTCMD
   TAAOBKSC      *PGM       CLP         TAAOBKSC      QATTCL
					

Added to TAA Productivity tools March 15, 2003


Home Page Up to Top