TMF Application Programmer's Guide (G06.26+)

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—522419-005
5-37
ARFETCHAFTERIMAGE
ARFETCHAFTERIMAGE
This procedure copies the after-image field from the most recently read audit record
into the application’s buffer. This procedure works with records of type Update (10)
and Insert (5). This procedure cannot be used with audit records for SQL/MX objects.
The object type can be determined by checking the OBJECTTYPE field in the
ARRECORD.
return-code output
INT .EXT:ref:1
is a returned value indicating the outcome of this procedure.
buffer output
INT .EXT
is a buffer in the application process in which the information returned by
ARFETCHAFTERIMAGE is stored. Note that buffer can be allocated from the
64K data stack or from an extended segment.
max-copy-length input
INT(32):value
is the maximum number of bytes to copy into the buffer. This routine returns an
error for values of max-copy-length less than 1.
maybe-comp-byte output, optional
STRING .EXT:ref:1
returns the single byte which may be the actual first byte of the after-image in
cases where warning <return-code>.<14> is returned. If the data file has the
DCOMPRESS attribute set, then this is the actual first byte of the after-image, and
CALL ARFETCHAFTERIMAGE ( return-code ! o
, buffer ! o
, max-copy-length ! i
,[ maybe-comp-byte ] ); ! o
Errors (<0) Table 5-3 (later in this section) describes the error codes.
Warnings (>0) Bit 14, when set, indicates that the first byte of the after-image is
a 1 (possibly representing a compression count rather than the
actual first byte of data if data compression is enabled). The
Enscribe Programmer’s Guide and the HP NonStop SQL/MP
Reference Manual discuss the DCOMPRESS attribute.
Bit 15, when set, indicates that the after-image is longer than
max-copy-length. At least one byte was truncated.