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

TMF ARLIB2 Audit-Reading Procedures

HP NonStop TMF Application Programmer’s Guide—522419-005

5-82

ARPOSITION2

This procedure uses the aux-trail-range returned by an ARFETCHAUXPOINTER call

to position the cursor for the specified auxiliary audit trail. An AUXPOINTERINFO Def

structure may also be specified for the MAT. When reading forward, ARREAD returns

audit records starting with the LOWPOS and returns ARE-END-OF-AUDIT when the

HIGHPOS is reached. When reading in reverse, ARREAD returns audit records

starting with the HIGHPOS and returns ARE-END-OF-AUDIT when the LOWPOS is

reached. The AUXPOINTERINFO Def structure simplifies merging the MAT and

auxiliary audit trails.

return-code output

INT .EXT:ref:1

is a returned value indicating the outcome of this procedure.

cursor-number input

INT:value

is the number of the previously opened cursor that is to be positioned.

position-info input

INT .EXT:ref:1

is an AUXPOINTERINFO Def structure containing the LOWPOS and HIGHPOS

audit-trail position information.

cursor-direction input, optional

INT:value

is a value indicating which direction the cursor will travel through the audit. The

values are:

If cursor-direction is omitted, forward is assumed.

CALL ARPOSITION2 ( return-code ! o

, cursor-number ! i

, position-info ! i

, [ cursor-direction ] ); ! i

Errors (<0) Table 5-3 (later in this section) describes the error codes.

Warnings (>0) None.

0forward

> 0 reverse