FIP FILE INTERCHANGE PROGRAM Version 1.0 Reference Manual Soft Circuits, Inc. P.O.Box 15801 Oklahoma City, Oklahoma 73155 COPYRIGHT Copyright (C) 1983 by Garry Womack. All rights reserved. No part of this publication, or the software supplied with it, may be reproduced, in any form or by any means, except for the personal use of the original purchaser. (NOTE: July 31, 1985 released to SIG/M for non-commercial, non-profit public domain distribution.) DISCLAIMER SOFT CIRCUITS, INC. AND THE AUTHOR MAKE NO CLAIMS OR WARRANTIES, EITHER EXPRESS OR IMPLIED, WITH RESPECT TO THE CONTENTS OR ACCU RACY OF THIS MANUAL OR WITH RESPECT TO THE DESCRIBED SOFTWARE, THEIR QUALITY, PERFORMANCE, MERCHANTIBILITY OR FITNESS FOR ANY PARTICULAR PURPOSE. THIS MANUAL AND THE DESCRIBED SOFTWARE ARE SOLD 'AS IS' AND THE ENTIRE RISK AS TO THEIR QUALITY AND PERFOR MANCE RESTS WITH THE BUYER. THE USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM. ANY LIABILITY OF SELLER OR MANUFACTURER WILL BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF THE PURCHASE PRICE. The right is reserved to make any changes to this manual with out obligation to notify any person of such changes. Wherever referred to throughout this manual, CP/M is a registered trademark of Digital Research, Inc., and Z80 is a registered trademark of Zilog, Inc. TABLE OF CONTENTS _____ __ ________ PAGE SYSTEM REQUIREMENTS 2 INTRODUCTION TO FIP 3 DEFINITIONS & TERMINOLOGY 5 INVOKING FIP 6 OPERATING NOTES 7 DIRECTORY LIST OPTION #1 9 TRANSFER FILE(S) OPTION #2 10 PROMPTING 12 NOTE #T1 15 NOTE #T2 15 NOTE #T3 16 NOTE #T4 17 STATUS -FILE(S) OPTION #3 18 STATUS -DISK(S) OPTION #4 20 TYPE FILE OPTION #5 22 DUMP FILE OPTION #6 23 COMPARE FILES OPTION #7 24 RENAME FILE(S) OPTION #8 26 DELETE FILE(S) OPTION #9 28 NOTE #R1 29 CHANGE FILE ATTRIBUTES OPTION #10 30 NOTE #C1 32 CHANGE USER(S) OPTION #11 33 PRINTER ECHO OPTION #12 34 EXIT TO CP/M OPTION #13 34 .PO 6 SYSTEM REQUIREMENTS ______ ____________ FIP version 1.0 runs on a Z80 processor under the Digital Research CP/M 2.2 Operating System. FIP version 1.0 is designed for an 80 column console device and at least one disk drive. While programming considerations were made for CP/M 2.x, there may be User Number limitations for versions earlier than 2.2 . .HE INTRODUCTION INTRODUCTION TO FIP ____________ __ ___ FIP is a user oriented disk file handler designed for both the CP/M beginner and the system expert. FIP allows the beginning CP/M user to copy and examine files and to examine directories easily without having to memorize operations. FIP gives the system expert the capability to perform high speed batch file transfers automatically and to completely examine disk directo ries. FIP prompts for all user responses, always shows you what user# and what drives will be accessed, supplies the user response defaults (which are invoked by typing to prompts), and has built in safety feature -no action on files will ever take place by responding to any prompt with a . Some of FIP's features: * allows file transfers across user# boundaries. * designed to make backups of hard disks or other large storage devices using smaller storage devices automatic - (will transfer specified files to 'backup' floppy until it is full -then will prompt user to insert next backup floppy, etc.). * provides detailed disk(s) characteristic summaries. * provides a detailed disk file summary of any file(s) on any or all user#'s and the remaining free storage. * allows any two files on system to be compared and optionally shows differences in hexadecimal-ascii format with location. * allows any file to be inspected in either hexadecimal-ascii format or ascii format. * accepts wildcard characters in all filenames. * allows changing file attributes on a prompted 'file-by-file' nature or any specified set of files automatically. * allows printer logging of all file operations. * allows deleted directory entries to be displayed. * maximizes the available memory space by dynamically dividing all of the available memory between directory entries and file buffer areas thereby enabling high speed file transfers and compares. * FIP is written in very optimized Z80 code allowing highest operating speed and only requires 8 Kbytes storage. * allows wildcard inputs on file renaming -saving you time. ..PA 4 * file transfer operations allow: - confirmation prompts any time a file transfer would overwrite an existing file and then allowing abort, skip, and renaming options. - bulk file transfers, with or without prompting, with or without verification. - always shows the amount of space each source file requires (using destination disk blocksize) and the amount of free space remaining on destination disk. - allows changing destination floppy at any time (even during bulk file transfers). - allows changing destination drive at any time (even during bulk file transfers). - allows filename to be changed for destination copy at any time. ..PA 5 DEFINITIONS & TERMINOLOGY ___________ _ ___________ [] indicates that the enclosed entry is optional. <> indicates data that is entered by user. {} indicates that the user has a choice between two or more entries (entries will be separated with a vertical bar). At least one of the entries enclosed in braces must be chosen unless the entries are also enclosed in square brackets. | separates choices within braces. At least one of the entries must be chosen unless the entries are also enclosed in square brackets. d: represents drive spec, range A through P, lowercase and uppercase are accepted. fn represents the primary filename (1 to 8 alphanumeric characters). ft represents optional filetype (0 to 3 alphanumeric characters separated from the filename by a period. * wildcard -replaces all or part of a filename and/or filetype. ? wildcard -replaces any single character in the same position. fn[.ft] filename [d:]fn[.ft] filespec ambiguous filespec -contains one or more wildcard characters in the filename and/or filetype. unambiguous filespec -contains no wildcard characters. fn and ft may not contain any of the special characters <>.,;:=[] R/W means Read-Write. R/O means Read-Only. SYS means System attribute. DIR means Directory attribute. indicates a carriage return keystroke. ^S control-S will halt display output until ^Q is typed. ^Q control-Q will cause display output to continue. ..PA 6 INVOKING FIP ________ ___ There are 2 methods in which to invoke FIP: METHOD #1: FIP {< >|} examples: FIP FIP will return the status of all _____ files on currently logged in drive. FIP C: FIP will return the status of all ______ files on drive C: The status of all files on specified disk will be displayed and THEN FIP WILL RETURN TO SYSTEM COMMAND LEVEL. The user number, record count, bytes used, the number of extents, the R/W status, drive spec, filename, and indication of SYS attribute will be displayed for each file, and the number of bytes remaining on specified drive will be shown. This is the same display as would be generated under Menu Selection #3, with filespec set to *.*, with sub selection of A -except that user will be returned to System Command Level at end of display instead of staying within FIP. ------------------- METHOD #2: FIP with no command line arguments. ___ The copyright notice and Main Menu will be displayed, then FIP will wait for your option selection. The menu choices are shown below and are explained in the following pages: 1> Directory List 7> Compare Files 2> Transfer File(s) 8> Rename File(s) 3> Status -File(s) 9> Delete File(s) 4> Status -Disk(s) 10> Change File Attributes 5> Type File 11> Change User(s) 6> Dump File 12> Printer Echo 13> Exit to CP/M Choose ->_ The cursor is represented with an underscore. Response must be [n] where n is a valid one or two digit option number entered with no spaces and followed with . A non-valid response will return you to the Main Menu. NO action will ever take place on your files if, after choosing any option, you then respond to all prompts with only. ..PA 7 OPERATING NOTES _________ _____ NOTE #1 ** underlined text in the examples is the data as entered by the user and italicized text is data printed by FIP. The underscore character _ used alone will represent the position of the cursor. NOTE #2 ** You may return to the Main Menu at any time by typing Q after any prompt except where a filename is expected (Q is a valid filename). NOTE #3 ** You may respond to prompts using uppercase or lowercase. NOTE #4 ** You may abort FIP at any time by entering ^C (control-C) as the first character of any response. If you use option #13, FIP will return you to the CP/M system in the state that you existed at the time you invoked FIP. NOTE #5 ** Unless otherwise noted, when FIP prompts: File ? _ enter [[d:][fn][.ft]] default is *.* This entry will tell FIP what file(s) or range of files to look for. Your response may take any form as shown after enter above. If only is entered the default [source] drive as listed will be used and the filename accepted will be *.* (a request for all files on the default [source] drive). If a drive spec is entered it will become the new default source disk for FIP. If the drive spec is omitted the listed default [source] drive will be used. The filespec may be ambiguous or unambiguous. If an illegal filespec is entered, FIP will respond with a question mark on the next line and then reprompt with File ? _ . Examples: File ? B: equivalent to B:*.*. ______ File ? C:A*.B* would return all files on drive C: that ___________ began with A for the primary filename and began with B for the filetype. File ? AB??C*. would return all files on default drive ___________ whoose 1st two letters were AB and the 5th letter a C and with filetype of 3 blanks. NOTE #6 ** When processing of a Menu Option has been completed, FIP will prompt: Done _ on options 1,3, & 4 No more files _ on options 2,8,9, & 10 _ on options 5,6, & 7 enter [{n|M}] default is Main Menu..PA 8 Your response may take one of the forms as shown after enter above. n represents a valid one or two digit option number entered with no spaces and followed with . M means More of the same option. These are allowable responses at the end of most every option. If M is entered and followed with the Main Menu will be bypassed and you will start at the beginning of the current option you are using. If another option number is entered you will immmediately enter that option, bypassing the Main Menu. If only is entered you will be returned to the Main Menu. An invalid response will return you to the Main Menu. Examples: Done 9 would send you to option #9 _____ bypassing the Main Menu. DONE would send you to the Main Menu. ____ Done M would send you to the beginning of _____ current option (restart option). NOTE #7 ** If the listing process is stopped by depressing a key (other than ^S), FIP will take the next input as shown above after Done _, aborting the current operation and allowing the Main Menu to be bypassed. NOTE #8 ** When invoked, FIP will set the default Source Disk [Drive] (also referred to as Drive 1) and the default Destination Disk [Drive] (also referrred to as Drive 2) to the currently logged drive in effect at the time FIP was invoked. When invoked, FIP will also set the Source User number and the Destination User number equal to the user number that was in effect at the time FIP was invoked making the user number consideration in options 1 through 10 a transparent concern until option 11 is selected. NOTE #9 ** When in doubt on any response, enter only . NO action will ever take place on your files if, after choosing any option, you then respond to all prompts with only. ..PA 8 OPTION #1 - DIRECTORY LIST ______ __ _________ ____ This option will give you a directory listing under the Source User (see option #11) and on specified or default drive of speci fied or default (all) files in alphabetical order. The file(s) will be listed whether or not they have the system attribute attached to them. An asterisk will be printed after the filetype if the file has the system attribute attached to it. Upon entry to this option FIP will print: ** Directory ** User: n Default Drive = d: The current source user number (0 to 31) is where the directory will be taken from (this may be changed using option #11). The prompt for the filespec will then appear: File ? _ enter [[d:][fn][.ft]] default is *.* as described in Operating Note #5. The drive spec that was used to find the files will be printed in the beginning of each row of the directory listing. If no file could be found FIP will print: d: NO FILE and you will be returned to the Main Menu. After the files are listed FIP will print: Done _ enter [{n|M}] default is Main Menu as described in Operating Note #6. .PO 6 OPTION #2 - TRANSFER FILE(S) ______ __ ________ _______ This option allows you to copy files from any source drive and any source user to any destination drive and any destination user with or without prompting for the source filenames and with or without prompting for deletions when destination file already exists and with or without verifying the files after transferring them. This option allows you to give the new copy of a file a different name and allows you to physically change the floppy in the destination drive while still in the same pass through this option. You may also re-direct the destination drive during the same pass through this option. The source file size (as deter mined by the destination drive's block size) is always printed and the remaining free space on the destination drive is always shown. Messages will be given when a file won't fit and the automatic mode will stop and allow a new destination floppy to be inserted when the next file won't fit on the current destination floppy and then resume the automatic mode. The destination copy of R/O files will be changed to R/W (ie, to make working copies of source files). If the source file has the System attribute then the copy will also have the System attribute. Unless directed otherwise, the copy will have the same name as the source file. ..PA 11 Upon entry to this option FIP will print: ** Transfer File(s) ** Source User: n1 Destination User: n2 The current Source User number n1 (0 to 31) is where the source files will be taken from (this may be changed using option #11). The current Destination User n2 is where the selected files will be written to (this may be changed using option #11). If you don't use option #11 then you will not have to worry about user numbers at all. The prompt for the source disk will appear next: Source Disk x: _ enter [{d|d:}] or default is no change FIP displays the current default source disk (x:) and waits for your entry. You may enter the optional drive spec with or with out the colon as shown. If a drive spec is entered it will become the new default Source Disk for FIP. If only is entered the source disk will remain the same. If or any illegal drive spec is entered, FIP will immediately return you to the Main Menu. FIP will next show verification of Source Disk selection and prompt for the Destination Disk: Source Disk d: Dest Disk y: _ enter [{d|d:}] or default is no change FIP displays the current default destination disk (y:) and waits for your entry. You may enter the optional drive spec with or without the colon as shown. If a drive spec is entered it will become the new default Destination Disk for FIP. If only is entered the destination disk will remain the same. If or any illegal drive spec is entered, FIP will return you to the Main Menu. FIP will next show verification of Destination Disk and then prompt for the source filespec: Dest Disk d: File ? _ enter [[d:][fn][.ft]] default is *.* as desbribed in Operating Note #5. Note that you have another chance here to change the Source Disk. ..PA 12 FIP will next ask if you want prompting: Prompt (Y/N) ? _ enter {Y|N|V|Q|cr} default is Y If , , or any illegal character is entered FIP will prompt for each file to be transferred. If your single character entry is: Yes, prompt. FIP will prompt with (Y/N/R/C/T/V/Q) ? _ after each source file is printed. This mode is described on the next page under PROMPTING. No, do not prompt. This is one of the automatic modes of file transfer. FIP will transfer all specified files until: 1) all the source files have been transferred (-see NOTE #T1), or 2) there isn't enough room on the destination disk for the next source file (-see NOTE #T2), or 3) a file exists on the destination disk and under the destination user with the same name as the current source file (-see NOTE #T3), or 4) you hit a key (ie, the space bar) while FIP is transferring files (-see NOTE #T4) Verify after transfer. This one of the automatic modes of file transfer. After each file has been transferred both the source file and the destination file will be read again and compared. The verification status will then be displayed. This process will be continued until: 1) all the source files have been transferred (-see NOTE #T1), or 2) there isn't enough room on the destination disk for the next source file (-see NOTE #T2), or 3) a file exists on the destination disk and under the destination user with the same name as the current source file (-see NOTE #T3), or 4) you hit a key (ie, the space bar) while FIP is transferring files (-see NOTE #T4) Quit. FIP will return you immediately to the Main Menu. Note that FIP will not delete any files without first prompting when in any automatic transfer mode. For all cases except , FIP will next print a header along with the remaining free space in Kbytes on the Destination Disk: Source File Bytes Yes/No (default)/Rename Dest File Free Bytes Change dest floppy/Quit On d: xxxxxK FIP will alphabetically print the next file's name and the amount of space that it will require if it is transferred to the Desti nation Disk (this is determined by the destination disk's block size). If prompting was asked for, FIP will next print the transfer prompt. If a file is transferred, FIP will print the destination file's name and drive when the transfer is complete and the remaining free bytes on the destination disk. ..PA 13 PROMPTING After each source file is listed FIP will prompt: (Y/N/R/C/T/V/Q) ? _ enter {Y|N|R|C|T|V|Q|cr} default is N Any character entry other than those shown will be ignored and the cursor will remain stationary. At this level, if you enter: Yes, transfer file. FIP will transfer the file unless: 1) there is not enough room on the destination disk for this file (-see NOTE #T2), or 2) a file exists on the destination disk and under the destination user with the same same as the current source file (-see NOTE #T3) No, do not transfer this file. FIP will print the next source file prompt. Rename New File. You will be allowed to give the destination copy of this file a name that differs from the current source file. FIP will next prompt: New Filename ? _ enter [[d:][fn][.ft]] default is no transfer FIP will copy the source filename for any character positions in which a wildcard character is entered. FIP will then transfer the file if a file with this name doesn't exist on the destination disk and under the destination user. This command will override the Not Enough Space message given by FIP (-see NOTE #T2). Note that you may change the destination drive at this level by entering a drive spec for the new filename. If an illegal filespec is entered, FIP will respond with a question mark on the next line and then reprompt. If only is entered, no file will be transferred and FIP will print the next source file prompt. If *.* is entered, FIP will copy all the characters from the current source filename resulting in the same name whereby FIP would respond with: File d: filename Exists (-see NOTE #T3). Examples: Source filename New Filename Destination File name OLDCLUBS.JUN NOTES.MAY NOTES.MAY _____________ TEXT1.DOC B: B:TEXT1.DOC ______ MLAST.DOC FIR*.* FIRST.DOC __________ LASTMAIL.NEW *.OLD LASTMAIL.OLD _________ FBCBNK1L.BX3 A*.* ABCBNK1L.BX3 ________ ALSNOTE.LZ5 F??VERS2.* FLSVERS2.LZ5 ______________ ..PA 14 Change floppy in destination drive. You must use this command AFTER you physically change floppies in the destination drive during the Transfer File(s) option (other ______ wise suffer a CP/M System error). The cursor will advance and then FIP will allow you to make another entry selection (from (Y/N/R/C/T/V/Q)). FIP will automatically take care of a new floppy insertion if it is done before OPTION #2 is invoked. Transfer file even if it requires deleting a file on the destination disk and under the destination user with the same name -unless the destination file is marked as R/O. This command will also override the Not Enough Space message given by FIP (-see NOTE #T2). It is your responsibility to insure that there is enough room for the current source file to be transferred to the destination disk. This command is useful when you know that you want to overwrite an old copy. If the file on the destination disk and under the destination user is marked as R/O FIP will print: File is R/O FIP will then print the next source file prompt. If you request a transfer with the entry when there isn't enough room for the file to be transferred- FIP will delete the file with the same name on the destination disk if it exists (unless it is R/O), start transferring the source file until it runs out of physical space on the destination disk, print Not Enough Space, then print the next source file prompt. A destination file will not have been created. Verify after transfer. This selection will transfer file(s) in a manner identical to the selection described in the above paragraphs but with file verification after the transfer process has been completed. After the file has been transfered both the source file and the destination file will be read again and compared. The verification status will then be printed: File #1 File #2 d:filename.typ e:filename.typ Files Match or File #1 File #2 d:filename.typ e:filename.typ xxxxx Bytes Different as the case may be. d would be the source drive, e would be the destination drive, xxxxx would be the number of different bytes (base ten). FIP will then print the next source file prompt. This command is useful when you know that you want to over write an old copy and verify that the new copy is identical to the source (and hasn't been written on some possibly bad sectors) or when you are in the automatic transfer-verify mode and FIP has stopped to warn you that there isn't enough space (FIP computes the space requirement before checking to see if a file exists). Quit. FIP will return you to the Main Menu without further delay. NOTE #T1 No More Files When there are no more source file(s) to be transferred, FIP will prompt: No more files _ enter [{n|M}] default is Main Menu Your response may take one of the forms as shown after enter above. n represents a valid one or two digit option number entered with no spaces and followed with . M means More of the same option. These are allowable responses at the end of most every option. If M is entered and followed with the Main Menu will be bypassed and you will start at the beginning of the current option you are using. If another option number is entered you will immediately enter that option, bypassing the Main Menu. If only is entered you will be returned to the Main Menu. An invalid response will return you to the Main Menu. NOTE #T2 Not Enough Space When FIP computes that the next source file will not fit on the destination disk, the message: Not Enough Space will be printed. If you are in the prompting mode- the prompt (Y/N/R/C/T/V/Q) ? _ will be reprinted. The responses are described under PROMPTING. You may still effect a file transfer possibly through choices , , , or as described earlier. If you are in one of the automatic transfer modes- the source file prompt: (Y/N/R/C/T/V/Q) ? _ will show up for the current source file. The responses are described under PROMPTING. FIP will resume the automatic mode in progress after your response. If you are in the process of downloading the source files to backup floppies you could insert a new backup floppy in the destination drive, enter , then enter either , , or to resume the file transfers as you desire. If you wanted to change the destination drive, you would enter , and respond with d: (where d is the new destina tion drive) to the New Filename ? _ prompt causing the automatic transfer mode to resume...PA 16 NOTE #T3 Filename Exists If a file already exists on the destination disk and under the destination user with the same name as the current source file then FIP will prompt: File d: filename Exists D> Delete Old File R> Rename New File N> No Transfer Choose ->_ enter {D|R|N|Q|cr} default is N Any character entered other than those shown will be interpreted as . At this level, if you enter: Delete the file found on the destination disk and under the destination user if it isn't marked as R/O and then perform the transfer. If the file on the destination disk and under the destination user is R/O FIP will print: File is R/O FIP will then print the next source file prompt if you requested prompting; otherwise, FIP will resume the automatic mode that was in progress. You will be allowed to give the destination copy of this file a different name (The source file's name is never changed except under option #8). FIP will next prompt: New Filename ? _ enter [[d:][fn][.ft]] default is no transfer FIP will copy the source file name for any character positions in which a wildcard character is entered. FIP will then transfer the file if a file with this name doesn't exist on the destination disk and under the destination user. The next source file prompt will then be printed if you requested prompting; otherwise, FIP will resume the automatic mode that was in progress. This command will override the Not Enough Space message given by FIP (-see NOTE #T2). Note that you may change the destination drive at this level by entering a drive spec for the new file name. If only is entered, no file will be transferred and FIP will continue on with the next source file. If an illegal filespec is entered, FIP will respond with a question mark on the next line and then reprompt. The SYS attribute (if the source file had it) will be retained for the new filename if FIP is allowed to copy the 2nd character of the filetype. If *.* is entered, FIP will copy all the characters from the current source filename resulting in the same name whereby FIP would respond with: File d: filename Exists again. (See examples under PROMPTING with the entry). FIP will print the next source file prompt if you requested prompting; otherwise, FIP will reenter the automatic mode in progress. Quit. FIP will return you immediately to the Main Menu. NOTE #T4 Enter keystroke during transfer If you should hit a key (ie, the space bar) while one of the automatic transfer modes is in progress: FIP will finish any file transfer and/or verification currently in progress, then drop into the source file prompt mode for the next source file. The automatic mode will be resumed after your response. This is a convenient way to exit the transfer mode, change destination drives (through entry), change destination floppies (through entry), to rename the next file (), to change the type of transfer for the next file ( or ), or to temporarily halt the transfer process. ..PA 18 OPTION #3 STATUS -FILE(S) ______ __ ______ ________ This option allows the display of the user number, virtual size, record count, size in bytes, number of extents, and any attributes (R/W,R/O,DIR,SYS) of all or specified range of files on specified or default drive. Information on deleted files may also be displayed: old record count, old size, number of extents, name, and the attributes that the file(s) had. The files will be listed alphabetically. The number of free bytes remaining on the source drive will be displayed after the file status listing. Upon entry to this option FIP will print: ** Status -File(s) ** User: n Default Drive = d: The current source user number (0 to 31) is where the file information will be taken from for the current user listing (this may be changed using option #11). The prompt for the filespec will then appear: File ? _ enter [[d:][fn][.ft]] default is *.* as descibed in Operating Note #5. The drive spec that was used to find the files will be printed in each row of the status listing. FIP will next prompt: C> Current User (default) A> All Users V> Virtual Size D> Deleted Choose ->_ enter {C|A|V|D|Q|} default is C If your single character entry is: Current User. FIP will display the file(s) specified that reside under the current source user number. The record count, number of bytes, number of extents, attributes, drive, and filename will be displayed. All Users. FIP will display the file(s) specified, sorted 1st by user number and then alphabetically, that reside under any user number. The user number, record count, number of bytes, number of extents, attributes, drive, and filename will be displayed. Virtual Size. FIP will display the file(s) specified that reside under the current user number. The virtual size will be listed first, then the record count, number of bytes, number of extents, attributes, drive, and filename will be displayed...PA 19 Deleted Files. FIP will display the file(s) specified that resided under any user number. The old record count, number of bytes, number of extents, attributes, drive, and filename will be displayed. Note that a deleted filename directory entry will be reused when necessary, therefore the displayed files will be those whose entry hasn't been reused by the system yet. If you have deleted a file but haven't yet written anything to that disk, then that file will show up on this listing. Quit. FIP will immediately return you to the Main Menu. This is identical to the entry response described earlier. The appropiate header will be printed for the requested listing. An asterisk will be printed after the filetype if the file has the system attribute. After the status listing is printed, FIP will display: Bytes Remaining on d: xxxxxK Where d: is the source drive and xxxxx represents the number of free bytes remaining. After the remaining free space has been displayed, FIP will print: Done _ enter [{n|M}] default is Main Menu as described in Operating Note #6 allowing the Main Menu to be bypassed. If the listing process is stopped by depressing a key (other than ^S), FIP will take the next input as described in Operating Note #7. ..PA 20 OPTION #4 STATUS -DISK(S) ______ __ ______ ________ This option will display the characteristics of the specified or default drive(s) or the number of free bytes remaining on drive(s) at your request. FIP presents a comprehensive characteristics listing: B: Drive Characteristics xxxxx: Kilobyte Total Drive Capacity xxxxx: Kilobyte Storage Capacity xxxxx: Block Storage Capacity xxxxx: 128 Byte Record Capacity xxxxx: Kilobyte File Space xxxxx: Kilobyte Directory Space xxxxx: Kilobyte Reserved Space xxxxx: 32 Byte Directory Entries xxxxx: Checked Directory Entries xxxxx: Records/ Extent xxxxx: Records/ Block xxxxx: Kilobytes/ Block xxxxx: Sectors/ Track xxxxx: Tracks/ Drive xxxxx: Reserved Tracks Upon entry to this option FIP will print: ** Status -Disk(s) ** (drv, * =all, S=storage) The prompt for the source disk will appear next: Source Disk x: _ enter [{d|d:|*|S|Q}] default is characteristics of displayed drive FIP displays the current default source disk (x:) and waits for your entry. If an illegal response or is entered, FIP will return you to the Main Menu. You may enter an optional drive spec with or without the colon as shown in which case FIP will display the characteristics of that drive. If a drive spec is entered it will become the new default source disk for FIP. If only is entered the source disk will remain the same and its characteristics will be displayed. If <*> is entered, FIP will display the characteristics of all the drives that have been accessed during the program. If is entered, FIP will display the bytes remaining on each drive that has been accessed during the program:..PA 21 Bytes Remaining on d: xxxxxK . . . Where d: represents the drives and xxxxx represents the number of free bytes remaining. When finished, FIP will print: Done _ enter [{n|M}] default is Main Menu as described in Operating Note #6 allowing the Main Menu to be bypassed. If the listing process is stopped by depressing a key (other than ^S), FIP will take the next input as described in Operating Note #7. ..PA 22 OPTION #5 - TYPE FILE ______ __ ____ ____ This option will allow you to examine the contents of an ascii file. Upon entry to this option FIP will print: ** Type File ** User: n Default Drive = d: The current source user number (0 to 31) is where the file will be taken from (this may be changed using option #11). The prompt for the filespec will then appear: File ? _ enter [[d:][fn][.ft]] default is Main Menu as described in Operating Note #5 except that if only is entered you will be returned to the Main Menu. If an ambiguous filespec is entered, FIP will type the first file found in the directory that will match the filespec. If no file could be found FIP will print: d: NO FILE and you will be returned to the Main Menu. After the file has been typed, Fip will leave the cursor at the left edge of the screen: _ enter [{n|M}] default is Main Menu as described in Operating Note #6 allowing the Main Menu to be bypassed. If the listing process is stopped by depressing a key (other than ^S), FIP will take the next input as described in Operating Note #7. ..PA 23 OPTION #6 - DUMP FILE ______ __ ____ ____ This option will allow you to examine the contents of any file in hexadecimal and ascii format. Upon entry to this option FIP will print: ** Dump File ** User: n Default Drive = d: The current source user number (0 to 31) is where the file will be taken from (this may be changed using option #11). The prompt for the filespec will then appear: File ? _ enter [[d:][fn][.ft]] default is Main Menu as described in Operating Note #5 except that if only is entered you will be returned to the Main Menu. If an ambiguous filespec is entered, FIP will dump the first file found in the directory that will match the filespec. The hexadecimal address will be printed at the left of each line. The address for the first byte will start off at 0100 hex (which is especially beneficial when dumping a '.com' file under CP/M). The content of sixteen bytes will be printed next in hexadecimal with the equivalent ascii representations displayed at the right of each line if they exist (non ascii bytes will be represented with a '-' character. If no file could be found FIP will print: d: NO FILE and you will be returned to the Main Menu. After the file has been dumped, Fip will leave the cursor at the left edge of the screen: _ enter [{n|M}] default is Main Menu as described in Operating Note #6 allowing the Main Menu to be bypassed. If the listing process is stopped by depressing a key (other than ^S), FIP will take the next input as described in Operating Note #7. ..PA 24 OPTION #7 - COMPARE FILES ______ __ _______ _____ This option allows you to compare any two files on your system. The files may be under the same or different user numbers (which are specified using Option #11). A quick summary showing whether the files match or the number of differing bytes may be requested; or their differences shown in hexadecimal and ascii with hexadecimal location may be requested. Upon entry to this option FIP will print: ** Compare Files ** User1: n1 User2: n2 Default Drive 1 = x: Default Drive 2 = y: where: n1 will be the user number used to find File #1, n2 will be the user number used to find File #2, x: will be the default drive for File #1, and y: will be the default drive for File #2. FIP will next prompt for the files to be compared: File #1 ? _ enter {[d:][fn][.ft]} default is Main Menu File #2 ? _ enter {[d:][fn][.ft]} default is y:filenam1 If only is entered for the first filename you will be returned to the Main Menu. If an ambigious filename is entered for the 2nd file, FIP will copy the 1st filename for any character positions in which a wildcard character exists; therefore, if only is entered for the 2nd filename FIP will use the default drive #2 and the 1st filename as the 2nd file (see Operating Note #5). If an ambigious filespec is entered for the 1st file, FIP will use the first file found that matches the filespec and similarly if needed for the 2nd file. The filenames actually used will be displayed. FIP will next prompt: Summary/Differences/Quit (S/D/Q) ? _ enter {S|D|Q|} default is S If your single character entry is: Summary. FIP will compare the files byte for byte and then display the filenames actually used and the results: File #1 File #2 d:filenam1.typ e:filenam2.typ Files Match _ enter [{n|M}] default is Main Menu or File #1 File #2 d:filenam1.typ e:filenam2.typ xxxxx Bytes Different _ enter {{n|M}] default is Main Menu as the case may be. d would represent drive #1, e would represent drive #2, filenam1 is File #1, filenam2 is File #2, and xxxxx would be the number of different bytes (base ten). FIP will then wait for your Option # selection as described in Operating Note #6 allowing the Main Menu to be bypassed. Differences. FIP will display a header: File #1 File #2 d:filenam1.typ e:filenam2.typ aaaa: hh A hh A . . to identify which column of the output corresponds with each file. The hexadecimal address (aaaa) starting with 0000 will be printed on each line along with the content of one byte from each file. Each byte will be displayed in hexadecimal (hh) and in ascii (A) if an ascii equivalent exists (a '-' will be displayed in the ascii position otherwise). FIP displays ONLY the differences to speed up your ability to locate differences. FIP will print a blank line when the first 'bytes match' condition occurs after a 'no-match' condition has existed. For example, assume that differences have been displayed for the first 30 bytes found, then if the next bytes match or if the next 900 bytes match, FIP will print only one blank line -until the next 'no-match' is found, at this time the different bytes will be displayed with their corresponding address. This process is continued until you either abort it (see Operating Note #7) or the end of the longest file is found. When the files are of different length, FIP will blank out the column for the short file's entry and continue to count the differences and display the other file until the EOF of the larger file is found. When finished, FIP will display: File #1 File #2 d:filenam1.typ e:filenam2.typ Files Match _ enter [{n|M}] default is Main Menu (if you are lucky) or: File #1 File #2 d:filenam1.typ e:filenam2.typ xxxxx Bytes Different _ enter {{n|M}] default is Main Menu The filenames and their column number are identified again (in case you have forgotten which column was which file after close scrutiny of the last 400 bytes). FIP will then wait for your response as described in Operating Note #6. Quit. FIP will return you immediately to the Main Menu. This is identical to the entry response described earlier. NOTE: If FIP cannot find one of the files (after entry of either or as decribed above), then d:filename NO FILE will be displayed and you will be returned to the Main Menu...PA 26 OPTION #8 - RENAME FILE(S) ______ __ ______ _______ This option allows you to rename files. The specified candidates for renaming will be listed alphabetically one at a time allowing you to decide upon action. FIP will make sure that a file with the possible new name doesn't already exist under the current user before any renaming actually takes place. FIP will not allow any R/O files to be renamed. Upon entry to this option FIP will print: ** Rename File(s) ** User: n Default Drive = d: The current source user number (0 to 31) is where FIP will look for the specified or default files (this may be changed using option #11). The prompt for the filespec will then appear: File ? _ enter [[d:][fn][.ft]] default is *.* as described in Operating Note #5. FIP will next print: Rename/No (default)/Quit filename.typ (R/N/Q) ? _ enter {R|N|Q|} default is N Each file from the specified range will be listed alphabetically. If the listed file is R/O FIP will print: File is R/O instead of the prompt and the next filename will be listed. The prompt will appear after the filename and if your single character entry is: Rename. FIP will next prompt: New Filename ? _ enter [[d:][fn][.ft]] default is no change FIP will copy the source filename for any character postions in which a wildcard character is entered (see Operating Note #5). If only is entered, FIP will go on to the next source file prompt without making any changes. The SYS attribute (if the source file had it) will be retained for the new filename if FIP is allowed to copy the 2nd character of the filetype. When a file is renamed, FIP will respond: d: oldname .typ Renamed To newname .typ confirming the action taken. ..PA 27 If the drive spec is changed FIP will respond with: Not Source Disk New Filename ? _ allowing another response. If *.* is entered, FIP will copy all the characters from the current source file name resulting in the same name whereby FIP would respond with: File d: filename Exists New Filename ? _ allowing another response. If the new filename exists FIP will respond as just shown. No change. FIP will go on to the next source file prompt without making any changes. FIP will return you to the Main Menu without delay. FIP will go on to the next source file prompt without making any changes. When there are no more source file(s), FIP will prompt: No more files _ enter [{n|M}] default is Main Menu as described in Operation Note #6 allowing the Main Menu to be bypassed. ..PA 28 OPTION #9 - DELETE FILE(S) ______ __ ______ _______ This option allows you to delete files with or without prompting for the source filenames at your request. The source file size is always printed and the remaining free space on the specified or default drive is always shown. When prompting, the specified candidates for deleting will be listed alphabetically one at a time allowing you to decide upon action. FIP will not delete any R/O files. Upon entry to this option FIP will print: ** Delete File(s) ** User: n Default Drive = d: The current source user number (0 to 31) is where FIP will look for the specified or default files (this may be changed using option #11). The prompt for the filespec will then appear: File ? _ enter [[d:][fn][.ft]] default is *.* as described in Operating Note #5. You may simply change the drive by entering . FIP will next ask if you want prompting: Prompt (Y/N) ? _ enter {Y|N|Q|} default is Y If , , or any illegal character is entered FIP will prompt for each file to be deleted. If your single character entry is: Yes, prompt. FIP will prompt with (D/N/Q) ? _ after each source filename is printed. This mode is described on the next page under PROMPTING. No, do not prompt. This is the automatic mode of file deletion. Each source filename and its storage space will be printed. FIP will print Deleted after the file has been deleted and the remaining free space on the specified or default disk. FIP will delete all specified files until: 1) all the specified files have been deleted (-see NOTE #R1), or 2) a source file is marked R/O, in which case FIP will print: File is R/O after the filename and then go on to the next source file, or 3) you hit a key (ie, the space bar) while FIP is deleting files, in which case FIP will finish any disk access in progress, then drop into the source file prompt mode for the next source file. The automatic mode will be resumed after your response. This is a convenient way to exit the delete mode, keep the next file from being deleted, or to temporarily halt the delete process. Quit. FIP will return you to the Main Menu. For all cases except , FIP will next print a header along with the remaining free space in Kbytes on the specified or default disk: Bytes Delete/No (default)/Quit Free Bytes On d: xxxxxK FIP will alphabetically print the next file's name and its storage space (the amount of space that will be freed up if it is deleted). If prompting was asked for, FIP will next print the source file prompt. If a file is deleted, FIP will print: Deleted after the source filename and the remaining free bytes on the specified or default disk. If the current source file is marked as R/O FIP will print File is R/O instead of the prompt and then go on to the next source file. PROMPTING After each source file is listed FIP will prompt: filename.typ xxxxxK (D/N/Q) ? _ enter {D|N|Q|} default is N The prompt will appear after the filename and if your single character entry is: Delete this file. FIP will delete the file and then print Deleted after the filename and the new remaining free space on the specified or default disk. FIP will then go on to the next source file prompt. No change. FIP will go on to the next source file prompt without making any changes. FIP will return you to the Main Menu. NOTE #R1 When there are no more source file(s), FIP will prompt: No more files _ enter [{n|M}] default is Main Menu as described in Operation Note #6 allowing the Main Menu to be bypassed. .PN 30 OPTION #10 - CHANGE FILE ATTRIBUTES ______ ___ ______ ____ __________ This option allows you to change file attributes with or without prompting for the source filenames at your request. When prompting, the specified candidates for attribute change will be listed alphabetically one at a time allowing you to decide upon action. Upon entry to this option FIP will print: ** Change File Attributes ** User: n Default Drive = d: The current source user number (0 to 31) is where FIP will look for the specified or default files (this may be changed using option #11). The prompt for the filespec will then appear: File ? _ enter [[d:][fn][.ft]] default is *.* as described in Operating Note #5. You may simply change the drive by entering . FIP will next prompt: L> Lock (R/O) U> Unlock (R/W) D> DIRectory S> SYStem Q> Quit Choose ->_ enter {L|U|D|S|Q|} default is Main Menu (Q) This entry will set the 'attribute mode' for this option. One of the attributes must be chosen or you will be returned to the Main Menu. The attribute selected will be the only attribute you will be allowed to change until this option is restarted. If your single character entry is: The attribute mode is set to make the selected files Read Only. The attribute mode is set to make the selected files Readable and Writable. The attribute mode is set to make the selected files DIRectory files (will show up with CP/M's DIR command). The attribute mode is set to make the selected files SYStem files (will not show up with CP/M's DIR command). Quit. Return to the Main Menu. FIP will next ask if you want prompting: Prompt (Y/N) ? _ enter {Y|N|Q|} default is Y If , , or any illegal character is entered FIP will prompt for each file to be changed. If your single character entry is:..PA 31 Yes, prompt. FIP will prompt with (C/N/Q) ? _ after each source filename is printed. This mode is described below under PROMPTING. No, do not prompt. This is the automatic mode of file attribute change. FIP will print each source filename and its present attributes, change the requested attribute, and then print the attribute change made for all specified files until: 1) all the specified files have been changed (-see NOTE #C1), or 2) you hit a key (ie, the space bar) while FIP is changing the attributes, in which case FIP will finish any disk access in progress, then drop into the source file prompt mode for the next source file. The automatic mode will be resumed after your response. This is a convenient way to exit this option, keep the next file from being changed, or to temporarily halt the change process. Quit. FIP will return you to the Main Menu. For all cases except , FIP will next print the message: Acc Change/No (default)/Quit where Acc is the present attributes column. FIP will alphabetically print the next file's name and its present attributes. If prompting was asked for, FIP will next print the source file prompt. If the file's attribute is changed, FIP will print: Changed to R/W or Changed to R/O or Changed to DIR or Changed to SYS after the source filename depending on the attribute mode you selected. PROMPTING After each source file is listed FIP will prompt: filename.typ sccc (C/N/Q) ? _ enter {C|N|Q|} default is N s is where the SYS indicator '*' will be displayed and ccc represents R/O or R/W. The prompt will appear after the filename and if your single character entry is: Change this file's attribute. FIP will change the attribute to agree with the current attribute mode you selected earlier. For instance, if you selected earlier FIP will make this file Read Only. The actual change made will be printed. FIP will then go on to the next source file prompt. No change. FIP will go on to the next source file prompt without making any changes. FIP will return you to the Main Menu. NOTE #C1 When there are no more source file(s), FIP will prompt: No more files _ enter [{n|M}] default is Main Menu as described in Operation Note #6 allowing the Main Menu to be bypassed. ..PA 33 OPTION #11 - CHANGE USER(S) ______ ___ ______ _______ This option allows you to change the Source User and/or the Destination User. The Source User is the current source user number referred to in options 1,2,3,5,6,8,9, and 10, and User1 referred to in option 7. The Destination User is the destination user referred to in option 2 and is the same as User2 referred to in option 7. When invoked, FIP will set the Source User number and the Destination User number equal to the user number that was in effect at the time FIP was invoked. The user number consideration in options 1 through 10 will be a transparent concern if this option is never used to change the user numbers. FIP always shows the user number(s) of concern when each option is selected; however, this option may also be used to view the current Source User number and Destination User number in effect. Upon entry to this option FIP will print: ** Change User(s) ** Source User: n1 Destination User: n2 The current Source User and Destination User numbers in effect are shown. FIP will next prompt: Source User: n1 _ enter [n] default is no change n represents a one or two digit user number (0 through 31) entered with no spaces and followed with . If only is entered, FIP will make no change. If an illegal response is entered, FIP will return immediately to the Main Menu with no changes made. FIP will next confirm the change made: Source User: N2 where N2 is the default or new number just entered. FIP will next print: -destination user is for file transfers & compares- and prompt: Destination User: n2 _ enter [n] default is no change n represents a one or two digit user number (0 through 31) entered with no spaces and followed with . If only is entered, FIP will make no change. If an illegal response is entered, FIP will return immediately to the Main Menu with no change made to the Destination User number. FIP will next confirm the change made: Destination User: N2 where N2 is the default or new number just entered. FIP will next print the confirmation of both possible changes: Source User: n1 Destination User: n2 and then you are returned to the Main Menu...PA 34 OPTION #12 - PRINTER ECHO ______ ___ _______ ____ This option allows you to obtain a hard copy listing of output from FIP in addition to console output. The conversational prompts and messages will be suppressed for the hard copy output. This allows clean hard copy directory and file status listings and logging of all operations for record keeping. The standard CP/M list device will be used. When invoked, FIP will initially set the printer echo function to the OFF condition. Upon entry to this option FIP will print: ** Printer Echo ** Current Status: printer echo is SSS where SSS stands for either ON or OFF as the case may be. Then: 1> Listings To Console Only 2> Listings To Console & Printer Choose ->_ enter [{1|2}] default is no change If only or an illegal response is entered, FIP will return to the Main Menu with no change made. If an acceptable response is entered, FIP will next confirm the current echo status: Current Status: printer echo is SSS where SSS stands for either ON or OFF as the case may be. You will then be returned to the Main Menu. ^P (control-P) may be entered as the first character of any response in which a single character is not expected to toggle the printer echo on and off. OPTION #13 - EXIT TO CP/M ______ ___ ____ __ ____ This option returns you to the CP/M system in the state that you existed at the time you invoked FIP.