MPE/iX Intrinsics Reference Manual (32650-90905)

Chapter 4 119
Command Definitions (ABORTSESS - FCLOSE)
FCLOSE
tape is rewound. If the file resides on labeled magnetic tape, the
tape is backspaced to the beginning of the opened file..
011 Close as a temporary job file (not rewound). This option has the
same effect as domain disposition 010, except that tape files are
not rewound. In the case of unlabeled magnetic tape, if this
FCLOSE is the last done on the device (with no other
FOPEN/HPFOPEN calls outstanding), the tape is rewound and
unloaded. If the file resides on a labeled magnetic tape, the tape
is positioned to the beginning of the next file on the tape..
100 Release the file. The file is deleted from the system..
101 Makes a permanent standard disk file temporary (valid only for
standard disk files with either fixed-length, variable-length, or
undefined-length record formats). The file is removed from the
permanent file directory and inserted into the temporary file
directory. (PM capability is required for this option.).
11:2 Disk space disposition (valid only for standard disk files with either
fixed-length, undefined-length, or variable-length record formats):
00 Does not return any disk space allocated beyond the
end-of-file marker.
01 Returns any disk space allocated beyond the end-of-file
(EOF) marker to the system. The EOF becomes the file
limit; records cannot be added to the file beyond the EOF.
10 Returns any disk space allocated beyond the end-of-file
(EOF) marker to the system. The file limit remains the
same; records can be added to the file beyond EOF, up to
the file limit. The disk space disposition takes effect on
each FCLOSE.
10.1 Set EOF to File Limit on Close
This flag indicates whether or not to set the EOF of a file to the file limit at
close time. This is primarily useful when the file has been opened for user
mapped access. The FPOINT and FCONTROL(6) intrinsics can be used to
set the EOF of a file to any value except the file limit. This option can be
used in this situation to set the EOF to the file limit.
value meaning
0 Do not change the EOF from its current value
1 Move the EOF to the file limit
0:7
Reserved for the system.
NOTE When a file is opened with the FOPEN/HPFOPEN intrinsic, the file count
(maintained by the operating system for each file) is incremented by one;
when a file is closed, the file count is decremented by one. If more than one
FOPEN/HPFOPEN is in effect for a particular file, its domain disposition is saved
but not affected by the FCLOSE call until the file count is decremented to zero;