TAA Tools
FIND2           FIND 2                                 TAAOBKB

The Find  2 command is  intended to assist  you in identifying  all the
objects of  a generic name on the library  list, in a specific library,
all libraries, etc.  Messages are returned when an object is found.

The  command works best  on the full command  entry display (CALL QCMD)
where more message lines exist than with a command line on a menu.

A typical command would be:

             FIND2 ABC

All generic ABC objects on  the user portion of the library  list would
be searched for and a message would appear for each one found.

You may also ask for all ABC generic objects on the system such as:

             FIND2     OBJ(*ALL/ABC)

You can also do the following:

       - Request by specific object type
       - Request all of a specific type
       - Request a non-generic search
       - Request for a specific library, *LIBL,
           *CURLIB, *ALL, or *ALLUSR

For  each  object  found, a  message  is  sent  with the  object  name,
library,  type, object attribute, and  an abbreviated text description.

By  default, after  15  detail  messages  have  been  sent,  a  summary
message is sent describing the total number of objects found.

Comparison with CHKOBJ4
-----------------------

CHKOBJ4 is  a similar  command, but  uses the  system convention  where
you must enter a generic name to gain the generic function.

Performance
-----------

The  TAA Tool  RTVOBJLST is  used to  retrieve the  object information.
It uses the QUSLOBJ API.

If you  limit your  request so  that hundreds  of objects  will not  be
found, the performance is  usually very good.  Requesting  a search for
all libraries or all user libraries takes longer.

The API  used does not  support a generic  library name.   If a generic
library  is specified, the object parameter will  be used in the API to
access the named  object in all  libraries.  If  a generic object  name
is used, this  may result in many objects being  returned from the API.
The  individual objects are  then checked to  see if they  exist in the
generic library  name.   If  many  objects are  to  be checked,  it  is
possible that 0 messages will be produced.

Authorization considerations
----------------------------

You must be authorized  to the library that is  specifically named.  If
not, an escape message will occur.

If  a library  you are  not authorized  to is  included in  the special
library value (such as *ALLUSR), the objects are not considered.

If you are  authorized to the  library, but not  the object, a  special
string of text will appear in the object Text description.

Locks, damage, etc.
-------------------

If an  object  is exclusively  locked or  damaged,  an indication  will
appear in the text description.

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

   OBJ           The  qualified name of  the object  to be found.   The
                 string  of  characters  that  are  entered  must  be a
                 name, but  is treated as  a generic  value by  default
                 (do not  enter an *).   See the GENERIC  parameter for
                 a  non-generic  search.   The special  value  *ALL may
                 also be used.

                 The  library  value  defaults  to  *LIBL.     *CURLIB,
                 *USRLIBL, *ALL, or *ALLUSR may also be specified.

                 A generic library  name may also be entered,  but if a
                 short   generic  object   name   is  also   used,  the
                 performance may be much slower  and 0 messages may  be
                 produced.       See    the    previous   section    on
                 'Performance'.

   OBJTYPE       The  object type to  be checked  for.  The  default is
                 *ALL.    For  a  full  list  of  the  supported object
                 types, use the command prompting facility.

   GENERIC       A  *YES/*NO  value  for  whether  the   object  to  be
                 searched  will  use  a  generic  name.   *YES  is  the
                 default.

                 *NO  may be  specified to cause  a search  only by the
                 object name.

   MAXMSGS       The maximum  number  of duplicate  objects  for  which
                 detail messages  will appear.  The  default is 15.   A
                 summary  message will  describe the number  of objects
                 that match  the criteria  and  whether all  appear  as
                 detail messages.   If you  want a different  number of
                 detail messages,  you may enter a value  between 1 and
                 75.

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

See the previous comments.

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

The following TAA Tools must be on your system:

     EDTVAR          Edit variable
     RTVOBJLST       Retrieve object list
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   FIND2         *CMD                   TAAOBKB       QATTCMD
   TAAOBKBC      *PGM       CLP         TAAOBKBC      QATTCL
					

Added to TAA Productivity tools May 1, 1998


Home Page Up to Top