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

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—540139-009
5-32
Procedure Calls
UNDOFLAG
The UNDOFLAG field, when set to a nonzero value, indicates that the audit record was
produced by a TMF recovery process (transaction backout, volume recovery, or file
recovery) as it undid the effects of a transaction. You use the UNDOFLAG field to
distinguish such records from those produced on behalf of an application program.
The value of the UNDOFLAG field has the following meaning:
VOLUME
This is the 4-word (8-character) name of the affected disk volume (“$DATA ”, for
example).
Procedure Calls
This section provides the format of each TMF audit-reading procedure call. The
descriptions are presented in alphabetic order by procedure name.
Table 5-2 summarizes the audit-reading procedures.
<> 0 the audit record was generated as part of an undo operation by a TMF
recovery process (backout, volume recovery, or file recovery)
0 the audit record does not represent undo work
Note. The TMF audit-reading procedures cannot be called from highpin user processes. Any
attempt to do so will cause a run-time error.
Table 5-2. TMF Audit-Reading Procedures (page 1 of 3)
Procedure Name Function
ARCLOSE
Closes a cursor to an audit trail.
ARCOMPLETEIO
ARCOMPLETEIO is for compatibility, the application will
not see ARLIB2 I/O's.
ARFETCHAFTERIMAGE
Copies the after-image field from an SQL/MP or
Enscribe audit record to the application buffer.
ARFETCHAUXPOINTER
Retrieves information about the audit ranges in auxiliary
audit trails.
ARFETCHBEFOREIMAGE
Copies the before-image field from an SQL/MP or
Enscribe audit record to the application buffer.
ARFETCHCHILDNODELIST
Copies the child node list from an audit record to the
application buffer.
ARFETCHFIELDVALUE
Retrieves both the before-image and after-image from
field-compressed update record.
ARFETCHFRAGMENT
Returns information about updated data record
fragments from field-compressed update record.