1 DIRECTORY Provides a list of files or information about a file or group of files. The files must reside on a foreign volume; EXCHANGE does not list directories of Files-11 volumes. Format DIRECTORY [file-spec[, . . . ]] 2 Parameters file-spec[, . . . ] Specifies one or more files to be listed. The /VOLUME_FORMAT qualifier determines the syntax of a file specification. To specify more than one file, separate the file specifications with either commas or plus signs. You can use wildcard characters in the directory specification, file name, file type, or version number fields of a file specification. 2 Qualifiers /ALL /ALL /NOALL Lists all deleted or unused files on an RT-11 volume, in addition to other files selected by the command. For example, the following command lists all MACRO source files, in addition to deleted and unused files: EXCHANGE> DIRECTORY DMA0:*.MAC/ALL /BADBLOCKS /BADBLOCKS /NOBADBLOCKS Scans the volume to find any blocks that return read errors. The data on the volume is not modified. If a bad block replacement table is present, the contents of the table are displayed. This is valid for RT-11 volumes only. /BLOCKS /BLOCKS /NOBLOCKS Lists the starting block number of the file. This qualifier is valid only for directories of RT-11 devices. The first block of the device is block number 0. The default is /NOBLOCKS. /BRIEF /BRIEF /NOBRIEF Includes only the file name of each file to be listed. Specifying the /BRIEF qualifier is equivalent to specifying /NODATE/NOSIZE. The default is /BRIEF. /COLUMNS /COLUMNS=n Lists the files, using the specified number of columns on each line of the display. This qualifier is used in conjunction with the /BRIEF qualifier (either explicitly or by default). The default number of columns is dependent on the volume format and the information requested. The DIRECTORY command attempts to use as many columns as possible. If you request too many columns, DIRECTORY displays a message and reduces the number of columns to the number that fit on the listing. /DATE /DATE /NODATE Includes the date for each file listed. If you omit this qualifier, the default is /DATE. /DELETED /DELETED /NODELETED Lists a directory of files that have been deleted from an RT-11 device, but whose file name information has not been destroyed. The listing includes the file names, types, sizes, creation dates, and starting block numbers (in decimal, unless you also specify the /OCTAL qualifier) of the deleted files. The /DELETED qualifier is valid only with block-addressable volumes in RT-11 format. The default is /NODELETED. /FREE /FREE /NOFREE Includes unused areas in the directory listing. The /FREE qualifier is valid only with RT-11 formatted volumes. /FULL Lists all the available information for each file. The format of the listing depends on the format of the volume. The /FULL qualifier overrides the default brief listing format. /OCTAL /OCTAL /NOOCTAL Controls whether numeric information is displayed in decimal or octal format. The default is /NOOCTAL; numbers are displayed in decimal radix. Dates are always displayed in decimal format. /OUTPUT /OUTPUT[=file-spec] Writes the DIRECTORY output to a specified file, rather than to the current SYS$OUTPUT device. If you specify the /OUTPUT qualifier without a file specification, the output is directed to SYS$OUTPUT. If you omit the file type in the file specification, the default file type is LIS. If you specify a file type and omit the file name, the default file name is EXCHDIRE. No wildcard characters are allowed in the file specification. /OWNER Displays information about the owner of a volume and the files on the volume. For RT-11, the volume owner is shown. For DOS-11, the UIC of the file owner is shown. /PRINTER Queues the command output for printing under the name specified by the /OUTPUT qualifier. If you specify /PRINTER without the /OUTPUT qualifier, the output is directed to a file named EXCHDIRE.LIS, which is spooled for printing and then deleted. /SIZE /SIZE /NOSIZE Displays the file size in blocks for each file listed. The default is /SIZE. /SUMMARY /SUMMARY /NOSUMMARY Lists a summary of the usage of the directory segments for an RT-11 volume. If a bad block replacement table is present, the contents of the table are displayed. /VOLUME_FORMAT /VOLUME_FORMAT=option Defines the physical format of the volume to be processed. The default format is dependent on the device type. The EXCHANGE command DIRECTORY is not valid for Files-11 devices. 2 Description The output of the DIRECTORY command depends on the volume format and on certain formatting qualifiers and defaults. The following are the formatting qualifiers: /ALL /BLOCKS /BRIEF /COLUMNS /DATE /FULL /OCTAL /OWNER /SIZE The files that are listed always appear in the order in which they appear in the volume directory or the order in which they reside on a magnetic tape. 2 Examples 1.EXCHANGE> DIRECTORY DLA2:.OBJ/VOLUME=RT11/FULL The command in this example lists all files with the type OBJ on the RT-11 volume mounted on DLA2. The /FULL qualifier causes the file sizes and dates to be listed along with the names. 2.EXCHANGE> DIRECTORY MFA0:/VOLUME=DOS11 The command in this example lists all files on the DOS-11 magnetic tape mounted on MFA0. The magnetic tape is rewound before the files are listed.