TMF Application Programmer's Guide (H06.06+, J06.03+)

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—540139-009
5-53
ARFETCHMXBEFOREDATA
ARFETCHMXBEFOREDATA
This procedure retrieves column data from the before image of audit records for
SQL/MX objects. ARFETCHMXBEFOREDATA can only be used with data-fork audit
records for SQL/MX objects. The object type can be determined by checking the
OBJECTTYPE field in the ARRECORD. ARFETCHMXBEFOREDATA copies the data
for all columns from the before image of the current audit record into a buffer specified
by the application. ARFETCHMXBEFOREDATA works with audit records of type
UPDATE (10), UPDATE FIELDCOMP (15), and DELETE (3).
return-code output
INT .EXT:ref:1
is a returned value indicating the outcome of this procedure.
request-bitmap input
INT(32) .EXT:ref:*
must be bitmap-length bytes long. The setting of the various bits, however,
does not matter. request-bitmap and reply-bitmap must not overlap one
another. For best performance, request-bitmap and reply-bitmap should
be allocated as INT(32) variables.
reply-bitmap output
INT(32) .EXT:ref:*
is bitmap-length bytes long. Each bit represents a column in the output buffer.
Upon return, a bit is zero if data is not present in the corresponding column or one
if data is present. If reply-bitmap is not large enough to represent all of the
columns in the returned output, then data about columns corresponding to the
missing bits is not returned. request-bitmap and reply-bitmap must not
overlap one another. For best performance, request-bitmap and reply-
bitmap should be allocated as INT(32) variables.
CALL ARFETCHMXBEFOREDATA ( return-code ! o
, request-bitmap ! i
, reply-bitmap ! o
, bitmap-length ! i
, image-buffer ! o
, image-buffer-length ! i
, end-image-dataoffset ! o
, reply-hint ! o
, [sub-system ] ! o
, [ar-error ] ); ! o
Errors (<0) Table 5-3 describes the error codes.
Warnings (>0) None.