home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / modem / tandem31.arc / TANDEM.DOC < prev    next >
Text File  |  1988-04-13  |  39KB  |  1,108 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                     T A N D E M
  21.  
  22.                                      Rev. 3.1
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                        Copyright (C) 1988 - Louis E. Wheeler
  51.                                 All Rights Reserved
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.     
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.                                       WARRANTY
  79.  
  80.  
  81.  
  82.       The  TANDEM Remote System is warranted to be free from  copying  defects
  83.       when  shipped.   There are no other warranties,  expressed  or  implied,
  84.       including, but not limited to, any implied warranties of merchantability
  85.       or  fitness for any particular application.  In no event will  Louis  E.
  86.       Wheeler  be  liable  for consequential damages even if  advised  of  the
  87.       possibility of such damages.  This software has been thoroughly  tested,
  88.       but  there  may  be  bugs for which Louis  E.  Wheeler  cannot  be  held
  89.       responsible.  No liability or responsibility is assumed to the  customer
  90.       or  any other person or organization for any application or use of  this
  91.       software or documentation sold or distributed by Louis E. Wheeler or any
  92.       dealer.
  93.  
  94.  
  95.  
  96.  
  97.  
  98.                                     N O T I C E
  99.  
  100.  
  101.               THE TANDEM REMOTE SYSTEM IS NOT PUBLIC DOMAIN SOFTWARE
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.     
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                                Table of Contents
  136.  
  137.  
  138.                 The TANDEM Remote System . . . . . . . . .  1
  139.  
  140.                 Equipment Requirements . . . . . . . . . .  2
  141.                    Host Computer . . . . . . . . . . . . .  2
  142.                    Remote Computer . . . . . . . . . . . .  2
  143.                    Modem . . . . . . . . . . . . . . . . .  2
  144.                    Cables  . . . . . . . . . . . . . . . .  2
  145.  
  146.                 Getting Started  . . . . . . . . . . . . .  4
  147.  
  148.                 Passwords  . . . . . . . . . . . . . . . .  7
  149.  
  150.                 Operating TANDEM . . . . . . . . . . . . .  8
  151.                    From A "Remote" Location  . . . . . . .  8
  152.                       CLS  . . . . . . . . . . . . . . . .  9
  153.                       TYPE . . . . . . . . . . . . . . . .  9
  154.                       DOS  . . . . . . . . . . . . . . . .  9
  155.                       BYE  . . . . . . . . . . . . . . . .  9
  156.                       SHUTDOWN . . . . . . . . . . . . . .  9
  157.                    Extended Commands . . . . . . . . . . . 10
  158.                       LDIR . . . . . . . . . . . . . . . . 10
  159.                       LDOS . . . . . . . . . . . . . . . . 10
  160.                       CHAT . . . . . . . . . . . . . . . . 10
  161.                       SEND . . . . . . . . . . . . . . . . 10
  162.                    From The "Host" Console . . . . . . . . 12
  163.                    From A "Remote" Terminal  . . . . . . . 12
  164.                    When Directly Connected By Cable  . . . 12
  165.  
  166.                 Problem Programs . . . . . . . . . . . . . 13
  167.  
  168.                 In Case of Difficulty  . . . . . . . . . . 14
  169.  
  170.                 User Support   . . . . . . . . . . . . . . 15
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.     
  185.  
  186.  
  187.  
  188.  
  189.  
  190.                               The TANDEM Remote System
  191.  
  192.                                       Rev. 3.1
  193.  
  194.  
  195.  
  196.                    Tandem adj. 1: consisting of things or having
  197.                    parts arranged one behind the other  2: work-
  198.                    ing in conjunction with each other.
  199.                           -  Webster's New Collegiate Dictionary
  200.  
  201.  
  202.  
  203.  
  204.       Two  computers  linked together with the TANDEM Remote  System  work  in
  205.       conjunction   with   each  other.   Both  monitors  present   the   same
  206.       information, both keyboards can be used to run programs and enter  data.
  207.       The TANDEM Remote System does what most other modem programs cannot  do;
  208.       it  allows you to run virtually all PC-DOS software from a remote  site.
  209.       You  can even run those pesky programs that bypass the operating  system
  210.       and  write  directly  to the video memory.  TANDEM does  what  the  CTTY
  211.       command  and other modem program SHELL or GATEWAY commands promise,  but
  212.       fail to deliver.
  213.  
  214.       The TANDEM system is designed to operate with "Hayes" compatible modems,
  215.       or,  if you wish, two computers can be directly connected using  an  RS-
  216.       232C  "null modem" cable.  It is also possible to substitute  an  H/Z-19
  217.       terminal  for the "remote" computer, however, the number of  application
  218.       that can be operated from a terminal is limited.
  219.  
  220.       The  software  consists  of two separate  modules:  (1)  the  TANDEM.EXE
  221.       program that runs on the "host" computer, and (2) the TMODEM.EXE program
  222.       that  runs  on the "remote" computer.  It is the  "host"  computer  that
  223.       actually  executes  the application and updates the files,  your  office
  224.       computer  for  example.  At some "remote" location, say  your  home,  or
  225.       another  office, a second computer running the TMODEM.EXE  program  will
  226.       enable  to you to control the "host" computer almost as though you  were
  227.       actually sitting in front of the "host" console.
  228.  
  229.       However,  there are some limitations on what TANDEM can do.  Because  of
  230.       the relatively slow transfer of information from the host to the  remote
  231.       computer, it does not work well with programs that use animation.   And,
  232.       because  the  TMODEM.EXE  program is especially designed  to  work  with
  233.       TANDEM.EXE,  it  cannot be used as a general purpose  modem  program  to
  234.       access  bulletin  board systems (BBS), or  other  information  retrieval
  235.       services.
  236.  
  237.       The  following pages describe the operation of the TANDEM Remote  System
  238.       in detail.
  239.  
  240.  
  241.  
  242.  
  243.  
  244.                                       1
  245.     
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.                                      EQUIPMENT
  254.  
  255.  
  256.  
  257.       HOST COMPUTER
  258.  
  259.       The "host" is an IBM compatible computer with at least one serial  port,
  260.       either  COM1  or COM2 (or internal modem),  and at least 256K  bytes  of
  261.       memory,  640K  bytes is suggested.  Computers running at 4.77  MHz  will
  262.       work,  but  over  all performance is  greatly  enhanced  with  computers
  263.       running  at  6 MHz or faster.  Either color (CGA)  or  monochrome  (MDA)
  264.       video controller cards are acceptable.  Enhanced Graphics adapter  (EGA)
  265.       cards  will  work,  but programs must use the CGA  or  MDA  modes.   Any
  266.       monitor  (color or monochrome) compatible with the video controller  can
  267.       be  used.   A monitor with an integral power switch is  useful,  as  the
  268.       monitor  can  then  be  turned  off  when  the  host  computer  is  left
  269.       unattended.
  270.  
  271.  
  272.       REMOTE COMPUTER
  273.  
  274.       The "remote" is an IBM compatible computer or H/Z-19 terminal.  A remote
  275.       computer  should have at least 256K bytes of memory and one serial  port
  276.       (or internal modem).  Computers running at 4.77 MHz work just fine, even
  277.       small  portables can be used.  The video system can be either  color  or
  278.       monochrome.   Note  that  the "remote" computer  can  use  a  monochrome
  279.       monitor,  even  though the "host" computer uses color; the  opposite  is
  280.       also true.
  281.  
  282.  
  283.       MODEM
  284.  
  285.       A  "Hayes" compatible modem that uses the "AT" command set and  responds
  286.       with the standard Hayes command responses is required.  Modems operating
  287.       at 300-baud will work but the results may be disappointing.  A 1200-baud
  288.       modem  works well with most programs, but modems capable of even  higher
  289.       baud  rates  are useful when running some applications.   However,  some
  290.       computers  running at 4.77 MHz do not have the "horse power"  to  handle
  291.       modems running faster than 1200-baud.
  292.  
  293.  
  294.       CABLES
  295.  
  296.       Modem cables only need three signal lines, "hand shake" signals are  set
  297.       to  a  "high" state and then ignored.  RS-232C pin  connections  are  as
  298.       follows:
  299.                             Pin  Name      Signal
  300.                              2   TxD       Transmitted Data
  301.                              3   RxD       Received Data
  302.                              7   Gnd       Signal Ground
  303.  
  304.  
  305.  
  306.                                       2
  307.     
  308.  
  309.  
  310.  
  311.       RS-232C  cables  used for direct connection differ from  those  used  to
  312.       connect  a modem to a computer and are normally referred to as  a  "Null
  313.       Modem"  cable.  In this type of cable, pin 2 (Transmitted Data)  on  one
  314.       end of the cable is connected to pin 3 (Received Data) on the other  end
  315.       of the cable.  That is, pins 2 and 3 are cross connected.  Signal ground
  316.       is  connected to pin 7 on both ends of the cable.  TANDEM does  not  use
  317.       the "hand shake" signals and they may be left unconnected.
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.                                       3
  368.     
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.                                   GETTING STARTED
  376.  
  377.  
  378.  
  379.       We  suggest  that you first format two (2) diskettes.   Run  the  FORMAT
  380.       program  with  the /S option to produce a diskette  with  system  files.
  381.       Copy  your  original TANDEM diskette onto one of these  newly  formatted
  382.       diskettes  with  the  operating system COPY  command,  then  place  your
  383.       original  TANDEM  diskette in a place for safe keeping.   Next,  make  a
  384.       second copy of the TANDEM diskette from the copy you have just made.
  385.  
  386.       One  copy  of the TANDEM system is for use on the "host"  computer,  the
  387.       other  is for the "remote" computer.  Both of the diskettes  should  now
  388.       have the following files:
  389.  
  390.                           COMMAND.COM    Disk Operating System.
  391.                           TANDEM.EXE     The host program.
  392.                           TMODEM.EXE     The remote modem program.
  393.                           PASSWRDS.DAT   Sample pass word file.
  394.                           TANDEM.DOC     Instruction manual.
  395.                           READ.ME        A note to the user.
  396.  
  397.       If  you wish, you can delete TANDEM.DOC and the READ.ME files  from  the
  398.       diskettes  using the operating system DEL or ERASE commands.   Only  the
  399.       COMMAND.COM,  TANDEM.EXE,  and PASSWRDS.DAT files are required  for  the
  400.       host  (main  computer)  system.   Only COMMAND.COM  and  TMODEM.EXE  are
  401.       required  for  the  remote computer  system.   However,  creating  three
  402.       "batch"  files, an AUTOEXEC.BAT, HOST.BAT, and REMOTE.BAT, will make  it
  403.       even easier to start the TANDEM system and provide for an automatic  re-
  404.       start  in  case  of  a power failure when  the  host  computer  is  left
  405.       unattended.
  406.  
  407.       Before  creating the three "batch" files, some information is  required.
  408.       You will need to know:
  409.  
  410.            (1) the serial port number (COM1 or COM2) you are going to use on
  411.                the host and remote computers;
  412.            (2) the baud rate at which your modems, or serial ports, are going
  413.                to operate;
  414.            (3) whether the computers are to be connected by modems, or
  415.                directly connected with an RS-232C cable;
  416.            (4) if you are using a modem, the dialing method to be used (pulse
  417.                or tone);
  418.            (5) whether your remote is to be a computer running TMODEM or an
  419.                H/Z-19 terminal.
  420.  
  421.       Creation  of the "batch" files is optional, but you still need  to  know
  422.       the system configuration.  If you run TANDEM or TMODEM without supplying
  423.       this  information on the command line, you will be asked to  furnish  it
  424.       before  communication can be established between the two  computers  (or
  425.       host computer and terminal).
  426.  
  427.  
  428.  
  429.                                       4
  430.     
  431.  
  432.  
  433.  
  434.       The TANDEM command line is constructed as follows:
  435.  
  436.            d:>TANDEM port, baud-rate [,H] [,D]
  437.  
  438.                 port           Is the COM port number, 1 or 2.
  439.                 baud-rate      Is the baud rate at which the modem/port runs.
  440.                 H              The optional "H" indicates that the remote is
  441.                                an H/Z-19 terminal.  Default is a computer.
  442.                 D              The optional "D" indicates that the two
  443.                                computers are directly connected via cable.
  444.                                Default is a connection via modems.
  445.  
  446.       For  example, to invoke TANDEM from the operating system  prompt,  using
  447.       COM  port #2, at 1200-baud, with a remote computer, using a  modem,  the
  448.       command line would look like this:
  449.  
  450.            A:>TANDEM 2, 1200
  451.  
  452.       Using COM port #1, at 2400-baud, with an H-19 terminal, connected to the
  453.       serial port with an RS-232C cable would look like this:
  454.  
  455.            A:>TANDEM 1, 2400, H, D
  456.  
  457.       Note:  the spaces between parameters are optional, however,  the  commas
  458.       separating the fields are required.
  459.  
  460.  
  461.       The  TMODEM command line is similar to the TANDEM command line.   It  is
  462.       constructed as follows:
  463.  
  464.            d:>TMODEM  port, baud-rate [,P] [,D]
  465.  
  466.                 port            Is the serial port number.
  467.                 baud-rate       Is the baud rate of the serial port/modem.
  468.                 P               The optional "P" indicates that pulse
  469.                                 dialing rather than tone dialing is
  470.                                 to be used.  Default is tone dialing.
  471.                 D               The optional "D" indicates that the two
  472.                                 computers are directly connected via cable.
  473.                                 Default is a connection via modems.
  474.  
  475.       For example, using COM port #1, at 1200-baud, with tone dialing, via
  476.       modem:
  477.  
  478.            A:>TMODEM  1, 1200
  479.  
  480.       Using COM port #2, at 2400-baud, with pulse dialing:
  481.  
  482.            A:>TMODEM  2, 2400, P
  483.  
  484.       Using  COM port #1, at 9600-baud, directly connected via  RS-232C  cable
  485.       (Note: dialing method is not applicable when directly connected):
  486.  
  487.            A:>TMODEM  1, 9600, D
  488.  
  489.  
  490.  
  491.                                       5
  492.     
  493.  
  494.  
  495.  
  496.       As with the TANDEM example, spaces between parameters are optional,  but
  497.       commas are required to separate fields.
  498.  
  499.       Using  the same command line format, we can now generate a "batch"  file
  500.       called HOST.BAT.  This file can be created with an ASCII text editor  or
  501.       using  the operating system COPY command.  To create HOST.BAT using  the
  502.       COPY command, enter the following:
  503.  
  504.            A:>COPY CON: HOST.BAT
  505.            TANDEM  2, 1200, H, D
  506.            ^Z <RETURN>
  507.  
  508.       The symbol ^Z is entered by pressing the "Z" key while holding down  the
  509.       "Control"  key.  Refer to the DOS manual for additional  information  on
  510.       creating "batch" files using the COPY command.
  511.  
  512.       Using the same procedure, create a REMOTE.BAT file:
  513.  
  514.            A:>COPY CON: REMOTE.BAT
  515.            TMODEM  1, 1200, P
  516.            ^Z <RETURN>
  517.  
  518.       Having created the two "batch" files, we can now invoke TANDEM by simply
  519.       typing  HOST at the operating system prompt on the host computer.   And,
  520.       we can invoke TMODEM by typing REMOTE on the remote computer.
  521.  
  522.       On  the diskette you are going to be using on the host computer,  it  is
  523.       suggested  that  one  additional  "batch"  file  be  added.   Create  an
  524.       AUTOEXEC.BAT file as follows:
  525.  
  526.            A:>COPY CON: AUTOEXEC.BAT
  527.            SET COMSPEC=d:\path\COMMAND.COM
  528.            HOST
  529.            ^Z <RETURN>
  530.  
  531.       Note: "d:" is the disk drive specification, usually "A:" and "\path\" is
  532.       the  directory where COMMAND.COM will always be available.   FAILURE  TO
  533.       PROVIDE  A PATH TO COMMAND.COM WILL CAUSE TANDEM TO MALFUNCTION!   Refer
  534.       to your operating system manual for more information on the SET  COMSPEC
  535.       command.
  536.  
  537.       The  diskette  with  the AUTOEXEC.BAT file should be used  to  boot  the
  538.       TANDEM host computer system.  It should be left in the boot drive at all
  539.       times, especially when the host system is left unattended and there is a
  540.       chance  of  a power failure.  TANDEM does not, normally, write  on  this
  541.       diskette, therefore, it can be protected with a "protect tab."
  542.  
  543.       If  you wish, you may add additional commands to the AUTOEXEC.BAT  file.
  544.       For  example,  you  may wish to use one or more of  the  popular  memory
  545.       resident  programs.   Memory resident programs should be  loaded  before
  546.       TANDEM,  therefore,  they should be inserted in  the  AUTOEXEC.BAT  file
  547.       prior to the TANDEM command line.
  548.  
  549.  
  550.  
  551.  
  552.                                       6
  553.     
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.                                      PASSWORDS
  561.  
  562.  
  563.  
  564.       Passwords  are  used  to protect the  TANDEM  system  from  unauthorized
  565.       intrusion.   The  PASSWRDS.DAT  file  must be  present  when  TANDEM  is
  566.       started.  It contains a list of, up to ten, passwords that are  composed
  567.       of  any printable ASCII characters, one password per line.  All  of  the
  568.       following examples are valid passwords:
  569.  
  570.            John
  571.            JOHN
  572.            JOHN SMITH
  573.            1345-X-ROBERT
  574.  
  575.       When  you sign on the system, passwords must be entered exactly as  they
  576.       appear  in  the PASSWRDS.DAT file.  Capital letters must be  entered  as
  577.       capital letters, lower case letters must be entered in lower case.  Note
  578.       that  John, JOHN and JOHN SMITH are three different passwords  and  will
  579.       not  be  confused  by  TANDEM.  The space  between  JOHN  and  SMITH  is
  580.       considered to be a part of the password.
  581.  
  582.       The  PASSWRDS.DAT  file can be created using the operating  system  COPY
  583.       command,  or your favorite ASCII text editor.  WordStar  document  files
  584.       are  not  acceptable and will not work.  A sample PASSWRDS.DAT  file  is
  585.       included  on  your  distribution diskette as an example;  it  should  be
  586.       replaced with a list of passwords you invent.
  587.  
  588.       The  password  system works like this:  When you call the  host  system,
  589.       after  contact  is  established  between the  two  computers,  the  host
  590.       computer will request that you enter a password.
  591.  
  592.            PASSWORD: _
  593.  
  594.       Enter  one  of the passwords from the PASSWRDS.DAT file, followed  by  a
  595.       RETURN  (or  ENTER).  If you make a mistake (typing error),  the  system
  596.       will  respond  with  "TRY AGAIN".  You have three shots  at  getting  it
  597.       correct,  then you're out!  After the third attempt, TANDEM will  simply
  598.       hang  up the phone.  This should prevent unauthorized persons from  just
  599.       trying random words to get into your system.  If no characters are typed
  600.       for  20-seconds,  TANDEM  will assume no one is there and  hang  up  the
  601.       phone.
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.                                       7
  614.     
  615.  
  616.  
  617.  
  618.  
  619.  
  620.                                   OPERATING TANDEM
  621.  
  622.  
  623.  
  624.       FROM A "REMOTE" LOCATION
  625.  
  626.       First  boot  the  host  computer system  using  the  diskette  with  the
  627.       AUTOEXEC.BAT  and  HOST.BAT  files (see GETTING  STARTED),  or,  if  you
  628.       prefer,  just type TANDEM at the operating system prompt; you will  then
  629.       be  asked to furnish the missing parameters - COM port, baud rate,  etc.
  630.       The  TANDEM  program  will initialize the system and  then  display  the
  631.       selected configuration for a few seconds.  The monitor screen will  then
  632.       clear,  even the cursor will not be visible.  If you are going to  leave
  633.       the host system unattended and your monitor has a power switch, you  may
  634.       turn the monitor off.
  635.  
  636.       If  you  have booted the system with a floppy diskette, we  suggest  you
  637.       leave  this  diskette  in the drive.  If you  replace  it  with  another
  638.       diskette, the replacement must have a copy of COMMAND.COM on it, or  you
  639.       must provide the operating system with a path to COMMAND.COM, otherwise,
  640.       TANDEM will not function correctly.
  641.  
  642.       At  the  remote location, boot the remote computer and  run  the  REMOTE
  643.       command  (see  GETTING STARTED).  Or, you may just type  TMODEM  at  the
  644.       operating  system prompt; you will then be asked to furnish the  missing
  645.       parameters  - COM port, baud rate, etc.  The remote modem  program  will
  646.       then  ask  you to enter the phone number to be dialed.  The  number  you
  647.       enter  will be sent to the modem exactly as you enter it.  For  example,
  648.       if you enter: (229) 776-4321, then "(229) 776-4321" will be sent to your
  649.       modem.   Most modems accept the punctuation, check your modem manual  to
  650.       be  sure.   TMODEM  will  then wait for your modem  to  respond  with  a
  651.       "CONNECT" message.
  652.  
  653.       Sometimes,  because of noise on the phone lines, the  "CONNECT"  message
  654.       may  be  garbled.   If this happens, press  the ESCape  key,  enter  the
  655.       letter "C" and a RETURN.  This will force the TMODEM program to continue
  656.       as though the proper "CONNECT" message had been received from the modem.
  657.  
  658.       Pressing  the ESCape key before the modem responds with  "CONNECT"  will
  659.       cause  the phone to hang up.  You may enter another number,  or  re-dial
  660.       the same one by entering the letter "R" and a RETURN.
  661.  
  662.       To exit from TMODEM without establishing contact with the host computer,
  663.       you can press the ESCape key 4-times (your computer will "beep").
  664.  
  665.       Once  contact has been established with the host computer,  TANDEM  will
  666.       ask  for  a  "PASSWORD:", (see the section  on  PASSWORDS).   Enter  the
  667.       correct password and TANDEM will sign on with the "TANDEM:>" prompt.
  668.  
  669.       From the TANDEM:> prompt, there are a number of special TANDEM  commands
  670.       you  can  run.   Each of these commands is discussed  in  the  following
  671.       paragraphs:
  672.  
  673.  
  674.  
  675.                                       8
  676.     
  677.  
  678.  
  679.  
  680.       CLS - Clears the screen and re-displays the TANDEM:> prompt.
  681.  
  682.       DIR - Displays the current directory or you may specify a disk drive and
  683.       path  name.   For  example:  TANDEM:>DIR  B:\WORK\  would  display   the
  684.       directory for disk drive B:, subdirectory \WORK\.
  685.  
  686.       TYPE  -  Displays an ASCII text file on the screen, pausing  after  each
  687.       page.  You may specify a disk drive and path name, for example:
  688.  
  689.            TYPE B:\WORK\MYDATA.TXT
  690.  
  691.       This  would  display  the  MYDATA.TXT  file  found  on  disk  drive  B:,
  692.       subdirectory  \WORK\.  After each page of text is displayed,  press  the
  693.       ESCape key to terminate, or any other key to view the next page.
  694.  
  695.       DOS  - Takes you to the operating system prompt after loading  a  second
  696.       copy  of  COMMAND.COM into memory.  A message reminds you to  enter  the
  697.       EXIT  command  at the DOS prompt to return to the TANDEM:>  prompt,  you
  698.       must do so to sign off the system or use the TYPE command, etc.
  699.  
  700.       At the DOS prompt, you can issue any command and run almost any program.
  701.       There are, however, a few programs that will not run correctly, or  even
  702.       worse, lock up the system.  See the section on PROBLEM PROGRAMS.
  703.  
  704.       With the exception of two keys, the remote computer keyboard works  just
  705.       like  the  host  console keyboard.  The two  exceptions  are  the  BREAK
  706.       (CONTROL-SCROLL   LOCK),   and  SHIFT-PrintScreen  keys.    The   SHIFT-
  707.       PrintScreen  key  will  cause the monitor screen to be  printed  on  the
  708.       "remote"  computer's  printer, not the "host" computer's  printer.   The
  709.       BREAK key has no affect at all.  Because of this, programs that  require
  710.       the BREAK key to terminate should not be run from a remote site.
  711.  
  712.       When you are through with the DOS system, always return to the  TANDEM:>
  713.       prompt and issue a BYE or SHUTDOWN command.
  714.  
  715.       BYE  - Causes TANDEM to hang up the phone and recycle to await the  next
  716.       caller.  DO NOT FAIL TO RUN THE "BYE" COMMAND (or SHUTDOWN command,  see
  717.       below).   If you terminate the remote modem program without  giving  the
  718.       BYE command, your computer is left wide open to anyone who comes  along.
  719.       They won't even need a password!  The BYE command will cause the  remote
  720.       modem program to terminate.
  721.  
  722.       SHUTDOWN  -  This  command allows you to terminate TANDEM  on  the  host
  723.       computer from a remote location.  TANDEM will ask; "Are you sure ?",  if
  724.       you  answer  with  a  "Y"  for yes, TANDEM  will  close  down.   ONCE  A
  725.       "SHUTDOWN" COMMAND HAS BEEN EXECUTED, TANDEM CAN ONLY BE RESTARTED  FROM
  726.       THE  "HOST"  COMPUTER.  This command should only be given when  you  are
  727.       certain that no further calls will be made to the "host" computer.
  728.  
  729.       Normally,  either  the BYE or SHUTDOWN commands will  cause  the  TMODEM
  730.       program to exit to the operating system prompt.  If, for some reason, it
  731.       is  necessary to exit TMODEM without issuing BYE or SHUTDOWN, then  hold
  732.       down  the  ESCape key (or press it at least eight times),  the  computer
  733.       will beep several times before exiting....
  734.  
  735.  
  736.  
  737.                                       9
  738.     
  739.  
  740.  
  741.  
  742.       EXTENDED COMMANDS
  743.  
  744.       The  extended commands (LDIR, LDOS, CHAT, and SEND) are  available  only
  745.       with  the  extended version of the TANDEM Remote System.   The  extended
  746.       version  can  be identified by the letter "E" appended to  the  revision
  747.       number (e.g. Rev. 3.0E).  The following paragraphs discuss the operation
  748.       of the extended commands:
  749.  
  750.       LDIR  -  The LDIR command displays a directory of  the  remote  computer
  751.       system  disks, similar to the DIR command discussed above.  As with  the
  752.       DIR command, you may specify a disk drive and path name.  Note that this
  753.       directory information is not displayed on the host computer console.
  754.  
  755.       LDOS - Similar to the DOS command, the LDOS command allows you to access
  756.       the  remote  computer's  operating system - without  loosing  the  phone
  757.       connection.  A message reminds you not to forget to return and sign  off
  758.       the  system  when you are finished.  You return by typing  EXIT  at  the
  759.       operating  system  prompt.   The  LDOS command can  be  used  to  change
  760.       directories,  erase  files, rename files, etc.   The  information  being
  761.       displayed  on the remote computer's screen will not be displayed on  the
  762.       host computer's screen.
  763.  
  764.       CHAT - Switches you to the CHAT MODE and provides a clear screen so that
  765.       you  can communicate with someone at the host console  without  prompts,
  766.       beeps,  and  other things getting in your way.  You can  ring  the  bell
  767.       (beep) on the host computer by typing CONTROL-G (press the "G" key while
  768.       holding down the CONTROL key).  Similarly, the CONTROL-L key can be used
  769.       to clear the screen.  You exit the CHAT MODE by hitting the ESCape key.
  770.  
  771.       SEND - The SEND command is used to transfer files between the "host" and
  772.       "remote" computers.  The SEND command line is constructed as follows:
  773.  
  774.          TANDEM:>SEND direction d:\path\FILENAME.EXT [d:\path\FILENAME.EXT]
  775.  
  776.       The  "direction" parameter uses the symbol ">" to indicate "to," or  the
  777.       symbol  "<" to indicate "from."  One of these two symbols  coupled  with
  778.       the  word  "Host"  or "Remote" establishes the direction  in  which  the
  779.       specified file is to be transmitted.  If you wish, the words "Host"  and
  780.       "Remote" can be abbreviated to "H" and "R".  Therefore:
  781.  
  782.            >HOST indicates that the source file (see below) is to be
  783.                  sent from the "remote" computer to the "host computer.
  784.  
  785.            <REMOTE means exactly the same thing as ">HOST".
  786.  
  787.            >REMOTE indicates that the source file is to be sent from
  788.                    the "host" computer to the "remote" computer.  Just the
  789.                    opposite of the above two direction indicators.
  790.  
  791.            <HOST means exactly the same thing as ">REMOTE".
  792.  
  793.       The  next parameter is the "source" file name.  A disk drive letter  and
  794.       path name are optional, the file name and extension are required.  If no
  795.       drive  letter or path name is given, then the source file is assumed  to
  796.  
  797.  
  798.                                      10
  799.     
  800.  
  801.  
  802.       be on the currently logged disk drive and directory.
  803.  
  804.       The last parameter is optional; this is the "destination" file name.   A
  805.       disk  drive letter and path name are optional.  If the destination  file
  806.       name  is not specified, it is assumed to be identical with  source  file
  807.       name, including disk drive letter and path name.  Note: A file name must
  808.       be included with a disk drive letter and/or path name.
  809.  
  810.       Excepting  the added "direction" parameter, the SEND command works  very
  811.       much  like  the operating system COPY command.  For example, to  send  a
  812.       file  called  "MYSTUFF.DAT" on drive "B:" subdirectory "\WORK\"  on  the
  813.       remote computer to the host computer's drive "C:" subdirectory  "\TEXT\"
  814.       with the file name "YOURSTUF.DAT", you would enter the following:
  815.  
  816.            TANDEM:>SEND >HOST B:\WORK\MYSTUFF.DAT C:\TEXT\YOURSTUF.DAT
  817.  
  818.       If the transfer is to take place using the currently logged disk  drives
  819.       on both computers, and the source and destination files are to have  the
  820.       same names, all you need to enter would be the following:
  821.  
  822.            TANDEM:>SEND >HOST MYSTUFF.DAT
  823.  
  824.       This  would cause the file named "MYSTUFF.DAT" to be transmitted to  the
  825.       host  computer,  creating a copy of the original file  from  the  remote
  826.       computer.
  827.  
  828.       If  the destination file name is that of an existing file,  TANDEM  will
  829.       ask if you wish to erase the file.  Answer with a "Y" (for Yes) to erase
  830.       the existing file, or "N" (for No) to return to the TANDEM prompt.   The
  831.       ability  to erase (over write) and existing file on the remote  computer
  832.       is not permitted when the SEND command is issued from the host console.
  833.  
  834.       While  transmitting the specified file from one computer to  the  other,
  835.       the  following  status  information is displayed on both  the  host  and
  836.       remote  screens: transfer direction, source file name, destination  file
  837.       name,  the  number of 128-byte blocks to be sent, the number  of  blocks
  838.       transmitted,  the number of repeated transmissions required  because  of
  839.       errors  in  transmission, the starting time, and  upon  completion,  the
  840.       ending time.
  841.  
  842.       After  the file transfer is completed, aborted, or terminated due  to  a
  843.       problem that makes it impossible to continue, a final status message  is
  844.       displayed.   Normally, this will be FILE TRANSFERRED.  Press the  ESCape
  845.       key  to  return to the TANDEM prompt immediately.  If  you  do  nothing,
  846.       return to the TANDEM prompt is automatic after a few seconds.
  847.  
  848.       During  transmission of a file, the transfer can be aborted by  pressing
  849.       the  ESCape  key.  Appropriate messages will be displayed  on  the  "End
  850.       Status" message line.
  851.  
  852.       The  time  it takes to transfer a file from one computer  to  the  other
  853.       varies  due  to a number of factors; the serial  port/modem  speed,  the
  854.       quality  of  the transmission lines, and even the  computer's  operating
  855.       speed.  However, at 1200-baud, it takes slightly longer than  one-second
  856.       to transmit one 128-byte block of data.  At 300-baud it takes four times
  857.  
  858.  
  859.                                      11
  860.     
  861.  
  862.  
  863.       as long.  Therefore, to transfer an 128,000-byte file, with your  serial
  864.       port/modem running at 1200-baud, would take over 1,000-seconds or  about
  865.       17-minutes.
  866.  
  867.       FROM THE "HOST" CONSOLE
  868.  
  869.       After  starting TANDEM and the screen clears, you may still operate  the
  870.       host computer from the host console.  You do this by typing "LOCAL"  and
  871.       a RETURN on the host keyboard.
  872.  
  873.       TANDEM will, as it does for a remote call, ask for a PASSWORD:.  Enter a
  874.       valid  password and TANDEM will display the TANDEM:> prompt.   Operation
  875.       is  just as though you had called in from a remote location.  For  calls
  876.       to be accepted, you must sign off using the BYE command.
  877.  
  878.       The host computer keyboard is always active, even when a remote user  is
  879.       operating  the system.  This feature allows two people to run a  program
  880.       "in tandem."
  881.  
  882.  
  883.       FROM A "REMOTE" TERMINAL
  884.  
  885.       TANDEM can be operated using a remote H/Z-19 terminal instead of another
  886.       computer  running  TMODEM.  Note, the system must be started  using  the
  887.       command line "H" option.  Operation is essentially the same, except that
  888.       the terminal will only display the first 24-lines of data showing on the
  889.       host  monitor.   Also,  since the terminal keyboard does  not  have  the
  890.       ALTernate  key,  we have substituted combination of  ESCape,  CONTROL-{A
  891.       thru Z} to serve as ALTernate-{A thru Z}.  Even so, many programs cannot
  892.       be controlled from an H/Z-19 terminal because it has only eight function
  893.       keys and lacksther necessary features.
  894.  
  895.  
  896.       WHEN TWO COMPUTER ARE CONNECTED BY CABLE
  897.  
  898.       Two  computers can be directly connected by an RS-232C null modem  cable
  899.       (see  the section on EQUIPMENT).  Since no modems are involved,  dialing
  900.       the  phone  is not possible, in fact,  meaningless.   However,  password
  901.       checking  is still in force.  Otherwise, TANDEM operates exactly  as  it
  902.       does  through a modem and the phone lines.  You may, of course, use  one
  903.       of the higher baud rates.  Running at 2400-baud works very nicely, 9600-
  904.       baud is even better; however, some computers are incapable of supporting
  905.       9600-baud --- try it to determine if any problems exist.
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.                                      12
  921.     
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.                                   PROBLEM PROGRAMS
  929.  
  930.  
  931.  
  932.       Most  application  programs will run under TANDEM.  However,  there  are
  933.       some  exceptions, generally problem programs that fall into one or  more
  934.       of the following categories:
  935.  
  936.       1.  Programs  that use the same COM port that TANDEM is using,  such  as
  937.       another  modem program.  It is okay for a program to use one of the  COM
  938.       ports, so long as it is not the one TANDEM is using.
  939.  
  940.       2. Programs that assume direct (and absolute) control over the keyboard.
  941.       Few  programs do this.  The QuickBASIC compiler editor is an example  of
  942.       one  that  does.  The result is a locked remote system  ---  the  "host"
  943.       keyboard still operates, but the "remote" keyboard will not work.
  944.  
  945.       3. Programs that use dot graphics.  TANDEM does not support dot graphics
  946.       (character  graphics  are okay).  Running one of these  programs  causes
  947.       strange  things  to  happen  to the remote  screen.   Returning  to  the
  948.       operating system prompt clears the problem.
  949.  
  950.       4.  Programs that use animation may not work very well.  This is due  to
  951.       the relatively slow transmission of data from the host to the remote.
  952.  
  953.  
  954.       SOME PROGRAMS YOU SHOULD NOT RUN:
  955.  
  956.            The QuickBASIC compiler's editor (Microsoft, Inc)
  957.            SideKick (Borland Int)
  958.  
  959.  
  960.       SOME PROGRAMS THAT HAVE BEEN TESTED (and run okay):
  961.  
  962.            Microsoft's assembler, MASM  (Microsoft, Inc)
  963.            GW-BASIC  (Microsoft, Inc)
  964.            Turbo Pascal (Borland Int)
  965.            GALAXY  (OmniVerse)
  966.            PC-WRITE  (Quicksoft, Inc)
  967.            Right Hand Man (RHM)  (Red E Products, Inc)
  968.            POPALARM  (Bell Soft, Inc)
  969.            SDIR  (Public Domain)
  970.            PROCOMM  (Datastorm Technologies, Inc)
  971.            Z80MU  (Z-80 emulator) (Computerwise Consulting Services)
  972.            Utah FORTRAN  (Ellis Computing, Inc)
  973.            FORMAT, COPY, TREE, and other DOS commands.
  974.  
  975.  
  976.       Let  us know what programs you have ran successfully and we will  expand
  977.       this listing.
  978.  
  979.  
  980.  
  981.  
  982.  
  983.                                      13
  984.     
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.                                IN CASE OF DIFFICULTY
  992.  
  993.  
  994.  
  995.  
  996.       If  you have a problem with TANDEM, we suggest the following  points  to
  997.       check:
  998.  
  999.            1.  Check  the equipment.  Could be someone unplugged  the  RS-232C
  1000.       cable or something like that.
  1001.  
  1002.            2.  Is  your  modem  on the COM port you think  it  is?   Have  you
  1003.       selected the proper baud rate?
  1004.  
  1005.            3.  Recycle  your  equipment.   Some modems will  hang  up  for  no
  1006.       apparent reason, turning them off and on will clear things.
  1007.  
  1008.            4.  Is  the printer turned off?  Trying to print with it  off  will
  1009.       sometimes hang the system.
  1010.  
  1011.            5.  Are  there diskettes in all disk drives and the  doors  closed?
  1012.       Some systems will hang if you try to access a drive that can't run.
  1013.  
  1014.            6. From the remote system, it may appear at times that TANDEM  does
  1015.       some  strange  things  with the display screen.   This  usually  happens
  1016.       during  scrolling  of the screen or when menus pop-up.  Be  patient  and
  1017.       things will eventually settle down.
  1018.  
  1019.            7.  If  someone picks up a phone on the modem line,  the  resultant
  1020.       noise may cause the screen to blow up!  Exit the program you are running
  1021.       and issue a CLS command.
  1022.  
  1023.            8. If you should get an error message from TANDEM itself, we  don't
  1024.       think  it can happen, then TANDEM will do its best to lock  the  system.
  1025.       This has been done to prevent unauthorized access to your computer.
  1026.  
  1027.            9.  If  your problem is none of the above, take a few  moments  and
  1028.       drop  us a line.  Tell us what you were doing and what happened.   We'll
  1029.       do our best to help you solve the problem.
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.                                      14
  1045.     
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.                                     USER SUPPORT
  1053.  
  1054.  
  1055.  
  1056.  
  1057.       We know that The TANDEM Remote System is not perfect.  We will  continue
  1058.       to  work  to improve it, but we also need your help.   Your  suggestions
  1059.       steer  us  in the right direction and even help to  squash  those  nasty
  1060.       "bugs."
  1061.  
  1062.       If  you have a suggestion or a problem, let us hear from you.  Write  to
  1063.       the following address:
  1064.  
  1065.                                Louis  E. Wheeler
  1066.                                  P.O. Box 888
  1067.                                Oceano, CA  93445
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.                                      15
  1106.     
  1107.  
  1108.