CLUB 100 Library - 415/939-1246 BBS,    937-5039 NEWSLETTER, 932-8856 VOICE

             CREATING 'XMDPW3.CO'
             ********************
 
   Download XMDPW3.100 and load into Basic; save as XMDPM3.BA and store to
your disk, desktop computer, or cassette before proceeding further.
 
   Now run XMDPW3.BA in order to create the machine language program; it will
locate XMDPW3.CO at the address of your choice, or immediately below HIMEM.
The Basic program automatically save XMDPW3.CO to RAM; you may then kill the
XMDPW3.BA file and proceed.

   XMDPW3.ASM contains the assembly source code; it is NOT required for use of
the program.

             RUNNING 'XMDPW3.CO'
             *******************

    Put your menu cursor on "XMDPW3.CO" and press "ENTER".  The screen will
clear and the copyright and version message will be displayed, followed by the
prompt "TelXcommand:".  If it doesn't, there is probably a memory conflict with
another program, or an error occured during the creation process (leave me a 
message).  This is command mode, and is very like the same mode of "TELCOM" 
except TERM is at [F7] and [F4] and [F5] are the directory and free RAM 
displays, respectively.

    To send or receive with XMODEM protocol you must enter the normal terminal 
mode (in any of the normal ways) and then the XMODEM terminal mode (same mode, 
actually, only the function keys are different) by pressing "[F7] Xmod".  Now 
you will see "[F2] Send" and "[F3] Recv".  Before proceeding, the host 
(computer being Sent to or Received from) must be at the point of waiting for 
the XMODEM transfer to begin.  It will either be awaiting a CRC or checksum 
request, or repeatedly sending same.  Pressing either "[F2] Send" or "[F3] 
Recv" will prompt for a filename (must be an ASCII file, i.e., .DO).  In the 
case of receiving, the file must not already exist.  If it does, you will be 
asked if you want to erase it.  This is different from the Download routine, 
which will presumptuously erase your file without asking.  After this filename 
is entered, Send or Receive will automatically go on to completion or error, 
either of which beeps the buzzer.  In the case of error, it displays the cause 
of error and retry number (it trys up to 10 times).  After a successful tranfer
it returns to XMODEM terminal mode.

   NOTES:
            The Xmodem transfer can be used with any baud rate, word length, 
parity, number of stop bits, and flow control (XON/XOFF enabled or not) since 
it forces the setting to "x8N1D"(where 'x' is the baud rate [1-9 or M] you have
set) during the transfer, then restores your previous settings when finished or
aborted.  However, if the "RESET" button on the back of the model 100 is 
pressed during the transfer, the settings remain at "x8N1D".
    In this version, tranfer can be aborted by pressing control-X (CTRL and X 
together), which returns to XMODEM terminal mode without breaking the 
connection.  This does not, however, send the host a CTRL-X character, which it
should to signal the abort.  The transfer routine doesn't respond to the abort 
signal from the host except as a BAD HEADER, and must receive at least 10 to be
aborted.  Also, at the end of a tranfer, you make see some extraneous 
characters, or a truncated message from the host.  This is because the "send" 
or "receive OK" message is printed before the serial settings are restored and 
therefore XON/XOFF is still disabled, causing the loss of a few characters from
any post-transfer message the host may send.  Later versions should correct 
these oversights.



  Command Mode Function Keys:

   [F1] Find / search ADRS.DO for a number (see 'TELCOM' section of model 100 
operating manual)
   [F2] Call / dial a selected number, just as in TELCOM
   [F3] Stat / display or alter the serial port status
   [F4] File / displays the filename directory, as in BASIC
   [F5] Free / displays free RAM remaining, as in the MENU display
   [F6] is unused (suggestions ?)
   [F7] Term / switches to normal terminal emulation mode
   [F8] Menu / returns to the MENU


  Normal Terminal Mode Function Keys:

   [F1] Prev / displays the previous 8 lines (also XOFF's the reception, if 
enabled) until [F1] is pressed again
   [F2] Down / downloads just like "TELCOM"
   [F3]  Up  / uploads just like "TELCOM"
   [F4] Full or Half / toggles between full and half duplex  (remains in effect
in XMODEM terminal mode; see model 100 operating manual)
   [F5] Echo (or blank) / toggles the printer echoing on and off (remains in 
effect in XMODEM terminal mode)
   [F6] Wait (or blank)/ says 'Wait' when reception has been stopped by the 
host (see model 100 operating manual)
   [F7] Xmod / switches to XMODEM terminal mode (see below)
   [F8] Bye  / returns to command mode, 'Y' to confirm


  XMODEM Terminal Mode Function Keys:

   [F1] Prev / displays the previous 8 lines (also XOFF's the reception, if 
enabled) until [F1] is pressed again
   [F2] Send / sends a .DO file to the host, using XMODEM protocol, beginning 
by prompting for a filename (.DO ext may be left off)
   [F3] Recv / receives a .DO file from the host, using XMODEM protocol, 
beginning by prompting for a filename(.DO ext may be left off)
   [F4] File / displays the filename directory, as in BASIC
   [F5] Free / displays free RAM remaining, as in the MENU display
   [F6] Wait (or blank)/ says 'Wait' when reception has been stopped by the 
host (see model 100 operating manual)
   [F7] CRC or CkSm / toggles between CRC (cyclic redundancy check: a 
polynomial-generated 16-bit checksum) and regular checksum mode...overridden by
host request when sending XMODEM.
   [F8] Norm / returns to normal terminal emulation mode


   Please address any questions or reports of difficulties to:
     Phil Wheeler - PWHEELER

[Note: instructions are essentially those of John Chenoweth, the author of
the original XMD.CO, but the loading instructions have been modified to reflect
the use of a Basic loader instead of a Hex file converter.]