RwIniOpen

Opens the specified file, creating it if it doesn't exist. After the entire INI file is read into memory the physical file is closed. All read and write operations occur in memory and are only written to file when rwIniClose() is called.

Syntax

handle = rwIniOpen(fileName [, option])

Parameters

option

The only option available is 'N' or 'n' for "no-create". If specified, the file will not be created if it does not exist already.

Returns

Returns a handle to the opened file if successful. This handle must be passed to rwIni() and rwIniClose(). Returns the string 'ERROR:' if the file can not be opened.

Remarks

rwIniOpen() will refuse to open the current User and System profiles (normally, '\os2\os2.ini' and '\os2\os2sys.ini'). Use the 'REXXUTIL' function SysIni() instead.