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

TMF ARLIB2 Audit-Reading Procedures

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

5-44

ARFETCHFRAGMENT

This procedure returns information about updated data record fragments from audit-

compressed update records. Use the ARFETCHFRAGMENT procedure call after

reading a record of type UPDATE AUDITCOMP to get the offset, length, before-image,

and after-image of each data record fragment. 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.

frag-number input

INT:value

is the zero-based ordinal number of the updated data record fragment to retrieve.

frag-offset output, optional

INT .EXT:ref

is the zero-based byte offset within the data record where the specified fragment

begins.

CALL ARFETCHFRAGMENT ( return-code ! o

,frag-number ! i

,[ frag-offset ] ! o

,[ before-image-buf ] ! o

,[ max-before-copy-len ] ! i

,[ actual-before-len ] ! o

,[ after-image-buf ] ! o

,[ max-after-copy-len ] ! i

,[ actual-after-len ] ); ! o

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

Warnings (>0) Bit 14 indicates that the before-image of the fragment is longer

than max-before-copy-length. At least one byte was

truncated from the end.

Bit 15 indicates that the after-image of the fragment is longer

than max-after-copy-length. At least one byte was

truncated from the end.