ŚFLIB returns a character matrix of the
names of the component files in a particular directory. Names are padded to the
right with blanks as necessary. It
takes a single argument, which can be either a library number (usually 0 to 9,
corresponding to the rows of the ŚMOUNT table), or a character string representing an operating-system path.
For example, under Windows you might have:
ŚFLIB 1 RUN4 JIM COPY ŚFLIB 'C:\TEMP' RUN3
Only files which end in the .aqf
extension will appear in the list. The
extension is stripped from the names of the files returned.
See also ŚLIB which returns the names of all files in a directory.
In Client-Server implementations of APLX, the front-end which implements the user-interface (the "Client") runs on one machine, and the APLX interpreter itself (the "Server") can run on a different machine.
In such systems, you can specify whether the directory being searched is on the Client or the Server machine. You do this by preceding the path name with either an Up Arrow † to indicate that the directory is on the Client, or a Down Arrow ‡ to indicate that it is on the Server. (If you do not specify, the default is that the access takes place on the Client.) This is true either if you specify the full path name in the ŚFLIB call, or via the ŚMOUNT table.