SA_TxtOpen

A file must be created or opened prior to any attempt to process data against it. SA_TxtOpen opens the indicated text file.

SA_FH SA_TxtOpen ( char *TxtName, u32 TxtNameLen, u32 OpenMode, u32 DiskOpSize );

Parameters:

TxtName

The file name of the text file to open.

TxtNameLen

The length of {txtName}.

OpenMode

A valid file access mode.

DiskOpSize

The sector size and record size for random I/O.

Note the following:

1. Upon success of the function, the open file handle is returned.

2. There is no implied close of an open file. If a file is opened and the file handle is used again in a subsequent open or prepare, the first file will remain open for the duration of the program.

3. Function return codes are as follows:

 

Value	Meaning
+nn	Success.
-nn	Error as described in Sunaccess Errors