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

TMF ARLIB2 Audit-Reading Procedures

HP NonStop TMF Application Programmer’s Guide—540139-009

5-40

ARFETCHBEFOREIMAGE

This procedure copies the before-image field from the most recently read audit record

into the application’s buffer. This procedure works with records of type Update (10) and

Delete (3). 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:ref:*

is a buffer in the application process in which the information returned by

ARFETCHBEFOREIMAGE 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.

ARFETCHBEFOREIMAGE returns an error for values of max-copy-length less

than 1.

CALL ARFETCHBEFOREIMAGE ( return-code ! o

, buffer ! o

, max-copy-length ); ! i

Errors (<0) Table 5-3 describes the error codes.

Warnings (>0) Bit 15, when set, indicates that the before image is longer than

max-copy-length. At least one byte was truncated from the

end.