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

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—540139-009
5-56
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:ref:*
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:ref:*
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
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
, [sub-system ] ! o
, [ar-error ] ); ! o
Errors (<0) Table 5-3 describes the error codes.
Warnings (>0) None.