The   Convert   Module  Information   command   converts   the   module
information   for  ILE  *PGM   objects  and   *SRVPGM  objects.     The
information  is accessed  from *PGM  or *SRVPGM  objects as  opposed to
*MODULE objects.   An  outfile is created  with one  record per  module
with descriptive fields  for the object as well as  the module (such as
the source file and type used to create the module).

Only  'bound by  copy' modules  within the *PGM  or *SRVPGM  object are
converted.

The model file is TAAPGMYP with a format name of MODRCDR.

A typical command would be:

             CVTMODINF    LIB(ABC) MODULE(*ALL) OUTLIB(QTEMP)

All the ILE  *PGM objects  and *SRVPGM  objects would be  found in  the
ABC library.   The module information would be extracted  from each and
written to the outfile MODINFP in QTEMP.

A list  of up to 40 libraries may be  named.  The special value *ALLUSR
or *USRLIBL may also be entered  with an optional list of libraries  to
be  omitted.   If *ALLUSR  is  specified, the  user  must have  *ALLOBJ
authority.

The  default  is  to  extract  information  for both  types  (ILE  *PGM
objects and *SRVPGM objects).  A specific type may also be named.

If  one  of the  libraries named  does not  contain  any of  the object
types described, a diagnostic message is sent.

If none  of the libraries  contain any of  the object types  requested,
an escape message occurs.

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

   LIB           A  list  of  up  to  40  libraries  to  extract  from.
                 *ALLUSR  may be entered for all  user libraries if the
                 the user  has *ALLOBJ  authority.   *USRLIBL may  also
                 be entered.

   OBJECT        The  object  name  to  be  converted.    *ALL  is  the
                 default  for all  objects in the  named libraries.   A
                 single object name or a  generic name may be  entered.

   OBJTYPE       The object  type  to be  considered.   The default  is
                 *ALL  meaning  to access  both  ILE  *PGM objects  and
                 *SRVPGM   objects.    *PGM  or  *SRVPGM  may  also  be
                 entered.

   OUTLIB        The  library  to  contain  the  MODINFP  file.     The
                 default  is *LIBL  meaning  the  file already  exists.
                 If  the file does  not exist, a  specific library must
                 be used.

   OUTMBR        The member  to  be used  in  the  MODINFP file.    The
                 default is MODINFP.

   REPLACE       A  *YES/*NO value  for  whether the  member should  be
                 cleared  before writing records into  it.  The default
                 is *YES.

                 *NO may be  specified to  add records  to the  MODINFP
                 file.

   OMITLIBS      Up to  40  library names  that may  be  omitted.   The
                 intent is  to be able  to omit certain  libraries when
                 *ALLUSR   or  *USRLIBL  are   specified  for  the  LIB
                 parameter.  *NONE  must be used if  specific libraries
                 are named.

   COMPMSG       The type  of completion message  to be sent.   *NORMAL
                 is the default.

                 *SHORT   may  be   specified  to  provide   a  message
                 containing  only  the  number  of  modules  converted.
                 This  is  intended  for  use   by  other  tools  using
                 CVTMODINF.

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

If  LIB(*ALLUSR)  is  specified, the  user  must  have *ALLOBJ  special
authority.

Only 'bound by  copy' modules  within the  *PGM or  *SRVPGM object  are
converted.

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

The following TAA Tools must be on your system:

     CHKALLOBJ       Check all object
     DUPFILFMT       Duplicate file format
     EDTVAR          Edit variable
     EXTLST          Extract list
     RTVILEMODA      Retrieve ILE module attributes
     RTVPGMA         Retrieve program attributes
     RTVSRVMODA      Retrieve service module attributes
     RTVSYSVAL3      Retrieve system value 3
     SNDCOMPMSG      Send completion message
     SNDDIAGMSG      Send diagnostic message
     SNDESCMSG       Send escape message
     SNDSTSMSG       Send status message

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

None, the tool is ready to use.

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

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

   CVTMODINF     *CMD                   TAAPGMY       QATTCMD
   TAAPGMYC      *PGM       CLP         TAAPGMYC      QATTCL
   TAAPGMYR      *PGM       RPG         TAAPGMYR      QATTRPG
   TAAPGMYP      *FILE      PF          TAAPGMYP      QATTDDS