FLIST Version: V05.00 Date: November 18, 1982 System: RT-11 V02, V03, V04 D. N. Tanner Sandia Laboratories Livermore, CA 94550 ABSTRACT FLIST is a text file listing utility program with special features. The listing includes the file name, creation date and text line numbers appended to each line. Options are available for double spaced listings, selective page or pages, and a wait option for single sheet printers. Features can be deleted including the title block, the line numbers and the output can be changed to some device other than the printer. A form feed simulation option is available for printers with out a form feed feature. FLIST V05.00 Page 2 OPERATION FLIST requests the names of the files to be listed. Each file name is entered separately and is located on the specified disk. Errors are reported immediately so only the file name in error need be re-entered. A carriage return only for a file name will terminate input and start the listing of the files. FLIST has several options which change the listing characteristics. The options can be patched or entered as a command each time FLIST is run. The command is entered when a file name is requested and an asterisk (*) is placed before the command name. For example, the command for double spaced listings is: *DOUBLE. The command options selected take affect only when the listings start. They apply to all files to be listed even though you enter the command after the file name is entered. An execption is the DEVICE and TYPE commands which apply to the file names as you enter them. FLIST can be patched to default to any combination of options. The OPTION command will display the current option settings. All input to FLIST can come from an indirect commands file if you are running on RT-11 V03 or later. The program checks the version of RT-11 so no re-assembly is required to run on earlier versions of RT-11 or HT-11. An example of FLIST operation is: .R FLIST FLIST Vxx.xx File Name: PROGRA.FOR File Name: PROGB.MAC File Name: PROGC.BAS File Name: RK1:DEMO.FOR File Name: DX0:FLOPPY.MAC File Name: (Return only to end input) The files are listed. FLIST starts a new page if the page size is exceeded or a Top of Form character (Control L) is encountered. For Macro files (.MAC file type only) a .PAGE in the text will start a new page. This option can be disabled by patching FLIST. FLIST V05.00 Page 3 COMMANDS DOUBLE Listings are double spaced. The option flag is toggled each time the command is entered. SET reply results in double spaced listings. RESET reply results in single spaced listings. TITLE/NOTITLE The TITLE command enables the title block option. The NOTITLE command disables the option such that the file name, page and date are omitted. LINENO/NOLINENO Adds line numbers to each line in the listing. NOLINENO disables this option. DEVICE Device Changes the default device to that specified for all files to be listed. Example: DEVICE RK1: Will will cause all files to be from RK1 unless specified otherwise in the input. The default is used only if no device is specified. This command affects the file names entered after the command is entered. TYPE Type Sets a default file type for all file names which do not have a period (.). The default is used if no file type and no period is included in the file name. The TYPE command is of the form: *TYPE MAC - default file type is set to "MAC" R FLIST FILE NAME: *TYPE MAC File type: MAC ; Reply to TYPE command FILE NAME: PROG1 ; Lists file PROG1.MAC FILE NAME: PROG2 ; Lists file PROG2.MAC FILE NAME: DATA1.DAT ; Lists file DATA1.DAT FILE NAME: DATA2. ; Lista file DATA2. This command affects the file names entered after the command is entered. NOTE: The command EXT is equivalent to the TYPE command and is retained to be compatable with earlier versions of FLIST. LINES n LINES sets the number of lines per page to the decimal number following the command(n). LINES 63 will set the page size to 60 lines of text and 3 lines for the title, if this option is enabled. FLIST V05.00 Page 4 WAIT This command enables a pause BEFORE each page. This allows the output to go to a single page printer. You will be asked to enter a return just before each page. The message prompting for the return can be disabled for systems using the terminal as the printer, see WAIT message disable patch instructions. WAIT is a toggle command. A second WAIT will disable the option. If WAIT has been enabled by patching FLIST then the WAIT command will disable WAIT. MARGIN n This sets the left margin setting for the NOLINES option. If no line numbers are selected for the listing then a margin of "n" spaces is placed before each line. "n" can be set to any value including zero. An example is MARGIN 5 which sets the margin to 5 spaces. START n This specifies the starting page for the listing. The file (or files) is not listed until the specified page is found. Listing then continues from this page to the end. This command will replace a previous ONLY command and the ONLY command will replace this command. The last command entered will be used. ONLY n Lists only the page specified. All other pages are not listed. This applies to all files entered. OUTPUT file name Output goes to specified device and file. If output is to a file the program will check to see if the file exists on that device. You will be told if the file exists and you must reply to indicate if the operation is to continue. A CR reply says go ahead (create a new file or write over an old file). Any other character typed will abort the operation. Example: File Name: *OUTPUT PROG.LST New file ; Reply with return SET File Name: FLIST V05.00 Page 5 SPOOL SPOOL Sets the output to a file FLISTA.LST. This is equivalent to: *OUT FLISTA.LST If file FLISTA.LST exists then FLISTB.LST is used. The name is changed until an unused file is found. This option is for the line printer spooler which lists all files with the LST extention and runs under the forground background monitor. OPTION The current option settings are displayed on the terminal. QUIT Exit to monitor, Control C also works! No listings are made. HELP Lists a summary of the commands and the current option settings on the terminal. Commands File Part or all of the input to FLIST can come from an indirect commands file. (RT-11 V3 or later). A file could be used to set options, but require the file names come from the terminal. The entire input could come from the file. R FLIST *DOUBLE *TYPE MAC This file will set FLIST to double space, default file type to MAC and request the actual file names from the terminal. FLIST V05.00 Page 6 PATCH OPTIONS There are a few options which are available only by patching the program. These options and the default values of the command options are selected by running the program PATCH. Each patch in done in the same way. Two value are needed, the location to be changed "LOC", and the value to be inserted "NEW VALUE". Options are either set or reset. The Set value is 1. The reset value is zero. The patch is entered as follows: R PATCH PATCH VXX-YY FILE NAME-- *FLIST.SAV *"LOC"/ Present Value "NEW VALUE" *E Return to monitor Extra Page This option gives an extra page after each file listing if the number of pages is odd. The result is an even number of pages for each file. This is useful to get the fan fold to always fold the same for all files listed. No extra page: 1010/ xxx 0 Extra page if number of pages is odd: 1010/ xxx 1 Form Feed, New Page FLIST normally uses the form feed character to start a new page. If there is a form feed in the text FLIST also generates a new page. Form feeds can be simulated with line feeds for those printers which do not have the form feed feature. Send form feeds to the printer: 1012/ xxx 0 Simulate form feeds with line feeds: 1012/ xxx 1 DOUBLE SPACE DEFAULT The spacing option can be changed to default to double spacing. The DOUBLE command toggles this option. Double space default: 1002/ xxx 1 Single space default: 1002/ xxx 0 FLIST V05.00 Page 7 TITLE The TITLE/NOTITLE flag can be patched to default to notitle. The TITLE and NOTITLE commands set this option also. No title: 1006/ xxx 1 Title: 1006/ xxx 0 LINE NUMBERS: The line number flag indicates if line numbers are to be included in the file listing. The LINENO and NOLINENO commands set this option also. No line numbers: 1004/ xxx 0 Line numbers: 1004/ xxx 1 SPOOL OUTPUT This patch causes the listing to be sent to the spool file. See the SPOOL command. Spool 1014/ xxx 1 Normal 1014/ xxx 0 DEFAULT FILE TYPE FLIST normally has no default file type. The TYPE command can be used to set one temporarily. This patch will permanently set a default file type. Enable a Default File Type 1016/ xxx 1 1021\ xxx 115 ;Letter M 1022\ xxx 101 ;Letter A 1023\ xxx 103 ;Letter C This will set the default file type to MAC. Disable the default File Type 1016/ xxx 0 Page Size This flag contains the number of lines per page. The number includes 3 lines for the title block, if it is selected. The LINES command can be used to temporarily set this value. The patch value must be in octal. The example changes the page size to 63 lines. 1000/ xxx 77 ; 63 Lines per page FLIST V05.00 Page 8 DEFAULT DEVICE A default device can be set with a patch. FLIST normally defaults to the device DK:. The DEVICE command can be used to set a temporary default device. This patch will permanently set a default device. Enable a Default Device 1026/ xxx 1 1030\ xxx 104 ;Letter D 1031\ xxx 130 ;Letter X 1032\ xxx 61 ;Number 1 1033\ xxx 72 ;Colon Disable the default device and use DK: 1026/ xxx 0 DOT PAGE The option to start a new page if .PAGE is found in a Macro file can be disabled. Disable the option 1040/ xxx 1 Enable the option 1040/ xxx 0 Margin The default margin can be changed, in Octal, to any value. No margin 1042/ xxx 0 Set Margin 1042/ xxx 10 ; Set to 8. Wait Option The wait option can be permanently enabled. It can be disabled when you run the program by entering the WAIT command. Enable WAIT 1050/ xxx 1 Disable WAIT 1050/ xxx 0 Wait Message Disable The message typed before each page "Type return to continue with the next page" can be disabled by the following patch. When disabled, no message is typed but the program will wait for the return before listing the next page. Disable Wait message 1052/ xxx 1 Enable Wait message 1052/ xxx 0