Startup manual v1.0

D. Brahm (brahm@theory3.caltech.edu)
Tue, 9 Jul 91 11:30:38 PDT

* Starting Up the UltraLite (v1.0 7/9/91) David Brahm *

I wrote this as a beginner's manual on obtaining UltraLite (UL) software,
but I hope the pros will comment, make corrections, suggest software, and
answer my own questions [in brackets]. If there's enough feedback I'll post
an updated version.

I own a 2MB UL with no disk drive and no printer. I have an account on
a Sun3 running UNIX, with access both via phone and via IBM PC. The Sun3
supports Kermit and ftp. I will assume you have a similar system.

Before you even turn on the UL, you must acquire (to the PC) some basic
software. The classic (and often overwhelming) source is the Simtel20
archive wsmr-simtel20.army.mil (192.88.110.20); any directory refered to
below as "XXX]" is in pd1:[msdos.XXX] here. A complete listing of Simtel's
contents is in FILEDOCS]SIMLIST.ARC. A "mirror" archive, often more
accessible and faster, is wuarchive.wustl.edu (128.252.135.4); the
corresponding directory is /mirrors/msdos/XXX. Other useful ftp sites are
rusmv1.rus.uni-stuttgart.de (131.215.139.47), garbo.uwasa.fi (12.214.12.37),
nic.funet.fi (128.214.6.100), and sol.deakin.oz.au (128.184.1.1). Other
sources are:
The PC you're using, which may have external DOS commands and Kermit.
ultralite-archive@csd.mot.com (email with subject line "index", no body)
Files with suffix .UU should be run through the UNIX command UUDECODE.
The UltraLite Connection, $39 from Thaddeus Computing (formerly
Personalized Software) (800)373-6114. Helpful, though not essential.
"Stupid PC Tricks", a book of shareware with disks. Not worth buying.

Here's a sample session on the PC:
PC> mskermit
Kermit> c ("connect", then login to UNIX)
UNIX> ftp wuarchive.wustl.edu
ftp> login: anonymous
ftp> password: (your email address)
ftp> cd /mirrors/msdos/arc-lbr
ftp> binary (for EXE/COM/ARC/ZIP, "tenex" on Simtel, "ascii"
for text [Pros: How do TENEX & BINARY differ?])
ftp> get pk361.exe
ftp> quit
UNIX> kermit
C-Kermit> set file type binary
C-Kermit> server (then type ^]c to return to the PC)
Kermit> get pk361.exe
Kermit> bye
PC> pk361

Get the following files:
ARC-LBR]PK361.EXE -- creates PKPAK and PKUNPAK, needed for .ARC files
STARTER]UNZIP41.EXE -- creates UNZIP, needed for .ZIP files
FILUTL]PKLTE105.EXE -- creates PKLITE which shrinks .EXE and .COM files
DSKUTL]YASE.ARC -- Yet Another (disk) Sector Editor
KERMIT]MSVIBM.ARC -- Kermit 2.32/A, smaller and PKLITE-able
KERMIT]MSIIBM.ARC -- Kermit initialization files, scripts, tutorial
UEMACS]UE310IBM.ARC -- MicroEMACS text editor (though this version seems to
run out of memory too easily with large files)

If you need to unpack .LZH files use ARC-LBR]LH113C.EXE; for .ZOO files
use ZOO]ZOO201.EXE; but these are less common. By running PK361.EXE you
create (among other things) PKUNPAK.EXE. Type PKUNPAK YASE, and you will get
YASE.EXE. Also unpack the other .ARC files.

OK, it's time to open the UL! Initialize, Format, and System the C: disk,
then run LapLink. Hook up the UL to the PC with the supplied cable, using
the same port in back of the PC you had used to connect to the UNIX machine.
Transfer YASE.EXE to the UL, and quit LapLink. Now run YASE on the UL; type
? for help. You will see sector 0. Change offset 00d (hex for 13) from 08
to 02, and offset 016 (hex for 22) from 02 to 08. (On the 1MB UL, offset 016
should be changed from 01 to 03.) Write the sector, then quit. Super-reboot
with Ctrl-Alt-Fn-Del, then Format and System the C: disk. These changes
change the cluster size from 4K to 1K, saving about 1.5K per file. You won't
need YASE on your UL, but keep it on the PC.

[Pros: Did I get that right? (I've only done it once!) Does the UL work
if you don't System the second time through? Can one remove the hidden files
IO.SYS and MSDOS.SYS, which after all are on d: drive?]

LapLink the other files to the UL, and learn to use them. Throw out the
documentation files when you've read them. Now you can Kermit directly from
the UL to your UNIX machine (by phone), unpack or unzip Simtel files, and
edit files.

Currently I have the following files (with sizes, about 1M total):

\
CONFIG.SYS 69 Add the line "shell=d:\command.com d:\ /p", then you can
delete COMMAND.COM
ULITE.INF 496 My greatly-reduced program documentation
ADDRESS.INF 280 Addresses and phone #'s; I search with Emacs
AUTOEXEC.BAT 223 Remove "SETUP", add "@echo off", "c:\util\xeq swapkey",
"xeq alarm -L", expand the PATH

\UTIL\
MGR.INI 412 I use MANAGER which came with the UL
XEQ.COM 13805 ARC-LBR]XEQ115.ARC, contains other .COM files:
DGSET (from the UL mailing list, replaces SETUP)
CTYPE (SCREEN]CTYPE.ZIP, makes cursor big in editor)
SWAPKEY (KEYBOARD]SWAPKY11.ARC, swaps Ctrl/CapsLock)
MOREC (=MORE, a standard DOS external command)
UNERASE (from UltraLite Connection, restores files)
CAL (from UltraLite Connection, makes a calendar)
INPUT (from UltraLite Connection, batch file input)
ALARM (see AN.EXE below)
EPSILON.EXE 44332 Actually I use this version of Emacs, but it's not
EPSILON.STA 64890 available to the public
KERMIT.EXE 56192 An alternative, if your mainframe supports XMODEM, is
DGTERM, available from the ultralite-archive
MSKERMIT.INI 1658 "set port 2", LOOKUP, DIAL, GETQ macros
FIND.EXE 1589 Standard DOS external command
SORT.EXE 1215 Standard DOS external command
BM.BAT 798 Contains other .BAT files:
MANAGER (came with UL)
ED (runs CTYPE then EPSILON)
MORE (xeq morec < %2)
INPUTDEM (demo for INPUT.COM)
FORT (compiles & links a Fortran program)

\PACK\
PKLITE.EXE 12990 Shrinks .EXE files, except some with overlays
HDROPT.EXE 4557 Came with PKLITE, needed for BCF.EXE.
PKPAKJR.EXE 21702 Create .ARC archives
PKUNPAKJ.EXE 15030 A smaller, slower alternative is ARC-LBR]ARCE40G.ZIP
UNZIP.EXE 27268 For .ZIP files

\GAMES\
BUGLE.EXE 33950 From "Stupid PC Tricks"
PAC-GAL.EXE 24236 From UltraLite Connection
NYET.EXE 12708 From UltraLite Connection, beats SOT and OBJETRIS
(Warning: if you tried OBJETRIS, be sure to remove
with LapLink the hidden file \OBJETRIS.SAV)
GNUCHESS.EXE 26037 From rusmv1 in /games
GNUCHESS.ARC 15097 Contains GNUCHESS.BOO, book of opening moves

\FORTRAN\
BCRTSY.EXE 7249 These are all from rusmv1. Be warned, documentation is
BCF.EXE 138201 in German! Run BCRTSY (a TSR), unpak LIB, then
BCL.EXE 21918 compile with "BCF prog", link with "BCL prog LIB".
LIB.ARC 40666 BCRTSY must be resident for programs to run, too.

\MCAD\
MCAD.ARC 285590 MathCad (not public), a numerical package with the feel
of a symbolic manipulator - manipulates matrices,
solves eqs., plots, does derivatives & integrals

\AN2\
AN.EXE 53925 AmpleNotice (DESKACCESS]AN203.ZIP) appointment calendar
NOTES 2057 and alarm clock. I haven't decided yet if it's any
ANHELP 1507 better than carrying around a calendar.
CONFIG.CAL 1205

\TEXT\
... Text files to edit, the UL's raison d'etre!

When you've decided what you like, you should of course back everything up
on the PC. I make a directory on the hard drive called e.g. \UL070991\, with
subdirectory structure identical to the UL's. In addition I keep one more
subdirectory, PCONLY\, containing the PC's LapLink (LLNU.EXE), YASE.EXE, and
any other files (like documentation) I want to keep around. Also when your
system is more or less settled, you may want to delete everything then
LapLink it back, to minimize disk fragmentation [Does this matter on a
Silicon Drive?].

-- David Brahm (brahm@theory3.caltech.edu)