OSI/FTAM Programming Reference Manual

FTM Procedures

HP NonStop OSI/FTAM Programming Reference Manual—528611-001

4-106

FTM_LOCATE_REQ_

This procedure allows you to move a location pointer to a specified place in the

previously opened file. The location pointer is used in read and write operations.

status return value

INT

indicates the outcome of the call. For a list of possible ZAPS-VAL-STATUS-xxx

values, see Table B-1 on page B-2.

cepi input

INT:value

is the connection endpoint identifier (CEPI) used to identify the specific

association. Use the CEPI value returned from the FTM_INITIALIZE_REQ_

procedure for this association. For additional information on using the cepi

parameter, see the OSI/FTAM Programming Guide.

cepi is a required parameter.

fadu-id input

INT .EXT:ref:(ZFTM-DDL-FADU-ID)

specifies the target FADU. The following possible values apply only to the FTAM-2

document type:

For a full explanation of this parameter and its usage, see ISO 8571, Part 2, or in

the OSI/FTAM Programming Guide.

fadu-id is a required parameter.

status := FTM_LOCATE_REQ_ ( cepi ! I

, fadu-id ! I

, [ tag ] ) ; ! I

Data Structure Field Possible Values

ZFIRSTLAST ZFTM-VAL-FADUID-FIRST

ZFTM-VAL-FADUID-LAST

ZRELATIVE ZFTM-VAL-FADUID-PREVIOUS

ZFTM-VAL-FADUID-CURRENT

ZFTM-VAL-FADUID-NEXT

ZBEGINEND ZFTM-VAL-FADUID-BEGIN

ZFTM-VAL-FADUID-END

ZFADUNUMBER (specifies number of FADUs separating desired FADU from

root FADU)