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

HP NonStop TMF Application Programmer’s Guide—522419-005
5-1
5
TMF ARLIB2 Audit-Reading
Procedures
This section describes the ARLIB2 audit-reading interface that is available in the
G06.23 and later release version updates (RVUs) of the TMF product. For information
about the ARLIB audit-reading interface, refer to the TMF Application Programmers
Guide associated with the G06.22 or earlier RVUs.
The TMF ARLIB2 audit-reading interface allows you to programmatically examine TMF
audit records for SQL/MX, SQL/MP, and Enscribe objects. The interface consists of
two parts: a set of procedures that you bind into your program and a set of data
definitions that describe the information returned by the procedures. Table 5-2
summarizes the ARLIB2 audit-reading procedures.
Information about how to include the TMF ARLIB2 audit-reading procedures in your
application appears at the end of this section.
This section contains the following topics:
Topic Page
ARLIB2 Compared to ARLIB
5-2
Cursors 5-3
Restoring Audit-Trail Files From Audit Dumps 5-4
Retrieving Information From Audit Records 5-5
Error Reporting 5-6
Audit Compression 5-7
Reading Active Audit Files 5-8
Reading a Range of Audit-Trail Files 5-9
Reading a Merged Audit Trail With a MERGE Cursor 5-10
Reading a Merged Audit Trail Without a MERGE Cursor 5-11
Distributed Transactions 5-12
Auxiliary Audit Trails 5-15
NonStop SQL/MP Internal Field Formats 5-16
Audit Records 5-19
Procedure Calls 5-32
Error Codes 5-92
How to Include Audit Reading in an Application 5-96