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

TMF ARLIB2 Audit-Reading Procedures
HP NonStop TMF Application Programmer’s Guide—522419-005
5-39
ARFETCHAUXPOINTER
ARFETCHAUXPOINTER
This procedure retrieves information about the ranges of audit in auxiliary audit trails
that are logically ordered at this point relative to audit records in the master audit trail.
Together, these ranges create a logical ordering among all audit records in all audit
trails on a given system.
return-code output
INT .EXT:ref:1
is a returned value indicating the outcome of this procedure.
audit-trail-index input
INT:value
specifies the index of an auxiliary audit trail in the TMF configuration whose audit-
trail position is to be returned from the current AUXPOINTER audit record. The
specified value must be an integer between 1 and 15, but not greater than the
value of NUMAUXTRAILS in the current AUXPOINTER audit record. A value of 1
specifies auxiliary audit trail AUX01, 2 specifies AUX02, and so forth.
aux-trail-range output
INT .EXT:ref:*
points to a caller-allocated buffer into which the AUXPOINTER information for the
specified auxiliary audit trail will be returned. The format of this information is as
follows:
record AUXPOINTERINFO
02 LOWPOS type ATLOCSPEC.
02 HIGHPOS type ATLOCSPEC.
record ATLOCSPEC
02 SEQ-NO type binary 32, 0.
02 FILLER type x(4).
02 RBA type binary 64, 0.
CALL ARFETCHAUXPOINTER ( return-code ! o
, audit-trail-index ! i
, aux-trail-range ); ! o
Errors (<0) Table 5-3 (later in this section) describes the error codes.
Warnings (>0) None.