TMF Application Programmer's Guide (H06.05+)

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—540139-002
5-52
ARFETCHMXBEFOREDATA2
ARFETCHMXBEFOREDATA2
This procedure is the same as ARFETCHMXBEFOREDATA except that it uses byte
maps instead of bit maps. Byte maps are easier to use for languages that have
difficulty checking and setting bits.
This procedure retrieves column data from the before image of audit records for
SQL/MX objects. ARFETCHMXBEFOREDATA2 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. ARFETCHMXBEFOREDATA2 copies the
data for all columns from the before image of the current audit record into a buffer
specified by the application. ARFETCHMXBEFOREDATA2 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-bytemap input
STRING .EXT
must be bytemap-length bytes long. The setting of the various bytes, however,
does not matter. request-bytemap and reply-bytemap must not overlap
one another.
reply-bytemap output
STRING .EXT
is bytemap-length bytes long. Each byte represents a column in the output
buffer. Upon return, a byte is 0x00 if data is not present in the corresponding
column or 0xFF if data is present. If reply-bytemap is not large enough to
represent all of the columns in the returned output, then data about columns
corresponding to the missing bytes is not returned. request-bytemap and
reply-bytemap must not overlap one another.
CALL ARFETCHMXBEFOREDATA2 ( return-code ! o
, request-bytemap ! i
, reply-bytemap ! o
, bytemap-length ! i
, image-buffer ! o
, image-buffer-length ! i
, end-image-dataoffset ! o
, reply-hint ); ! o
Errors (<0) Table 5-3 (later in this section) describes the error codes.
Warnings (>0) None.