kgetpos

kgetpos

Return Position Information for VSAM File

Portability: SAS/C extension

SYNOPSIS
DESCRIPTION
RETURN VALUE
CAUTION
RELATED FUNCTIONS
SEE ALSO

SYNOPSIS

#include <lcio.h>

int kgetpos(FILE *f, fpos_t *pos);

DESCRIPTION

The kgetpos function determines the file position of the current record of the keyed stream associated with the FILE object addressed by f and stores it in the object addressed by pos . This object is of type fpos_t , which is defined in <stdio.h> . If no current record is defined when kgetpos is called, kgetpos fails.

The fpos_t type is composed of two fields, _recaddr and _offset . The file position returned by kgetpos has the control interval number for the current record in _recaddr , and the offset of the record in the control interval in _offset .

RETURN VALUE

The kgetpos function returns 0 if successful, or a negative number if an error occurred.

CAUTION

The position of a record changes due to file updates. Therefore, you should not record file positions for later use, unless the file contents are not subject to change.

RELATED FUNCTIONS

fgetpos