V V U U EEEEEEE RRRRRR A N N V V U U E R R A A NN N V V U U E R R A A N N N V V U U EEEE RRRRRR A A N N N V V U U E R R AAAAAAA N N N V V U U E R R A A N NN V UUUUUUU EEEEEEE R R A A N N V V EEEEEEE RRRRRR SSSSS IIIII OOOOO N N V V E R R S S I O O NN N V V E R R S I O O N N N V V EEEEEE RRRRRR SSSSS I O O N N N V V E R R S I O O N N N V V E R R S S I O O N NN V EEEEEEE R R SSSSS IIIII OOOOO N N 222222 111111 2 2 11 11 2 11 2 11 2 11 2 11 22222222 * 1111111 NOTICE This program was written by James A. Jarboe IV and donated to the AMUS system for use by its members at no charge. This program makes use of two assembly language routines that are available from the AMUS system. They are ACCEPT.SBR and PPN.SBR by Mike Sigona, modified for the AM100/L by John Keys. The program will run fine without PPN.SBR if the XCALL PPN is remarked out and it will run using any subroutine in place of ACCEPT.SBR if that subroutine accepts one character input including control characters. Just rename the subroutine to ACCEPT.SBR or change the XCALL ACCEPT in the program VUERAN.BAS to the name of your subroutine and recompil. This version of VUERAN was written on an AM100/L but should run on any AM100/whatever if recompiled and uses an assembly language routine that accepts one character input. PREFACE VUERAN is a vue like data editor used for vueing Random files on the Alpha Micro computer. It allows the editing of any Random file no matter the size or structure of it's data. It can save time in writing a new program for a specific Random file each time you need to get in, locate, and correct or modify data. This program enables you to manipulate data on all Random files. With a good knowledge of this Manual and a little practice you will be able to quickly locate and manipulate any data in the Random file just like modifying a regular sequential VUE file. VUERAN'S DISPLAY WINDOW Only 512 bytes of the Random file may be displayed on the terminal screen at any one time. You should consider this display to be your window on the file through which you vue the data in that portion of the file. QUICK REFERENCE Screen Mode: right................^L or right arrow key left.................^H or left arrow key up...................^K or up arrow key down.................^J or down arrow key beg. of line.........^U end of line..........^N (end of ASCII string) erase to end of line.^Y next line............^M or carriage return beg. of file.........^^ or home key end of file..........^E page up..............^R page down............^T binary number........^B floating point #.....^F next match...........^X next word............^W next logical record..^G exit screen mode ....ESC ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Command Mode: specify page.........P)age restore page.........B)ackup switch random files..A)nother character fill.......F)ill return to AMOS.......Q)uit & finish search for string....S)earch replace string.......R)eplace global replace.......G)lobal calc MAP statements..M)aps sort random..........SORT set record size......TAB print data...........PRINT return to screen.....CR CHAPTER 1 SCREEN MODE When the cursor is within VUERAN's window on the file you are said to be in Screen Mode. As well as Modifying and Deleting data in this mode by typing over the data displayed, there are numerous control characters which allow you to rapidly move the cursor around throughout the file to manipulate data. VUERAN is always in the screen mode unless an ESC is pressed. This puts you in the command mode which allows other types of file manipulation by entering the proper command. At any point in Screen mode you may press ESC then Q to end VUERAN, with all file modifications made, and return to AMOS. While in the screen mode control characters are used to move the cursor to the proper location, delete characters, lines, erase or add data. CURSOR MOVEMENT Cursor Right: ^L or right arrow To move the cursor right one position within the current line, press ^L (or use the right arrow key on many terminals). If the cursor is at the end of the line, it will "wrap" to the beginning of the next line below. If the cursor "wraps" at the end of the current page, the cursor will wrap to the begining of the next 512 bytes on the next page. Cursor Left: ^ H To move the cursor left one position within the current line, press ^H (or use the left arrow key on many terminals). If the cursor is at the beginning of the 1 line, it will "wrap" to the end of the previous line above. If the cursor "wraps" at the beginning of the current page, the cursor will wrap to the end of the previous 512 byte current page. Cursor Up: ^ K To move the cursor up one line in the file, press ^K (or use the up arrow key on many terminals). The cursor will be at the same position within the new line as the previous line. If the cursor is within the first line of the current page and you move up, the cursor will move to the last line of the previous 512 current page. Cursor Down: ^ J To move the cursor down one line in the file, press ^ J (or use the down arrow key on many terminals). The cursor will be at the same position within the new line as the previous line. If the cursor is within the last line of the current page and you move down, the cursor will move to the first line of the next page. Pressing RETURN, will place the cursor at the beginning of the next line in the file regardless of its position in the previous line. Cursor to beginning of Line: ^ U To move the cursor to the beginning of the current line, press ^ U. Cursor to End of Line: ^ N To move the cursor to the end of the current line, press ^N. Since we are working with Random files and since they are capable of handling 6 byte floating point numbers and binary numbers control N will only move the cursor to the end of the current ascii string data. 2 Beginning of File: ^^ or Home key To move the cursor to the beginning or first record of the file press ^^ or the Home key on many terminals. End of File: ^E To move the cursor to the end of the entire file, press ^E. Page Up: ^R To move the cursor back one page in the file, press ^R. The cursor will be at position one or the first byte of the page displayed. Note that when the cursor is within the first page of the file no upward paging occurs. Page Down: ^T To move the cursor down one page in the file, press ^T. The cursor will be at position one within the new page displayed. Note that when the cursor is within the last page of the file no downward paging occurs. Next word: ^W To move the cursor to the next word press ^W. The cursor will move to the next recognizable word. Next record: ^G When in the TAB mode a ^G will move the cursor to the next logical record as indicated by the record size. The cursor will be at position one or the first byte of the record. If the cursor is within the last record of the current page and a ^G is pressed then the cursor will move to the first byte of the record on the next page. If the cursor falls within a area that is not a valid record depending on the record size within 3 a 512 byte block then a "not valid" will be displayed in the "Record #" field. NOTE: If a ^G is envoked while not in the TAB mode then the cursor will move to the end of the current page. String data: Type-over String data may be modified by simply typing new characters over old characters on the screen. For instance, suppose that you have an invalid date in the file and displayed on the screen as "102482". You wish to change that date to be "012482". First position the cursor on the "1" and then type "01" right over the "10". The date both in the file and on the screen is now "012482". Floating Point data: ^F Each floating point number in a random file always takes up six bytes. To this end VUERAN has the ability to display any six byte group as a decimal value at any point in the random file. There are two modes to use this function: 1. Place the cursor on the first byte location of the floating point number then type a control F (^F) . The floating point number will appear in the lower left hand corner and then ask the number to change it to. If a change in the number is desired then type in the number and a carriage return. If no number change is wanted then type a carriage return. OR 2. From the screen mode type an ESC for command mode, then type an N number type choice. Then F for floating point numbers. Then enter the byte location of the floating point number. The number will be displayed . Type any new number, positive or negative, that you wish stored at that location then press RETURN. VUERAN then returns to the screen mode. Binary data: ^B Each binary number in a random file takes up from 1 to 5 bytes. At this time VUERAN has the ability to display only any 1 to 2 byte group as a decimal value at any point in the random file. There are two modes to use this function: 4 1. Place the cursor on the first byte location of the binary number then type a control B (^B) . VUERAN will ask how many bytes this number is. Enter a 1 or a 2 then a carriage return. The Binary number will appear in the lower left hand corner and then ask the number to change it to. If a change in the number is desired then type in the number and a carriage return. If no number change is wanted then type a carriage return. 2. From the screen mode press ESC then N for number choice then B for binary numbers. Then enter then byte location of the binary number. Then enter the length of the binary number 1 or 2. The number stored at that location is displayed. Type any new number, positive or negative, that you wish stored at that location then press RETURN. VUERAN will then return to the screen mode. DELETIONS Character at a time: Type-over To delete data character at a time, you may use the Space Bar. RUB or DEL or ^D. You may use any character you wish (e.g. in AlphaACCOUNTING a "]" is used to fill the logical record after which it is simply sorted to the end of the file). 5 CHAPTER 2 COMMAND MODE Some commands in VUERAN are not available in Screen mode but are executed in what is know as Command mode. To toggle Command mode when you are in Screen mode, press ESC (or whatever key on your terminal sends the ASCII Control signal ESC). An arrow ">" will appear with the cursor to the right. The ">" is the VUERAN prompt which means that VUERAN is waiting for your command. If VUERAN does not understand your command, it prints "What?" and dings your terminal once. You simply re-enter the command properly. Whenever you wish to go back to Screen mode, press ESC or a carriage return. Specify page: P or PAGE To move the cursor to a specific page in the file, type in P or PAGE then a carriage return. VUERAN will ask "Which page"? Enter a page number and then a carriage return. If the number entered is greater than the possible number of pages in the file the last page will be displayed and a bell will ring. If a number less than 1 is entered page 1 will be displayed and a bell will ring. If PAGE and then a number is entered VUERAN will not ask "Which page ?" it will just go to that page number. EXAMPLE: >PAGE 10 (cr) will display page ten Pages at a time: F for FILL To delete groups of data at a time, enter an F or FILL in command mode. VUERAN now requests the page numbers of data to be deleted. If, at this point, you do not wish to delete the data type a CR. VUERAN next requests the fill character to be used. Simply press the key of the character to be used. If you press 6 RETURN, the default character,"]" will be used. If you do enter a begining and ending page number, the data from the current page to the end page number that you entered will be writen over with the fill character. SEARCH: S or SEARCH To locate a particular word or string of characters in the file, type ESC S. VUERAN then requests the string you are searching for, then press RETURN. Note that VUERAN always begins its search starting at page 1 and continues to the end of the file. If VUERAN finds your string it displays the page where the string was found, with the cursor on the string in lower intensity. You are now back in Screen mode and may resume editing. To find the next occurence of the string, press a ^X. When VUERAN can find no more occurences of the string, it returns you to Command mode. NOTE: If VUERAN is within SEARCH and has not yet found a match, a CR will immediately end the SEARCH and return you to Screen mode with the cursor at byte 1 on the current page in the file that SEARCH had reached when aborted. REPLACE: R or REPLACE To replace a particular word or string of characters in the file, type ESC R. VUERAN then requests the string you wish to replace, then press RETURN. VUERAN now prompts you, with "With ?", for the characters you wish to replace the first string with. If VUERAN cannot find the string to be replaced, it returns you to screen mode record #1. Otherwise, it displays the page where the string was found, with the cursor on the string in lower intensity. VUERAN now waits for you to press one of the following keys: Y - yes, replace this string and go to the next match N - no, go to the next match without replacing this string carriage return - return to screen mode without replacing this string. 7 NOTE: If VUERAN is within REPLACE and has not yet found a match, a CR will immediately end the REPLACE and return you to Screen mode with the cursor at byte 1 on the screen that REPLACE had reached when aborted. ALSO: VUERAN can only replace the same size string. If the string you wish to replace is 10 characters long then the replacement string must also be 10 characters long inclusive of spaces. String Replacements are also limited to 64 characters in length. GLOBAL: G or GLOBAL To replace ALL particular words or strings of characters in the file, type G or GLOBAL in command mode. VUERAN then requests the string you wish to globally replace, then press RETURN. VUERAN now prompts you, with "With ?", for the characters you wish to replace the first string with. If VUERAN cannot find the string to be replaced, it returns you to screen mode record #1. Otherwise, it displays the page numbers it is searching, and replaces every occurance of the string it finds. VUERAN does not wait for your Y or N answer as it globally replaces every occurance of the string it finds. NOTE: VUERAN can only replace the same size string. If the string you wish to replace is 10 characters long then the replacement string must also be 10 characters long inclusive of spaces. String Replacements are also limited to 64 characters in length. BACKUP: B or BACKUP VUERAN always has an immediate backup of the page being displayed. If you modify the page being displayed and then decide you do not want the changes made, then type B or BACKUP in command mode. VUERAN then will display the backup and ask if you wish to use it. A "Y" will REPLACE the screen with the current backup. A "N" will use not use the backup. This immediate mode only stores the last current modification of the screen as first displayed. If you make a change, display another page, and then redisplay the 1st page and ask for a backup, the backup will be what was written in previously. IF you invoke VUERAN with the option "/B" VUERAN will create a 8 backup copy of the random file when it is invoked. The backup file will be "on-line" throughout your editing of the original. Therefore if you make a mistake while editing you simply press B or BACKUP in command mode to immediately restore the Current Page from the backup file. If you have already left VUERAN, simply use the COPY.PRG to restore the entire original file. The backup file has the same filename as the VUERAN'ed file with the extension of ".DAK". NOTE: If you do not have enough free space on the disc for a backup and you set do not use the "/B" option then, you should manually make a copy of the random file on another disc before editing. EXAMPLE for backup option: VUERAN datafile.DAT/B TABSET: T or TAB Since we are dealing with Random files, the data file is usually formatted to a record size containing so many bytes of data. For instance a record size of 25 bytes will allow you 20 data records within a 512 byte block of data. A recordsize of 64 will allow 8 records per 512 byte block. VUERAN allows you to set the record size so that going from record to record is can be done by using a ^G. VUERAN also displays the current byte within the 512 byte block the current record size designation the current byte within that particular record and the logical record number of that file using the record size indicated. This allows for ease in editing data files if the record size is known. To envoke this capability enter T or TAB in the command mode. VUERAN will ask for "Record size ?" enter the desired reocrdsize and then a carriage return. The current record size, location within that record and the current logical record will be displayed according to cursor location. Using a ^G will move the cursor to the next logical record. Entering a record size less than 2 will turn off the tabset function of VUERAN. At that point a ^G will move the cursor to the end of the current page. PRINTING: PRINT VUERAN allows you to print the random file. Only printable ascii characters will be printed. Type PRINT in the command 9 mode. VUERAN then requests how many bytes a line you wish to use. Enter it then RETURN. Next it requests which page to start printing and then which page to end printing. Enter this information then RETURN. Finally VUERAN asks how many lines per page to print. Upon entering this data and RETURNing, VUERAN will clear the screen, count the pages, and spool the file VUERAN.LST to your default printer, and return to the screen mode, on page 1. 10 SUPPORT VUERAN can support many terminals. All the options at this time must be program dependent though. The characters that allow GRAPHIC CAPABILITIES must be change to correspond with your terminal. The LOW and HIGH intensity display capabilities must correspond with those applicable for your terminal. These "customized " features must be made in the listing VUERAN.BAS under the : MAP STATEMENTS: GRAPHON - graphics on character or characters GRAPHOFF - graphics off character or characters LOW - display low intensity character or characters HIGH - display normal intensity character or characters File Extensions On the Alpha Micro, files are specified by a file name of one to six characters followed by a period "." follow by an extension of zero to three characters (i.e. "FILNAM.EXT"). RANDOM EXTENSION default = ".DAT" BACKUP EXTENSION default = ".DAK" FILL CHARACTER default = "]" 11 .