_NAME_
openOrCreateFileToReadWrite

_PROTOTYPE_
int openOrCreateFileToReadWrite(char *path);

_SHORT-DESCRIPTION_
Open a file (or create it if it doesn't exist) with read/write capability

_DESCRIPTION_
openOrCreateFileToReadWrite is a low level routine used internally in
the CRIS/SIS routines. It is used mostly by the put routines to write
data to an archive file. If the file does not exist, it is created,
initialized, and re-opened with read and write capability.
openOrCreateFileToReadWrite also does some error checking and
exits if the file cannot be created or opened as expected.

_SHORT-CODE-SAMPLE_
int bytesToRead = 1024;
char buffer[1024];
int fileDescriptor;
char *path = "/home/idunn/rgr/data/sis2/1997.09/1997.09.24/sis2.1997.09.24.hsk";
_
fileDescriptor = openOrCreateFileToReadWrite(path);
readFromFile(fileDescriptor, buffer, bytesToRead);
close(fileDescriptor);

_INPUT_
* path is a pointer to a string containing the path to the file.

_OUTPUT_
* 1 if successful.
* The run terminates if openOrCreateFileToReadWrite is unsuccessful.