GDSX (Extended General Device Support) Manual

Service Routines
Extended General Device Support (GDSX) Manual—529931-001
8-25
^FILE_GETINFOBYNAME_
•
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.
If USCODE is unconverted, TSCODE receives device information in the C-series
system message format, and so USCODE tasks cannot call this D-series service
routine. If a task within an unconverted application calls this procedure, file-system
error 29 or 560 is returned. Unconverted USCODE must instead call ^DEVICEINFO2.
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
•
Calling ^FILE_GETINFOBYNAME_ in a nowaited mode causes the calling task to
be suspended.
•
If you want USCODE to provide calls to ^AWAITIO[X] in order to wait for I/O
completion on ^DEVICEINFO2, ^FILE_GETINFOBYNAME_, and
^PROCESS_CREATE_ service routines, as would be done for typical nowaited
Guardian procedure calls, you must set the PROCNOWAIT configuration
parameter to 1. If you want TSCODE to supply AWAITIO[X] calls to complete
these nowaited I/Os on behalf of USCODE, you set the PROCNOWAIT to 0. See
PROCNOWAIT on page 2-70 for more information.
^FILE_GETRECEIVEINFO_
Information about the last message read on $RECEIVE is returned from
^FILE_GETRECEIVEINFO_. If USCODE is unconverted and a user task calls this
procedure, file-system error 29 or 560 is returned. Unconverted USCODE must
instead call ^RECEIVEINFO.
To facilitate coding of this procedure, USCODE may source in the
getreceiveinfo^template section of the ULHDECS, ULHDECSE, or USKELDEC
installed subvolume files.
The syntax, condition code settings, and considerations regarding this procedure are
the same as the counterpart in the Guardian Procedure Calls Reference Manual.