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

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—522419-005
5-29
Field Descriptions
Aux Pointer
This 16-byte structure specifies a range of audit in an auxiliary audit trail that is
logically ordered at this point relative to the records in the master audit trail. When all
aux pointer records are combined, they show the logical ordering of all audit records in
all audit trails on a given system.
The NUMAUXTRAILS field returned by the ARREAD procedure specifies the number
of auxiliary audit ranges represented in the record.
You use the ARFETCHAUXPOINTER procedure to copy the auxiliary audit trail ranges
into your application buffer. The format of the output is like the following:
record AUX-POINTER.
02 BEGIN-SEQNO type binary 32,0.
02 FILLER type binary 32,0.
02 BEGIN-RBA type binary 64,0.
02 END-SEQNO type binary 32,0.
02 FILLER type binary 32,0.
02 END-RBA type binary 64,0.
Audit records in an auxiliary audit trail are considered “in range” if the audit record
begins at or after the beginning SEQNO and RBA, and ends before the ending
SEQNO and RBA.
Before-image
A before-image is a byte-for-byte copy of a record (as it was before being deleted or
modified) in an audited file.
The BEFORELEN field returned by the ARREAD procedure specifies the length (in
bytes) of the associated before-image field.
You use the ARFETCHBEFOREIMAGE procedure to copy the before-image field from
the audit record into your application buffer.
Child Node List
Each entry in this list specifies the system number of a node that is the child of the
current node in a network transaction, represented as a 32-bit integer.
The NUMCHILDREN field returned by the ARREAD procedure specifies the number of
entries in the associated child node list.
You use the ARFETCHCHILDNODELIST procedure to copy the child node list field
from the audit record into your application buffer.