CBM Funet Archive/cbm-funet-archive-2003.iso/cbm/c128/utilities/svnt128.doc

Text File | 1993-01-17 | 10KB | 179 lines

tHE ARCHIVES SVNT484?.SFX CONTAIN "tHE sERVANT" FOR THE c128.  tHANKS TO mARK
sPACEK FOR SUBMITTING THEM TO THIS SITE.

CRC32 =  963122059 FOR "SVNT484A.SFX".
CRC32 = 2362161600 FOR "SVNT484B.SFX".
CRC32 = 3622206924 FOR "SVNT484C.SFX".
CRC32 =  903412072 FOR "SVNT484D.SFX".

tHE FOLLOWING ARE THE iNTRODUCTION AND oVERVIEW FILES FROM PART A...

**************************
*hERE IS THE iNTRODUCTION*
**************************

the servant

a rom-BASED UTILITY PACKAGE DESIGNED
EXCLUSIVELY FOR THE cOMMODORE 128

hI!  aND WELCOME TO the servant.  tHE GUYS WHO DESIGNED THE cOMMODORE 128 DID
A GREAT JOB.  bOTH YOU AND i HAVE ENJOYED THE FRUITS OF THEIR EFFORTS.  iN THE
DESIGN OF THE c128 THEY INCLUDED A FEATURE WHICH HAS ONLY RARELY BEEN PUT TO
USE.  iF YOU OPEN YOUR TRUSTY COMPUTER THERE SEEM TO BE SOMETHING MISSING.
aMONG ALL THE BLACK, RECTANGULAR CHIPS THERE'S A VACANT SOCKET.  wHAT KIND OF
CHIP MIGHT FIT.  aN EXTRA PROCESSOR?  nAH.  eXTRA MEMORY?  wELL KIND OF, THE
SOCKET IS MEANT TO CONTAIN A rom CHIP OF UP TO 32 KILOBYTES.  a CREATIVE
PROGRAMMER IS FREE TO USE THIS SPACE IN WHATEVER WAY HE OR SHE (i WOULD LIKE
TO SEE FEMALE c128 PROGRAMMERS!) SEES FIT.  a LOT OF GOODIES CAN BE PUT INTO
THAT SPACE.

tHIS IS WHERE the servant COMES IN.  the servant OFFERS A PLETHORA OF NIFTY
UTILITIES AND CONVENIENCE FEATURES DESIGNED TO MAKE YOUR COMPUTING LIFE EASIER
AND MORE FUN.  tHIS GOES EVEN IF YOU NEVER USE THE 128 MODE AT ALL.  the
servant IS DESIGNED WITH MAXIMUM CONVENIENCE, COMPATIBILITY AND SECURITY IN
MIND, MAKING IT UNUSUAL OR EVEN UNIQUE IN MANY WAYS.  bUT THEY ALL SAY THAT
DON'T THEY?

wELL SEE FOR YOURSELF AND ENJOY!


tHE AUTHOR WELCOME ALL KINDS OF REACTIONS FROM THE USERS.  cOMPLAINTS,
SUGGESTIONS, TECHNICAL OR OTHER QUESTIONS, COMMENTS, CORRECTIONS, REPORTS ON
ERRORS AND BUGS, NITPICKS, BOAST OR WHATEVER.  eVERYONE, PLEASE WRITE!

the servant AND THIS MANUAL HAS BEEN PRODUCED USING THE FOLLOWING:  c128,
mASTER 41, 1570, 1571, 1581 DISK DRIVES, 1750 rAM eXPANSION uNIT, pROMENADE c1
eprom PROGRAMMER, bROTHER hr15 PRINTER WITH sUPER g INTERFACE, mIDNIGHT
aSSEMBLY sYSTEM MACHINE LANGUAGE ASSEMBLER, tHE wRITE sTUFF WORD PROCESSOR.

tHE AUTHOR WISHES TO THANK ALL PEOPLE USING AND SUPPORTING THE 128 (AND THEN
SOME) WHO, MOSTLY WITHOUT KNOWING, HAVE MADE THIS POSSIBLE.  oNE PERSON
DESERVES A SPECIAL MENTION THOUGH.  i WISH TO THANK mATTHEW mONTCHALIN FOR HIS
WONDERFUL mIDNIGHT aSSEMBLY sYSTEM, THE ASSEMBLER USED TO CREATE the servant.
wITHOUT IT, the servant WOULD NEVER HAVE SEEN THE LIGHT OF DAY.

tHIS WORK IS DEDICATED TO ALL THE GOOD PEOPLE AROUND THE WORLD WHO ARE WORKING
FOR PEACE, UNDERSTANDING, NON-VIOLENCE AND THE SAVIOUR OF OUR WONDERFUL BLUE
PLANET.

aND LAST BUT NOT LEAST; PLEASE BEAR WITH ME AS YOU READ THIS MANUAL.  i AM NOT
NATIVE TO THE eNGLISH LANGUAGE.  i WAS BORN, RAISED AND STILL LIVE IN nORWAY,
THE LAND OF THE MIDNIGHT SUN.  nORWAY IS KNOWN FOR ITS MOUNTAINS AND FIORDS
AND FOR BEING A PEACEFUL CORNER OF THE WORLD.  tHANK YOU.

important note:
yOU'LL PROBABLY SPEND YOUR FIRST HOURS USING the servant IN COMPUTER ram.  the
servant IS SOMEWHAT HAMPERED WHEN WORKING IN THAT CONFIGURATION.  tHERE WILL
BE LESS BUFFER SPACE AVAILABLE FOR THE dISK cOPIER AND fILE cOPIER.
fURTHERMORE, SOME PROGRAMS WON'T LAUNCH PROPERLY WHEN USING the servant IN
ram.  eSPECIALLY, USING ramdos WILL PRODUCE SEVERE PROBLEMS IN SOME CASES.
aLSO, YOU CAN'T LOAD PROGRAMS OF MORE THAN 100 BLOCKS IN SIZE, AS BIGGER
PROGRAMS WILL OVERWRITE the servant AND CRASH IT.  yOU MAY ALSO DISCOVER OTHER
QUIRKS WHEN USING the servant FROM COMPUTER ram.  hOWEVER, ALL THESE PROBLEMS
WILL DISAPPEAR WHEN the servant IS ALLOWED TO LIVE ON A CHIP.  the servant
WORKING AS A ram-RESIDENT PROGRAM IS ONLY FOR YOUR REVIEW, CUSTOMIZING AND
THEN FOR MAKING A COPY THAT CAN BE PROGRAMMED INTO AN eprom.  the servant IS
not INTENDED TO BE RUN FROM COMPUTER ram ON A REGULAR BASIS!  i SHOULD ALSO
MENTION THAT THE COPYRIGHT MESSAGE YOU SEE WHEN REVIEWING the servant IN ram
WILL DISAPPEAR WHEN IT IS WORKING FROM AN eprom.

**********************
*hERE IS THE oVERVIEW*
**********************

overview of the servant'S features

servant FEATURES, MAIN MENU:
100% COMPATIBILITY WITH ALL SOFTWARE AND HARDWARE YOU MIGHT THROW AT IT.
ramdos IS FULLY SUPPORTED WHERE APPROPRIATE.  dOES NOT USE ANY MEMORY.
sUPPORTS 40 OR 80 COLUMN MODE, FAST (2mHZ) OPERATION IN 80 COLUMNS.  sIMPLE
DEVICE NUMBER SELECTION.  dEVICE NUMBERS OTHER THAN 8 (9 THROUGH 12) CAN BE
ACCESSED BY HOLDING DOWN shift, c=, control OR alt ALONG WITH THE COMMAND KEY.

-yOUR COMPUTER WON'T TRY TO BOOT A DISK WHEN POWERED UP OR RESET.  iF YOU do
 WANT TO BOOT A DISK, JUST SMACK THE "0" KEY WHICH IS BIG AND EASILY ACCESSIBLE
 ON THE NUMERIC KEYPAD.
-rUN THE FIRST PROGRAM ON A DISK AS A basic PROGRAM.
-lOAD THE FIRST PROGRAM, SWITCH TO 64 MODE, AND RUN IT.  cAN HANDLE FILES OF
 UP TO 249 BLOCKS.
-rUN c64 PROGRAMS AS IF YOU ENTERED 'load "*",X,1' IN 64 MODE WHERE 'X' IS THE
 DEVICE NUMBER.
-dIRECTORY.  run, dload, bload OR boot A 128 MODE PROGRAM, OR RUN A 64 MODE
 PROGRAM BY POINTING AT THE DESIRED FILE.  vIEW THE CONTENTS OF seq, prg, usr,
 rel AND EVEN del FILES.  dISPLAY AS ascii OR SCREEN CODES.  qUICK AND
 CONVENIENT 1581 PARTITION SELECTION.  sCRATCH SELECTED FILE.
-rECOVER A new-ED basic PROGRAM.  eVEN WORKS AFTER A RESET WHEN A GRAPHICS
 SCREEN WAS INVOLVED.
-gO TO 64 MODE.  yOU CAN GO BACK TO 128 MODE, AND THEN RE-ENTER 64 MODE WITH
 ml PROGRAMS, basic PROGRAMS AND VARIABLES AS YOU LEFT THEM.  eVEN UTILITIES
 WILL STILL BE WORKING!
-eNHANCED dos COMMANDS.  vALIDATE WILL NOW PROTECT THE BOOT AREA (IF BOOT
 SECTOR EXISTS), EVEN IF IT CONSISTS OF SEVERAL SECTORS.  dEVICE NUMBER
 CHANGE/SWAP COMMAND.  rECALL LAST COMMAND.
-sWAP 40/80 COLUMN SCREENS.
-cONVERT MEMORY TO basic data STATEMENTS.  cREATE STAND-ALONE PROGRAM OR MERGE
 data STATEMENTS INTO ANY basic PROGRAM.  sELECT INITIAL LINE NUMBER, INCREMENT,
 LINE LENGTH AND DATA TYPE (2 TYPES OF DECIMAL AND 3 TYPES OF HEXADECIMAL).  cAN
 READ ALL BANKS AND MEMORY RANGES.
-iNTEGRATED FILE MANAGER FOR THE quick brown box.  uNLIKE THE qbb'S OWN FILE
 MANAGER IT WON'T INTERFERE WITH jIFFYdOS, PROGRAMS, UTILITIES OR ANYTHING ELSE.
 fAST (2mHZ) AND CONVENIENT ONE-KEY LOADING FROM THE BOX.  dOWNLOAD FILES FROM
 DISK BY USING THE DIRECTORY.  yOU CAN FREELY MIX 64 & 128 MODE PROGRAMS WITHIN
 THE SAME BOX.

servant FEATURES, DISK TOOLS:
cAN USE ALL DEVICE NUMBERS 4 THROUGH 30.  aUTOMATICALLY DETECTS THE HARDWARE
YOU ARE USING, AND ADJUSTS ACCORDINGLY.  uSES BURST MODE WHENEVER POSSIBLE.
rECOGNIZES ramdos AS ANY OTHER DRIVE.  fULL 1581 PARTITION SUPPORT.  tHE
COPIERS AUTOMATICALLY DETECT AND TAKE ADVANTAGE OF 64k vdc MEMORY.  1700, 1764
AND 1750 MEMORY EXPANSION UNITS SUPPORTED AS AN OPTION.  wILL AUTOMATICALLY
DETECT THE SIZE OF THE reu (UP TO 1mB SUPPORTED) WHEN SELECTED.

-dIRECTORY.  vIEW NORMAL DIRECTORY ON SOURCE OR TARGET DISK, OR VIEW AN
 EXTENDED DIRECTORY* WHICH DISPLAYS DELETED FILES AS WELL.
-dISK REPORT.  sTATISTICAL OVERVIEW OF THE NUMBER OF FILES OF EACH TYPE, THE
 BLOCKS THEY USE, BOOT BLOCKS AND BLOCKS FREE ON DISK.
-dISK COPIER*.  cOPY WHOLE DISK OR ONLY THE TRACKS WHICH ARE USED (MARKED AS
 USED IN THE bam).  sINGLE OR DUAL DRIVE COPY.  aUTOMATICALLY DETECTS IF THE
 DISK IS SINGLE OR DOUBLE SIDED.  wITH 64k vdc MEMORY (BUT WITHOUT A reu), IT
 WILL COPY A WHOLE SINGLE SIDED DISK IN ONE PASS.
-fILE COPIER.  sINGLE OR DUAL DRIVE COPY.  aDJUSTABLE SECTOR INTERLEAVE ON
 TARGET DISK FOR MAXIMUM RELOAD SPEEDS.  nO LIMITS ON THE USE OF 1581
 SUBDIRECTORIES.  iT CAN COPY FILES FREELY BETWEEN SUBDIRECTORIES, EVEN FROM ONE
 SUBDIRECTORY TO ANOTHER ON THE SAME DISK.  aUTOMATICALLY DETECTS THE SPACE
 REMAINING ON THE TARGET DISK, AND REPORTS IF THE SPACE IS INADEQUATE.  oPTIONS
 TO MAKE MULTIPLE COPIES OF FILES, SCRATCH COPIED FILES FROM THE SOURCE DISK,
 AND AUTOMATICALLY REPLACE OF DUPLICATE FILES ON THE TARGET DISK.
-sCRATCH FILES.  bULK SCRATCH THE FILES YOU SELECT.
-uNSCRATCH FILES*.  rECOVER SCRATCHED FILES.  wILL REPORT, AS FAR AS POSSIBLE,
 WHICH FILES ARE RECOVERABLE OR NOT.  cAN RECOVER ALL FILE TYPES, EVEN cbm
 FILES.
-hEADER/FORMAT DISK.  oN THE 1571 YOU CAN SELECT SINGLE OR DOUBLE SIDED
 FORMAT, AND YOU CAN CONVERT A SINGLE SIDED DISK TO DOUBLE SIDED.  cHANGE DISK
 NAME & id.  cREATE PARTITIONS AND SUBDIRECTORIES ON THE 1581.  gRAPHIC
 REPRESENTATION OF THE DISK WHICH DISPLAYS THE FREE SPACE USABLE AS SUBDIRECTORY
 AREAS.
-eDIT DIRECTORY*.  rE-ARRANGE, SORT, RENAME, LOCK/UNLOCK FILES.  cHANGE
 PROGRAM LOAD ADDRESS, CHANGE FILE TYPE & COMPRESS DIRECTORY.
-pRINT DIRECTORY*.  oUTPUT DIRECTORY TO PRINTER INCLUDING ALL NORMALLY HIDDEN
 INFORMATION.  tHIS INCLUDES START TRACK/SECTOR, rel FILE SIDE SECTOR AND RECORD
 LENGTH.  oPTIONALLY, PRINT START AND END ADDRESSES FOR prg FILES AND seq/usr
 FILE LENGTHS.
-aUTOBOOT TOOL.  cREATE BOOT SECTOR ON A DISK FOR A VARIETY OF PURPOSES.
 wRITE A basic COMMAND LINE TO BE EXECUTED UPON BOOTING.  lIMITED ONLY BY basic
 AND SIZE OF THE BOOT SECTOR; ALL DIRECT MODE COMMANDS CAN BE USED.  mAKE BOOT
 SECTOR TO RUN 64 MODE PROGRAMS, EVEN PROGRAMS REQUIRING A sys COMMAND OR load
 "*",8,1 TO EXECUTE.  aNALYZE BOOT SECTOR.  kILL BOOT SECTOR, TRANSFER BOOT
 SECTOR FROM ONE DISK TO ANOTHER.  cONVERT BOOT SECTOR TO AN EXECUTABLE PROGRAM
 OR VICE VERSA.  bOOT SECTORS WILL SUPPORT ALL DEVICE NUMBERS.

* tHE MARKED FEATURES WON'T WORK WITH ramdos, THE OLD cbm HIGH CAPACITY DRIVES
SUCH AS THE 8250, 4040 AND 8250 OR HARD DRIVES.  wHETHER IT WILL WORK WITH HARD
DRIVES USING "EMULATION PARTITIONS" HAVE NOT BEEN TESTED.  1581, 1571 AND ALL
DRIVES USING 1541 COMPATIBLE DISKS WILL WORK PERFECTLY IF THEY CAN BE HOOKED UP
TO THE 128.

iF YOU PREFER, THE sERVANT rom CAN BE PUT INTO A CARTRIDGE FOR THE EXPANSION
PORT, OR EVEN INSIDE THE 17XX SERIES reu'S.