TMF Application Programmer's Guide (H06.06+, J06.03+)

TMF ARLIB2 Audit-Reading Procedures

HP NonStop TMF Application Programmer’s Guide—540139-009

5-82

ARGETRECADDR64

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

unstructured files, this procedure computes and returns the 64-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.

return-code output

INT .EXT:ref:1

is a returned value indicating the outcome of this procedure.

recaddr64 output

FIXED .EXT:ref:1

returns the 64-bit 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). Note that you cannot use this

value with the POSITION or KEYPOSITION Enscribe procedures; instead you

must use it with the FILE_SETPOSITION_ or FILE_SETKEY_ procedure.

root-part input, optional

INT .EXT: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.

sub-system output, optional

INT .EXT:ref:1

CALL ARGETRECADDR64 ( return-code ! o

, recaddr64 ! o

, [ root-part ] ! i

, [sub-system ] ! o

, [ar-error ] ); ! o

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

Warnings (>0) None.