25.1 Purpose
FILES is a program which selectively prints or displays DOS file descriptions in file name sequence.
One may select information pertaining to all DOS files or to only those files with names and/or extensions beginning with the characters specified by the operator. Selected directory entries are sorted into ascending file name sequence. If desired,
information from associated Retrieval Information Blocks
(described in the chapter on System Structure) is also extracted for each directory entry. Extracted data is interpreted and displayed on the screen, listed on a Local or Servo printer, or written to a disk file.
25.2 Use
To execute the FILES program, type in the name FILES followed by selection criteria and display options (if option codes are to be used):
FILES [<filename>J[/<ext>J[:<drv>J[,<subdir>J[,<output-file>J[;optionsJ
<filename> Select entries for files with names beginning with the 1-8 characters specified.
<ext> Select entries for files with name extensions starting with the 1-3 characters specified.
<drv> Specifies the disk drive to be selected.
If this field is omitted, drive 0 will be selected.
<subdir> Specifies the named subdirectory from which to select entries.
<output-file> Specifies the disk file to which the
selected entries will be written, if disk file output is specified.
options: The following option codes are available, and may be entered in any order:
N - Suppress file allocation map.
D - Display on CRT.
L - List on local printer.
S - List on servo printer.
F - Write output to disk as DOS text-type file.
If options are keyed and D, L, Sand F are omitted, then D is assumed. D, L, S, and F options are mutually exclusive; output can be sent to only one device. If F is keyed and the (output file spec) is not present in the command line, one is requested by the message:
DOS OUTPUT FILE SPEC:
25.3 Default Messages
If no option codes are entered, the following messages will be displayed on the CRT:
SUPPRESS FILE ALLOCATION MAP?
If "Y" or "YES" is entered in response to this message, the display of file allocation information from Retrieval Information Blocks (RIB) will be suppressed. If any other response is
entered, file allocation information will be displayed for each selected file.
After the user has replied to the map selection message, the program will test to see if the there is a servo printer connected to the processor. If a servo printer is attached and ready, the following message will be displayed:
LIST ON SERVO PRINTER?
If the user enters a "Y" or "YES" in response to this
message, the servo printer will be selected to display output. If any other response is entered or the program cannot find an
available servo printer, the program will test to see if a local printer is connected and ready for printing. If the program finds that a local printer is available, the following message will be displayed:
LIST ON LOCAL PRINTER?
25-2 DISK OPERATING SYSTEM
If the user enters "Y" or "YES" in response to this message, the local printer will be selected for output. If a printer has been selected for output, the following message will be displayed:
ENTER HEADING:
Up to 32 characters can be entered, which will be displayed at the top of each page of printed output.
If no printer is available, or if the operator has rejected printer output, the program will ask for disk output:
WRITE OUTPUT ON DISK?
If the user enters "Y" or "YES", output will be wri tten to a disk file, otherwise output will be displayed on the CRT. If disk output is selected, an output file name will be requested unless one was provided on the command line.
25.4 File Descriptions
File descriptions are sorted into ascending file name sequence for easy reference and displayed or printed in the following format:
FILENAME/EXT (PFN) DW
DW flags following the Physical File Number (PFN) indicate if the file is delete protected (D), or write protected (W). If the file allocation map was not suppressed, messages describing the file's size and location will be included in the file description.
When allocation map information is printed or displayed, the
program displays totals lines specifying the total number of files listed and the total number of sectors in those files. Disk
output never has totals lines.
Depressing the DISPLAY key during display or printing of file descriptions will cause the prdgram to pause until the key is
released. Depressing the KEYBOARD key will cause the program to terminate and return control to the operating system.
Allocation map information describes each segment in the file by giving the cylinder and cluster starting address of the segment and its length in sectors. One line is displayed for each
segment. See the chapter on System Structure and the Appendix for the ,appropriate DOS for a description of disk' space allocation.
25.5 Error Messages
*
PARITY ERROR*
FILES can not continue due to an irrecoverable parity error encountered while" trying to read data from the disk.
*
DRIVE OFFLINE*
FILES is unable to connect to the disk drive selected by the operator (drive 0 if not otherwise specified).
FILE(S) NOT FOUND.
No Directory entries h~ve been found that meet the user's selection criteria.
INVALID DRIVE
An invalid drive specification was entered.
CONFLICTING OPTIONS SPECIFIED
Options specify output on more than one device.
UNRECOGNIZABLE OPTION CODE
An unrecognizable code has been entered in the option field.
PRINTER NOT AVAILABLE
An option code specifies a printer that does not respond when tested for status.
25-4 DISK OPERATING SYSTEM