* Copyright 1987 by 4th Works, Inc. *
* written by Steve Ahlstrom and Dan Moore *
* Support for this program to be found on CompuServe's AmigaForum *
-----------------------------------------------------------------------------
This program is not public domain. It is a freely distributable
copyrighted program with the following conditions:
1) The program and data files must be distributed in the exact
form and content as they were found on the original source of
distribution (AmigaForum on CompuServe).
2) A seperate file, meant to be incorporated into the manual file,
may be included in the distribution ARC file.
3) Any form of commercial sales of this program is specifically
denied with the exception of those user groups or entities
selling "Public Domain Program Disks". If this program is
included in such a collection, the disk containing this
program may not sell for more than $8.00 (US currency).
------------------------------------------------------------------------------
#arc
Arc ---- Archive utility, Version 0.23
Syntax:
ARC {amufdxerplvtc}[bswn][g<password>] <archive> [<filename> . . .]
Switches:
a = add files to archive
m = move files to archive
u = update files in archive
f = freshen files in archive
d = delete files from archive
x,e = extract files from archive
p = copy files from archive to standard output
l = list files in archive
v = verbose listing of files in archive
t = test archive integrity
c = convert entry to new packing method
b = retain backup copy of archive
s = suppress compression (store only)
w = suppress warning messages
n = suppress notes and comments
g = Encrypt/decrypt archive entry
#Help
Help -- An online help facility
Syntax:
Help command_name
Inputs:
command_name Name of the command or function for which you are
seeking help. Example: HELP ARC.
Since AmigaDOS is case insensitive, Help is also
case insensitive.
Copyright 1987 by 4th Works, Inc.
This program is not public domain. It is a freely distributable
program with the following conditions:
1) The program and data files must be distributed in the exact
form and content as they were found on the original source of
distribution (AmigaForum on CompuServe).
2) A seperate file, meant to be incorporated into the manual file,
may be included in the distribution ARC file.
Support for this program to be found exclusively on AmigaForum on CompuServe
#Assign
Assign - assign a logical device name to a filing system directory.
Syntax:
ASSIGN [[<name>]<dir>] [LIST]
Specification:
ASSIGN with no parameter s or with the LIST switch ("ASSIGN LIST")
displays all current assignments. To remove the assignment, just give
<name> by itself.
Example:
ASSIGN sources: ram:work/game --
a "CD sources:" will put you in the ram:work/game directory.
ASSIGN sources: --
this will remove the assignment of "sources:" to "ram:work/game"
#Break
Break - set the break flag
Syntax:
BREAK <task> [ALL] [C] [D] [E] [F]
Specification:
BREAK sets the specified attention flags in the process. C sets the
CTRL-C flag, D sets the CTRL-D flag, etc. AmigaDOS only sets the
CRTL-C flag. If the program is not written to look for these attention
flags, the process will continue to run until normal termination.
Example:
BREAK 7 sets the CTRL-C attention flag of process 7.
BREAK 5 D sets the CTRL-D attention flag of process 5.
BREAK 3 D E sets both CTRL-D and CTRL-E in process 3.
BREAK 4 ALL sets all frags in process 4.
#CD
CD - changes the current default directory or drive.
Syntax:
CD [<dir>]
Specification:
CD with no parameters displays the name of the current directory.
"CD TEST" will change the current directory to TEST if test exists as a
subdirectory in the current directory.
If you are in a subdirectory, "CD /" will move you up one level, "CD //"
will move you up 2 levels, etc.
"CD :" will move you to the root directory of the logged drive.
"CD dfn:" sets the current drive to dfn: and the current directory to
the root directory of dfn:
Example:
"CD df1:work" sets the current directory to 'work' on disk 'df1:' and
sets current drive to df1:.
#Copy
Copy - copy a file or directory from one place to another
Syntax:
COPY [[FROM] <name>] [TO] <name>] [ALL] [QUIET]
Specification:
Copy places a copy of the file or directory specified as TO.
If you specify a directory name as FROM, COPY copies all the files in
the FROM directory to the TO directory. The TO directory must exist.
If you specify ALL, COPY also copies the files in any subdirectories.
It automatically creates subdirectories in the TO directory as needed.
Example:
COPY FROM file1 TO :work/file2 COPY file1 TO :work/file2
COPY file1 :work/file2 COPY :wrk :work ALL
#Addbuffers
ADDBUFFERS - adds cache buffers to disk to reduce access time
Syntax:
ADDBUFFERS <drive> <##>
Specification:
DOS 1.2 uses disk sector caching in memory to speed up disk accesses.
This command allows the user to significantly increase the access
times. The amount of available RAM will be decreased by approximately
500 bytes for each buffer added.
NOTE: Adding more than 25-30 buffers will not enhance speed greatly.
Example:
ADDBUFFERS DF0: 12 --
This will add 12 disk cache buffers drive DF0:
#Date
DATE -- display or set the system date.
Syntax:
DATE [<date>] [<time>] [TO|VER <name>]
Specification:
DATE with no parameters displays the currently set system date and time.
Time is displayed using a 24-hour clock. The earliest date which can be
set is 01-JAN-78.
<date> is of the form DD-MMM-YY, with MMM being the first three
letters of the month.
<time> is of the form HH:MM (i.e. HOURS:MINUTES). Use leading zeros.
Example:
DATE -- displays the current date and time.
DATE 16:30 14-Feb-87 -- set date to Wednesday, Feb. 14, 1987 at 4:30 PM.
DATE 16:30 -- set time only to 4:30 PM.
DATE 14-Feb-87 -- set date only to Feb. 14, 1987
#Delete
DELETE - deletes specified files or directories.
Syntax:
DELETE <name> [<name> ...] [ALL] [QUIET]
Specification:
<name> Any file or directory name. Patterns may also be used to
specify the filename or directory levels, and/or files.
ALL If ALL is specified with a directory name, DELETE will
delete all files in that directory and it's subdirectories.
Otherwise, a directory must be empty to be deleted.
QUIET Do not display names of files being deleted.
Example:
DELETE work/file1 work/file2 work --
deletes "file1" and "file2" from the directory "work" and then
deletes the directory "work".
DELETE DF1:#?.txt ALL -- deletes all files on DF1: ending in ".txt".
#Dir
DIR - display a sorted directory listing.
Syntax:
DIR [<name>] [OPT A | I | A I | D | K]
Specification:
Provides a list of the files in a directory in sorted order.
<name> Must be a directory name. If omitted, the files in the current
directory will be displayed.
OPT is a keyword that passes options to DIR.
A - option is used to include any subdirectories below the
specified one in the list. Each sublist of files is indented.
D - when this option is used, only directory names will be listed.
Example:
DIR -- lists the files in the default directory.
DIR DF1: OPT A --
lists all directories, subdirectories, and files on "DF1:"
DIR RAM: OPT D -- lists all directory names on "RAM:".
#Echo
ECHO - displays the text string given.
Syntax:
ECHO <string>
Specification:
Echo writes the single string argument to the current output stream,
which can be a file or a device. Normally this is only useful within
a command sequence or as part of a RUN command. If the string is given
incorrectly, an error is displayed. The string must be enclosed in
quotes ("").
Example:
ECHO "" -- this will display a blank line to the screen.
ECHO "Please insert the test disk in the internal drive..." --
is a typical prompt for user action from within a command sequence.
#BindDrivers
BINDDRIVERS - allows user to bind device drivers for new hardware to DOS
Syntax:
BINDDRIVERS
Specification:
(usually used as a batch command in the "s/startup-sequence" boot file)
This command is used to connect new hardware to AmigaDOS. The way this
is done is to bind the device driver software provided with the hardware
into Workbench. Then when the user selects the device's icon, DOS will
use the driver to access the device. BINDDRIVERS will cause DOS to bind
in ANY new drivers that it finds in the directory "SYS:Expansion".
Example:
Copy the device driver to the "SYS:Expansion" directory.
Add the BINDDRIVERS command to the file "s/startup-sequence", which
will be automatically executed whenever you boot DOS.
#Diskcopy
DISKCOPY - copies the contents of one 3.5" diskette to another.
Syntax:
DISKCOPY [FROM] <disk> TO <disk> [NAME <disk>]
Specification:
DISKCOPY copies the entire contents of the disk you specified as FROM,
overwriting the previous contents of the entire disk specified as TO.
If you specify NAME, the new disk is renamed. If needed, the TO disk
will be formatted as it is copied. If the TO disk contains data before
the DISKCOPY, it will be lost. Once the command is entered, you are
prompted to insert the source and destination disks. If you do not
specify a <NAME> for the destination disk, the new disk will have the
same name.
Example:
DISKCOPY DF0: TO DF0: NAME "Data" --
copies the disk in drive DF0: using only one drive with new name
"Data".
#DiskChange
DISKCHANGE - indicates that the disk in a 5-1/4" drive has been changed
Syntax:
DISKCHANGE <drive>
Specification:
Unlike the Amiga's 3-1/2" drives, which keep checking to see if a disk
has been changed in the drive, the Amiga 5-1/4" drive just sits there.
It doesn' t let DOS know whether you've swapped disks or not. This
command should be used whenever you change the disk in the drive.
Example:
DISKCHANGE DF3: --
tells DOS that you just swapped the disk in drive DF3: for another
one.
#Ed
ED - a full-screen ASCII text editor (mouse not supported).
Syntax:
ED [FROM] <name> [SIZE <n>]
Specification:
A very simple full-screen editor used to create/modify ASCII text files.
<name> Specifies the file you wish to edit. If the FROM filename does
not exist, AmigaDOS creates a new file. The keyword FROM is
optional.
SIZE The complete file you are editing is held in memory. The default
workspace size i s 40,000 bytes. To alter the workspace, a
suitable value (in bytes) is specified after the SIZE keyword.
Examples:
ED df1:practice/test --
edits the file "DF1:practice/test".
ED "My File" SIZE 60000 --
edits a large file named "My File" in the current directory,
using a memory workspace of 60,000 bytes (or characters).
#Edit
EDIT - a line-oriented ASCII text editor.
Syntax:
EDIT [FROM] <name> [TO <name>] [WITH <name>] [VER <name>] [OPT <option>]
Specification:
A line-at-a-time editor used to modify ASCII text files.
FROM Specifies an existing file you wish to edit.
TO TO is the output filename, if different from the input FROM
filename. If a TO filename is given, the FROM file is not changed.
WITH specifies a file containing EDIT commands to be used in this EDIT
session. If WITH is omitted, EDIT will read commands from the
the terminal.
VER editor messages are output to the file specified. If the
VER name is omitted, the output is sent to the terminal.
OPT specifies editor options. P# sets the max # of previous lines
(default=40). W# sets the max line width (default=120).
Example:
EDIT Practice/Test TO Practice/Newtest --
edits the file "Practice/Test" the edited result being saved to
"Practice/Newtest". "Practice/Test" remains unchanged.
#ChangeTaskPri
ChangeTaskPri - changes the time-slice priority of the current CLI
Syntax:
ChangeTaskPri <##>
Specification:
This command changes the CPU time allocation priority with which DOS
treats the current CLI window task. Normal task priority is 0. Priority
should be changed to a positive number to increase it and to a negative
number to decrease it. The maximum priority values are +127 to -127,
but you should keep user tasks between +5 and -5 to avoid interfering
with DOS tasks; e.g. Intuition runs at priority 10.
Tasks which are run from the changed CLI will also operate at the higher,
or lower, priority.
Example:
ChangeTaskPri 2 --
this will give the CLI task where the command is given, as well
as all successive programs running under it, a slightly higher
priority than regular tasks. This means that DOS will allocate
more CPU time to tasks running under this CLI than others.
#DiskDoctor
DISKDOCTOR - fixes corrupted disks with soft errors (not defects!)
Syntax:
DISKDOCTOR <drive>
Specification:
Whenever a diskette is inserted in a 3-1/2" drive, DOS attempts to
verify whether the disk is valid. If DOS fails to validate the disk,
it will let you know. So that you don't lose all your information on
the disk, you should try to restore the disk using this command. If
DISKDOCTOR fails, the error is likely a physical defect!
Example:
DISKDOCTOR DF1: --
This will temporarily restore MOST of the file structure on
DF1:. Your next step will be to format a blank disk and copy
all the files from the old disk to the new one using the COPY
command. You should reformat the old, restored disk after
COPYing off your files.
#EndCLI
ENDCLI - ends an interactive CLI process.
Syntax:
ENDCLI
Specification:
ENDCLI can only be used within a n active CLI window. It closes the
CLI window and deletes the process from the list of currently executing
tasks. If the CLI was started from Workbench (using the CLI icon), you
will be returned to the Workbench. If you used NEWCLI to open the
current CLI from a previous one, then you will be returned to that
previous CLI. Note that if you do not have Workbench loaded, then
ending the startup CLI with no other CLI open gives you no way doing
anything else other than rebooting using CTRL-AMIGA-AMIGA.
#Run
RUN - executes a command as a background process.
Syntax:
RUN <command>
Specification:
RUN creates a non-interactive Command Line Interface (CLI) process.
The background CLI executes the commands then deletes itself. The
new CLI has the same command stack size as the CLI from which you
executed RUN.
The background CLI commands will be executed simultaneously with
commands given in the foreground CLI window.
A plus sign <+>, followed by a <RETURN>, i s used to separate
multiple commands. However, a better method would be to create a
command sequence file (see the EXECUTE command), then RUN EXECUTE
the sequence.
Examples:
RUN "Sample" --
will execute the user application program "Sample" as a
background task.
#SetMap
SETMAP - changes the keyboard definition map being used
Syntax:
SETMAP <file>
Specification:
This command let's the user choose a different keyboard setup.
Example:
SETMAP :devs/keymaps/gb --
sets the keyboard to the keymap for Great Britain.
SETMAP usa --
resets to the default USA keymap (resident in DOS, not on disk).
#Relabel
RELABEL - changes the volume name of a diskette.
Syntax:
RELABEL [DRIVE] <drive> [NAME] <name>
Specification:
RELABEL changes the volume name of a disk to the name you specify.
Volume names are set when you initialize a disk using Workbench or
FORMAT, and may also be changed with Rename [Workbench menu]. The
max length is 30.
Example:
RELABEL df1: "Data Disk Backup" --
gives the name "Data Disk Backup" to the disk currently in drive
"DF1:"
#Version
VERSION - shows the current version numbers for KickStart and for WorkBench
Syntax:
VERSION
Specification:
VERSION will display the current version numbers for the KickStart and
WorkBench code loaded. For example, KickStart 1.0 has a version number
of 29, while the version number for KickStart 1.1 is 31 and if you are
using DOS 1.2, the version number for KickStart 1.2 is 33.
#Why
WHY - explains why the previous command failed (if it did).
Syntax:
WHY
Specification:
When a command fails, a brief message that something went wrong is
usually displayed on the screen, or else the screen is flashed by
AmigaDOS. If you enter WHY immediately after the failure, a message
describing in somewhat more detail what sent wrong will be displayed.
Example:
you've entered: TYPE DF1:
Amiga responds: cannot open DF1:
you enter: WHY
Amiga responds: Last command failed because object not of
required type.
#Join
JOIN - concatenates up to 15 files to form a new file.
Syntax:
JOIN <name> <name> [<name>...] AS <name>
Specification:
Each of the specified files is appended to the last in the order
listed on the command line and output into the AS file.
Example:
JOIN part1 part2 part3 part4 AS book --
joins the four files together in the order listed, with the
combined file being placed in "book". The four original files
remain unchanged.
#Fault
FAULT - display a message about the fault codes supplied.
Syntax:
FAULT [<n>...]
Specification:
AmigaDOS looks up the fault codes and displays the corresponding
messages. Up to ten messages may be displayed. Codes must be
separated by spaces.
Example:
FAULT 103 221 218 --
displays the messages for fault conditions 103, 221, and 218.
#Format
FORMAT - formats and initializes a new 3.5 inch disk.
Syntax:
FORMAT DRIVE <drivename> NAME <diskname> [NOICONS]
Specification:
FORMAT prepares a disk for use by AmigaDOS.
DOS 1.2 Addition: NOICONS will prevent a Trashcan icon from being added.
DRIVE Under DOS 1.2, any existing drive or partition is valid.
NAME can be any string; if it includes spaces, the whole string must
be enclosed in quotes <"">.
Example:
FORMAT DRIVE df1: NAME "1986 Taxes" --
formats and initializes the disk in drive DF0: with the name
"1986 Taxes".
FORMAT DRIVE df2: NAME Data001 NOICONS --
formats the 5-1/4" floppy disk drive DF2: with name "Data001"
with no Trashcan icon.
#Alink
ALINK - Links together sections of code into an executable file.
Syntax:
ALINK [FROM|ROOT] <filename> [{, <filename> ...} | {+ <filename> ...}]
[TO <name>] [WITH <name>] [LIBRARY|LIB <name>] [MAP <map>]
[XREF <name>] [WIDTH <n>]
Specification:
Links sections of compiled or assembled AmigaDOS object code together
into executable program files. Handles automatic library references
and builds overlay files. The output from ALINK is a file in the proper
form to be loaded by the loader and, if necessary, run under the overlay
supervisor.
Example:
ALINK FROM libs/Lstartup.o+myobj TO myprog LIB libs/mylib --
links the files "libs/Lstartup" and "myobj", and produces the output
file "myprog". External references will be searched for in "libs/mylib".
ALINK myprog.o TO myprog WITH link-parms --
creates the executable program "myprog" from the object file "myprog.o",
using additional parameters supplied by the file "link-parms".
#Assem
ASSEM - Assemble a program written in MC68000 assembly language.
Syntax:
ASSEM [PROG|FROM] <source filename> [-O|TO <object filename>]
[-V <message file>] [-L <list file>] [-H <header file>]
[-I <include list>] [-C|OPT <option>] [-E]
Specification:
To use this command, you first must purchase the MC68000 assembler.
The MC68000 assembler is not provided with the Workbench disk.
This command produces a linkable object file from a text source
code file written in MC68000 assembly language.
For information on parameters and flags, see ASSEM_FLAGS.
Example:
ASSEM myprog TO myobj -L mylist -V mybugs -H myhdr -I includes/myincl1.i+
includes/myincl2.i+intuition/myincl3.i+dos/myincl4.i OPT -S -D -X --
will assemble "myprog", including header code in "myhdr", into object
file "myobj", with listing in "mylist" including a cross-referenced
global symbol table, and with error messages in "mybugs".
#ASSEM_FLAGS
ASSEM_FLAGS - description of flags and parameters used by ASSEM.
Parameters which may be set are:
-O or TO <object file> the assembler will not produce any binary object
code unless this parameter is provided.
-L <list file> produces a list file containing both source and
the corresponding object code.
-V <message file> save warnings and error messages to a file
-H <header file> use to include a source code header file
-I <include list> a list of paths to files listed as INCLUDE files
within the source file.
-E <equates file> generates a header file containing the EQU
directive assignments in the source file
-C <options> one or more option "switches" may be specified
or OPT <options> to the assembler, as follows:
-S produce a complete list of symbols during assembly.
-D restrict the -S switch output to Global symbols only.
-C ignores the case of labels
-W <width> sets the size of the assembler workspace.
-X produces a cross-referenced symbol table listing.
#Execute
EXECUTE - executes a file of commands (similar to batch files).
Syntax:
EXECUTE <sequence> [<argument>...]
Specification:
EXECUTE allows you to perform a complex , pre-programmed sequence of
AmigaDOS commands. (For those already familiar with MS-DOS or PC-DOS,
it is the same as a .BAT batch file.) A command sequence is a list of
DOS commands which will be executed sequentially. There are several
AmigaDOS commands which are intended specifically for use in such
sequences.
Many commands will require parameters (arguments, switches, etc.) that
are unknown ahead of time. EXECUTE allows you to include variable
parameters which are filled in when the sequence is executed.
Many AmigaDOS commands are specific to EXECUTE command files, they
include: IF ELSE ENDIF FAILAT QUIT SKIP LAB WAIT ECHO
Example:
EXECUTE install -- executes a script program named "install".
#Syntax:
FAILAT <n>
Specification:
When a command fails, a non-zero return code is set. A return code
greater than or equal to the fail limit terminates a sequence of non-
interactive commands. The return code indicates how serious the error was
and is usually: 5 (warning), 10 (error), or 20 (fatal).
The FAILAT command is used to alter the default value fail level of 10.
The argument should be a positive integer. Upon exit from the command
sequence, the fail level is reset to the default value of 10.
If the return code value is increased, it indicates that certain classes
of error should not be regarded as fatal and that execution of subsequent
commands may proceed after an error.
The FAILAT command should be used BEFORE the commands that will be tested
for failure. If you use FAILAT without an argument, the current value of
the current fail limit will be displayed.
#FileNote
FILENOTE - attaches a comment or a note to a file.
Syntax:
FILENOTE [FILE] <file> [COMMENT] <string>
Specification:
COMMENT adds an optional comment of up to 80 characters. If the comment
contains embedded spaces, it must be enclosed in quotes <"">.
When a new file is created, it does not have a comment. If you overwrite
an existing file that has a comment, the comment is retained,
If a file with a comment is copied with the command COPY, the new file
will not have the comment from the original.
Example:
FILENOTE program1 "Version 2.1 July 4, 1987" --
attaches the comment "Version 2.1 July 4, 1987" to the file
"program1". If the LIST command "LIST program1" is used, the
result will be a two-line listing of the file as follows:
program1 1341 rwed Today 12:36:51
:Version 2.1 July 4, 1987
#If
IF - allows conditionals within a command sequence.
Syntax:
IF [NOT] [WARN | ERROR | FAIL | {<string> EQ <string>} | {EXISTS <name>}]
Specification:
NOT processing should occur only if the test following fails.
The command MUST be followed by one of the following tests:
WARN TRUE if the immediately prior command returned a code >= 5.
ERROR TRUE if the immediately prior command returned a code >= 10.
FAIL TRUE if the immediately prior command returned a code >= 20.
<string> EQ <string> ... tests the exact equality of two strings. <string>
EXISTS <name> .......... TRUE if the file <name> exists in the specified
directory (may be part of <name>).
ERROR is meaningful only if you set FAILAT to greater than the default 10.
FAIL is only meaningful if FAILAT is set to greater than 20.
Nested IF's are terminated by the nearest enclosing ENDIF in the sequence.
The optional ELSE may provide an alternative if the specified conditions
are not met. The conditions and commands in IF and ELSE statements can
span several command lines before their corresponding ENDIFs. Indentation
is permitted.
#Info
INFO - displays a report on mounted disk devices.
Syntax:
INFO
Specification:
Information about each mounted disk device is given as follows:
Unit.... the disk device name
Size.... total space on the disk (in Kbytes, typically 880K)
USED.... disk space allocated to files & subdir's (in 512-byte Blocks)
Free.... available free space on the disk (in Blocks)
Full.... the % space now used (i.e. USED/Size)
Errs.... number of soft disk errors detected
Status.. Read/Write or Read Only
Name.... the disk volume name
#Install
INSTALL - makes a formatted disk bootable.
Syntax:
INSTALL [DRIVE] <drive>
Specification:
<drive> the drive containing the formatted diskette to be installed.
An INSTALLed disk can be inserted at the Workbench prompt (after
KICKSTARTing the Amiga) to "boot" the system. The only possible drive
names are DF0:, DF1:, DF2:, and DF3:.
No files are copied to the disk during installation. If you want to be
able to execute AmigaDOS commands after booting, you must copy the "c"
subdirectory from your Workbench disk onto the disk you have INSTALLED.
You will probably also need the other workbench directories as well.
Example:
INSTALL DF1: --
makes the disk in drive "df1:" a bootable disk. To add all the
Workbench files to the disk, you would use the COPY command.
#List
LIST - list specified information about a directory or file.
Syntax:
LIST [DIR] <dir> [P|PAT=<pattern>] [KEYS] [DATES] [NODATES]
[TO <name>] [S <string>] [SINCE <date>] [UPTO <date>] [QUICK]
Specification:
LIST with no options will display:
filename size protection date time
:comment
There are three options for the <dir> argument to the DIR keyword:
(1) if a filename is specified, information for that file will be displayed;
(2) if a directory name is given, the file information for all files and
subdirectories within that directory will be displayed;
(3) if the <dir> argument is omitted, information about files and
subdirectories within the current directory will displayed.
Other LIST options available:
P <pattern> searches for files whose name matches the specified pattern.
KEYS displays the block number of each file header or directory.
SINCE <date> displays only the files last update ON OR AFTER <date>.
UPTO <date> displays only files last updated ON OR BEFORE <date>.
#MakeDir
MAKEDIR - creates a new subdirectory.
Syntax:
MAKEDIR <dir>
Specification:
MAKEDIR creates a directory with the name you specify. Only one directory
can be created at a time, so if you wish to create a subdirectory within a
directory, that parent directory must exist or be created first.
The directory will not be created if a directory or file with the same
name already exists in the directory above it in the heirarchy. You can,
however, have two with the same name within two different directories.
Example:
MAKEDIR :map --
creates a directory named "map" in the default root directory.
MAKEDIR DF1:sheets --
creates a directory "sheets" in on drive DF1:.
MAKEDIR "DF1:budget/work sheets" --
creates a subdirectory "work sheets" the parent directory "budget"
on drive DF1:. The directory "budget" must already exist.
#Mount
MOUNT - install a new hardware device name into DOS (not WorkBench)
Syntax:
MOUNT <devicename>
Specification:
This command installs a new hardware device into DOS's device tables.
In most cases, the hardware will be supplied with a mounting disk
containing a "mountlist" file which must be added to the file
"SYS:devs/Mountlist". The default Mountlist file on your DOS disk
contains an example device specification for a 5.25" disk drive and
for a serial device (the handler is NOT supplied for the example).
You will probably include MOUNT commands in your "s/startup-sequence"
boot file. This will install the devices at power-up.
Example:
(1) Copy the device handler to the "l:" directory.
(2) Add the device's mountlist to the "SYS:devs/Mountlist" file.
(3) Add the command "MOUNT <device-name>" to the file "s/startup-sequence".
#Prompt
PROMPT - changes the prompt in the current CLI.
Syntax:
PROMPT [<prompt>]
Specification:
The prompt is set to the string you supply. The special character
combination <%N> in the prompt string is displayed as the CLI's process
number. If a parameter is not given, the prompt is reset to the standard
string "%N> ". Note the space included after the > symbol!
Example:
PROMPT -- resets the current prompt to "%N> ".
PROMPT "Current Process is #%N. Command? " --
resets the CLI prompt to "Current Process is #n. Command? " where
n is the current process number. If the CLI's process were #4, the
resulting prompt would appear as:
Current Process is #4. Command? _
The underscore character above is positioned where the cursor would be.
#Read
READ - download development files over serial or parallel port.
Syntax:
READ [TO] <name> [SERIAL]
Specification:
This command allows the user to download specially formatted files over
the serial or parallel port. If SERIAL is specified, then data is read
at the current Preferences data speed. Otherwise data is read from the
parallel port.
The file to be downloaded must be converted into the format of a
two-digit hex code for each byte in the file BEFORE it is read.
Use the CONVERT command supplied with your cross-development system.
Example:
On the IBM-PC: CONVERT <PROGRAM >PROGRAM.OUT
then transfer it to the Amiga at 9600 bps.
On the Amiga, you enter:
READ DF1:PROGRAM SERIAL, then start output from the IBM-PC.
#Rename
RENAME - changes the name of a file or directory.
Syntax:
RENAME [FROM] <name> [TO|AS] <name>
Specification:
RENAME changes the name of the FROM file or directory to the specified
TO name. If you already have a file with exactly the same name as the
TO file, RENAME won't work.
RENAME can also be used to MOVE a file into another directory.
RENAME cannot be used to change the case of the letters in a file name;
(i.e. "RENAME jones TO Jones" will not work).
Example:
RENAME Demo1 Demonstration --
changes the name of the file "Demo1" to "Demonstration".
The contents of the file remain the same.
#Quit
QUIT - exit from a command sequence with a given error code.
Syntax:
QUIT [<returncode>]
Specification:
QUIT exits the current command sequence with a error return code.
The default return code is zero.
Example:
IF WARN
QUIT 20
ENDIF
If the last command was in error (code >=5), this terminates the
command sequence with return code 20.
#Protect
PROTECT - sets a file's protection status.
Syntax:
PROTECT [FILE] <filename> [[FLAGS] <status>]
Specification:
The keyword FLAGS has four options: <rwed>, where...
r = read e = execute
w = write d = delete
If a flag is set, that option is NOT protected. If it is omitted, then
protection is set. The keyword FLAGS itself is optional; omitting it does
not change the effect of the command. To check the current protection
status of a file, use the LIST command.
Example:
PROTECT report1 r
sets the protection status of "report1" as read only.
PROTECT report2
resets all the protection flags of the file "report2" to unprotected.
#Skip
SKIP - perform a jump in a command sequence.
Syntax:
SKIP <label>
Specification:
SKIP is used in conjunction with LAB. SKIP will read through the command
file looking for a label you defined with LAB, without executing any
commands. SKIP will only jump forward in the command sequence.
SKIP can be used with or without a label. Without one, it finds the next
unnamed LAB command. With one, it will look for a LAB defining the
specified label. LAB must be the first item on a line of the file. If
SKIP does not find the label you specified, the sequence terminates and
the following message is displayed: "label "<label>" not found by Skip."
Example:
SKIP
used alone jumps to the next LAB command that does not have
a name following it.
#NewCLI
NEWCLI - opens a new interactive CLI process and creates a console
window for input and output.
Syntax:
NEWCLI [<window>] [FROM <startup-file>]
Specification:
A new CLI window is created, which becomes the currently selected process.
Each CLI window is independent, allowing separate & nearly simultaneous
input, output, and program execution.
Example:
NEWCLI -- creates a new CLI process in a window of default size &
location.
NEWCLI "CON:20/30/300/100/Tom's Custom CLI" --
The quotes <""> around the window argument allows the title to
contain spaces.
NEWCLI FROM ExecFile [ DOS 1.2 ONLY! ] --
this will open a default CLI window, and will begin EXECUTEing
"ExecFile".
#SetDate
SETDATE - updates the date and time assigned to a file or directory
Syntax:
SETDATE <file> <date> [<time>]
Specification:
This command let's the user set the date and time of a file.
<file> the filename to receive a date change.
<date> a date specified in the standard Amiga format: ##-LLL-##,
where:
the first two digits are the month; (1-9) must be 01-09;
the second three letters are the month code;
the last two digits are the year;
<time> this is the time in 24-hour format: ##:##, representing
hours and minutes.
Example:
SETDATE TempFile 01-Jan-88 13:07 --
this sets the date and time on file "TempFile" in the current
directory.
#Path
PATH - specifies which directories to search in for CLI commands
Syntax:
PATH [SHOW] | [ADD <dir>,<dir>,...] | [RESET <dir>,...]
Specification:
When a DOS command is given in the CLI, the current directory is searched
for the command. If the command isn't found, the next directory in the
path will be searched. Ultimately, the "c:" directory is searched.
<dir> this is a directory name, including drive or disk name if needed.
SHOW this option will display the current path.
ADD this mutually exclusive option lets you add the specified directory
or directories to the current path.
RESET this option, also mutually exclusive, lets you remove the specified
directories from the current path. If no directory is supplied, the
path is reset to the default DOS path: Current Directory, C:
Example:
PATH ADD DataFiles,Utilities --
adds the directories "DataFiles" and "Utilities" to the current command
search path.
#Search
SEARCH - looks for a text string in all the files in a directory.
Syntax:
SEARCH [FROM] <name>|<pattern> [SEARCH] <string> [ALL]
Specification:
<name> a filename, including directories;
<pattern> a generalized form of filename specification
SEARCH looks through the FROM file (or, if only a directory is specified,
all files in that directory) for occurences of the SEARCH string. If ALL
is added, then all the subdirectories contained in the specified directory
are searched. When the SEARCH string is found, the line where it occurred
is displayed. As each file is being searched, its name is displayed to the
screen. The search is non-case sensitive.
Example:
SEARCH SEARCH "Test #86" --
searches the default directory for file containing the string
"Test #86".
#Sort
SORT - alphabetically sorts a specified file.
Syntax:
SORT [FROM] <name> [TO] <name> [COLSTART <n>]
Specification:
WARNING: If the file is longer than about 150 records (lines) , you
should increase Stack size. Estimate an additional 1000 bytes of Stack
for each additional 50 records (lines) in the file.
Does a simple, ascending-order, alphabetic sort of the FROM file into
the TO file, without distinguishing between upper and lower cases.
Each record in the file to be sorted must end with a carriage return.
COLSTART this keyword can be used to specify the first column where the
comparison will take place.
Example:
SORT Pre-Registered TO "Class Roster" COLSTART 16 --
"Pre-Registered" is a list of students with first names in columns
1-15 and last names beginning in column 16. In this example, the names
would be sorted in order of last names, with each group of identical
last names being subsorted by the first name.
#Stack
STACK - sets the stack size for commands.
Syntax:
STACK [<size>]
Specification:
When a program is run, it uses a certain amount of stack space. The
normal stack size is 4000 bytes, which is sufficient in most cases.
When using some programs, you may need to increase the stack size to
prevent a crash. To do this, type STACK followed by the new stack
size in bytes. A value from 8000 to 10000 is usually adequate.
STACK alone displays the currently set stack size.
WARNING: The only indication that you have run out of stack is that
the Amiga crashes. It is better to overestimate if you are not sure.
Example:
STACK -- displays the current stack size.
STACK 16000 --
sets the stack size to 16000 bytes.
#Status
STATUS - displays information about existing CLI processes.
Syntax:
STATUS [<process>] [FULL] [TCB] [SEGS] [CLI|ALL]
Specification:
STATUS without any parameters lists the numbers of the CLI processes
and the program tasks running in each.
<process> specifies a process number and only gives information about
that process. Otherwise, information is displayed about all
processes.
FULL = SEGS + TCB + CLI flags
SEGS displays the names of the sections on the segment list of each
process.
TCB displays information about the priority, stacksize, and global
vector size of each process.
CLI or ALL identifies Command Line Interface processes and displays the
section name(s) of the currently loaded command.
Example:
STATUS 4 FULL --
displays full information about task #4 in the current CLI window.
#Type
TYPE - type a text file, or type a file out as hexadecimal numbers.
Syntax:
TYPE [FROM] <name> [[TO] <name>] [OPT N|H]
Specification:
TO <name> with this optional keyword, you can send the output of the
TYPE command to a specified file. If an output file is
not specified the output is usually sent to current window.
OPT this keyword lets you specify one of two available options:
N ... line numbers will be included in the output.
H ... each byte will be output as a hex number, as well as ASCII. If
Example:
TYPE sales/report1 --
displays the text file "report1" in the subdirectory "sales"
TYPE program1 program1hex OPT H --
writes out the code stored in "program1" in hexadecimal and ASCII
and stores it in the file "program1hex".
#Wait
WAIT - wait for a specified amount of time.
Syntax:
WAIT <n> [SEC|SECS] [<m> MIN|MINS] [UNTIL <time>]
Specification:
WAIT can be used in command sequences or after RUN to wait for a
certain period, or to wait until a certain time of day. The waiting
time is one second unless you specify otherwise.
The keywords SECS and MINS may follow or precede the amounts.
Use the keyword UNTIL to wait until a specific time of day, given in
the format HH:MM.
Example:
WAIT -- waits one second.
WAIT 15 -- waits for 15 seconds.
WAIT 30 MINS -- waits for 30 minutes.
WAIT UNTIL 14:30 -- waits until 2:30 p.m.
#
