Function
Produces a listing of selected information about file entries contained in a directory.
Format
LISTDIR filename,output level,basic output peripheral type,PROPERTY property names
The filename must be the name of a directory file. If the first parameter is null, the job's current directory is assumed. Since all directories have generation 1 and language C1 supplied by GEORGE, the user should not include such details in the filename parameter. If included the generation number and language will normally be ignored but in some cases will cause a command error.
The third parameter gives the type of peripheral on which the listing is to be output. If it is omitted, the monitoring file system (LISTING category) is assumed. The only peripheral type permitted is *LP. If this is given, the further parameters, PROPERTY and property names, may be given. Further details are given under the LISTFILE command.
The output level specifies the amount of information required in the listing and may be either HIGH or LOW. If it is omitted or null, LOW is assumed. The significance of these parameters is as follows:
| Output Level | Listing information about each entry |
|---|---|
| LOW | type of entry (file or magnetic tape) name reel sequence number (for magnetic tapes) generation number language (for files) serial number (for magnetic tapes) |
| HIGH | all the information above retention period date and time written type number/mode (for peripheral files) increment number of the latest dump of the file date and time of the last dump number of copies in on-line storage size of the file (in 512 word blocks) |
Forbidden contexts
NO USER
Execution
A check is made that the user is allowed to read the named directory. The
listing is produced in HIGH or LOW level format using an internally
issued LISTFILE command. If
the directory is empty, the message:
DIRECTORY IS EMPTY
is printed out.
Examples
| LISTDIR :MANAGER,LOW | A LOW level listing of :MANAGER's directory will be sent to the monitoring file system. |
| LISTDIR :PSEUDIR,HIGH,*LP | A HIGH level listing of the directory :PSEUDIR will be output on a line printer. |
Error Messages
PERIPHERAL TYPE z NOT AVAILABLE
THE OUTPUT LEVEL MUST BE EITHER HIGH OR LOW
z IS NOT AN OUTPUT DEVICE
THIRD PARAMETER MUST BE NULL OR *LP
YOU CANNOT CHOOSE THE DETAILS OF THE LOCAL NAME OF A DIRECTORY
PERIPHERAL PROPERTIES z NOT AVAILABLE