DISKLIST Version 2.64 This file contains the list and documentation for new features in DISKLIST since Version 2.50 - these are not in the DISKLIST manual that is in the file DISKLIST.DOC. Please read DISKLIST.DOC, and, if you are using a laser or ink jet printer, also read DISKLASR.DOC. The major new features since Version 2.50 are: 1) DISKLIST can now create a Disk Catalog, 2) List only the files in a specific subdirectory, 3) The ability to run DISKLIST without any display, unless DISKLIST has to report an error. Consequently, it can also be run from a batch file. 4) Finely adjust the left margin when printing on Avery labels. 5) Set the last drive letter - allows DISKLIST to run on a LAN. 6) Automatically read a title line from a disk. 7) Print multiple lines of text from a file onto the list. 8) Deselect any DISKLIST data including file directory data. 9) A new output device option is Ink Jet Printer. These are explained in more detail in NEW FEATURE DESCRIPTION below. BUG FIXES DISKLIST will now run from subdirectories that have a very long path name. Previous versions of DISKLIST won't run under this condition. It blew up when it tried to find the file DISKLIST.PRM in the subdirectory with the long name. DISKLIST now reports the actual drive size on partitions larger than 67 megs. Before it would give a number like -57 million for the space on large drives. DISKLIST now handles error code 24 generated by some printers and does not abend. EDITORIAL CHANGE A few of the original DISKLIST format titles have changed to be consistent with the titles of formats added later, but all formats are the same since Ver 2.50. For example, 'NORMAL' is changed to '1 with All' to indicate 1 column on the list containing all data fields - Name, Size, Date, Time. -1- NEW FEATURE DESCRIPTION 1. DISK CATALOG DISKLIST can produce a single catalog file of the files that are on many disks. The purpose is for you to be able to search a list to determine which disk a particular file is on. It is intended to be used for disks that contain data files. First check to make sure each disk has a label name. Use the DOS command DIR or LABEL to display the label name. If you want to add or change a label, use the DOS command LABEL. LABEL A: If you don't want to delete or change the existing label, press return when DOS prompts for a new label or none. DOS will then ask if you want to delete the existing label. The label name can be 11 characters and have imbedded spaces. Don't use a period like you do in a file name or DOS will say the name is invalid. Also write the label name on the disk with a felt tip pen so you can identify the disk later. Run DISKLIST to create the catalog file. For Parameter 5 in the control window, Output Device, select Disk & Vol Name. This feature is similar to the output device File with two exceptions. Only file names, space, date, and time are written to the file, not any titles or directory names. And, the disk volume label name is written on each line before the file name. To make use of this feature, run DISKLIST on a series of disks and send the output to the same catalog file. DISKLIST will append data to a previously used catalog file. You can add a comment about each file name in the catalog file that DISKLIST produced. Use an ASCII word processor such as PC-Write or DOS 5 EDIT. Start the comment after the file time data. Then sort the file on the file name with the DOS sort command using the following syntax: SORT /+15 < input file name > output file name The symbols < and > are part of the command and you must put them in. The input file name is the file DISKLIST wrote all the data to. The output file can have the same name or any other name. For example, if your catalog file is named CATFILE, then the sort command would be: SORT /+15 < CATFILE > CATFILE You can sort on the comments you inserted with the command: -2- SORT /+58 < input file name > output file name The switches /+15 and /+58 specify the column that SORT starts sorting on. To find out more about sort in DOS 5 use the command: SORT /? Now you can print the catalog file to visually scan to find out what disk a particular file is on, or search the catalog file using a word processor or LIST or Q-DOS 3. 2. SUBDIRECTORY LIST DISKLIST can now limit the list to the files in a single directory or directory tree. Below is the new control window. Parameter 3 now contains the functions of the old parameter 3 & 4. Parameter 4 defines the directory you want to list. If the directory name is longer than the display area, the name is truncated for the display but the full name is used. On the same line as Directory is the command B to toggle Yes or No your desire to also list the subdirectories of the directory you selected. Parameters D I S K L I S T Commands ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ 1 - Disk Drive C: H or F1 - HELP A - Space Yes 2 - Filespec *.* P - Print List Z - ZIP No 3 - Sort Files by Name Ascending L - Line Feed E - Eject Page 4 - Directory \PROCOMM\FILES B - Subdirs Yes T - LPT1: 5 - Output Device Laser Printer S - Save Title on Disk Drive 6 - Format 5¬ 1 with All R - Read Title from Disk Drive 7 - Border Line Type IBM ÃÄÄÄ´ F - Print Registration Form 8 - Lines Per List 28 C - Configuration 9 - Title for List F10 or ESC - Quit DISKLIST 3. BATCH OPERATION DISKLIST Command Line Syntax for automatic operation DISKLIST can be run from the command line or a batch file without any display. It will print one list then exit. Only /AUTO is required. The format of the command line is: DISKLIST drive /AUTO, filespec, directory, list subdirectories?, type sort, sort direction, output device, format, printer port, read title from disk -3- drive the drive letter of the diskette to be read, optional /AUTO tells DISKLIST to perform an automatic operation filespec file selection template, i.e. *.* directory directory name list subdirectories? 0 = Yes, 1 = No Type Sort Enter a digit for the type sort desired: 1 = Name, 2 = .EXT, 3 = Date, 4 = Size, 5 = No sort Sort Direction 0 = Ascending, 1 = Descending Output Device 0 = NonLaser printer, 1 = Screen, 2 = Disk, 3 = Laser Printer, 4 = Avery-Laser 5 = Sleeve on LJ 3, 6 = Catalog file Format 1 to 36 as numbered in DISKLIST with F7 Printer Port Enter LPT #, i.e. 1, 2 or 3. Enter digit only Read Title Y = read, N = not to read, the title for list from DISKLIST.TTL on the selected drive All of these parameters are optional except /AUTO. DISKLIST will use the values you used last that are saved in the file DISKLIST.PRM unless you override then on the command line. If you do want to override a selection, you must insert all of the commas before the value so DISKLIST knows which parameter you are changing. For example, if the only change for this run to parameters saved in the DISKLIST.PRM file is that you want to sort by size instead of by the selection saved in DISKLIST.PRM, then enter this command: DISKLIST /AUTO,,,,4 The last three of the four commas indicate that you accept the values in DISKLIST.PRM for filespec, directory, and list subdirectories?. And since there are no entries after the 4 (for Size), you also accept all the other parameters in DISKLIST.PRM. DISKLIST.PRM is not changed after a /AUTO run. There is a file on the distribution disk named AUTOLIST.BAT. You can edit it with a text editor to insert the values you desire in the line that starts with DISKLIST. Rem stands for REMARK and tells DOS to ignore that line. The comments on the rem lines are there to help you figure out what parameters to put where. Leave all the rem lines in, and execute the bat file just by entering its name, AUTOLIST, at a DOS prompt. You may also run DISKLIST /? which produces a help screen. The file DISKLIST.HLP must be in the same directory as DISKLIST.EXE. 4. ADJUST AVERY LABELS On some laser printers the list doesn't quite align with the Avery labels and a character or two may not print on the label. -4- You may adjust the left margin where DISKLIST starts printing the Avery label. Select Configuration from the control window. Then select item D from the Configuration menu. You are prompted to enter values that will reposition the printing of the lists by 720ths of an inch for each column of both 3« and 5¬ labels. The values can be positive or negative. Negative values adjusts to the left. An adjustment of the left margin of one label column does not affect the position of the other label columns. Each column is adjusted individually. These values are saved by DISKLIST. When prompted for new values, enter a new value or press RETURN to accept the value in the brackets. For example, DISKLIST prints about 17 characters per inch on most Avery Labels. So to shift the left margin to the right by one character, the value entered would be 42 (= 720/17). You can see that you have very fine control of the position of the left margin. 5. SET THE LAST DRIVE LETTER (This feature is also useful even if you do not access a LAN, so all should read it). When DISKLIST starts, it checks to determine the last physical drive in your computer and limits your drive selection to this value. LAN users have additional drive letters that previous versions of DISKLIST could not read. To set the last drive letter in DISKLIST, select Configuration from the control window. Then select item E from the Configuration menu. A question mark indicating a prompt appears at the end of the menu line: Last Drive for LAN use? Enter the highest drive letter you expect to use. It doesn't hurt to enter Z. If you try to have DISKLIST read a drive that it can not, it presents an error message. If you have selected a last drive letter and want DISKLIST to return to automatic detection of the last drive, press return at this prompt. This feature can also be used if you only want DISKLIST to select drives A and B. Set the last drive letter to B. 6. DISKLIST has had the ability to print a single line title that can be saved on the disk in a file named DISKLIST.TTL. The title and file can be created from DISKLIST. DISKLIST contains a -5- command to read the title from the file. Ver 2.64 contains the option of having DISKLIST automatically read the title that is on a disk when a list is printed. Toggle this option on and off in the configuration screen. It is item F, Auto Read Title from Disk. Like all configuration settings, your choice is saved when you exit DISKLIST. If you are running DISKLIST with the /AUTO switch as described above and the default setting in your parameter is to read the title from the disk, you can overide it using N for the parameter to read the title from the disk. 7. In addition to the one line title, DISKLIST now allows a multiple line message to be printed at the top of the list. It is printed below the title and disk volume name, although both of these can be deselected from the configuration screen. Put your message in an ASCII file. Name that file DISKLIST.HDR. If DISKLIST.HDR is in the root directory of a disk, DISKLIST will print it as is, whereas DISKLIST centers the title on the list. Actually it is possible to use DISKLIST to just print this message by deselecting everything else. 8. Configuration Screen Additions. Use the configuration screen to toggle the data elements that DISKLIST prints about the disk on and off. Press C when in the control window to activate the configuration screen. Read the configuration list carefully. The purpose of the configuration screen is to give you control over the layout of the list. New options are always being added. A few of the new ones will be mentioned here. You can turn off the printing of the file names. And, registered users may disable printing Created by DISKLIST. Another new option on the configuration screen is to Print Root Directory Name - Yes/No. Benefit - one less line on the list if you are trying to print many file names on an Avery label. 9. DISKLIST now has Ink Jet Printer as a new Output Device option. The output device Ink Jet Printer works exactly the same as Laser Printer because the ink jet uses the same HP commands and command data file, DISKLIST.LSR. The Ink Jet Printer option is there so that ink jet users know what output device to use without reading the manual. Ink jet users please read the section of the DISKLIST manual, DISKLIST.DOC, on the Deskjet - it contains some very important ink jet setup information. -6- Configuration Menu 1 - NonLaser Printer Codes F5 2 - Laser Commands F6 3 - Form/Printer Sizes F7 4 - Date Format MM/DD/YY 5 - Download a Font F3 6 - Print Total Space at TOP Yes 7 - Print Date-Time at TOP No 8 - Print Date-Time at BOTTOM Yes 9 - Lines to skip at label gap 0 A - Line under Title & Label No B - A Blank Line at the Top No C - Print File Names Yes D - Position Avery Labels E - Last Drive for LAN use F - Auto Read Title from Disk Yes G - Print Root Directory Name Yes H - Print Header File Yes I - Print Volume Name Yes J - Print Created by DISKLIST Yes -7-