The Merge Directory Entries  tool allows the user to merge  a single or
all directory  entries using a user generated file  as input.  The file
would  typically be  created by  the CVTDIRE  command which is  part of
the same  tool.   The  intent  of the  tool is  to  allow you  to  copy
directory entries from one system to another.

Assume  you  want  to  copy  the  directory  entries  from  SYSTEMA  to
SYSTEMB.  On SYSTEMA, you would enter the command:

           CVTDIRE   OUTLIB(xxx)

CVTDIRE  is a  TAA Tool command  that simplifies  generating an outfile
of directory  entries.    All  directory entries  would  be  converted.
DSPDIRE can also be used (see later discussion).

You  would  then  transfer  the  file to  SYSTEMB  (such  as  by  using
Save/Restore).

On  SYSTEMB,  the user  of  MRGDIRE  must have  *SECADM  authority.   A
typical command would be:

           MRGDIRE   FROMFILE(DIRENTP)

Since the USRID  parameter was not  specified, the default  of *ALL  is
used to  copy all directory  entries.  A  specific user ID  and address
could have been named to copy only those entries.

Error handling
--------------

If a  user entry already exists  in the directory, it is  ignored and a
diagnostic message is sent.

Using CVTDIRE outfile
---------------------

The  CVTDIRE TAA command provides a  simple approach for converting all
existing  directory  entries.   It  uses  the  system  command  DSPDIRE
outfile file function.

DSPDIRE  may  be  entered  directly  to  create the  same  file.    For
example,  this could  be used  on a  system that did  not have  the TAA
Productivity Tools.

If you  use  DSPDIRE  directly,  you  must  specify  DETAIL(*FULL)  and
OUTFILFMT(*TYPE3).   The MRGDIRE command  will reject any  file formats
that were not converted with these parameters.

Using MRGDIRE for the current system
------------------------------------

It would  also be possible to use DSPDIRE to  capture an outfile of the
current directory entries to use as backup  in case there is a need  to
reset the directory at a later point.

CVTDIRE escape messages you can monitor for
-------------------------------------------

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

MRGDIRE escape messages you can monitor for
-------------------------------------------

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

CVTDIRE parameters                                    *CMD
------------------

   OUTLIB        The library to contain the DIRENTP file.

   OUTMBR        The  member in  the  DIRENTP  file.   The  default  is
                 *FIRST.

   REPLACE       Whether  to replace  the data  in the  DIRENTP member.
                 The  default is  *YES.   *NO may  be specified  to add
                 records to an existing member.

MRGDIRE parameters                                    *CMD
------------------

   FROMFILE      The  input   library/file  name   that  contains   the
                 directory  entries  to  be  copied.   The  default  is
                 DIRENTP  which  is  the name  of  the  file  output by
                 CVTDIRE.

                 The file must  have been output  from the TAA  command
                 CVTDIRE  or  the  system  DSPDIRE  command  using  the
                 OUTFILE       parameter,       DETAIL(*FULL),      and
                 OUTFILFMT(*TYPE3).

   FROMMBR       The member name  of the  input file.   The default  is
                 *FIRST  for  the  first  member  of  the  input  file.
                 *LAST may  also be entered for the  last member in the
                 file.

   USRID         The  user id and address of  the directory entry to be
                 copied.    The   default  is  ALL   directory  entries
                 contained in the input file.

                 If a  user entry already  exists in the  directory, it
                 is ignored and a diagnostic message is sent.

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

The user must have *SECADM authority for MRGDIRE.

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

The following TAA Tools must be on your system:

     CHKAPOST        Check apostrophes
     CHKOBJ3         Check object 3
     CHKSECADM       Check *SECADM special authority
     EDTVAR          Edit variable
     RTVDIAGMSG      Retrieve diagnostic message
     RTVFMT          Retrieve format
     SNDCOMPMSG      Send completion message
     SNDESCMSG       Send escape message
     SNDJLGMSG       Send job log message

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

None, the tool is ready to use.

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

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

   MRGDIRE       *CMD                   TAADIRA       QATTCMD
   CVTDIRE       *CMD                   TAADIRA2      QATTCMD
   TAADIRAC      *PGM       CLP         TAADIRAC      QATTCL
   TAADIRAC2     *PGM       CLP         TAADIRAC2     QATTCL

Structure
---------

CVTDIRE     Cmd
   TAADIRAC2  CL pgm

MRGDIRE     Cmd
   TAADIRAC    CL pgm