EXPLOR.DOC

(15 KB) Pobierz

                                  EXPLORER II

                Commodore 128 - 80 column Disk Utility Program.

                            Written by Rick Simon
                              and placed within
                              the Public Domain.

              This program may be copied and distributed for free.
                            It may not be sold.



 This program will only operate on the Commodore 128 computer. It utilizes 
the 80 column screen in Fast mode, and should work with any Commodore 
compatible disk drive and printer. It was compiled using Basic 128 by 
Abacus Software to increase the speed of the program. It's features are:

   #1.  Multi-file copier using one or more disk drives (single/dual).
   #2.  Full sector editor capable of reaching track 70 on the 1571.
   #3.  Print files to the screen or printer as normal characters, with
        control codes trapped, with control codes as ASCII codes, or
        all characters as ASCII codes.
   #4.  Unscratch command to retrieve accidently erased files.
   #5.  Trace data sectors of files to screen or printer.
   #6.  Full directory of disk including scratched files.
   #7.  Screen dump to printer.
   #8.  Multi-file scratch command.
   #9.  Access to full disk commands.
   #10. Ability to change file types from/to Prg/Seq/Usr format.

-----------------------------------------------------------------------
                              THE MAIN MENU

$ - Directory:

 This command will call up the entire directory of the disk and display it 
to the screen. Included will be the name, type, size, track & sector of the 
first data block for each file on the disk. Also, the remaining blocks free 
on the disk. Included are any scratched files on the disk. Additionally, 
the disk name, ID, and type of format (1541/1571) will be displayed in the 
upper window. Up to twenty file names may be viewed at any given time. If 
there are over 20 files on the disk, the first 20 will be shown, and a 
message at the bottom of the screen telling how many files total are on the 
disk. (see scrolling below)

NOTE: The format type displayed in the upper window is the disk format,
      NOT the type of drive.


> - Disk Commands:

 This calls up the disk commands menu. (see below)




C - Copy files:

 This command will allow for the copying of program, sequential, or user 
files from the currently listed Source drive to the listed Destination 
drive. If the same drive is listed for both, a 54K buffer will be used for 
the copying. The buffer will accept files up to 219 blocks long. If two 
different drives are used, file size is only limited by disk space. You 
will be prompted for the file(s) you wish to copy. Enter the number of the 
file from the directory and press RETURN. The cursor will reappear with the 
same prompt. You may either enter more file numbers, or press the RETURN 
key by itself to begin copying. You will be asked if you wish to format the 
destination disk. The copier is not 'blazing' fast, but it will allow 
copying between different types of disk drives (i.e. 1571 and 1541, 1571 
and MSD, etc.) I timed the copy speed out at approx. 1.5 seconds per block. 
The name of the current file being copied will be displayed along with the 
number of bytes in the file.


T - Trace File:

 This command will print out to the screen or the printer a track and 
sector trace of the data blocks for the requested file. Simply enter the 
number of the file you wish to have traced. You will then see the track and 
sector of each data block printed across the screen (or printer if 
selected). The name of the file will be displayed in the upper window (or 
printed on the paper).


U - Unscratch Command:

 This command allows you to change a Deleted (scratched) file back to it's 
original format, and will re-allocate all of the blocks used by that file. 
It will also let you change any Prg, Seq, or Usr file on the disk to any of 
those three formats. This is handy for converting that Seq word processor 
file over to Prg format so your 'other' word processor can read it, or vice 
versa. You will be prompted for the file number, and which type format 
(P,S,U) you wish to change it to. Pressing RETURN by itself at the file 
name prompt will abort from this command back to the Main Menu.

WARNING: To insure the proper restoration of a scratched file, you must
         not save or append any data on the disk after scratching the
         file, and before using this command.


P - Print File:

 This command will print to the screen or printer the contents of any Prg, 
Seq, or Usr file. Pressing RETURN by itself at the file number prompt will 
abort back to the menu. While the file is being printed, you may pause it 
at any time by pressing any key. At that time you can either abort out of 
it by pressing the 'Q' key, or restart by pressing any other key. 
Additionally, there are four different 'translation' types for the data. 
You will be prompted for which Translation type you wish (1,2,3,4). They 
are as follows:


  1. This prints all characters as their equivalent CHR$ codes.

WARNING: This includes such codes as cursor colors, clear screen, home
         cursor, flash on/off, reverse on/off, set windows, etc. If
         this option is used to print the file to the screen, there is
         no telling what your screen will look like at the end of it.

  2. This prints all normal characters (letters,numbers,etc.) normally.
     All control codes mentioned in the Warning above are trapped and
     appear as a white period. Recommend this option for printing to
     the screen. If you press Return at the Translation prompt, this
     translation option is used.
  3. Same as #2 above except, trapped characters are printed as their
     equivalent number inside white brackets. For instance, a Reverse
     On would appear as:  [ 18]  -  equivalent to CHR$(18)
  4. This prints ALL characters as ASCII equivalents inside brackets.
     This is handy for dumping out to printer the numbers needed for
     POKE statements for machine language programs/sub-routines.


B - Block Editor:

 Calls the sector editor menu. (see below)


E - Exit:

 This exits the entire program. You are prompted:    'Are You Sure ?'


^ - Screen Dump:

 Pressing the up arrow key (next to the asterisk key, not the cursor key) 
will do a screen dump to the selected printer. This is an 'invisible' 
command and does not appear in the menu.


<- - New Parameters:

 Pressing the left arrow key (next to the 1, not the cursor key) will allow 
you to set the parameters for your peripherals. You will be prompted for 
the Source device number (8 to 30) and drive number (0 or 1), the 
Destination device number (8 to 30) and drive number (0 or 1), the printer 
device number (4 to 7), and the printer secondary address (0 to 255). When 
answering the prompts, pressing the RETURN key by itself will leave the 
device numbers for the Source drive, Destination drive, and printer the 
same as they were. The drive numbers and printer secondary address will be 
changed to zero unless otherwise specified. This is an 'invisible' command 
which does not appear on the menu.


Up/Down Cursor keys:

 These keys may be used to scroll the disk directory up or down when it is 
displayed if there are more files on the disk than can be displayed at one 
time. These are 'invisible' commands and do not appear on the menu.





----------------------------------------------------------------------
                        BLOCK EDITOR MENU

F1 - Chain Block:

 This command will read the byte under the cursor as the next Track, the 
byte to the right of the cursor as the next Sector, and attempt to jump to 
and display that block. This is very handy when tracing a file on the disk 
since the first two bytes of any Sector are the Track and Sector of the 
next data block in that file. This also works well when going from the 
directory entry for a file to the first block of that file.


F2 - Read Block:

 This command will prompt you for the specific Track and Sector you wish to 
view.


F3 - Directory:

 This command will jump to and display Track 18, Sector 1. This is the 
beginning of the directory entries for all files on the disk.


F4 - Write Block:

 This command will write the contents visible on the screen to the Track 
and Sector presently accessed (shown in the upper window) of the presently 
selected Destination drive.


F5 - ASCII Edit:

 This command displays the block data on the screen in it's ASCII format. 
All control codes are trapped and printed as white periods, similar to 
Translation option 2 in the Print File section of the main menu.


F6 - HEX Edit:

 This command displays the block data on the screen in it's Hexadecimal 
format. This is handy for figuring out what all those white periods are! 
<<grin>>


F7 - Exit:

 This command exits the block editor back to the main menu.


F8 - Copy Block:

 This command allows you to copy the contents of the block displayed on the 
screen to any other block on the disk. You will be prompted for the Track 
and Sector number where you want the data written to. This is handy for 
experimentation purposes.


^ - Screen Dump:

 This is an 'invisible' command. (see above in main menu)


<- - New Parameters:

 This is an 'invisible' command. (see above in main menu)


Cursor Keys:

 The cursor keys (including the 'home' key) will move the cursor around the 
screen to the desired byte of the displayed block. These are also 
'invisible' commands and do not appear on the menu.



                         EDITING SECTOR DATA

 While the sector data is displayed on the screen you may move the cursor 
over any specific byte and change the contents of that byte. If using ASCII 
Edit, pressing an...
Zgłoś jeśli naruszono regulamin