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

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—540139-009
5-47
ARFETCHMXAFTERDATA
ARFETCHMXAFTERDATA
This procedure retrieves column data from the after image of audit records for SQL/MX
objects. ARFETCHMXAFTERDATA 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. ARFETCHMXAFTERDATA copies the data for all columns
from the after image of the current audit record into a buffer specified by the
application. ARFETCHMXAFTERDATA works with audit records of type UPDATE (10),
UPDATE FIELDCOMP (15), and INSERT (5).
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 ARFETCHMXAFTERDATA ( return-code ! o
, request-bitmap ! i
, reply-bitmap ! o
, bitmap-length ! i
, image-buffer ! o
, image-buffer-length ! i
, end-image-data-offset ! o
, reply-hint ! o
, [sub-system ] ! o
, [ar-error ] ); ! o
Errors (<0) Table 5-3 describes the error codes.
Warnings (>0) None.