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

98 Chapter9

KSAM Intrinsics

FFINDBYKEY

Operation Notes

Split stack calls are permitted.

The FFINDBYKEY intrinsic does not read the advance ﬂag. It positions both the logical

record pointer and the physical pointer to the appropriate record. When the function is

complete, it sets the advance ﬂag to FALSE.

To locate and read a single record, use the FREADBYKEY intrinsic.

Condition Codes

CCE Request granted.

CCG Request denied. The requested position was beyond the logical end-of-ﬁle

or beginning-of-ﬁle.

CCL Request denied. An error occurred: an I/O error occurred, the

relop

parameter could not be satisﬁed, a

length

less than the full length was

speciﬁed for a key with numeric display or packed decimal format, or a key

was not found when

relop

=0.

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

pertaining to KSAM ﬁles.