home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Frozen Fish 1: Amiga
/
FrozenFish-Apr94.iso
/
bbs
/
alib
/
d5xx
/
d555
/
thea64package.lha
/
TheA64Package
/
A64Utils.lzh
/
Doc
/
Utilities
< prev
next >
Wrap
Text File
|
1991-10-02
|
25KB
|
1,135 lines
UTILITIES
NOTE: Throughout this section reference is made to the CLI.
The CLI is the same thing as the Shell. I was just too
lazy to update everything :)
The A64 Package comes with a number of utility programs that are
designed to compliment A64. The following list gives a brief
summary of the utilities included with The A64 Package. A couple
of the headings need explanation. The heading HDW is short for
HarDWare interface and is used to signify if the utility directly
needs A64's hardware interface. The heading ENV is short for
ENVironment and is used to state what environment the utility
is to be used in. The different environments are: WB - the
utility is meant to be used with the WorkBench, but can also be
used from the CLI, CLI - the utility is used from the CLI only,
C64 - the utility is meant to be used on the C64, and A64 - the
utility can be used by both A64 and the C64. Please note that
the utilities with their environment set to C64 or A64 are actual
Commodore 64 programs, all other utilities are Amiga programs.
Also note that just because a utility does not use the hardware
interface directly does not mean that the utility will be useful
without the interface. For example the utility "Pet2ASCII" will
convert a file from PetASCII to ASCII, but to use it you must
first transfer a C64 program to an Amiga disk. Also note that
although most programs state that they should be run from the
CLI most of them can be accessed from the WorkBench with the
utility "64Tools."
UTILITY NAME HDW ENV FUNCTION
------------ --- --- --------
64Tools YES WB WorkBench interface to most other utils
64Cmd YES CLI Send a command to a C64 drive
64Dir YES CLI Read the dir of a C64 drive
64Print YES CLI Print an Amiga file to a C64 printer
64Status YES CLI Read a C64 drives' status
64ToAmiga YES CLI Copy a file from a C64 drive to an
Amiga drive
AmigaTo64 YES CLI Copy a file from an Amiga drive to a
C64 drive
GrabGO64ROMs NO WB Grab C64 ROMs from GO-64! V2.0
Pet2ASCII NO CLI Convert a file from PetASCII to ASCII
ASCII2Pet NO CLI Convert a file from ASCII to PetASCII
PrintFile NO WB Print Amiga file(s) to an Amiga
printer
StripLoadAddr NO CLI Strip the load address from a file
64Colors NO A64 View the C64's colors
SaveROMs NO C64 Save the C64's ROMs
5-1
CONVENTIONS FOR THE CLI BASED UTILITIES
Here are some general conventions for using the CLI based
utilities that will help make them easier to use:
For all the CLI based utilities except one, 64Status, you may
enter the utilities name alone to get it's usage (for 64Status
enter ? after its name to get its usage).
For example, if you type: 64ToAmiga [RETURN]
The utility will print a short copyright message followed by
a usage line that shows the syntax of the input that the
utility expects. A usage line appears like this:
Usage: 64ToAmiga <source filename> <destination filename>
[file type]
A utilities usage line shows what parameters are needed by the
utility and encloses these parameters with symbols:
When you see a parameter enclosed in < > this parameter is
required by the utility and must be entered for the utility
to function properly.
When you see a parameter enclosed in [ ] this parameter is
optional. If you don't enter anything for this parameter the
utility will use some default value for it.
5-2
64Tools
The 64Tools utility is actually a WorkBench interface to most of
The A64 Package's CLI based utilities. This means that 64Tools
doesn't actually perform the functions of the CLI based
utilities, it allows you to run the CLI based utilities from the
WorkBench. 64Tools allows Amiga users who are not familiar with
the CLI to access all of The A64 Packages utilities. 64Tools
also adds some features that are not available when using the CLI
utilities by themselves, like transferring multiple files from a
C64 disk to an Amiga disk.
NOTE: 64Tools was written while using V2.0 of the OS, if you are
using it with V1.3 the colors of the window will not appear
exactly as intended.
64Tools can be run from either the WorkBench or CLI. To run it
from the WorkBench double-click its icon in the A64Utilities
drawer. To run it from the CLI you should first set your
current directory to the A64Utilities drawer.
When you run run 64Tools a window will open on the WorkBench
screen. In this window will be many gadgets that allow you to
access The A64 Packages utilities and perform related operations.
Basically 64Tools' gadgets can be broken into two sections: All
the gadgets that relate to transferring files from C64 disks to
Amiga disks and all the other gadgets that relate to the rest of
The A64 Packages utilities.
DRIVE GADGET
The Drive gadget allows you to pick the current C64 drive that
you are using with 64Tools. It has four possible settings: 8, 9,
10 and 11. These settings correspond to the C64's drive numbers.
The drive gadget effects all of the utility programs that use A64's
interface except 64Print.
Note that the Drive gadget is different than all the other
gadgets because it not only effects transferring file from C64
disks to Amiga disks, but also the other utilities that use C64
drives as well.
PATTERN GADGET
The Pattern gadget is used to enter a C64 wildcard pattern when
reading the directory of a C64 disk. For example if you enter
"$:c*" and then selected the New Disk gadget (discussed below)
64Tools would read the directory of the current C64 drive and
would only list list the files that began with "c."
Anytime you change the Pattern gadget you must select the New
5-3
Disk gadget to get a new directory listing using the wildcard
pattern.
NEW DISK GADGET
The New Disk gadget allows you to read the directory of the
current C64 drive. Anytime you change the Drive gadget, Pattern
gadget or put a new disk in the C64 drive you must select the New
Disk gadget to get a new directory listing
FILE GADGETS
Covering most of the left side of the 64Tools window is an area
used to display the directory of a C64 disk. This area works
just like a standard file requester does. It displays a number
of files in the directory and allows you to scroll through the
entire directory by using the scroll and arrow gadgets just to
the right of the file area. Each file in the directory will
be displayed by showing its size (in C64 blocks), name and file
type. You select or unselect a file in the directory by clicking
on its name. Selected files will be transferred when the Start
gadget is selected (discussed below). 64Tools is unable to
transfer USR or REL files so files with these file types will be
disabled in the directory listing and you will be unable to
select them.
INCLUDE ALL GADGET
The Include All gadget allows you to select all the files in
the directory list.
EXCLUDE ALL GADGET
The Exclude All gadget allows you to unselect all the files in
the directory list.
DESTINATION GADGET
The Destination gadget allows you to enter the name of the drive
or directory that you want to transfer C64 files to. For Example
if you enter "df1:" then when you select the Start gadget all of
the selected files in the directory will be transferred to drive
df1:.
START GADGET
The Start gadget allows you to start the file transfer from a C64
drive to an Amiga drive. All the selected files will be copied
from the C64 drive to the Amiga drive you specified in the
Destination gadget.
5-4
AMIGATO64 GADGET
The AmigaTo64 gadget allows you to transfer a file from an Amiga
disk to a C64 disk. When you select this gadget a requester will
appear asking you to enter the parameters that 64Tools should
pass to the 64ToAmiga utility. See the 64ToAmiga utility section
for more information on what these parameters should be.
64STATUS GADGET
The 64Status gadget allows you to read the status of a C64 drive.
64CMD GADGET
The 64Cmd gadget allows you to send drive commands to a C64
drive. This allows you to do a variety of useful things like
formatting C64 disks and deleting files. When you select this
gadget a requester will appear asking you to enter the
parameters that 64Tools should pass to the 64Cmd utility. See
the 64Cmd utility section for more information on what these
parameters should be.
64PRINT GADGET
The 64Print gadget allows you to print an Amiga file to a C64
printer. When you select this gadget a requester will appear
asking you to enter the parameters that 64Tools should pass to
the 64Print utility. See the 64Print utility section for more
information on what these parameters should be.
STRIPLOADADDR GADGET
The StripLoadAddr gadget allows you to strip the load address
from a C64 program that has been transferred to an Amiga disk.
When you select this gadget a requester will appear asking you to
enter the parameters that 64Tools should pass to the
StripLoadAddr utility. See the StripLoadAddr utility section for
more information on what these parameters should be.
PET2ASCII GADGET
The Pet2ASCII gadget allows you to convert a C64 file, that has
been transferred to an Amiga disk, from PetASCII to ASCII. When
you select this gadget a requester will appear asking you to
enter the parameters that 64Tools should pass to the Pet2ASCII
utility. See the Pet2ASCII utility section for more information
on what these parameters should be.
5-5
ASCII2PET GADGET
The ASCII2Pet gadget allows you to convert an Amiga file from
PetASCII to ASCII. When you select this gadget a requester will
appear asking you to enter the parameters that 64Tools should
pass to the ASCII2Pet utility. See the ASCII2Pet utility section
for more information on what these parameters should be.
5-6
64Cmd
PURPOSE: Send a drive command to a C64 disk drive
USAGE: 64Cmd <command string> [drive]
<command string> is a valid C64 drive command
string.
[drive] is a C64 drive, specified as df8:, df9:,
df10: or df11:. df8: is the default.
ENVIRONMENT: CLI
INTERFACE: YES
64Cmd will allow you to send a command to a C64 disk drive. It
supports all of the standard Commodore DOS commands. Some
examples of using 64Cmd are:
FUNCTION: Format a disk
USAGE: 64Cmd N0:<disk name>,<2 digit id> [C64 drive]
EXAMPLE: 64Cmd N0:testdisk,64 df8:
FUNCTION: Delete a file
USAGE: 64Cmd S0:<filename> [C64 drive]
EXAMPLE: 64Cmd S0:testfile df8:
FUNCTION: Rename a file
USAGE: 64Cmd R0:<new name>=<old name> [C64 drive]
EXAMPLE: 64Cmd R0:testfile2=testfile1 df8:
For more information on C64 drive commands see your 1541 disk
drive user's manual.
5-7
64Dir
PURPOSE: Get a directory listing of a C64 disk
USAGE: 64Dir <pattern> [drive]
<pattern> is a valid C64 wildcard pattern string.
[drive] is a C64 drive, specified as df8:, df9:,
df10: or df11:. df8: is the default.
ENVIRONMENT: CLI
INTERFACE: YES
64Dir will allow you to get a directory of a C64 disk. Some
examples of using 64Dir are:
64Dir $ df8:
Will list the entire directory of drive 8.
64Dir $:a* df9:
Will list only the files that begin with "a" on drive 9.
5-8
64Print
PURPOSE: Print an Amiga file to C64 printer
USAGE: 64Print <filename> <device> [opt]
<filename> is the name of the Amiga file you want to
print.
<device> is a C64 printer number, either 4 or 5.
The default is 4.
[option] can be either A for ASCII or B for Binary.
The default is A. The difference between these
options is that A will convert the file from
ASCII to PetASCII before printing it and B will
not do any conversion of the file.
ENVIRONMENT: CLI
INTERFACE: YES
64Print allows you to print an Amiga file to a C64 printer. Some
examples of using 64Print are:
64Print testfile 4
Will print the Amiga file "testfile" to printer 4 and
will convert the output from ASCII to PetASCII.
64Print testfile2 5 B
Will print the Amiga file "testfile2" to printer 5 and
will not do any ASCII conversions to the output.
5-9
64Status
PURPOSE: Read a the status of a C64 disk drive
USAGE: 64Status [drive]
[drive] is a C64 drive, specified as df8:, df9:,
df10: or df11:. df8: is the default.
ENVIRONMENT: CLI
INTERFACE: YES
64Status allows you to read the status of a C64 disk drive. When
a C64 drive encounters an error it will flash its access light
off and on. You can use 64Status to find out what caused the
error. An example of 64Status is:
64Status df8:
Will read the status of drive 8.
5-10
64ToAmiga
PURPOSE: Copy a file from a C64 drive to an Amiga drive.
USAGE: 64ToAmiga <source filename> <destination filename>
[file type]
<source filename> is a C64 drive and filename.
<destination filename> is an Amiga filename.
[file type] can be either P for PRG file or S for
SEQ file. The default is P.
ENVIRONMENT: CLI
INTERFACE: YES
64ToAmiga will allow you to copy a file from a C64 disk drive
to an Amiga disk drive. Some examples of using 64ToAmiga
are:
64ToAmiga df8:testfile df0:testfile
Will copy the file "testfile" from the C64 drive 8 to
the Amiga drive 0.
64ToAmiga df9:testfile2 df0:64Prgs/testfile S
Will copy the sequential file "testfile2" from the
C64 drive 9 to the file "testfile" in the directory
64Prgs on Amiga drive 0.
5-11
AmigaTo64
PURPOSE: Copy a file from an Amiga drive to a C64 drive
USAGE: AmigaTo64 <source filename> <destination filename>
[file type]
<source filename> is an Amiga filename.
<destination filename> is a C64 drive and filename.
[file type] can be either P for PRG file or S for
SEQ file. The default is P.
ENVIRONMENT: CLI
INTERFACE: YES
AmigaTo64 will allow you to copy a file from an Amiga disk
drive to a C64 disk drive. Some examples of using AmigaTo64
are:
AmigaTo64 df0:testfile df8:testfile
Will copy the file "testfile" from the Amiga drive 0
to the C64 drive 8.
AmigaTo64 df0:64Prgs/testfile df9:testfile2 S
Will copy the file "testfile" from the directory
64Prgs on the Amiga drive 0 to the sequential file
"testfile2" on the C64 drive 9.
5-12
GrabGO64ROMs
PURPOSE: Grab the C64 ROMs from GO-64! V2.0
USAGE: GrabGO64ROMs
ENVIRONMENT: Workbench or CLI
INTERFACE: NO
NOTE: To use this utility you must have an original copy
of GO-64! V2.0.
GrabGO64ROMs will allow you to "grab" the C64 ROMs from GO-64!
V2.0. This can greatly simplify the process of installing the
C64 ROMs into A64 (See ROMs in the TECHNICAL section).
When you run GrabGO64ROMs a window will open and you will be
prompted to insert the GO-64! V2.0 disk in any drive. After
doing so GrabGO64ROMs will read the ROMs off the GO-64! disk
and then prompt you to enter the name of the directory to save
the ROMs to. If you are using the standard configuration of The
A64 Package (Disk #1 is named A64), enter "A64:TheA64Pacakge."
GrabGO64ROMs will then install the C64 ROMs on your A64 disk.
5-13
Pet2ASCII
PURPOSE: Convert an Amiga file from PetASCII to ASCII.
USAGE: Pet2ASCII <source filename> [destination filename]
<source filename> is the name of the file you want
to convert
[destination filename] is the name of the file you
want to output the converted file to. If not
specified then <source filename> will be
overwritten by the converted file.
ENVIRONMENT: CLI
INTERFACE: NO
Pet2ASCII will allow you to convert an Amiga file from PetASCII
to standard ASCII. The C64 does not use standard ASCII. "ASCII"
stands for "American Standard Code for Information Interchange"
and is a standardized method for the way that many computers
represent certain information, namely english text. This manual
was written on an Amiga which uses ASCII codes to represent each
letter and symbol. The C64 has it's own form of ASCII called
PetASCII. The Commodore 64's PetASCII is quite a bit different
from standard ASCII and for the Amiga to represent it correctly
it must be converted to standard ASCII.
Some examples of Pet2ASCII's usage are as follows:
Pet2ASCII testfile
Will covert the file "testfile" from PetASCII to ASCII.
Pet2ASCII testfile testfile.asc
Will covert the file "testfile" from PetASCII to ASCII,
leaving the file "testfile" unchanged and the converted
file in "testfile.asc."
5-14
ASCII2Pet
PURPOSE: Convert an Amiga file from ASCII to PetASCII.
USAGE: ASCII2Pet <source filename> [destination filename]
<source filename> is the name of the file you want
to convert
[destination filename] is the name of the file you
want to output the converted file to. If not
specified then <source filename> will be
overwritten by the converted file.
ENVIRONMENT: CLI
INTERFACE: NO
ASCII2Pet will allow you to convert an Amiga file from standard
ASCII to PetASCII. Some examples of Pet2ASCII's usage are as
follows:
ASCII2Pet testfile
Will covert the file "testfile" from ASCII to PetASCII.
ASCII2Pet testfile testfile.pet
Will covert the file "testfile" from ASCII to PetASCII,
leaving the file "testfile" unchanged and the converted
file in "testfile.pet."
5-15
PrintFile
PURPOSE: Print one or more Amiga files to an Amiga printer.
USAGE: PrintFile [filename1] [filename2] [filename3] ...
ENVIRONMENT: WorkBench or CLI
INTERFACE: NO
PrintFile will allow you to print one or more files to an Amiga
printer. It can be used from either the CLI or the WorkBench.
To use it from the WorkBench double-click its icon and then enter
the name of the file you wish to print. After entering the
filename press the RETURN key to print the file. You can also
pass PrintFile one or more filenames by selecting the document
icons that represent the files that you want to print and holding
down one of the SHIFT keys while double-clicking the PrintFile
icon. For example if you want to print the files "ReadMe1st" and
"Registration.form."
1. Press one of the shift keys on the Amiga keyboard.
2. Select the ReadMe1st icon by clicking the left mouse
button on it once.
3. Select the Registration.form icon by clicking the left
mouse button on it once.
4. Double-click the PrintFile icon while still holding down
the shift key.
PrintFile will then be started and automatically start printing
the files. Using this method it is possible to print all of The
A64 Packages documentation at once, but be warned, The A64
Package's entire manual is around 120 pages in length and will
take some time to print.
To run PrintFile from the CLI enter the following:
PrintFile [filename1] [filename2] [filename3]
PrintFile will then be started and automatically start printing
the file(s) you specified.
When PrintFile is done printing a file it does not close itself.
This allows you to print multiple files without restarting it.
To quit PrintFile select the close gadget at the top left hand
corner of its window.
5-16
StripLoadAddr
PURPOSE: Strip the load address from a C64 program that has
been transferred to an Amiga disk.
USAGE: StripLoadAddr <filename>
<filename> is the name of the file you want to strip
the load address from.
ENVIRONMENT: CLI
INTERFACE: NO
StripLoadAddr will allow you to strip the load address from a C64
program that has been transferred to an Amiga disk. The C64 adds
a two byte load address to the start of its PRG files that tells
it where to load the file. When transferring these files to the
Amiga you may wish to strip this load address. NOTE: If you plan
on loading a transferred PRG file into A64 from an Amiga disk, you
should NOT strip the load address from the file. If you do, A64
will not know where to load the file. StripLoadAddr should only
be used when installing the C64 ROMs (See installing the C64 ROMs
in the TECHNICAL section) or if you specifically want to strip
the load address for some reason of you own, another words if you
are only transferring programs so they can be used in A64 you do
NOT need to use this command on the transferred files.
An example of using StripLoadAddr is:
StripLoadAddr BASIC.rom
Will strip the load address from the file "BASIC.rom"
5-17
C64 PROGRAMS
The A64 Package comes with a couple of Commodore 64 programs,
located in the directory 64Prgs. These programs are as follows:
SaveROMs
SaveROMs is for saving the C64 ROMs to disk. It is meant to be
run on a C64 because A64 does not contain the C64's ROMs. To use
this program see INSTALLING THE C64's ROMs in the TECHNICAL
section.
64Colors
64Colors is a simple BASIC program that allows you to view the
C64 colors. It was included with The A64 Package so you could
experiment with A64's COLOR MODES while using it (See COLORS in
the A64Prefs section).
For information on how to load and run this program see DRIVES in
the SYSTEM MENU section.
5-18