Product Documentation

FairCom ISAM for C

Previous Topic

Next Topic

GetSuperFileNames

Retrieve superfile member name.

Short Name

GETMNAME()

Type

Low-Level function

Declaration

COUNT GetSuperFileNames(FILNO filno, pTEXT nambuf,

VRLEN buflen, COUNT memberNo)

Description

In V12 the file number typedef was formally changed from COUNT, a two-byte value to FILNO, a four-byte value. Refer to this link for compatibility details. Four Byte File Numbering

GetSuperFileNames() retrieves the superfile member name for member number memberNo in superfile filno. After successful execution, the nambuf array, which is buflen bytes long, contains the superfile member name for member number memberNo.

Return

Value

Symbolic Constant

Explanation

0

NO_ERROR

Successful operation.

101

INOT_ERR

Member name not found.

411

BSUP_ERR

filno is not a superfile number.

See c-tree Error Codes for a complete listing of valid c-tree error values.

Example

LON buflen=64

TEXT nambuf[buflen]; /* superfile member name buffer */

COUNT ret=0; /* function return */

FILNO membno; /* member # for loop control */


/*list superfile member names for superfile number 5 */

for (membno =1; ret == 0; membno ++)

{

if (ret=GetSuperFileNames(5,nambuf,buflen, membno))

printf("\nError on GETMNAME, error = %d decimal",

ret) ;

else

printf("\n%s is member #%d of superfile #5", nambuf, membno);

}

TOCIndex