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

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—522419-004
5-32
Format 2 File Support
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).
Format 2 File Support
The D46 version of the TMF product employs an audit format that supports the use of
format 2 files (big files). With regard to the TMF audit-reading procedures, however,
the presentation formats have not changed. For a complete discussion of the
implications of this audit record format with regard to product migration and fallback,
see Appendix B of the TMF Configuration and Planning Guide (“Moving Between TMF
Environments”).
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.