TEENY.EXE MANUAL - Revision history

Jhoger at 05:09, 6 April 2009

2009-04-06T05:09:17Z

← Older revision		Revision as of 22:09, 5 April 2009
Line 291:		Line 291:
	supply the /S switch for immunity to noise. If you don't explicitly		supply the /S switch for immunity to noise. If you don't explicitly
	supply this switch, the default is 19200 Baud operation.		supply this switch, the default is 19200 Baud operation.

			[[Category:File Transfer]]

Ronw: /* Bonus */ trivial grammatical correction

2009-03-27T05:50:58Z

Bonus: trivial grammatical correction

← Older revision		Revision as of 22:50, 26 March 2009
Line 223:		Line 223:
	change in the file name listings at the PC screen while you are using		change in the file name listings at the PC screen while you are using
	TEENY.CO to transfer files. TEENY.EXE gave you a bonus, not magic		TEENY.CO to transfer files. TEENY.EXE gave you a bonus, not magic
	intervention in a session DeskLink.		intervention in a session of DeskLink.

	== About DeskLink ==		== About DeskLink ==

Ronwiesen at 14:36, 5 December 2008

2008-12-05T14:36:49Z

← Older revision		Revision as of 07:36, 5 December 2008
Line 152:		Line 152:
	TEENY.CO has three traits that it "inherits" from TEENY.EXE.		TEENY.CO has three traits that it "inherits" from TEENY.EXE.

	; working speed : either 9600 Baud or 19200 Baud, based on whether you did or did not supply the /S switch when you invoked TEENY.EXE.		* working speed -- either 9600 Baud or 19200 Baud, based on whether you did or did not supply the /S switch when you invoked TEENY.EXE.
	; DSR sensitivity : either insensitive (i.e., DSR unused/ignored) or sensitive (i.e., DSR used and expected), based on whether you did or did not supply the /IDSR switch when you invoked TEENY.EXE.		* DSR sensitivity -- either insensitive (i.e., DSR unused/ignored) or sensitive (i.e., DSR used and expected), based on whether you did or did not supply the /IDSR switch when you invoked TEENY.EXE.
	; laptop Model type : either type 10x or type 200, based on the Model of Tandy laptop that TEENY.EXE detected via the COM port of the PC.		* laptop Model type -- either type 10x or type 200, based on the Model of Tandy laptop that TEENY.EXE detected via the COM port of the PC.

	TEENY.EXE interacts with you; read and follow the directions that		TEENY.EXE interacts with you; read and follow the directions that
Line 177:		Line 177:
	wrong choice -- just choose! Do you want to:		wrong choice -- just choose! Do you want to:

	* conserve memory in the Tandy laptop. The Tandy laptop now is		* conserve memory in the Tandy laptop. The Tandy laptop now is consuming memory that holds BASIC statements, should you purge the statements to recover the memory they consume? NEW recovers the memory.
	consuming memory that holds BASIC statements, should you purge the		* be able to re-create TEENY.CO without using TEENY.EXE, a PC, and a null-modem cable. Such stand-alone ability now is held within the Tandy laptop, should you retain it for future use? SAVE"TEENY retains it in the form of a BASIC program file named TEENY.BA.
	statements to recover the memory they consume? NEW recovers the
	memory.
	* be able to re-create TEENY.CO without using TEENY.EXE, a PC, and a
	null-modem cable. Such stand-alone ability now is held within the
	Tandy laptop, should you retain it for future use? SAVE"TEENY
	retains it in the form of a BASIC program file named TEENY.BA.

	File TEENY.CO, like any conventional .CO file, is immutable. TEENY.EXE		File TEENY.CO, like any conventional .CO file, is immutable. TEENY.EXE
Line 216:		Line 210:
	within:		within:

	* the memory of the Tandy laptop. File names TEENY.CO and TEENY.BA		* the memory of the Tandy laptop. File names TEENY.CO and TEENY.BA are not in this (first) listing.
	are not in this (first) listing.		* a particular drive and directory of the PC. The particular drive and directory (e.g., C:\ROOT) are indicated above this (second) listing.
	* a particular drive and directory of the PC. The particular drive
	and directory (e.g., C:\ROOT) are indicated above this (second)
	listing.

	If you plan to immediately use TEENY.CO at the Tandy laptop to transfer		If you plan to immediately use TEENY.CO at the Tandy laptop to transfer

Jhoger: /* Primary Objective */

2008-12-05T06:12:47Z

Primary Objective

← Older revision		Revision as of 23:12, 4 December 2008
Line 152:		Line 152:
	TEENY.CO has three traits that it "inherits" from TEENY.EXE.		TEENY.CO has three traits that it "inherits" from TEENY.EXE.

	* working speed -- either 9600 Baud or 19200 Baud, based on whether you did or did not supply the /S switch when you invoked TEENY.EXE.		; working speed : either 9600 Baud or 19200 Baud, based on whether you did or did not supply the /S switch when you invoked TEENY.EXE.
	* DSR sensitivity -- either insensitive (i.e., DSR unused/ignored) or sensitive (i.e., DSR used and expected), based on whether you did or did not supply the /IDSR switch when you invoked TEENY.EXE.		; DSR sensitivity : either insensitive (i.e., DSR unused/ignored) or sensitive (i.e., DSR used and expected), based on whether you did or did not supply the /IDSR switch when you invoked TEENY.EXE.
	* laptop Model type -- either type 10x or type 200, based on the Model of Tandy laptop that TEENY.EXE detected via the COM port of the PC.		; laptop Model type : either type 10x or type 200, based on the Model of Tandy laptop that TEENY.EXE detected via the COM port of the PC.

	TEENY.EXE interacts with you; read and follow the directions that		TEENY.EXE interacts with you; read and follow the directions that

Jhoger: /* Primary Objective */

2008-12-05T06:12:01Z

Primary Objective

← Older revision		Revision as of 23:12, 4 December 2008
Line 152:		Line 152:
	TEENY.CO has three traits that it "inherits" from TEENY.EXE.		TEENY.CO has three traits that it "inherits" from TEENY.EXE.

	* working speed -- either 9600 Baud or 19200 Baud, based on whether		* working speed -- either 9600 Baud or 19200 Baud, based on whether you did or did not supply the /S switch when you invoked TEENY.EXE.
	you did or did not supply the /S switch when you invoked TEENY.EXE.		* DSR sensitivity -- either insensitive (i.e., DSR unused/ignored) or sensitive (i.e., DSR used and expected), based on whether you did or did not supply the /IDSR switch when you invoked TEENY.EXE.
	* DSR sensitivity -- either insensitive (i.e., DSR unused/ignored) or		* laptop Model type -- either type 10x or type 200, based on the Model of Tandy laptop that TEENY.EXE detected via the COM port of the PC.
	sensitive (i.e., DSR used and expected), based on whether you did or
	did not supply the /IDSR switch when you invoked TEENY.EXE.
	* laptop Model type -- either type 10x or type 200, based on the Model
	of Tandy laptop that TEENY.EXE detected via the COM port of the PC.

	TEENY.EXE interacts with you; read and follow the directions that		TEENY.EXE interacts with you; read and follow the directions that
Line 172:		Line 168:
	precise ways. For example, "At laptop, type ?HIMEM:CALL9643 and press		precise ways. For example, "At laptop, type ?HIMEM:CALL9643 and press
	Enter" does tell you precisely what to do.		Enter" does tell you precisely what to do.

	== Option ==		== Option ==

Jhoger: /* TEENY.EXE Placement and Syntax */

2008-12-05T06:11:15Z

TEENY.EXE Placement and Syntax

← Older revision		Revision as of 23:11, 4 December 2008
Line 1:		Line 1:

	This manual has five sections. They are in the order that is naturally		This manual has five sections. They are in the order that is naturally
	occurring for TEENY.EXE usage. The first section answers questions of		occurring for TEENY.EXE usage. The first section answers questions of
Line 81:		Line 80:
	than 9600 Baud, then select 9600 Baud.		than 9600 Baud, then select 9600 Baud.

	<~~block~~>		<blockquote>
	Note #1 Prior to the use of TEENY.CO with the Tandy Portable Disk Drive		Note #1 Prior to the use of TEENY.CO with the Tandy Portable Disk Drive
	or the Purple Computing Disk Drive, you must establish its		or the Purple Computing Disk Drive, you must establish its
Line 87:		Line 86:
	TEENY.CO. See the "Slave Disk Devices" section of the "TEENY		TEENY.CO. See the "Slave Disk Devices" section of the "TEENY
	MANUAL" for detail.		MANUAL" for detail.
	</~~block~~>		</blockquote>

	<~~block~~>		<blockquote>
	Note #2 The PC used for TEENY.EXE is not, necessarily, the "same PC"		Note #2 The PC used for TEENY.EXE is not, necessarily, the "same PC"
	which you might subsequently use for Disk Drive emulation. See		which you might subsequently use for Disk Drive emulation. See
	"About DeskLink" for Disk Drive emulation and 9600 Baud detail.		"About DeskLink" for Disk Drive emulation and 9600 Baud detail.
	</~~block~~>		</blockquote>

	There's a /IDSR switch for creation of an incarnation of TEENY.CO that		There's a /IDSR switch for creation of an incarnation of TEENY.CO that
Line 145:		Line 144:
	mediates the COM ports in that mode. Just guess at a lower value of		mediates the COM ports in that mode. Just guess at a lower value of
	pace and try it!		pace and try it!

	== Primary Objective ==		== Primary Objective ==

64.81.88.222: New page: This manual has five sections. They are in the order that is naturally occurring for TEENY.EXE usage. The first section answers questions of where, how, and why with respect to TEENY.EX...

2008-12-05T05:54:07Z

New page: This manual has five sections. They are in the order that is naturally occurring for TEENY.EXE usage. The first section answers questions of where, how, and why with respect to TEENY.EX...

New page

This manual has five sections. They are in the order that is naturally
occurring for TEENY.EXE usage. The first section answers questions of
where, how, and why with respect to TEENY.EXE invocation.

The next two sections bear on your interaction with TEENY.EXE while it
controls your PC, and how your interactions relate to your current and
future circumstances.

The last two sections are meaningful after TEENY.EXE control of your PC
has ended. Be sure to read the "Bonus" section, lest your PC screen
display fool you into believing that TEENY.EXE still controls your PC.
Both of these last sections cover DeskLink invocations: by TEENY.EXE,
and manually by you.

== TEENY.EXE Placement and Syntax ==

TEENY.EXE is an executable file for a PC. The ideal locale for this
file is C:\ROOT in a fixed disk drive, and A:\ROOT in a floppy
diskette. Place it there now!

The command name is TEENY. The command TEENY /? explains everything,
and the syntax it reveals is especially important. Do the TEENY /?
command now!

<pre>
-------------------------------------------------------------------------------
C:\ROOT> TEENY /?
-------------------------------------------------------------------------------
Purpose: Boot the Tandy laptop Model 100, 102, or 200 with TEENY for later use.
The boot speed applies now, the working speed of TEENY applies later.
Syntax: TEENY [/p] [/BS] [/S] [/IDSR] [/DOS] [pace]
/p is COM port number. Range: 1 to 4. Default: 1.
/BS is boot speed at 9600 Baud, rather than 19200 Baud.
/S sets TEENY to 9600 Baud working speed, rather than 19200 Baud.
/IDSR makes TEENY insensitive to DSR control line (i.e., DSR unused).
/DOS declares Op Sys as DOS in order to have no pace (i.e., override).
pace is useful only if the Op Sys is Windows, rather than DOS. Where
you don't specify pace, the Op Sys is surveyed: for Windows a
medium pace is set, DOS has no pace. The value set by the survey
is reliable in most cases. Low pace values work well, high values
work fast but can fail. Range: 10 to 99. Set by survey: 40.
Examples:
Port 1 Boot at 19200. TEENY set to 19200, DSR is used. If Windows, pace by 40.
TEENY
Port 1 Boot at 9600. TEENY set to 9600, DSR is used. If Windows, pace by 40.
TEENY /BS /S
Port 2 Boot at 9600. TEENY set to 19200, DSR unused. If Windows, pace by 40.
TEENY /2 /BS /IDSR
Port 3 Boot at 19200. TEENY set to 19200, DSR is used. Windows, pace is 25.
TEENY /3 25
Port 4 Boot at 9600. TEENY set to 9600, DSR is used. DOS declared, no pace.
TEENY /4 /BS /S /DOS
C:\ROOT>
-------------------------------------------------------------------------------
</pre>

TEENY boots the laptop. The end result is creation of an incarnation
of laptop command file TEENY.CO within the laptop.

The switches /1, /2, /3, and /4 steer the boot to any of four COM ports
of the PC: COM1, COM2, COM3, or COM4. If you don't explicitly supply
one of these switches, the default is boot to the COM1 port.

There's a /BS switch for boot at 9600 Baud. This is needed for a PC
where its COM port(s) can not operate any higher than 9600 Baud. If
you don't explicitly supply this switch, the default is boot at 19200
Baud. Note: do not confuse this /BS switch with the /S switch.

There's a /S switch for creation of an incarnation of TEENY.CO that
works at 9600 Baud. If you don't explicitly supply this switch, the
default is creation of TEENY.CO that works at 19200 Baud. Where the
Tandy Portable Disk Drive 2 is the slave device, it only operates at
19200 Baud -- do not supply the /S switch. Where the Brother Disk
Drive FB100 is the slave device, it only operates at 9600 Baud --
supply the /S switch. For the other Disk Drives (note #1), you have a
choice: 19200 Baud, or 9600 Baud. Where the cable to the slave device
runs through an area of high electrical noise, select 9600 Baud so you
have some immunity to noise. If you plan to use Disk Drive emulation
by "some PC" (note #2) and its COM port(s) can not operate any higher
than 9600 Baud, then select 9600 Baud.

<block>
Note #1 Prior to the use of TEENY.CO with the Tandy Portable Disk Drive
or the Purple Computing Disk Drive, you must establish its
operational speed so that it matches the working speed of
TEENY.CO. See the "Slave Disk Devices" section of the "TEENY
MANUAL" for detail.
</block>

<block>
Note #2 The PC used for TEENY.EXE is not, necessarily, the "same PC"
which you might subsequently use for Disk Drive emulation. See
"About DeskLink" for Disk Drive emulation and 9600 Baud detail.
</block>

There's a /IDSR switch for creation of an incarnation of TEENY.CO that
is insensitive to the DSR control line (i.e., DSR unused). If you
don't explicitly supply this switch, the default is creation of
TEENY.CO that is sensitive to the DSR control line. Where the cable to
the slave device is an inferior arrangement that has no connection to
DSR at the laptop side (e.g., a PalmOS device with a deficient serial
HotSync cable), you consequently must make TEENY.CO insensitive to the
DSR control line -- supply the /IDSR switch.

There's a /DOS switch that in all cases is not needed but in certain
cases may be desirable to use. If you don't explicitly supply this
switch, the boot operation might proceed in a slow-paced fashion that's
appropriate for a Windows Op Sys despite that fact that the Op Sys
which currently controls the PC is a DOS Op Sys. For example, some
dual-boot arrangements are cases that allow a PC to be controlled by
either a Windows Op Sys or a DOS Op Sys. Also there are cases where
removal of a Windows Op Sys from a PC is incomplete in the sense that
the PC environment still retains traces of the former Windows Op Sys
while the current Op Sys is a DOS Op Sys. In such cases you may, by
supplying the /DOS switch, declare the Op Sys as DOS in order to have
no pace (i.e., fastest possible boot operation) which overrides pacing
that would occur for a Windows Op Sys.

There's a "pace" argument you might need to supply to avoid failure of
the boot. If you don't explicitly supply this argument, the operating
system is surveyed: for Windows the boot is conducted at a medium pace
of 40, for DOS the boot is conducted as quickly as possible without any
pace. If you do supply this argument, there is no survey (i.e.,
Windows is assumed) and the boot is conducted at the pace you specify:
from 10 to 99 characters per second.

Initially you don't know whether to supply a pace argument or not. The
practical approach is to not supply it and see what happens. If the
boot completes, you're done. During the boot, the PC screen shows a
reducing down-count to indicate progress toward completion. Also, a
[Wait] shows during any period of suspension and it disappears whenever
boot progress continues. Should the boot fail, the [Wait] persists and
the down-count hangs (i.e., stops), but no harm occurs. The PC screen
also shows the pace value and explains how to escape from the hung-up
condition at both the PC and at the laptop. If it fails, just use the
TEENY command again with a lower value for the pace.

What lower value of pace should be tried? Nobody can know that. It's
a matter of how Windows "mediates" the COM ports of your PC, and that
depends upon a lot of things -- things that change. But it has nothing
to do with the hardware in your PC. Clock speed of the CPU doesn't
matter. Type of UART at the COM port doesn't matter. And restarting
Windows in so-called "DOS mode" doesn't help because Windows still
mediates the COM ports in that mode. Just guess at a lower value of
pace and try it!

== Primary Objective ==

TEENY.EXE has one primary objective -- creation of an incarnation of
command file TEENY.CO within the Tandy laptop. Once file TEENY.CO is
created, you might not ever need to use TEENY.EXE again! Note that
TEENY.CO has three traits that it "inherits" from TEENY.EXE.

* working speed -- either 9600 Baud or 19200 Baud, based on whether
you did or did not supply the /S switch when you invoked TEENY.EXE.
* DSR sensitivity -- either insensitive (i.e., DSR unused/ignored) or
sensitive (i.e., DSR used and expected), based on whether you did or
did not supply the /IDSR switch when you invoked TEENY.EXE.
* laptop Model type -- either type 10x or type 200, based on the Model
of Tandy laptop that TEENY.EXE detected via the COM port of the PC.

TEENY.EXE interacts with you; read and follow the directions that
appear on the PC screen. TEENY.EXE directs you step by step. In some
steps you are directed with terminology that's peculiar to a Tandy
laptop. For example, "At laptop, type an End address and press Enter"
does not precisely tell you what to type, but "End address" is peculiar
to a Tandy laptop in regard to .CO type files. Perhaps you have no
idea about what is an appropriate End address for file TEENY.CO -- the
PC screen gives you some limiting guidance such as "Do not use an End
address higher than 62959" which corresponds to "stuff" TEENY.EXE has
extracted from your Tandy laptop. In other steps you are directed in
precise ways. For example, "At laptop, type ?HIMEM:CALL9643 and press
Enter" does tell you precisely what to do.

== Option ==

After it creates an incarnation of file TEENY.CO, TEENY.EXE then leaves
you an option. Said another way, the primary objective has been
achieved but you have a decision to make now that might matter to you
in the future. The decision is not critical, there is no right or
wrong choice -- just choose! Do you want to:

* conserve memory in the Tandy laptop. The Tandy laptop now is
consuming memory that holds BASIC statements, should you purge the
statements to recover the memory they consume? NEW recovers the
memory.
* be able to re-create TEENY.CO without using TEENY.EXE, a PC, and a
null-modem cable. Such stand-alone ability now is held within the
Tandy laptop, should you retain it for future use? SAVE"TEENY
retains it in the form of a BASIC program file named TEENY.BA.

File TEENY.CO, like any conventional .CO file, is immutable. TEENY.EXE
has cast an incarnation of file TEENY.CO in concrete -- so to speak.
It inherits laptop Model type, working speed, and DSR sensitivity as
traits. It has an End address that you specified. These fit your
circumstance now, but the future may present you with a different
circumstance that requires another incarnation of file TEENY.CO that is
different. Consider the future -- TEENY.EXE leaves you an option for
how to handle a future circumstance: use TEENY.EXE again, or use
TEENY.BA. Using TEENY.EXE, you can select a different working speed
and/or DSR sensitivity and/or specify a different End address. Using
TEENY.BA, you can only specify a different End address.

== Bonus ==

Make no mistake about it, TEENY.EXE finishes! It knows when it is
done, and it ends. When TEENY.EXE ends, it no longer has control of
your PC. It has done its work -- end of story, finito, that's all
folks.

TEENY.EXE has a bonus that is related to DeskLink and it gives you that
bonus if it can. If it is technically possible, TEENY.EXE gives you
the bonus when it finishes. You may get the bonus, you may not get it.
If you do get the bonus then your PC screen shows two listings of
"laptop-type" file names, and directly below these two file name
listings "To exit Desk-Link, press F10." is seen.

The bonus is that TEENY.EXE invokes DeskLink on your behalf just after
TEENY.EXE lists, on the PC screen, laptop-type file names that it finds
within:

* the memory of the Tandy laptop. File names TEENY.CO and TEENY.BA
are not in this (first) listing.
* a particular drive and directory of the PC. The particular drive
and directory (e.g., C:\ROOT) are indicated above this (second)
listing.

If you plan to immediately use TEENY.CO at the Tandy laptop to transfer
laptop files to or from the PC, then this bonus has value to you. With
manual invocation of DeskLink, a "brag screen" is all that appears at
the PC -- it does not list any file names whatsoever. The bonus is
that TEENY.EXE provides two listings of file names and then it invokes
DeskLink in a way that leaves the screen intact.

It is DeskLink that has control of your PC. So don't expect to see any
change in the file name listings at the PC screen while you are using
TEENY.CO to transfer files. TEENY.EXE gave you a bonus, not magic
intervention in a session DeskLink.

== About DeskLink ==

DeskLink (also known as BOOSTER-LINK) is freeware placed in the public
domain by Club 100. Sessions of DeskLink provide Disk Drive emulation.
DeskLink is useful to Personal Computer (PC) owners who also own a
Tandy laptop or NEC notebook, and have a suitable null-modem cable.
The "Null-modem Cable" section of the "TEENY MANUAL" details what is
suitable for DeskLink. DeskLink freeware is distributed as the PC
command file DESKLINK.COM.

Although your usage of TEENY.EXE might invoke a session of DeskLink,
you must manually invoke it for other sessions. So placement of
DESKLINK.COM and its command line syntax for manual invocation are
necessarily detailed here. Certain desirable aspects of DeskLink that
pertain to its operation as a slave to TEENY.CO, and generally do not
pertain to other masters, are explained in the "Slave Device Nuance"
section of "TEENY.CO MANUAL".

DESKLINK.COM is a command file for a PC. The ideal locale for this
file is C:\ROOT in a fixed disk drive, and A:\ROOT in a floppy
diskette. Place it there now!

The command name is DESKLINK. The command DESKLINK /? explains
everything, and the syntax for its switches has much in common with
the syntax of TEENY.EXE. Do the DESKLINK /? command now!

<pre>
-------------------------------------------------------------------------------
C:\ROOT> DESKLINK /?

DESK-LINK (version 1.05)
(c) 1987, Traveling Software, Inc.

Usage: DESKLINK dir
Function: PC disk emulation of a TANDY Disk Drive via "COM1:" at 19200 baud.
Notation: dir - root directory name (\ROOT used if omitted).
Switches: /2 - to communicate through "COM2:".
/S - to communicate at 9600 baud.

C:\ROOT>
-------------------------------------------------------------------------------
</pre>

DeskLink makes a COM port of a PC respond, to stimulation, in the slave
fashion that a Disk Drive (e.g., Tandy Portable Disk Drive) exhibits.
Although the disk media of a PC differs considerably from the media of
a Disk Drive, stimulations and responses are alike. Thus, DeskLink is
an emulator of a Disk Drive. Thus, the stimulations by a master such
as TEENY.CO evoke operations which involve "laptop type" files and some
file repository within a PC.

There's a "dir" argument so you can specify what directory in the PC
current drive you want to use as the repository of "laptop type" files.
If you don't explicitly supply this argument, the default directory
\ROOT of the current drive is the repository.

There's a /2 switch which steers operation to the COM2 port of the PC.
If you don't explicitly supply this switch, the default is the COM1
port.

There's a /S switch for 9600 Baud operation. This is needed for a PC
where its COM port(s) can not operate any higher than 9600 Baud. Where
the null-modem cable runs through an area of high electrical noise,
supply the /S switch for immunity to noise. If you don't explicitly
supply this switch, the default is 19200 Baud operation.