TEENY.EXE MANUAL: Difference between revisions

From Bitchin100 DocGarden
Jump to navigationJump to search
(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...)
 
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 ==
   
   

Revision as of 23:11, 4 December 2008

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!

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

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.

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.

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.

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!

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


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.