HP C/iX Library Reference Manual (30026-90004)

Chapter 5 159
HP C/iX Library Function Descriptions
fopen
closed. The affect of each value of n is defined as follows:
If the Df option is not specified and the file is a new file, then the default is
to save the file as a permanent file. If the file is old, the default is not to
change the disposition.
Ds n The Ds option specifies the disk space disposition of the file after the file is
closed for fixed, undefined, and variable format files. The effect of each
value of
n is defined as follows:
If the Ds option is not specified, the default is not to return any disk space
allocated beyond the end-of-file indicator.
E
n The E option specifies the maximum number of extents that can be
allocated to the file.
The maximum value is 32. The default value, if the E option is not
specified, is 8 extents.
F
n The F option indicates the value used as the file code if this call to fopen()
creates the file. If the F option is not specified, the file code is zero.
L If specified, the L option indicates that dynamic locking should be allowed
on this file.
M
n The M option controls multi-access. The option character is followed by an
integer that indicates the level of multi-access for this open request. The
levels are specified in the MPE/iX Intrinsics Reference Manual under the
FOPEN intrinsic description.
Q If the Q option is specified, file equations are disallowed. The default is to
allow file equations.
R
n The R option specifies the size of the record if the file is created by this
open request. If the V option is also used, this option specifies the
maximum size of the variable-sized records. The option letter is followed
by a decimal number that is equal to the number of bytes in the record
size. Notice that the number must be positive. A byte count is always
0 Don't change the disposition.
1 Save the file as a permanent file.
2 Save the file as a temporary file.
3 Don't rewind on close.
4 Purge the file on close.
0 Don't return any disk space allocated beyond the end-of-file indicator.
1 Return to the system any disk space allocated beyond the end-of-file indicator. The EOF
becomes the file limit. No records may be added to the file beyond this new limit.
2 Return to the system any disk space allocated beyond the end-of-file indicator, but do not set
the file limit to EOF, and allow records to be added to the file up to the file limit.