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

TMF ARLIB2 Audit-Reading Procedures

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

5-71

ARGETRECADDR

For format 1 and non-oversized format 2 entry-sequenced, relative, or unstructured

files, this procedure computes and returns the 32-bit external (user-understood) record

address of the data record whose modification is reflected in the current audit record.

Format 1 is the default file format and supports file sizes up to 2 GB - 1MB. Format 2

is a disk format that supports large format files (big files). An oversized format 2 file is

one that has a maximum file size greater than 4 gigabytes - 4 kilobytes. If you use this

procedure with an oversized format 2 file, the call fails with an error -21.

return-code output

INT .EXT:ref:1

is a returned value indicating the outcome of this procedure.

recaddr output

INT(32):ref

returns the record address of the modified data record. This is a record address,

record number, or relative byte address, depending upon the particular file type

(entry-sequenced, relative, or unstructured).

If the procedure call fails with an error -21, the record address returned is -3D.

root-part input, optional

INT:ref:4

is the name of the volume containing the primary (root) partition of the data file. If

the modified file is a secondary partition of a partitioned Enscribe file, this

information is necessary to determine the record address; in all other cases, this

parameter is simply ignored.

CALL ARGETRECADDR ( return-code ! o

, recaddr ! o

, [ root-part ] ); ! i

Errors (<0) Table 5-3 describes the error codes.

Warnings (>0) None.