open an existing file using pio
Input parameters are read on comp task 0 and ignored elsewhere.
|iosystem||: a defined pio system descriptor created by a call to PIO_init (see PIO_types) |
|file||: the returned file descriptor |
An integer parameter which controls the iotype.
|fname||: the name of the file to open |
|mode||: a zero value (or PIO_nowrite) specifies the default behavior: open the dataset with read-only access, buffering and caching accesses for efficiency otherwise, the creation mode is PIO_write. setting the PIO_write flag opens the dataset with read-write access. ("writing" means any kind of change to the dataset, including appending or changing data, adding or renaming dimensions, variables, and attributes, or deleting attributes.) |
- Return values