GDSX Manual

Service Routines
Extended General Device Support (GDSX) Manual–134303
8-24
^FILE_CLOSE_
p-reg input
INT:value
contains the contents of the P register when FAULT is called.
e-reg input
INT:value
contains the contents of the E register when FAULT is called.
^FILE_CLOSE_
This procedure closes an open file. The ^CLOSE and ^FILE_CLOSE_ procedures
function exactly the same. ^FILE_CLOSE_ may be called whether USCODE is
converted or unconverted. This procedure is a waited operation.
The syntax, condition code settings, and considerations regarding this procedure are the
same as the counterpart in the Guardian Procedure Calls Reference Manual.
^FILE_GETINFO_
This procedure obtains a limited set of information about a file identified by file number.
The ^FILE_GETINFO_ procedure provides only a subset (last error, file name, and file
type) of the functions available with ^FILEINFO. ^FILEINFO and ^FILE_GETINFO_
can be called whether the application is converted or unconverted. ^FILE_GETINFO_
is a waited operation.
Except for the following considerations, the syntax, condition code settings, and
considerations regarding this procedure are the same as the counterpart in the Guardian
Procedure Calls Reference Manual.
Considerations
•
A filenum parameter value of -1 will return the last file-system error against the
current task.
•
If TSCODE is unconverted, then it is recommended that USCODE call ^FILEINFO.
When TSCODE is unconverted and USCODE calls ^FILE_GETINFO, the
following should be noted regarding the returned information:
•
Filename uses the C-series internal expanded format.
•
Filename-length is always returned with a value of 24.
•
Type-info is returned in a buffer of 5 words of which only the first word is
relevant.
^FILE_GETINFOBYNAME_
This procedure obtains the device type and the physical record length of a file. The file
can be open or closed.