The Add Date  Member command adds a  new member to a  multi-member file
using the  name MCYYMMDDnn where CYYMMDD is the  current date and nn is
a  consecutive number beginning with  01.  Up to  99 versions may exist
for a  single day  and a  maximum of  32,767 members  in the  file.   A
return value exists for the member name that was assigned.

The user  of the command  must have *OBJMGT  and *OBJOPR rights  to the
file.

See the RMVOLDMBR2 tool for removing old members.

A typical series of commands would be:

             DCL        &RTNMBR *CHAR LEN(10)
              .
             ADDDATMBR  FILE(xxx) RTNMBR(&RTNMBR)

The  file must allow for  multiple members.  When  the file is created,
specify MBR(*NONE).   The first  use of  ADDDATMBR will  add the  first
member of the day.

If multiple jobs attempt  to add a unique member at the  same time, the
command  monitors for the member  being in existence and  retries up to
5 times to add a unique member.

You should not attempt to  add your own member  of the file outside  of
ADDDATMBR unless you strictly follow the naming convention.

ADDDATMBR escape messages you can monitor for
---------------------------------------------

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

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

   FILE          The qualified name  of the multi-member file to  add a
                 member to.   The library  value defaults to  *LIBL.  A
                 specific library or *CURLIB may also be used.

   RTNMBR        The  member name that was added  to the file.  This is
                 a required return  variable that must be  specified as
                 *CHAR LEN(10).

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

Because ADDDATMBR  returns a value, the  command may only be  used in a
CL program.

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

The following TAA Tools must be on your system:

     CHKOBJ3         Check object 3
     CVTTIM          Convert time
     RSNLSTMSG       Resend last message
     RTVDAT          Retrieve date
     RTVDBFA         Retrieve data base file attributes
     RTVVALA         Retrieve value attributes
     SNDESCINF       Send escape information
     SNDESCMSG       Send escape message

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

None, the tool is ready to use.

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

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

   ADDDATMBR     *CMD                   TAADBMB       QATTCMD
   TAADBMBC      *PGM       CLP         TAADBMBC      QATTCL