GDSX Manual

Service Routines
Extended General Device Support (GDSX) Manual–134303
8-25
^FILE_GETRECEIVEINFO_
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-67 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.
^FILEINFO
This procedure obtains error and characteristic information about a file. ^FILEINFO
may be called whether USCODE is converted or unconverted. The ^FILE_GETINFO_
procedure provides only a subset of the functions available with ^FILEINFO.
Except for the following consideration, the syntax, condition code settings, and
considerations regarding this procedure are the same as the counterpart in the Guardian
Procedure Calls Reference Manual.
Consideration
To get the last file management error for a task, use CALL ^FILEINFO( -1, ERROR).