Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)

Guardian Procedure Calls Reference Manual—522629-013

5-145

FILE_SETPOSITION_ Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

Summary

The FILE_SETPOSITION_ procedure supersedes the POSITION Procedure

(Superseded by FILE_SETPOSITION_ Procedure). This procedure has the same

function as the POSITION procedure but the FILE_SETPOSITION_ procedure

accepts an 8-byte record specifier, enabling use with Format 2 files as well as with

other files.

The FILE_SETPOSITION_ procedure positions by primary key within relative and

entry-sequenced files. For unstructured files, the FILE_SETPOSITION_ procedure

specifies a new current position.

For relative and unstructured files, the FILE_SETPOSITION_ procedure sets the

current position, access path, and positioning mode for the specified file. The current

position, access path, and positioning mode define a subset of the file for subsequent

access.

The FILE_SETPOSITION_ procedure is not used with key-sequenced files; the

FILE_SETKEY_ procedure is used instead.

The caller is not suspended because of a call to the FILE_SETPOSITION_ procedure.

A call to the FILE_SETPOSITION_ procedure is rejected with an error indication if

there are incomplete nowait operations pending on the specified file.

Syntax for C Programmers

Syntax for TAL Programmers

#include <cextdecs(FILE_SETPOSITION_)>

short FILE_SETPOSITION_ ( short filenum

, long long recordspecifier );

error := FILE_SETPOSITION_ ( filenum ! i

,recordspecifier ); ! i