QMOpen()

 Top  Previous  Next

 

The QMOpen() function opens a file. It is analogous to the QMBasic OPEN statement.

 

The function takes a single argument, FileName, as the name of the file to be opened. This must correspond to an F or Q-type entry in the VOC of the QM account in which the server is running.

 

The returned integer value is the file number which must be used in all subsequent operations against this file. If the file cannot be opened, the function returns zero. The QMStatus() function can be used to retrieve the error cause.

 

To open a dictionary, the FileName argument should commence with "DICT" and a single space separating this prefix from the file name, for example:

 

DictNo = QMOpen("DICT READERS")

 

There is no practical limit to the number of files that can be open at one time.

 

The program fragment below opens the CLIENTS file, reads the record identified by ClientNo, and then closes the file. A real program should test the error status from the read to determine if the action was successful.

 

 

hmtoggle_plus1C

int QMOpen(char * FileName)

fClients = QMOpen("CLIENTS");

Rec = QMRead(fClients, ClientNo, Err);

QMClose(fClients);

Note that this example leaves variable Rec pointing to a dynamically allocated memory area that must be released using QMFree() when no longer needed.

 

hmtoggle_plus1VB.Net

QMOpen(ByVal FileName as String) as Integer

fClients = QMOpen("CLIENTS")

Rec = QMRead(fClients, ClientNo, Err)

QMClose(fClients)

 

hmtoggle_plus1QMBasic Class Module

Open(FileName)

fClients = session->Open("CLIENTS")

Rec = session->Read(fClients, ClientNo, Err)

session->Close(fClients)

 

hmtoggle_plus1Java

int Open(String FileName)

fClients = qm.Open("CLIENTS");

Rec = qm.Read(fClients, ClientNo);

qmClose(fClients);

 

hmtoggle_plus1Python

Open(FileName)

fClients = qm.Open("CLIENTS")

Rec, Err = qm.Read(fClients, ClientNo)

qmClose(fClients)