40.24. lookUpLogicalName

lookUpLogicalName returns the true file name associated with the logical name logicalName. A logical name association may be established by means of enterLogicalName. The null STRING is returned if no true file name is associated with logicalName.

If logicalName is the null STRING, lookUpLogicalName returns a STRING containing all defined logical names and their definitions. The STRING consists of one line for each logical name; the logical name is followed by a space character followed by the logical name's definition. For example, the return value:

"(service protocol table) /usr/local/lib/mslhosts" & eol &
"(system library) /mainsail/16.20/syslib.msl" & eol &
"xyz /usr/jim/xyz.dat" & eol

means that the following three logical names are defined:

(service protocol table)
(system library)
xyz

Note that the logical names may contain spaces but that the definitions of the logical names may not, so that the true name is the last (blank-delimited) word on each line.