Asynchronous Serial Communications Programmer's Reference Manual (32022-90052)

234 Chapter9
Intrinsics Reference (cont)
FGETINFO
blanks on the right. A nameless file returns an empty
string. Note that all character arrays must start on a
halfword boundary.
The fully qualified name of the file referenced by
filenum is returned as the value of this parameter.
Only names which can be expressed using MPE only
semantics are returned. If the name of the object
referenced by filenum cannot be expressed using MPE
name semantics, a CCL condition code is returned.
Calling FCHECK after this error will result in an error.
foptions 16-bit unsigned integer by reference
(optional)
Returns information about the
foption
characteristics
that are set through the FOPEN or HPFOPEN call.
The bit settings that designate each of these
characteristics are listed below. Note that not all of the
foptions
are meaningful for files on asynchronous
devices.
Bits (14:2) —Domain
foption
.
Domain is meaningless for asynchronous devicefiles.
However, if file redirection was anticipated at the time
the file was opened, these bits may have been set.
=00 The file is a new file.
=01 The file is an old permanent file.
=10 The file is an old temporary file.
=11 The file is an old file.
Bit (13:1)—ASCII/binary foption.
Note that all files not on disk are treated as ASCII.
=0 Binary.
=1 ASCII.
Bit (10:3)—Default file designator
foption
.
=000 The actual and formal file designators
are the same.
=001 The actual file designator is $STDLIST.
=010 The actual file designator is $NEWPASS.
=011 The actual file designator is $OLDPASS.
=100 The actual file designator is $STDIN.
=101 The actual file designator is $STDINX.