525 lines
25 KiB
Plaintext
525 lines
25 KiB
Plaintext
|
===============================================================================
|
||
|
= Cat-Fur 2.2a Enhanced =
|
||
|
= =
|
||
|
= Written by: The Screamer =
|
||
|
= =
|
||
|
= Thanks to: The Vulture & Captain Sensible =
|
||
|
= Docs written by: The Messiah =
|
||
|
= =
|
||
|
= Apple Tree //..............305/556-6858 =
|
||
|
= The Midnight Sun...........509/783-1856 =
|
||
|
= Eastern Alliance...........201/327-5725 =
|
||
|
= =
|
||
|
= Released on December 9, 1986 =
|
||
|
===============================================================================
|
||
|
|
||
|
Introduction:
|
||
|
=============
|
||
|
|
||
|
After seeing the new transfer programs that were being developed for the
|
||
|
purpose of improving and replacing Cat-Fur 2.2a, I decided to rewrite Cat-Fur
|
||
|
in order to improve it and maintain compatibility. This new version of Cat-Fur
|
||
|
is 100% compatible with the existing Cat-Fur 2.2a, fixed by The Ubiquitous
|
||
|
Hacker. It also uses 64k Diversi-Dos 4.1C and this must be loaded in order to
|
||
|
use the new version. There is no memory available for any more additions to the
|
||
|
program. At the last count there were about 30 bytes of free memory. This file
|
||
|
will first give an overview of all the new modifications and then go into the
|
||
|
specifics into each of the modifications.
|
||
|
|
||
|
NOTE: This Cat-Fur fully supports the Enhanced //e as well as any other
|
||
|
Apple // computer with 64k. (Even the IIGS in SLOW speed).
|
||
|
|
||
|
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
|
||
|
Overview:
|
||
|
=========
|
||
|
|
||
|
Terminal mods:
|
||
|
==============
|
||
|
Lightbar/Keyboard/Optional Joystick input
|
||
|
21000 Character buffer
|
||
|
Built in reconfigure menu
|
||
|
Auto-search feature added
|
||
|
Displays current baud rate [103/202]
|
||
|
Maintains online text page while in terminal mode
|
||
|
|
||
|
Unattended mods:
|
||
|
================
|
||
|
Counts number of calls in remote
|
||
|
Control-B/Control-F chat mode
|
||
|
Return to BBS
|
||
|
Online clock with timer
|
||
|
Online Transferring status
|
||
|
Auto-pause text file viewing
|
||
|
+/- or arrows to scan through volumes
|
||
|
Online 12800 character text editor
|
||
|
Chat call
|
||
|
Full DOS support for sysops
|
||
|
Search for file on hard drive
|
||
|
Find free space on hard drive
|
||
|
Loop Routine
|
||
|
|
||
|
Transfer mods:
|
||
|
==============
|
||
|
Counts number of sectors selected
|
||
|
Displays extended file descriptions
|
||
|
|
||
|
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
|
||
|
Terminal mods:
|
||
|
==============
|
||
|
|
||
|
Lightbar menus:
|
||
|
===============
|
||
|
Lightbar menus can take input by:
|
||
|
---------------------------------
|
||
|
1) Typing the character between the brackets on the menu.
|
||
|
2) Using arrows (either left/right or up/down) to move
|
||
|
lightbar to your choice then pressing Return to choose
|
||
|
option.
|
||
|
3) Using joystick to scroll lightbar to choice then pressing
|
||
|
either joystick button to select option.
|
||
|
|
||
|
In Terminal Mode, not all of the lightbars are displayed
|
||
|
at once, and to get to the other options it is necessary
|
||
|
to scroll off of the top or bottom of the screen, and
|
||
|
the lightbars will scroll as well.
|
||
|
|
||
|
NOTE: The joystick method is optional and can be set in the
|
||
|
reconfigure menu. If you do not have a joystick,
|
||
|
do not worry as it automatically disables itself.
|
||
|
|
||
|
Dialing Options:
|
||
|
================
|
||
|
The dialing delays have been greatly shortened as well
|
||
|
as the wait delay, if you experience any problems as a
|
||
|
result, simply use the ":" as a pause. To "Auto-connect"
|
||
|
to a board, simply Number:A, and it will Auto-Search.
|
||
|
|
||
|
NOTE: To Auto-Search upon loading simply issue a
|
||
|
POKE 836,102 before running it.
|
||
|
|
||
|
Buffer Options:
|
||
|
===============
|
||
|
Specs on the buffer:
|
||
|
--------------------
|
||
|
The 21000 character buffer is located between $900 and $5BA0.
|
||
|
This translates to 84 sectors and the amount of free
|
||
|
characters is displayed in the upper right corner. The buffer
|
||
|
status light (on/off) is kept at the top of the screen. The
|
||
|
buffer can be toggled in one of two ways:
|
||
|
|
||
|
1) Going into the terminal section and toggling the buffer.
|
||
|
2) Toggling it while online by hitting control-B.
|
||
|
|
||
|
If you have an extended 80 column card, the buffer will be
|
||
|
copied into auxiliary memory when you enter the transfer
|
||
|
section and copied back to main memory when you exit the
|
||
|
transfer section.
|
||
|
|
||
|
If you do NOT have an extended 80 column card then you will be
|
||
|
prompted if you haven't saved the buffer yet.
|
||
|
|
||
|
When the buffer gets full you will be prompted in the upper
|
||
|
right corner.
|
||
|
|
||
|
Viewing the buffer:
|
||
|
-------------------
|
||
|
When you choose to view the buffer you will be asked which
|
||
|
slot you want it sent to. This serves three purposes:
|
||
|
|
||
|
1) Send the buffer to the printer slot to have it printed.
|
||
|
2) Send the buffer to your 80 column card to view it in 80
|
||
|
columns.
|
||
|
3) Hit return and view it in 40 columns.
|
||
|
|
||
|
While viewing the buffer you can hit any key to pause the
|
||
|
listing or hit either return or escape to abort the listing.
|
||
|
|
||
|
Saving the buffer:
|
||
|
------------------
|
||
|
To save the buffer simply select the option to save it on the
|
||
|
terminal menu. After saving the buffer, it will automatically
|
||
|
be cleared.
|
||
|
|
||
|
Reading a file into the buffer:
|
||
|
-------------------------------
|
||
|
To read the buffer simply select the option to read it on the
|
||
|
terminal menu. It will read in as much of the text file as
|
||
|
possible. It will also prompt you if there is already
|
||
|
something in the buffer. You can then either clear the buffer
|
||
|
first or append to the buffer.
|
||
|
|
||
|
Clearing the buffer:
|
||
|
--------------------
|
||
|
Simply select this option on the terminal menu where you will
|
||
|
then be prompted if you are sure you want to clear the buffer.
|
||
|
|
||
|
Transmitting the buffer:
|
||
|
------------------------
|
||
|
When you select to transmit the buffer you will be asked to
|
||
|
set the delay after each return. The default is 1 which should
|
||
|
be a sufficient delay. If it is not then simply set it to what
|
||
|
you feel will be. When you transmit the buffer Cat-Fur sends
|
||
|
the current buffer. While it is being sent you can hit any key
|
||
|
to pause or hit either return or escape to stop transmission.
|
||
|
|
||
|
Reconfigure menu:
|
||
|
=================
|
||
|
New reconfigure options:
|
||
|
------------------------
|
||
|
1) Disable sound completely.
|
||
|
2) Sound alarm upon connection.
|
||
|
3) Volume lockout if you selected that you had a hard drive.
|
||
|
4) Optional @ACC files if you feel they are unnecessary.
|
||
|
5) @ACTION file selection [SEE BELOW].
|
||
|
6) Copy buffer to auxiliary memory when entering transfer
|
||
|
section.
|
||
|
7) Amount of transfers allowed per call.
|
||
|
8) Return to BBS from remote.
|
||
|
9) Select amount of time the user has in remote, if you have a
|
||
|
Thunderclock.
|
||
|
|
||
|
Upon Saving the updated Cat-Fur to disk, it will save
|
||
|
under the name of CAT-FUR to the default slot, drive,
|
||
|
and volume. (A$6000,L$5DC2)
|
||
|
|
||
|
NOTE: The Lockout all other slots, and drives is a very useful
|
||
|
feature for users who have only one drive, or for hard drive
|
||
|
users. This feature does not allow the online user to change
|
||
|
the slot or drive in anyway, in this way the user will only
|
||
|
be allowed to access different volumes.
|
||
|
|
||
|
@ACTION file
|
||
|
------------
|
||
|
This file contains the users transferring status which is
|
||
|
stored on the default volume you selected in the reconfigure
|
||
|
menu. It opens and appends to the file. It writes in the
|
||
|
following format:
|
||
|
|
||
|
Uxxx or Dxxx [where "xxx" is the number of sectors of the
|
||
|
file]
|
||
|
Vxxx [where "xxx" is the volume of the file]
|
||
|
Filename of the file which was transferred
|
||
|
Uxxx or Dxxx [same as above]
|
||
|
Vxxx [same as above]
|
||
|
Filename [same as above]
|
||
|
etc...
|
||
|
|
||
|
This should be very useful for boards which keep track of user
|
||
|
transferring status and have to scan every volume to see
|
||
|
whether or not something was uploaded.
|
||
|
|
||
|
NOTE: This option is only active if CF 2.2a Enh. is being
|
||
|
run Remotely (from a board). The @ACTION file will be
|
||
|
written to the slot, drive, and volume of which CF 2.2a
|
||
|
Enh. was run from.
|
||
|
|
||
|
Maintaining text page:
|
||
|
----------------------
|
||
|
As in BME, Cat-Fur 2.2a Enhanced will copy the current text
|
||
|
page in a buffer when you hit control-Q to enter terminal mode
|
||
|
so that when you re-enter term you will be at the same
|
||
|
location that you were in before.
|
||
|
|
||
|
NOTE: When you are off-line (connected but in Terminal mode),
|
||
|
NO incoming characters are displayed or intercepted, so
|
||
|
make sure when you do enter Terminal mode (via ^Q) you should
|
||
|
be at the main menu of a board, or some other place where
|
||
|
it does not change between 103/202.
|
||
|
|
||
|
Exiting from Cat-Fur 2.2a Enhanced:
|
||
|
------------------------------------
|
||
|
Upon exiting from CF 2.2a Enh. (via ESCAPE or ^C or RESET),
|
||
|
DOS is restored as much as possible to as it was before.
|
||
|
To re-enter CF 2.2a Enh. after exiting press & from BASIC,
|
||
|
or ^Y from MONITOR.
|
||
|
|
||
|
:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
|
||
|
|
||
|
Unattended mods:
|
||
|
================
|
||
|
Enhanced chat mode:
|
||
|
-------------------
|
||
|
Previously in the older versions of Cat-Fur, chat was entered
|
||
|
with a control-Q. With the new Enhanced chat mode, control-B
|
||
|
enters chat and control-F exits chat. There is no longer a
|
||
|
need for the receiving person to enter K)hat mode as there is
|
||
|
now an auto-echo feature which echoes every character to the
|
||
|
receiving end.
|
||
|
|
||
|
Return to BBS option:
|
||
|
---------------------
|
||
|
When a user selects "Return to BBS" from remote Cat-Fur will
|
||
|
then run "@FUR" but, to determine that they are returning to
|
||
|
the BBS a check must be added. PEEK (2046) will yield a 255 if
|
||
|
the user is returning to the BBS. Otherwise it will hold their
|
||
|
level as before. This is optional and can be selected from the
|
||
|
reconfigure menu, and is only active when being run remotely.
|
||
|
|
||
|
NOTE: See @FUR note at end of file.
|
||
|
|
||
|
Online Clock:
|
||
|
-------------
|
||
|
The Vulture's clock feature is now directly installed into
|
||
|
Cat-Fur. This feature is set in reconfigure and is optional.
|
||
|
|
||
|
NOTE: This option is only active if a Thunderclock is present
|
||
|
in any slot from 1-7, CF 2.2a Enh. will automatically find
|
||
|
the clock.
|
||
|
|
||
|
Online Transferring Status:
|
||
|
---------------------------
|
||
|
O)nline transferring status tells the user their current
|
||
|
upload/download ratios along with the total numbers of
|
||
|
transfers this call and transfers remaining (if not
|
||
|
unlimited). There is also a visible counter for the sysops
|
||
|
next to the incoming and outgoing character windows at the top
|
||
|
of the screen. This counts the number of files transferred,
|
||
|
not the total number of transfers.
|
||
|
|
||
|
Auto-pause:
|
||
|
-----------
|
||
|
This feature is used when viewing text files. It will
|
||
|
automatically pause when the screen is filled with characters,
|
||
|
not after every 18 returns. It will work when viewing ANY text
|
||
|
file whether 40, 80, or any other format. This feature is
|
||
|
useful when you wish to read text files online, but it is not
|
||
|
useful when you want to capture it in your buffer, therefore
|
||
|
it can be toggled on or off in remote via "A".
|
||
|
|
||
|
+/- or arrows to log volumes:
|
||
|
-----------------------------
|
||
|
You may now use your arrow keys (left/right or up/down) as
|
||
|
well as +/- keys to move up or down volumes on the hard drive.
|
||
|
|
||
|
NOTE: This option is only active if a hard drive is in use.
|
||
|
|
||
|
Online 12800 character message editor:
|
||
|
--------------------------------------
|
||
|
This is an online message editor. Although it is not a full
|
||
|
scale message editor, it is useful for "About files" as well
|
||
|
as messages to the sysop.
|
||
|
|
||
|
NOTE: All commands that are listed as "^A ^A:Abort.." mean
|
||
|
that Control-A must be pressed twice consecutively in order
|
||
|
to issue that command. It would also be helpful if you
|
||
|
ended every line with a RETURN, as many times it will
|
||
|
repeat your last line that you typed in, that is from
|
||
|
the last RETURN to the end of the message.
|
||
|
|
||
|
Chat Call:
|
||
|
----------
|
||
|
This feature is meant to call the sysops attention when the
|
||
|
online user needs assistance. It sounds a short tone three
|
||
|
times, after that no noise is made. Once selected it shows a
|
||
|
flashing "CHAT!" in the upper right corner. It can be
|
||
|
turned off by the user online as well as by chatting with the
|
||
|
user.
|
||
|
|
||
|
Full DOS support for Sysops:
|
||
|
----------------------------
|
||
|
Sysops can now log volumes or interpret DOS commands from
|
||
|
terminal mode as well as when in transfer mode.
|
||
|
|
||
|
Search for a File on Hard Drive:
|
||
|
--------------------------------
|
||
|
This feature will search the hard drive for a file which you
|
||
|
select by typing the first few letters. It will start the scan
|
||
|
from the lowest lockout volume up to the highest. The
|
||
|
volume(s) that the file was found on (if any) will be
|
||
|
displayed and it will put the user on the last found volume.
|
||
|
|
||
|
NOTE: This option is only active if a hard drive is in use.
|
||
|
|
||
|
Free Sector Scan:
|
||
|
-----------------
|
||
|
This feature will search the hard drive for a selected number
|
||
|
of sectors that the user online chooses. The user will then be
|
||
|
taken to the first volume found with enough room. If there is
|
||
|
no room anywhere on the hard drive the user will be prompted.
|
||
|
|
||
|
NOTE: This option is only active if a hard drive is in use.
|
||
|
|
||
|
Loop routine:
|
||
|
------------
|
||
|
If a key is not hit in unattended after approximately
|
||
|
two minutes, CF 2.2a Enh. will hang up. Two ^G BEEPS are sent
|
||
|
to the other side about 30 seconds before hanging up.
|
||
|
|
||
|
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
|
||
|
Transfer mods:
|
||
|
==============
|
||
|
Counts number of selected sectors:
|
||
|
----------------------------------
|
||
|
This feature shows the total number of selected sectors
|
||
|
on the bottom right of the text window, after a CATALOG
|
||
|
is sent or received. It keeps an running count of the number
|
||
|
of sectors the transfer will be.
|
||
|
|
||
|
Extended filetypes:
|
||
|
-------------------
|
||
|
Filetypes are now shown as: TXT, INT, APL, BIN, SEQ, REL, AUX,
|
||
|
and LSA. The files sectors are also corrected, in other words
|
||
|
it will now show the correct number of sectors a file is, if
|
||
|
it exceeds the standard 256.
|
||
|
|
||
|
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
|
||
|
Peeks, Pokes, & Calls:
|
||
|
======================
|
||
|
|
||
|
Pokes for Cat-Fur 2.2a Enhanced Remote:
|
||
|
---------------------------------------
|
||
|
All of the following pokes should be issues AFTER
|
||
|
CF 2.2a Enh. has been BLOADed into memory, and none
|
||
|
of the pokes should be less than 0 or greater than 255.
|
||
|
|
||
|
Set number of chat calls [default=3]: POKE 26097,number
|
||
|
|
||
|
Set starting slot, drive, and volume: POKE 26229,slot :
|
||
|
POKE 26221,drive : POKE 26237,volume
|
||
|
|
||
|
Upload only Cat-Fur 2.2a Enh.: POKE 36757,76 :
|
||
|
POKE 36758,125 : POKE 36759,139
|
||
|
|
||
|
Disable free sector print out in remote: POKE 44164,96
|
||
|
|
||
|
Set minutes allowed in remote: POKE 48423,minutes
|
||
|
|
||
|
Disable sound completely: POKE 48430,0
|
||
|
|
||
|
Set low/high volumes: POKE 48443,low : POKE 48444,high
|
||
|
|
||
|
Set number of transfers: POKE 48445,number
|
||
|
|
||
|
To start CF 2.2a Enh. after it has been BLOADed and
|
||
|
POKEd, issue a: CALL 24576
|
||
|
|
||
|
Peeks AFTER Cat-Fur 2.2a Enhanced has been run:
|
||
|
-----------------------------------------------
|
||
|
PEEK (898) = number of uploaded files
|
||
|
PEEK (899) = number of downloaded files
|
||
|
PEEK (900) = number of uploads total
|
||
|
PEEK (901) = number of downloads total
|
||
|
PEEK (2046) = 255, Returning to BBS
|
||
|
PEEK (2046) <> 255, not returning to BBS, lost carrier
|
||
|
|
||
|
@FUR and other notes:
|
||
|
---------------------
|
||
|
The hello text-file is still CAT.HELLO, and the file run
|
||
|
upon losing carrier, or Returning to the BBS is @FUR.
|
||
|
The only difference with @FUR is that now @FUR must
|
||
|
have a line 1. For example enter this:
|
||
|
|
||
|
1 REM NOW THERE'S A LINE 1!!
|
||
|
|
||
|
And @FUR will then work properly, without a line 1
|
||
|
@FUR will get an ?UNDEF'D STATEMENT ERROR.
|
||
|
|
||
|
MENU program Note:
|
||
|
------------------
|
||
|
Upon the bootup of the Cat-Fur 2.2a Enhanced disk,
|
||
|
the program MENU will BLOAD CF 2.2A ENH. ORIG and
|
||
|
do a checksum on it, if any discrepancies are found,
|
||
|
an appropriate message will be displayed.
|
||
|
|
||
|
NOTE: The checksum is for an unmodified copy, and
|
||
|
should not be done on a Reconfigured copy as the
|
||
|
checksum will be different.
|
||
|
|
||
|
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
|
||
|
Diversi-Dos 64k Notes:
|
||
|
======================
|
||
|
|
||
|
Boot:
|
||
|
-----
|
||
|
This disk automatically boots into 64k Diversi-Dos without
|
||
|
the use of the DDMOVER file. If you want this DOS on another
|
||
|
disk simply copy the DOS from this disk to another and it
|
||
|
will also automatically boot into 64k DOS. To disable the
|
||
|
auto-boot into 64k DOS press ESCAPE while loading.
|
||
|
|
||
|
Ramdisks:
|
||
|
---------
|
||
|
Do not use the RAMDISK program on the Diversi-Dos disk,
|
||
|
or any other RAMDISK program as CF 2.2a Enh. does not work
|
||
|
with them.
|
||
|
|
||
|
Versions:
|
||
|
---------
|
||
|
This program only works with Diversi-Dos 64k 4.1-C, do
|
||
|
not worry if you do not have this version as it is on the
|
||
|
disk.
|
||
|
|
||
|
Hard Drive Users:
|
||
|
-----------------
|
||
|
In order to get into 64k Diversi-Dos from your hard drive
|
||
|
(this was tested on the Sider, but should work for most
|
||
|
hard drives), boot into DOS 3.3 then BRUN the PATCH file
|
||
|
that is included on this disk. You will now be in 48k
|
||
|
Diversi-Dos, now BRUN the DDMOVER which is also included
|
||
|
on this disk. You will now be in 64k Diversi-Dos. This also
|
||
|
works if you do not have a hard drive.
|
||
|
|
||
|
Lowercase files:
|
||
|
----------------
|
||
|
Diversi-Dos 64k does not support lowercase filenames,
|
||
|
and neither does Cat-Fur 2.2a Enhanced. Even though
|
||
|
lowercase files will be displayed in the Catalog after
|
||
|
it has been transferred, any attempt at Receiving a lowercase
|
||
|
file will yield a Transfer Aborted message.
|
||
|
Patches:
|
||
|
========
|
||
|
^I/Macros and "?" patches:
|
||
|
--------------------------
|
||
|
The ^I/Macros an the "?" wildcard in 64k Diversi-Dos may cause
|
||
|
problems with your board, so it is best to disable them with
|
||
|
the following patches:
|
||
|
|
||
|
Disable ^I/Macros and "?" wildcard: POKE 57006,32 :
|
||
|
POKE 57007,30 : POKE 57008,191 : POKE 63326,234 :
|
||
|
POKE 63327,234 : POKE 63328,234 : POKE 63329,234
|
||
|
|
||
|
Re-enable ^I/Macros and "?" wildcard: POKE 57006,76 :
|
||
|
POKE 57007,7 : POKE 57008,218 : POKE 63326,201 :
|
||
|
POKE 63327,191 : POKE 63328,240 : POKE 63329,11
|
||
|
|
||
|
Catalog pause:
|
||
|
--------------
|
||
|
Disable Catalog pause: POKE 60985,96
|
||
|
|
||
|
Re-enable Catalog pause: POKE 60985,32
|
||
|
|
||
|
NOTE: CF 2.2a Enh. automatically installs the patches, so it
|
||
|
is not necessary to enter these patches before running
|
||
|
Cat-Fur 2.2a Enhanced.
|
||
|
|
||
|
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
|
||
|
Conclusion:
|
||
|
===========
|
||
|
This Cat-Fur took over a month to complete and is, as far
|
||
|
as we (the testers and the writers) know, it is bug-free. If
|
||
|
any problems arise, or you would just like to comment on the
|
||
|
program then please call Apple Tree // (305/556-6858) and
|
||
|
leave mail to The Screamer, account 3.
|
||
|
|
||
|
Thanks to:
|
||
|
==========
|
||
|
The Ubiquitous Hacker: For "fixing" Cat-Fur 2.2 in the first
|
||
|
place, and starting the trend of using Cat-Fur 2.2a
|
||
|
|
||
|
Enson Parker: For creating the first 64k Cat-Fur.
|
||
|
|
||
|
Mr. Slick: For making the anti-stack crashing routines
|
||
|
which are still in use now.
|
||
|
|
||
|
And to Radar, and all of the other testers. Without the help
|
||
|
of them this Cat-Fur wouldn't be out for another year.
|
||
|
|
||
|
Docs typed by The Messiah
|
||
|
with finishing touches by The Screamer
|
||
|
|
||
|
By the way, Merry Christmas!
|
||
|
|
||
|
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
|
||
|
|
||
|
|