NET/MASTER Network Control Language (NCL) Reference Manual

FILE CLOSE
Verbs
106126 Tandem Computers Incorporated 3–73
FILE CLOSE The FILE CLOSE verb closes a file, pair of files, or an operating system process after
processing by NCL. After the FILE CLOSE operation finishes, NCL no longer has a
current file, pair of files, or operating system process.
Specification of a file or pair of files that has not been opened or that has previously
been closed is ignored. NCL also ignores the case in which you specify ALL and no
files or file pairs are currently open.
A certain amount of storage is reserved each time a new file or pair of files is opened.
This storage is used during the processing of subsequent requests associated with the
file or pair of files. This storage is released when you issue the FILE CLOSE verb. The
amount of storage that NCL uses for opening and processing files and file pairs
depends on the type of file or pair of files, and also depends on the environment in
which processing takes place: it is not possible to place an accurate figure on this
amount of storage.
FILE CLOSE { ID= fileid | ALL }
ID= fileid
specifies the identity of the file or pair of files you want to access by using the FILE
CLOSE verb.
ALL
specifies that you want to close all files and file pairs that are currently open.
Considerations
The &SYS.FILE.RC system variable reflects the result of all file operations within
NCL. NCL sets this variable on completion of the FILE CLOSE verb, as follows:
Return Code Meaning
0 Not used.
4 Not used.
8 Not used.
12 Not used.
16 File or pair of files closed.
It is the user’s responsibility to test the &SYS.FILE.RC system variable for errors.
There is an implicit resumption of the NCL procedure after any errors, unless the
user has coded an error handler for the FILE_ERROR condition. See the core
statements ON and RESUME in Section 2, “Core Statements.”