Enscribe Programmer's Guide

3 System Procedures
File-System Procedures
You can use file-system procedures or a separate set of sequential I/O (SIO) procedures to create
and access Enscribe files. The two sets of procedures are mutually exclusive; with regard to any
given file, use one set or the other.
Table 4 (page 39) summarizes the functions of the applicable file-system procedures.
Table 4 File-System Procedures
DescriptionProcedure
Waits for completion of an outstanding I/O operation pending on an open
file.
AWAITIO[X]
Cancels the oldest outstanding operation, optionally identified by a tag,
on an open file.
CANCELREQ
Executes device-dependent operations on an open file.CONTROL_
Writes information (such as the EOF pointer) in file control blocks (FCBs)
to the associated physical disk volume. Supersedes REFRESH.
DISK_REFRESH_
Changes certain attributes (such as file type and file code) of a disk file
that are normally set upon creation. Supersedes ALTER.
FILE_ALTERLIST_
Waits for completion of an outstanding I/O operation pending on an open
file.
FILE_AWAITIO64_
Terminates access to a file and purges a temporary disk file. Supersedes
CLOSE.
FILE_CLOSE_
Executes device-dependent operations on an open file.FILE_CONTROL64_
Creates a new structured or unstructured disk file. The file can be permanent
or temporary. Supersedes CREATE.
FILE_CREATE_
Creates a new structured or unstructured disk file and specifies alternate-key
information, partition information, or other attributes. Supersedes CREATE.
FILE_CREATELIST_
Provides limited information about a file identified by file number.
Supersedes FILEINFO, FILEINQUIRE, and FILERECINFO.
FILE_GETINFO_
Provides limited information about a file. File is identified by name.
Supersedes FILEINFO, FILEINQUIRE, FILERECINFO, DEVICEINFO, and
DEVICEINFO2.
FILE_GETINFOBYNAME_
Provides detailed information about a file. File is identified by file number.
Supersedes FILEINFO, FILEINQUIRE, and FILERECINFO.
FILE_GETINFOLIST_
Provides detailed information about a file identified by file name.
Supersedes FILEINFO, FILEINQUIRE, and FILERECINFO.
FILE_GETINFOLISTBYNAME_
Locks an open disk file, making it inaccessible to other accessors.FILE_LOCKFILE64_
Locks a record (or a set of records if generic locking is enabled for a
key-sequenced file) in an open disk file so that other processes cannot
access it.
FILE_LOCKREC64_
Establishes communication with a file and returns a file number. Supersedes
OPEN.
FILE_OPEN_
Deletes a disk file that is not open. Supersedes PURGE.FILE_PURGE_
Following positioning, returns the first record of a subset; otherwise, it
returns the next record in the current access path.
FILE_READ64_
Is the same as FILE_READ64_, but it locks the record before reading it.FILE_READLOCK64_
File-System Procedures 39