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

TMF ARLIB2 Audit-Reading Procedures

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

5-79

ARPOSITION

This procedure positions a cursor within the audit trail to which it refers and specifies

the direction in which subsequent calls to ARREAD traverse the audit. Cursors are

positioned by the sequence number of the desired audit-trail file and a relative byte

address (offset) within the file.

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 open cursor for which the message text is to be retrieved.

audit-file-seqno input

INT(32):value

specifies the sequence number of an audit file in the audit trail referred to by the

cursor. If this is a MERGE cursor, this number is the MAT sequence number.

CALL ARPOSITION ( return-code ! o

, cursor-number ! i

, audit-file-seqno ! i

, audit-file-rba ! i

, aux-index ! i

, aux-seqno ! i

, aux-rba ! i

, [ cursor-direction ] ); ! i

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

Warnings (>0) None.

Note. The following five fields are used to position the specified cursor. These fields are the

same as the values returned in the ARRECORD structure. By saving these fields from the

ARRECORD, you can position the cursor and re-read the record. When reading forward, the

record that begins at or after the position is returned. When reading in reverse, the record that

ends at or before the position is returned.