FairCom ISAM for C

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);

}