|
Used to log user data (ASCII or binary) to the log file.
Static transactions are currently not supported with Eloquence
and DBMEMO has no effect. Eloquence relies on dynamic
transactions internally.
A future version of Eloquence may add support for static
transactions for use with forward recovery or auditing purposes.
DBMEMO(base,text,mode,status,textlen)
- base
-
is the name of the array used as the base parameter when opening the
database. The first element of the array must contain the base ID
returned by DBOPEN. (Refer to DBOPEN for more information about the
base ID.)
The base argument is ignored with Eloquence.
- text
-
is an array of up to 512 bytes that contains user data (ASCII or binary) to
be written to the log file as part of the DBMEMO log record.
- mode
-
must be an integer equal to 1.
- status
-
is the name of an array of 10 halfwords in which the database returns
status information about the procedure. If the procedure executes
successfully, the status array contents are:
Element |
Contents |
1 |
If the procedure succeeds, the return status is 0.
Otherwise it provides a status code to describe the failure.
|
2-4 |
Unchanged.
|
5-10 |
Information about the current procedure call and its results.
|
- textlen
-
is an integer equal to the number of halfwords to be logged from the text
parameter, or is a negative integer equal to the number of bytes. Length
can be zero.
Notes:
- Static transactions are not supported and DBMEMO has no
effect besides verifying the arguments.
|
|