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
|
