The Select  Objects command  provides a  display of designated  objects
within  a library and  allows the  user to  select one.   Return fields
describe  the selected  object, type,  and attribute.   The  command is
designed for use  as a sub  function in an  application where the  user
wants to select  from a list of objects.  The  DMOSELOBJ command may be
used to try a demonstration of the function.

You  must  name a  specific library.    You may  then  select all  or a
generic set of objects subset by  type.  The default authority is  *USE
meaning the user  must have at least  'use' authority for an  object to
be displayed.

To try the demo, against all *JOBD objects in QGPL, enter:

             DMOSELOBJ     OBJ(QGPL/*ALL) OBJTYPE(*JOBD)

The  SELOBJ command returns  variables and  therefore may only  be used
in a CL program such as:

             DCL           &RTNOBJ *CHAR LEN(10)
             DCL           &RTNTYPE *CHAR LEN(7)
              .
             SELOBJ        OBJ(...)  OBJTYPE(*...) +
                             RTNOBJ(&RTNOBJ) RTNTYPE(&RTNTYPE)

SELOBJ escape messages you can monitor for
------------------------------------------

      TAA9891    F3 or F12 was used to end SELOBJ
      TAA9892    The object name and type does not select any objects

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

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

   OBJ           The qualified name  of the object  (or objects) to  be
                 displayed.   *ALL is  the default  for all objects  in
                 the  named library.   A specific  object or  a generic
                 object name may be entered.

                 A specific library must be entered.

   OBJTYPE       The  object  type to  be  displayed.   The  default is
                 *ALL for all object types.

                 For a  list of  the  supported object  types, see  the
                 command prompt.

   OBJATTR       The  object attribute  to to  be displayed.    A value
                 such  as RPG  may be  entered.   There is  no checking
                 for a valid attribute.

   AUT           The authority required to the  object.  The user  must
                 have at least  the authority specified for  the object
                 to be  included in the display.   The default is *USE.

                 *CHANGE or *ALL may be specified.

   RTNOBJ        The object  selected  by  the  user  (if  any).    The
                 return variable is  required and must be  specified as
                 *CHAR LEN(10).

                 If  the  user   does  not  select  an  object,  escape
                 messages TAA9891 or TAA9892 will be returned.

   RTNTYPE       The  type  of object  selected by  the user  (if any).
                 The  return   variable  is   required   and  must   be
                 specified as *CHAR LEN(7).

                 If  the  user  does   not  select  an  object,  escape
                 messages TAA9891 or TAA9892 will be returned.

   RTNATTR       The  attribute of the object selected  by the user (if
                 any).  The  return variable  is optional  and must  be
                 specified as *CHAR LEN(10).

                 If  the  user  does   not  select  an  object,  escape
                 messages TAA9891 or TAA9892 will be returned.

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

   OBJ           The  qualified name of  the object (or  objects) to be
                 displayed.  *ALL  is the  default for  all objects  in
                 the named  library.   A specific  object or a  generic
                 object name may be entered.

                 A specific library must be entered.

   OBJTYPE       The  object type  to  be  displayed.   The  default is
                 *ALL for all object types.

                 For  a  list of  the supported  object types,  see the
                 command prompt.

   OBJATTR       The object  attribute to  be displayed.   The  default
                 is  *ALL  for  all  object attributes.    No  checking
                 occurs on the value.

   AUT           The  authority required to the object.   The user must
                 have at least the  authority specified for the  object
                 to be included  in the display.  The  default is *USE.

                 *CHANGE or *ALL may be specified.

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

Because  SELOBJ  returns a  variable,  it  may only  be  used  in a  CL
program and must be used in an interactive job.

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

The following TAA Tools must be on your system:

     ADJVAR          Adjust variable
     CHKOBJ3         Check object 3
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message
     TAAEXC          TAA Execute command

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

None, the tool is ready to use.

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

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

   SELOBJ        *CMD                   TAAOBKO       QATTCMD
   DMOSELOBJ     *CMD                   TAAOBKO2      QATTCMD
   TAAOBKOC      *PGM       CLP         TAAOBKOC      QATTCL
   TAAOBKOC2     *PGM       CLP         TAAOBKOC2     QATTCL
   TAAOBKOR      *PGM       RPG         TAAOBKOR      QATTRPG
   TAAOBKOD      *FILE      DSPF        TAAOBKOD      QATTDDS

Structure
---------

SELOBJ      Cmd
   TAAOBKOC   CL pgm
     TAAOBKOR   RPG Pgm
       TAAOBKOD   Display  file

DMOSELOBJ   Cmd
   TAAOBKOC2  CL pgm