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

TMF ARLIB2 Audit-Reading Procedures

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

5-84

ARREAD

This procedure advances the cursor to the next audit record and copies the fixed-

length fields and certain other attributes into the application’s buffer. The next audit

record is the subsequent record (in the set of audit records externalized by this

interface) in the cursor direction specified by the most recent call to ARPOSITION for

the specified cursor.

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 identifying the audit trail that is to be read.

buffer output

INT .EXT

is a buffer in the application process in which the record returned by ARREAD is

stored. Note that the buffer can be allocated either from the 64K data stack or from

an extended segment.

max-copy-length input

INT:value

is the maximum number of bytes to copy into the buffer. ARREAD returns an error

for values of max-copy-length less than 2.

CALL ARREAD ( return-code ! o

, cursor-number ! i

, buffer ! o

, max-copy-length ); ! i

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

Warnings (>0) Bit 15, when set, indicates that the record returned in the buffer

is longer than max-copy-length. At least one byte was

truncated from the end.