The Retrieve Object  Library command returns  the library name  where a
specified object  was found.   The libraries searched  are specified in
a  library group as defined by the TAA  LIBGRP tool.  The intent of the
tool is to  be used  as sub function  when the  library list cannot  be
used to identify all of the libraries where an object may exist.

A typical series of commands would be:

            DCL           &RTNLIB *CHAR LEN(10)
             .
            RTVOBJLIB     OBJ(xxx) OBJTYPE(*xxx)
                            LIBGRP(GRP1) RTNLIB(&RTNLIB)

The RTNLIB parameter  will contain the name of  the first library where
the  object  was  found  in the  list  of  libraries  described  by the
library group  GRP1  in the  LIBGRPP file,  The  search occurs  in  the
order the libraries are defined in the library group.

LIBGRP tool
-----------

The LIBGRP  tool allows  you to create  a list of  up to  25 libraries.
The basic commands that you need are:

             CRTLIBGRPD    - Creates the files necessary to hold
                                the list of libraries

             EDTLIBGRPD    - Allows entry of up to 25 libraries

RTVOBJLIB escape messages you can monitor for
---------------------------------------------

      TAA9892    The object was not found.
      TAA9896    The library group name does not exist

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

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

   OBJ           The object name to be searched for.

   OBJTYPE       The  object type to be  searched for.   For a complete
                 list of the possible  values, prompt for the  command.

   LIBGRP        The name  of  the library  group in  the LIBGRPP  file
                 containing  the  list  of  libraries to  be  searched.
                 The  LIBGRP  file  must  have  been  created  with the
                 CRTLIBGRPD  TAA  command.    Libraries   are  normally
                 entered  into the  library group  with the  EDTLIBGRPD
                 command.

   LIBGRPLIB     The   library  containing   the  library   group  file
                 LIBGRPP.   *LIBL  is  the  default.   *CURLIB  may  be
                 specified.

   RTNLIB        The  library  where   the  object  was  found.     The
                 variable must be specified as *CHAR LEN(10).

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

None.

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

The following TAA Tools must be on your system:

     LIBGRP          Library group
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   RTVOBJLIB     *CMD                   TAAOBKU       QATTCMD
   TAAOBKUC      *PGM       CLP         TAAOBKUC      QATTCL