INSTRUCTION MANUAL

 

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

 

TITLE                                     PAGE

 

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

UNLISTED COMMANDS

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


2

TIPS

 

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.

 

INTRODUCTION

 

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.

 

RESET BUTTON

 

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.

 

COMMAND MENU

 

* (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

UNLISTED COMMANDS

 

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!