All
these functions on one cartridge!
* read disk error channel
** send DOS command to disk
*A auto line numbering or renumbering
*B read or write a disk block
*C copy a file or entire disk, change a file type, recover scratched file
*D delete a range of lines
*F show how much free memory
*G get disk directory
*L show load address of program file
*M loads machine language monitor software program
*P print sequential file
*Q disable (quit) cartridge
*T text editor
*U un‑new a program
*X dump screen to printer
*! computer cold start (reset)
*# change cartridge number
*= change disk drive number (and cartridge number)
*+ change border color
*- change background color
*£ change character color
*? show command menu
*/ load program file
*@ load program file to header address
*{Up) load program file and run it
*{Left} save program file
*: load sequential file
*; save sequential file
*, load user file
*. save user file
ONE‑STEP
UTILITY CARTRIDGE REFERENCE GUIDE CONTENTS
TIPS........................................2
INTRODUCTION................................2
RESET
BUTTON................................2
LOADING AND RUNNING
CARTRIDGE...............3
COMMAND
MENU................................3
* (DISK STATUS).........................3
*A (AUTO NBR/RE‑NBR).....................3
*B (BLOCK READ/WRITE)....................4
*C (CPY/RSTR FL/DSK).....................4
*D (DELETE LINES)........................5
*F (SHOW FREE MEMORY)....................5
*G (GET DIRECTORY).......................5
*L (SHOW LOAD ADDR)......................5
*P (PRINT SEQ FILE)......................5
*T (TEXT EDITOR).........................7
*U (UN‑NEW)..............................8
*X (PRINT SCREEN)........................8
** (SEND DOS COMMAND)....................8
*# (NEW WDG#)............................8
*= (NEW DRIVE/WDG#)......................9
*+ (NEW BORDER COLOR)....................9
*‑ (NEW SCREEN COLOR)....................9
*? (GET COMMAND MENU)....................9
*/ (LOAD PROGRAM)........................9
*@ (LOAD ML PROGRAM).....................9
*{Up) (LOAD+RUN PROGRAM)....................9
*{Lft}(SAVE PROGRAM)........................9
*: (LOAD SEQ FILE).......................9
*; (SAVE SEQ FILE).......................9
1
SYS49152...............................................10
*M (MACHINE
LANGUAGE MONITOR).......................10
*Q (DISABLE
WDG)....................................10
*! (RESET)..........................................10
*£ (NEW CHARACTER
COLOR)............................10
*, (LOAD USER
FILE).................................10
*. (SAVE USER
FILE).................................10
1. Insert Cartridge with C64 OFF.
2. All One‑Step Utility Cartridge
commands, except DISK STATUS, are
preceded by an asterisk and entered with
RETURN key.
3. RESET BUTTON gets the command menu and
resets computer.
4. SYS49152 command restarts the Utility
Cartridge and does not interfere with
program in residence.
5. *! disengages the Cartridge and brings up
cold start screen.
6. *U (UN‑NEW) recovers BASIC program
after RESET BUTTON has been pressed.
7. Use "MENU",8,1 to load and run any
Green Valley Publishing software
products.
8. If you are using a Cardco printer interface
an I/O ERROR #5 may appear on the
display screen. To remedy this enter the
print command twice. For example, to print the screen enter *X*X.
The One‑Step
Utility Cartridge saves you time and energy. In just two keystrokes you can
perform BASIC functions that normally take several steps to complete. A RESET
BUTTON lets you reset the Cartridge without turning your computer off and on.
Also, with machine language monitor software you get 30 additional machine
language programming commands.
This document is
designed to give you more information about the Cartridge commands. If you have
any questions about programming consult a C64 programming manual.
The RESET BUTTON is
located on the top end of the Cartridge. Use it when the computer locks‑up.
Pressing the button resets the computer, brings the screen back to cold start
and recalls the command menu. If you were working on a program when you pressed
the RESET BUTTON use the *U (UN‑NEW) command to recover it.
3
LOADING AND
RUNNING THE ONE‑STEP UTILITY CARTRIDGE
We recommend you follow
the steps listed below to load and run the One‑Step Utility Cartridge.
Except for step 4, these instructions are similar to those in your C64
User's Manual.
1.
Turn OFF your
C64 computer before you insert the cartridge. IF THE COMPUTER IS ON YOU MAY DAMAGE
THE COMPUTER AND CARTRIDGE.
2.
Firmly insert
the Cartridge, LABEL SIDE UP, in the slot on the back of your computer. It will
click into place. DO NOT FORCE THE
CARTRIDGE INTO THE SLOT.
3.
Turn ON your
computer. The Cartridge automatically loads at this point.
4.
The Command
Menu will appear on the screen.
You may select any
of the 28 commands on the menu or choose from the unlisted commands in this
guide. ALL COMMANDS, except disk status, ARE PRECEDED BY AN ASTERISK (*). After
entering a command press the RETURN key.
* (DISK STATUS): Reads the error channel of
the disk drive and prints an error number on the screen. See your disk drive
manual for more detailed descriptions of the error numbers.
*A (AUTO NBR/RE‑NBR) : Automatic line
numbering and re‑numbering for BASIC programs.
*A, number: This command automatically assigns line numbers to individual lines. Any whole number increments as a multiple of itself. A syntax error appears if line numbers go beyond 63999. The cursor is also moved, at the same time, to one space following the line number. The command is disconnected if you hit RETURN twice or when an operation is performed other than editing or entering program lines.
*A,number,number:
Use to re‑number a BASIC program residing in the C64. The first number
represents the number you want your first line to be. The second number is the
line increment. GOTO and GOSUB commands are readdressed to their proper
locations.
4
*B (BLOCK READ/WRITE):
You must load machine language monitor software for this command to work. When
entering track and sector numbers specify they are hexadecimals by placing an $
before the number.
*BR,$track,$sector:
Reads a sector of data from the disk, displays the location of the buffer where
the data is stored and engages the machine language monitor software.
*BW,$track,$sector:
Writes a sector of data from C64 memory to a specified sector on the disk. It
is generally used after *BR where you have modified data and want to write it
back to the sector. A screen prompt asks you to confirm your intent to write.
Before responding make sure you have an extra copy of the disk you are writing.
*C (CPY/RSTR FL/DSK) : This copy and restore
command does not support relative files or copy open files.
*C:filename: Use to make copies of single files. FORMAT a destination disk to copy your file on. Remove the disk from the drive. Insert the disk that contains the file you want copied (source disk). Enter the *C:filename command and press RETURN. The file will load into memory. The screen prompts you to remove the source disk and insert the destination disk. If a file exceeds the memory area a screen prompt appears asking you to insert the source disk and begin the procedure over again. Continue until the entire file is copied.
*C:filename:
Use to change file type or recover a scratched file as a particular file.
Instructions for this command are given on the screen.
*C*:
Makes a copy of the entire disk rather than just a single file. FORMAT a
destination disk. You may need to alternate between the original and
destination disk until the procedure is completed. All sectors allocated as
files in the BAM (block availability map) are
copied.
*C**:
This command copies the entire disk as is, whether or not sectors have been
allocated to the BAM (block availability map).
5
*D (DELETE LINES): Deletes a specified range of
program lines. This command also resets variable pointers. Line number values
must be decimals.
*Dline
number ‑line number: Deletes all lines within the specified line numbers.
For example, *D300‑450 deletes program lines from 300 to 450.
*D‑line
number: Deletes all lines from 0 to specified line number. For example, *D‑300
deletes all lines from 0 to 300.
*Dline
number‑: Deletes all lines up to the specified number. For example, *D200‑
deletes all lines from 200 on.
*F (SHOW FREE MEMORY): Reads out amount of
usable memory left in your C64.
*G (GET DIRECTORY): Prints the disk directory
to the screen. If you want to slow down the display press CTRL. RETURN allows
you to continue using the Cartridge commands. Any other key will stop the
display.
*L (SHOW LOAD ADDR): Reads out the load address
in hexadecimal and decimal. The numbers show the area in memory where your
program starts to load.
*L:filename:
Entering the file name loads the requested program.
*P (PRINT SEQ FILE): Prints a sequential file
to the screen or printer. The CTRL button slow the screen display. Pressing X
will terminate the screen display and print the screen. Any other keys pause or
resume the display.
*P:filename: Enter file name to bring up the requested file. A prompt inquires if you want the file displayed on the screen (S) or printed out (P) .
*T (TEXT EDITOR): This function is useful for
writing sequential files or small documents like memos and letters. You have 8
pages or 481 lines to work with. Before you create a file or document free‑up
as much memory as possible by typing NEW prior to entering *T. You can go from
the text editor to the cartridge command menu without losing your document.
Simply press RUN/STOP to get back to the text editor menu. Then press 8 (exit
to basic) from the text
6
editor menu and *?
(GET COMMAND MENU). Avoid using Utility Cartridge commands other than ASCII
files. They add data to memory and overwrite the current file. Printed
documents must be CBM files. ASCII files can be loaded (*/) and saved back
(*{Up}) as CBM files. Text should be saved with the appropriate number of lines
per page (with or without perforated skip carriage returns).
1.
clear text: Before you edit text clear the area in the computer's memory where
text is stored by pressing 1 and RETURN. A prompt asks you to confirm clearing
the memory just in case you may have forgotten to save your text. Enter Y (yes)
if you want text erased and N (no) if you need to go back and save the text. A
screen of garbage or ?FORMAT ERROR message appears if the text memory was not
cleared.
2.
set margins: Margins and page length are preset to left 5, right 75, and 66
lines. These margin and page values are displayed on the screen in flashing
blue characters. Pressing @ and RETURN 3 times puts them in place. You can
change the preset margins and page length by entering your own numbers in the
spaces and pressing RETURN. A screen of garbage or ?ERROR FORMAT message
appears if margins are set to illegal values ( left > 77 or to close to the
right and right > 80) .
3.
edit text: When the memory has been cleared and margins and page length set you
can begin writing. The standard 80 character column line is displayed as 2
lines between margin markers. They show where lines begin and end. A status
line at the bottom of the screen identifies which page, line and column the
cursor is on. The parsing feature lets you type without watching the screen and
edit the previous line without moving text onto the next line. Parsing does not
operate on words longer than 10 characters. Watch for shifted spaces. The text
editor interprets them as characters. Pressing RETURN puts you onto a new
screen line. CRSR <- and ‑> and HOME function normally. CRSR {Up)
and {Down} moves the cursor 2 screen lines at a time. Moving the cursor past
the bottom of the screen scrolls text forward. Reverse scrolling happens when
the cursor is moved to the top of the screen. If you move the cursor to the end
of available memory forward movement stops. The same thing applies to reverse
movement at the top of the screen. INST and DEL work as expected but only on
the current
7
line. Holding DEL
down moves the cursor to the left margin. To delete part of the previous line
move the cursor there with CRSR left. Then you can continue deleting. INST
pushes all text into the right margin. Text pushed into the right margin cannot
be recovered, CTRL DEL deletes the current line and draws all lines in to close
the gap. CTRL INST opens a blank line and pushes all lines forward from the
current line on. Holding down CTRL DEL or CTRL INST allows you to delete or
insert large portions of text. To merge text from one document to another place
the cursor at the point in the original document where you want the inserted
document to begin. Load (4/5) the original file, locate the cursor, press
STOP/RUN for the text editor menu and load (4/5) the inserted file. You may
also insert blocks of text with CTRL I merging text from another file into the gap.
4/5.
load cbm/load ASCII: Clear the text memory (1) before performing this command
or you will merge some of the text. If the file was not written using this text
editor the margins will default to 0 (left) and 80 (right). Then the text
editor assigns the margins you have set to that file. This is useful for
creating or editing source code files for an assembler. After the load is
completed you are returned to the text editor menu. Pressing @ and RETURN 3
times puts you into the edit mode again.
6/7,
save cbm/save ASCII: Files saved by the text editor have information for
setting up left and right margins. Blank lines are saved as carriage returns
for CBM files or linefeeds for ASCII files. Carriage returns are also added at
the end of each page to provide perforation skips for the printer. The editor
assumes each page has 66 lines. If the page length is less than 66 lines unused
lines are added as carriage returns at the end of each page. If you do not want
these added to your file reset the lines to 66 before saving the file.
8.
exit to basic: This function returns you to BASIC. Entering *? (GET COMMAND
MENU) will get you back to the command menu.
*U (UN‑NEW): Recovers a loaded file if
you have not loaded another one. It also performs a CLR function.
8
*X (PRINT SCREEN): Transfers screen displayed
to the printer. You can enter this command from anywhere on the screen.
However, avoid entering it on the last line because the top screen line scrolls
off and will not appear on your print‑out. Upper‑ and lower‑case
characters and basic graphics (if they are not reverse video) print out. This
command works with most Commodore compatible printers.
** (SEND DOS COMMAND): This command sends any
text following the asterisks to the disk drive as a DOS (disk operating system)
command.
**N:
diskname,id: Formats a new disk or reformats an old disk. CAUTION. This command
erases all data on the disk. It may also be used to format a disk while the
BASIC program is listed.
**I: Initializes the drive and returns it to the original powered‑up state. Use if a drive error message appears.
**S:filename:
Flags the BAM (block availability map) and removes the file from the directory.
If you want to use the scratched sectors you must validate (**V) the disk.
**V:
Reallocates blocks of disk memory previously used by programs that have been
scratched or purged.
**R:
newname=oldname: Re‑names a file in the directory. Check the directory to
see there is not an asterisk (*) before the file type. This command does not
work with OPEN files.
*# (NEW WEDGE NUMBER): Reassigns the Cartridge
device number so you can use it with another disk drive and lets you read or
write to the designated drive. You should specify the device number as a
decimal from 8 to 12. For example, *#9 changes the Cartridge from device 8 to
device 9.
*= (NEW DRIVE/WDG #): Reassigns the Cartridge
and disk drive number you are presently working with. Turning the computer off
invalidates this command. Device numbers should be decimals from 8 to 12. For
example, * = 9 changes the drive number to 9 and sets the Cartridge to
communicate with device 9, the disk drive.
9
*+ (NEW BORDER COLOR): Changes the border color
using the color codes (0‑15) listed in the C64 User's Manual. For
example, *+5 makes the border green. You can give this command without a
number. If you do the color will be incremented to the next highest number. If
you turn the computer off or press the RESET BUTTON you will have to reset your
border color.
*‑ (NEW SCREEN COLOR): Changes the screen
color. Works the same way as *+ (NEW BORDER COLOR).
*? (GET COMMAND MENU): Displays the command
menu for quick reference.
*/ (LOAD PROGRAM): Loads a BASIC program from
the disk to the C64.
*
/filename: Loads the requested program so you can list or run it.
*@ (LOAD ML PROGRAM): Loads a machine language
program.
*@filename:
Loads the requested machine language program. However, you must use the SYS
number of the machine language program to run it.
*{Left} (LOAD+RUN PROGRAM): Loads and runs a BASIC
program.
*{Left}
filename: Loads and runs the requested BASIC program.
*{Up} (SAVE PROGRAM): Saves a BASIC program.
*{Up}
filename, address1,address2: Address 1 is the start of the save. Address 2 is
one byte more than the last address included in the save. Addresses can be
hexadecimal if preceded by $ or decimal.
*: (LOAD SEQ FILE): Loads a sequential file.
*:filename: Loads requested sequential file to the screen for editing.
*; (SAVE SEQ FILE): Saves a sequential file.
*;filename: Saves an edited sequential file back to disk.
10
SYS49152: If you have discontinued using the Cartridge
to perform some other computer operation typing SYS49152 will reactivate the
Cartridge. This command does not affect a BASIC program listing. To verify the
Cartridge is working enter *? (GET COMMAND MENU). The command menu will appear
on the screen.
*M (MACHINE LANGUAGE MONITOR): To use *M you
must load a machine language monitor software program from a disk. This
software will give you 30 additional functions for programming or working in
machine language.
*Q (DISABLE WDG) : Disengages the Cartridge so
you can perform other operations with your computer. If you want to use the
Cartridge again enter the SYS49152 command.
*! (RESET) : Disengages the Cartridge and
brings the computer back to the Commodore screen.
*£ (NEW CHARACTER COLOR): Changes the character
color (using the color codes (0‑15) in the C64 User's Manual. For
example, *£8 will change the character color from the start‑up color
(light blue) to yellow. You can give this command without a number. If you do
the color will be incremented to the next highest number. If you turn the
computer off or press the RESET BUTTON you will have to re‑enter this
command.
*, (LOAD USER FILE): Loads a user file the same
way as a sequential file (*:). Primarily for DOS (disk operating system)
programming. More information is available in your disk drive manual.
*. (SAVE USER FILE): Saves a user file the same
way as a sequential file (*;). Primarily for DOS (disk operating system)
programming. More information is available in your disk drive manual.
These are two of the
“Utility” cartridges I have found. They are both from ShareData Inc. and appear
to have the same firmware. The only difference are the labels.
Scanning & OCR
by Raj!