Beginner's manual v2.0 (and probably final)

D. Brahm (brahm@theory3.caltech.edu)
Mon, 29 Jul 91 23:57:18 PDT

* Starting Up the UltraLite (v2.0 7/29/91) David Brahm *

This is a beginner's manual on obtaining UltraLite (UL) software. I will
assume you have a system similar to mine: a 2MB UL with no disk drive and no
printer, access to a UNIX machine which supports ftp, and a PC which can
reach the UNIX machine through Kermit. Some software below is ShareWare, so
you are obliged to pay (usually $5-$25) if you find it useful.

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.

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 (EXE/COM/ARC/ZIP, "tenex" on Simtel, "ascii" for text)
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 and Format 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 Initialize, Format, and Setup 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.

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 1.1M total):

\
CONFIG.SYS 69 Add the line "shell=d:\command.com d:\ /p", then you can
delete COMMAND.COM
AUTOEXEC.BAT 223 See below
ULITE.INF 2544 My greatly-reduced program documentation
PHONE.INF 814 Phone & address book; I search with Emacs
SIMTEL.IDX 53217 My honed-down index of Simtel software

\UTIL\
MGR.INI 492 I use MANAGER which came with the UL
BM.BAT 597 Multiple-use batch file, see below
EPSILON.EXE 44332 Actually I use this version of Emacs, but it's not
EPSILON.STA 64890 public. I keep the documentation packed, with an
EDOC.ARC 23794 Emacs command to unpack it if needed.
KERMIT.EXE 56192 2.32A; if you use XMODEM try DGTERM (ultralite-archive)
MSKERMIT.INI 1887 See below
DGSET.COM 213 From the UL mailing list, replaces SETUP
CTYPE.COM 1256 SCREEN]CTYPE.ZIP, makes cursor big in editor
SWAPKEY.COM 816 KEYBOARD]SWAPKY11.ARC, swaps Ctrl/CapsLock
BROWSE.COM 958 SYSUTL]BATPOWER.ZIP, basis of "more" to view files
UNERASE.COM 2216 From UltraLite Connection, restores deleted files
CAL.COM 1024 From UltraLite Connection, makes a calendar

\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 a book called "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 /soft/pc/games
GNUCHESS.ARC 15097 Contains GNUCHESS.BOO, book of opening moves
BRIDGE.COM 63872 Origin unknown
TESS.EXE 23339 From rusmv1 in /soft/pc/games, text adventure game

\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.

\CCALC\
CC.EXE 131371 CALCULATOR]CCALC.ZIP evaluates expressions, solves eqs.,
CC.DOC 5483 vectors, functions (recursive, implicit), graphs (3D,
CC.HLP 29180 parametric), histograms, statistical analysis, finds
DEMO.CC 9572 derivatives (not integrals), programming environment

\AN2\
AN.EXE 53925 DESKACCESS]AN203.ZIP AmpleNotice appointment calendar
NOTES 2057
ANHELP 1507
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. \UL072991\, 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. Below I've
listed my AUTOEXEC.BAT, BM.BAT, and MSKERMIT.INI.

Here's my AUTOEXEC.BAT:
@echo off
c:\util\swapkey >nul
PATH c:\util;c:\pack;c:\games;d:\
for %%v in (\games\nyet.his \games\chess.lst \games\bridge \an2\notes.bak) do
if exist %%v del %%v
SET COMSPEC=D:\COMMAND.COM
D:\MANAGER C:\UTIL\MGR.INI

Here's my BM.BAT:
@echo off
if not %1.==. goto -%1
echo bm contains: manager,ed,more,fort,chess
goto end
:-manager
d:\manager c:\util\mgr.ini
goto end
:-ed
ctype /aa
epsilon %2
ctype /ga
if exist \util\edoc if exist \util\edoc.arc del \util\edoc
goto end
:-more
echo <ESC>[032;0;81p <ESC>[098;0;73p
rem Makes SPACE and "b" act like PgUp and PgDn; replace <ESC> with Esc char.
browse %2
echo <ESC>[032;032p <ESC>[098;098p
goto end
:-fort
cd c:\fortran
rem You must run BCRTSY first!
bcf %2
if errorlevel 1 goto end
if not exist lib.b pkunpakj lib
bcl %2 lib
goto end
:-chess
cd c:\games
if not exist gnuchess.boo pkunpakj gnuchess >nul
gnuchess 30 3
if exist gnuchess.arc del gnuchess.boo
del chess.lst
:end

Here's my MSKERMIT.INI (slightly abbreviated):
set port 2
set parity even
set speed 2400
set display 7 ; in the 7-bit environment
set terminal vt102 ; /vt52/heath/tek4010, toggle with ALT+
set warning on ; Don't overwrite existing files
set input echo off
output ATL0\13 ; Low volume
set input echo on
set input timeout quit

def hush output ATM0\13
def nohush output ATM1\13
def lookup -
if eq \%1 citint def \%1 94050161,-
if eq \%1 citloc def \%1 4050161,-
if eq \%1 citlong def \%1 8184050161,-
if eq \%1 slac def \%1 9264824
def dial clear, lookup \%1, echo \13, output ATDT\%1\13, wait 5, connect
def getq get *, bye, wait 5, output lo\13, quit
def t3 clear, echo \13, out ATDT9264824\13, inp 40 2400, wait 5, out \13,-
inp 5 class:, out telnet\13, wait 2, out \13,wait 1,out \13,wait 1,out \13,-
inp 5 Igate>, out c theory3.caltech.edu\13, inp 8 login:, out brahm\13, con

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