💾 Archived View for spam.works › mirrors › textfiles › apple › DOCUMENTATION › anix captured on 2023-06-16 at 21:14:11.
-=-=-=-=-=-=-
_______________________________
| |
| ANIX v2.2a |
| (c) 1985-87 Randall Hyde |
| all rights reserved |
|_______________________________|
This program is offered free of charge. It is not, however, public
domain. There is a distinction!
Following are some VERY brief notes on the ANIX operating system. This
version of ANIX is a shell for ProDOS/8 (or ProDOS 1.x.1 etc), and runs
on a II+, //e or IIgs. A nicely printed manual with a disk is available
for $25.00 (printing and mailing costs) from
HAL Labs
18942 Dallas
Perris, CA 92370
The manual is 200 pages+, and the disk has source code for many of the
extrinsics. If attention warrants it, I can post the manual; however, it
would take hours to download, and cost you lots. Hobbe's choice. If you
want to print your own manual, it is available on disk for $7.50 (one
disk with ANIX, extrinsics and manual).
Now, on to the good stuff!
----------------------------------------------------------------------
A Brief History:
The original ANIX (version 1.0) was a shell for DOS 3.3, written by
Randall Hyde to support his Lazer Pascal and other projects. The name
is derived from
Apple uNIX
which is not to say that it is UNIX. It supported I/O redirection, EXEC
files with parameters, user-written extrinsics (utilities) etc.
The current ANIX v2.2 is a shell for ProDOS/8, also written by Randall
Hyde (and modified by yours truly) mainly to provide an environment for
the LISA v3.1 assembler. It also supports I/O redirection
=PRINT FILE >OUTFILE
=PRINT FILE >.P {printer}
=PRINT <.C >FILE {from COM to a file}
(PRINT is an extrinsic used to print text files).
ANIX v2.x has replaceable console drivers, so it works the same with
Apple 40 column
Apple 80 column
Videx and Ultraterm 80x24, 80x48, 128x24
Wizard 80 column
It has a fairly complete cursor editing package (insert/delete char,
insert/delete line, clear EOLN/EOP, etc) that is consistent across any
video device that has a console driver written for it
-----------------------------------------------------------------------
To use ANIX:
Make a disk with
PRODOS {your version of ProDOS}
ANIX.SYSTEM {the ANIX system}
EXTRINSICS {make a directory for extrinsics}
PRINT {put extrinsics in here}
COPY
INIT
etc etc
ANIX is a command-line processor, so anything you type will first be
processed internally; if it is an intrinsic (internal command) like
CATALOG {or CAT}
PREFIX
DELETE
ONLINE
SAVE
etc, then ANIX will execute the command and return to the prompt.
Otherwise, it will look for an extrinsic (external command) on the disk.
It first looks in the current directory, then it looks in the directory
called EXTRINSICS on the root of the current volume.
-----------------------------------------------------------------------
Intrinsic commands
Notes: all char output is to standard out (may be redirected)
all char input is from standard in (may be redirected)
all numbers (addresses, etc) are in HEX
BRK
transfer control to Apple monitor
note: on IIgs, do a "3<ctrlP>" to reset video hooks
to return to ANIX, do A003G (in bank 00!)
CATALOG <pathname>
do catalog of directory <pathname>, or (if <pathname> is omitted),
of current prefixed directory
CLOSE
will close any open files (if an error left some open)
DATE
prints the current date
DELETE <pathname>
delete <pathname>. Currently, will not delete a non-empty directory
EXEC <pathname>
execute text commands from the text file <pathname>. Continues until
error or end of file
LOAD <pathanme> <addr>
loads <pathname> at <addr>. If <addr> is omitted, will load file at
address in AUXTYPE (usually the save address).
LOCK <switches> <pathname>
sets various lock attributes for <pathname>
=LOCK -rw MYFILE {lock read and write access}
=LOCK MYFILE {lock all except read access}
ONLINE
lists all volumes online, and slots where they are located
PREFIX <pathanme>
sets system prefix to <pathname> or (if blank) shows current prefix
RENAME <oldpath> <newpath>
rename <oldpath> to be <newpath>. Will not move file between
subdirectories.
RUN <addr>
will do a JSR to the given address.
SAVE <pathname> <addr> <len>
save file on disk from memory, starting with <addr>, and file length
<len>.
SYSSAVE <pathname> <addr> <len>
similar, except that instead of making a BIN file, it makes a SYS
file
TIME
prints the current time
UNLOCK
unlock the specified file attributes. See LOCK.
-----------------------------------------------------------------------
ANIX supports the idea of logical devices. All disk devices are named
.dN
By default
.d1 disk in slot 6, drive 1
.d2 " " slot 6, drive 2
.d3 slot 5, drive 1
.d4 slot 5, drive 2
.d5 slot 7, drive 1
.d6 slot 7, drive 2
.d7 slot 2, drive 1
.d8 slot 2, drive 2
If you didn't know (or care to know) the name of a disk, you could
just say
=CATALOG .d1
to get a catalog of the disk in drive .d1. The drive convention is
supported in all ANIX intrinsics, and extrinsics can use it by calling
the routine PARSENAM (which also does all checking for valid ProDOS
naming etc).
The printer device is .P
The communication device is .C
-----------------------------------------------------------------------
Extrinsics
PRINT <switches> <file1> <switches> <file2> ...
will print any number of files to standard out, with many options
-P issue page feed
-# number each line
-(n1:n2) print lines from n1 to n2
-[c1:c2] print columns from c1 to c2
refer to ANIX manual (or type in bad input and PRINT will prompt you)
COPY <pathname> <pathname>
will copy a file (or files with wildcard specification)
The "=" wildcard will copy all files that match without prompting
The "?" wildcard will prompt before each file
INIT drive
Will format a disk in drive specified.
ED
A simple line editor for text files. Has
Insert
Delete
List
Modify
LOad
SAve
Press <ctrl-2> to exit insert mode
PROMF <file>
print contents of OMF file, giving headers, record info, etc
very crude so far
FREESPC <drive>
give free space info about a drive
SETUP.ANIX
allow you to edit default ANIX parameters
MAKDIR
create a sub-directory
ADU
a disk block editor
CHANGETYPE <file> <type>
change a file's type. Specify the type in hex
----------------------------------------------------------------------
Any questions may be cheerfully answered. Send them to HAL.LABS on
GEnie, or (better) in an appropriate topic (like the LISA816 topic)
in the A2PRO section on GEnie.