FIND2 -- Find 2 - Finds Objects and Sends Messages

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

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