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

TMF ARLIB2 Audit-Reading Procedures

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

5-54

ARFETCHRECORDKEY

This procedure copies the record key field from the most recently read audit record into

the application’s buffer. This procedure works with records of type UPDATE

AUDITCOMP (11).

return-code output

INT .EXT:ref:1

is a returned value indicating the outcome of this procedure.

buffer output

INT .EXT

is a buffer in the application process in which the information returned by

ARFETCHRECORDKEY is stored. Note that the buffer can be allocated either

from the 64K data stack or from an extended segment.

max-copy-length input, optional

INT:value

is the maximum number of bytes to copy into the buffer.

ARFETCHRECORDKEY returns an error for values of max-copy-length less

than 1.

CALL ARFETCHRECORDKEY ( return-code ! o

, buffer ! o

, [ max-copy-length ] ); ! i

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

codes.

Warnings (>0) Bit 15, when set, indicates that the record key is longer than

max-copy-length. At least one byte was truncated from the

end.