Using KSAM/XL and KSAM 64 (32650-90886)

Chapter 9 133

KSAM Intrinsics

FPOINT

Sets the logical and physical record pointers to the speciﬁed record.

Syntax

I16V I32V

FPOINT(

filenum,lrecnum

);

Parameters

filenum

16-bit signed integer by value (required)

Passes the ﬁle number of the ﬁle where the pointer is to be set.

lrecnum

32-bit signed integer by value (required)

Passes the relative physical record number where the physical record

pointer is to be positioned. Record numbering starts with zero or one,

depending on how the ﬁle was created.

Operation Notes

This intrinsic does not read the advance ﬂag. It positions both the logical record pointer

and the physical pointer to the appropriate record. When its function is complete, it sets

the advance ﬂag to FALSE.

Condition Codes

CCE Request granted.

CCG Request denied. The physical record pointer position is unchanged.

Positioning was requested at a point beyond the ﬁle limit.

CCL Request denied. The physical record pointer position is unchanged because

of one of the following:

• Invalid

filenum

parameter.

• The

lrecnum

parameter speciﬁed a record marked for deletion.

Refer to this intrinsic in the MPE/iX Intrinsics Reference Manual for other codes

pertaining to KSAM ﬁles.