home *** CD-ROM | disk | FTP | other *** search
/ AMOS PD CD / amospdcd.iso / transfer / twin / twindoc < prev    next >
Text File  |  1991-12-24  |  99KB  |  2,477 lines

  1.  
  2.             Twin Express                                       User's Guide
  3.  
  4.  
  5.  
  6.             
  7.             
  8.             
  9.             
  10.             
  11.             
  12.             
  13.             
  14.             
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                                           Twin Express 1.1 
  22.                                                               User's Guide 
  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.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.         Copyright 1991 OMNICODE. All rights reserved.
  59.  
  60.             Twin Express                                       User's Guide
  61.  
  62.  
  63.  
  64.                                             
  65.             
  66.             
  67.             Copyright:  This  document  and  its  accompanying software are
  68.             copyrighted  by  OMNICODE  (Montréal, CANADA) which retains all
  69.             rights  of  ownership  and  copyright.  Registered  users  have
  70.             specific  rights as stated in the license agreement. Others may
  71.             only  distribute  the  complete  package  as  described  in the
  72.             distribution statement.
  73.             
  74.             Disclaimer:  The  software, the documentation and all the files
  75.             included  in  the  package  are  provided without any warranty.
  76.             Moreover,  OMNICODE  does  not guarantee that the software, the
  77.             documentation  and  the files are accurate, reliable or fit any
  78.             particular  task. The users of this software package accept all
  79.             risks   related   to  its  use.  OMNICODE  shall  not  be  held
  80.             responsible  for any damage, costs or loss arising from the use
  81.             of this software package.
  82.             
  83.             Trademarks:  IBM,  IBM  AT,  IBM  PS/2,  PC-DOS  and  OS/2  are
  84.             registered   trademarks   of  International  Business  Machines
  85.             Corporation.  IBM PC and IBM XT are trademarks of International
  86.             Business   Machines   Corporation.   MS-DOS   is  a  registered
  87.             trademark  of  Microsoft Corporation. Windows is a trademark of
  88.             Microsoft  Corporation.  Amiga  is  a  registered  trademark of
  89.             Commodore-Amiga   Inc.   AmigaDOS   and   Amiga  Workbench  are
  90.             trademarks   of  Commodore-Amiga  Inc.  Unix  is  a  registered
  91.             trademark of AT&T Bell Laboratories.
  92.             
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                      II
  121.  
  122.             Twin Express                                       User's Guide
  123.  
  124.  
  125.  
  126.             
  127.                                    TABLE OF CONTENTS
  128.             
  129.             
  130.         INTRODUCTION................................................ IV
  131.             1 GETTING STARTED...........................................  1
  132.           1.1  Summary of Features..................................  1
  133.           1.2  Installation on the Amiga Computer...................  2
  134.           1.3  Installation on the IBM-PC Computer..................  3
  135.           1.4  The Serial Cable.....................................  4
  136.           1.5  Running Twin Express.................................  5
  137.           1.6  Of Ports and Baud Rates..............................  6
  138.           1.7  Startup Problems.....................................  6
  139.           1.8  Registration.........................................  8
  140.           1.9  Support..............................................  9
  141.         2 TUTORIAL.................................................. 10
  142.           2.1  Vocabulary........................................... 10
  143.           2.2  Purpose of a File Transfer Program................... 10
  144.           2.3  Commands and Aliases................................. 11
  145.           2.4  Local Versus Remote Resources........................ 11
  146.           2.5  Transferring Files with the COPY Command............. 12
  147.           2.6  Syntax of File and Directory Names................... 13
  148.           2.7  File Groups and Wildcards............................ 15
  149.           2.8  Moving Text Files to a Different Type of Computer.... 16
  150.           2.9  Enabling Fast Transfers.............................. 17
  151.           2.10 Input from a Command File............................ 18
  152.         3 COMMANDS.................................................. 19
  153.           3.1  CHDIR................................................ 19
  154.           3.2  COPY................................................. 20
  155.           3.3  DELETE............................................... 21
  156.           3.4  DIR.................................................. 21
  157.           3.5  ECHO................................................. 23
  158.           3.6  HELP................................................. 23
  159.           3.7  MKDIR................................................ 24
  160.           3.8  QUIT................................................. 24
  161.           3.9  RENAME............................................... 24
  162.           3.10 RMDIR................................................ 25
  163.           3.11 SET.................................................. 26
  164.           3.12 SHOW................................................. 26
  165.           3.13 TREE................................................. 27
  166.           3.14 TYPE................................................. 28
  167.         APPENDIX A: Error Messages.................................. A1
  168.         APPENDIX B: License Agreement............................... B1
  169.         APPENDIX C: Distribution Statement.......................... C1
  170.         APPENDIX D: Problem Report Form............................. D1
  171.         APPENDIX E: Registration and Order Form..................... E1
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.                                     III
  183.  
  184.             Twin Express                                       User's Guide
  185.  
  186.  
  187.  
  188.             
  189.                                       INTRODUCTION
  190.             
  191.             
  192.                     Twin  Express  is a file transfer program that allows a
  193.             user  to  quickly  transfer  files  between two computers via a
  194.             cable  connected  to  their  serial  ports. It is an attractive
  195.             solution  to  the  problem  of  transferring data to a computer
  196.             equipped  with  a  different  type  of  floppy  drive  or  to a
  197.             floppyless  workstation.  It is also an inexpensive alternative
  198.             to  those  time-consuming  exchanges  of  floppy disks and slow
  199.             communication programs.
  200.             
  201.                     Speed  is  its  main  feature.  Between  two  12.5  MHz
  202.             AT-type  computers or two Amiga 3000 computers you can transfer
  203.             data  at about 22,000 bytes/second. This is 2 times faster than
  204.             many  other  serial  file transfer utilities and 7 times faster
  205.             than utilities relying on the serial handler of AmigaDos.
  206.             
  207.                     Its  second  main  feature  is  its ability to exchange
  208.             files  between  different  types  of  computers (e.g. Amiga and
  209.             IBM-PC).  In  this  case,  it  may  even translate some special
  210.             characters  (e.g.  ±,  £, ½, ß, é, â, ï, ñ) in your text files.
  211.             As  of  December  1991,  the  program  runs  under AmigaDOS and
  212.             PC-DOS  (or MS-DOS). It can also execute as a DOS process under
  213.             Windows and OS/2.
  214.             
  215.                     Twin  Express  is  a  shareware  program.  That  is,  a
  216.             program  that  you  can  try before you actually pay for it. As
  217.             such,  you  can copy it, distribute it or store it in a library
  218.             as  long  as  the  package  is  not  modified, not sold and not
  219.             linked  to  any  salable  item.  However,  if  you  install the
  220.             program  on  a  computer  and  decide  to use it after the free
  221.             one-week  evaluation  period  you  must purchase a license from
  222.             OMNICODE.  In  return you become a registered user and are thus
  223.             entitled  to a manual, a diskette containing the latest version
  224.             of  Twin  Express,  an  invoice  (as  proof  of  purchase)  and
  225.             customer support in case of problems.
  226.             
  227.                    This   manual   describes   the  features,  installation
  228.             procedures  and  commands  of  Twin  Express.  The  tutorial in
  229.             chapter  2  shows some basic examples of Twin Express commands.
  230.             However,  if  you  just  cannot  wait  to get your hands on the
  231.             keyboard   you   may  want  to  proceed  with  the  information
  232.             available through the on-line HELP command.
  233.             
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.                                      IV
  245.  
  246.             Twin Express                                       User's Guide
  247.  
  248.  
  249.  
  250.             
  251.                                     GETTING STARTED
  252.             
  253.             
  254.                     This  chapter  describes the features, the installation
  255.             and  the  start-up  procedures  for Twin Express. Typical error
  256.             messages  plus  suggestions for solutions are outlined in order
  257.             to  help  you  establish  communications between the computers.
  258.             Registration and support sections terminate the chapter.
  259.             
  260.             1.1 SUMMARY OF FEATURES
  261.             
  262.                     This  section highlights the most important features of
  263.             Twin Express:
  264.             
  265.               1.  Fast  serial transfers: about 22,000 bytes/second between
  266.                   two  12.5  MHz  AT-type  computers or two Amiga computers
  267.                   (ram disk to remote ram disk transfers).
  268.             
  269.               2.  Compatible versions run under AmigaDOS and PC-DOS.
  270.             
  271.               3.  Translation  of text files when they are transferred to a
  272.                   different  type of computer (useful for transfers between
  273.                   Amiga and IBM-PC computers).
  274.             
  275.               4.  Simple,  easy  to  use  commands similar to those used by
  276.                   your operating system (e.g. DIR, COPY, RENAME, etc).
  277.             
  278.               5.  Command  name  aliases  compatible  with AmigaDOS, PC-DOS
  279.                   and UNIX commands (e.g. MAKEDIR, XCOPY, LS).
  280.             
  281.               6.  Support  for wildcard characters allowing users to select
  282.                   a  group  of  files  with a single command. The operation
  283.                   can    be    extended   to   include   files   found   in
  284.                   subdirectories.
  285.             
  286.               7.  User   may  list  directory  files,  change  the  default
  287.                   directories and create or remove directories.
  288.             
  289.               8.  Copies  of  files get the same date stamp as the original
  290.                   files.
  291.             
  292.               9.  On-line help.
  293.             
  294.               10. Support for command files (batch files).
  295.             
  296.               11. Transmission   errors  are  detected  and  corrected  (by
  297.                   retransmission of bad packets).
  298.             
  299.               12. Support  for ports COM1, COM2, COM3 or COM4 on the IBM-PC
  300.                   or compatible computers.
  301.             
  302.               13. Support  for  baud  rates  up  to  115200  on  IBM-PC  or
  303.                   compatible computers and 290000 on Amiga computers.
  304.  
  305.  
  306.                                       1
  307.  
  308.             Twin Express                                       User's Guide
  309.  
  310.  
  311.  
  312.             
  313.               14. Detection  of  busy ports, incompatible baud rates and of
  314.                   non-present,   non-standard   or  malfunctionning  serial
  315.                   ports.
  316.             
  317.               15. Distributed  as  a  shareware  program:  "you  can try it
  318.                   before you buy it".
  319.             
  320.             1.2 INSTALLATION ON THE AMIGA COMPUTER
  321.             
  322.             Requirements:
  323.             
  324.               1. AmigaDOS 1.2 or higher.
  325.               2. 75K of disk space.
  326.               3. 150K of free memory.
  327.               4. A null-modem cable.
  328.               5. A free serial port (SER: is mandatory).
  329.             
  330.             Distribution files:
  331.             
  332.               1. INSTALL
  333.               2. INSTALL.INFO
  334.               3. README
  335.               4. README.INFO
  336.               5. TWIN
  337.               6. TWIN.INFO
  338.               7. TWINDOC
  339.               8. TWINDOC.INFO
  340.             
  341.             Installation:
  342.             
  343.               1. If  your are using your Amiga with Workbench, activate the
  344.                  CLI task by clicking the appropriate icon.
  345.             
  346.               2. Set  the default directory to the directory containing the
  347.                  Twin  Express  package. The following example assumes this
  348.                  to be the root directory on floppy disk DF0:
  349.             
  350.                    CD  DF0:
  351.             
  352.               3. Examine file README for any last-minute changes:
  353.             
  354.                    TYPE  README
  355.             
  356.               4. Copy  the  file  TWIN to a directory whose name appears in
  357.                  the  search  path of AmigaDos (e.g. utilities, c, system).
  358.                  This  way  you can run Twin Express from any directory and
  359.                  AmigaDos  will  find  it.  You can use the PATH command to
  360.                  display  the  current  search  path. The following example
  361.                  assumes  that  the  UTILITIES  directory on disk DH0 is in
  362.                  the search path:
  363.             
  364.                    PATH
  365.                    COPY  TWIN  DH0:UTILITIES
  366.  
  367.  
  368.                                       2
  369.  
  370.             Twin Express                                       User's Guide
  371.  
  372.  
  373.  
  374.                    COPY  TWIN.INFO  DH0:UTILITIES
  375.             
  376.               5. Print the documentation file TWINDOC:
  377.             
  378.                    COPY  TWINDOC  PRT:
  379.             
  380.               6. Connect  one  end  of  a  null-modem cable to the standard
  381.                  serial  port  "SER:"  on  the Amiga and the other end to a
  382.                  serial  port  on  the remote computer. See section 1.4 for
  383.                  details about the serial cable.
  384.             
  385.               7. You  have  one  week  to  evaluate the program. After this
  386.                  period  you  must  either  remove  the  program  from your
  387.                  system or register your copy.
  388.             
  389.             1.3 INSTALLATION ON THE IBM-PC COMPUTER
  390.             
  391.             Requirements:
  392.             
  393.               1. PC-DOS (MS-DOS) 2.0 or higher.
  394.               2. 75K of disk space.
  395.               3. 150K of free memory.
  396.               4. A null-modem cable.
  397.               5. A free serial port (COM1, COM2, COM3 or COM4) with a ...
  398.                    a) standard address (3F8h, 2F8h, 3E8h or 2E8h).
  399.                    b) compatible UART chip (8250, 82050, 16450).
  400.                    c) standard UART clock of 1.8432 MHz.
  401.             
  402.             Distribution:
  403.             
  404.               1. INSTALL.TXT
  405.               2. README.TXT
  406.               3. TWIN.EXE
  407.               4. TWINDOC.TXT
  408.             
  409.             Installation:
  410.             
  411.               1. If  your are using your IBM-PC with Windows or OS/2, acti-
  412.                  vate  the  DOS  environment  by  clicking  the appropriate
  413.                  icon.
  414.             
  415.               2. Set  the default directory to the directory containing the
  416.                  Twin  Express  package. The following example assumes this
  417.                  to be the root directory on floppy disk A:
  418.             
  419.                    A:
  420.                    CD  \
  421.             
  422.               3. Examine file README.TXT for any last-minute changes:
  423.             
  424.                    TYPE  README.TXT
  425.             
  426.               4. Copy  the  file TWIN.EXE to a directory whose name appears
  427.                  in  the  search  path  of DOS (e.g. DOS, c, bin). This way
  428.  
  429.  
  430.                                       3
  431.  
  432.             Twin Express                                       User's Guide
  433.  
  434.  
  435.  
  436.                  you  can  run Twin Express from any directory and DOS will
  437.                  find  it.  You  can  use  the  PATH command to display the
  438.                  current  search  path.  The following example assumes that
  439.                  the DOS directory on disk C is in the search path:
  440.             
  441.                    PATH
  442.                    COPY  TWIN.EXE  C:\DOS
  443.             
  444.               5. Print the documentation file TWINDOC.TXT:
  445.             
  446.                   PRINT  TWINDOC.TXT
  447.             
  448.               6. Connect  one  end  of  a null-modem cable to a serial port
  449.                  (COM1  is used by default) on the IBM-PC and the other end
  450.                  to  a  serial port on the remote computer. See section 1.4
  451.                  for details about the serial cable.
  452.             
  453.               7. You  have  one  week  to  evaluate the program. After this
  454.                  period  you  must  either  remove  the  program  from your
  455.                  system or register your copy.
  456.             
  457.             1.4 THE SERIAL CABLE
  458.             
  459.                     A  null-modem  cable  connects  the  computers by their
  460.             serial  ports.  Such  a cable can be bought in a computer store
  461.             or  can  be  made  from an eight-wire cable and two connectors.
  462.             The  table  below  shows  how  the  different signals are wired
  463.             along   with   the  pinout  in  use  with  different  types  of
  464.             connectors (9 and 25 pins):
  465.             
  466.               ------ CONNECTOR 1 -----        ----- CONNECTOR 2 ------
  467.                 DB25     DB9    SIGNAL        SIGNAL    DB9     DB25
  468.             
  469.                  07       05       GND  <---> GND       05       07
  470.                  02       03        TD  <---> RD        02       03
  471.                  03       02        RD  <---> TD        03       02
  472.                  05       08       CTS  <---> RTS       07       04
  473.                  04       07       RTS  <---> CTS       08       05
  474.                  06       06       DSR  <---> DTR       04       20
  475.                  20       04       DTR  <---> DSR       06       06
  476.             
  477.             Usually  the serial port has a male connector. The cable should
  478.             therefore  have  two female connectors. However, it is safer to
  479.             verify this before you buy a cable...
  480.             
  481.                     There  are  some  null-modem  cables with only 3 wires.
  482.             These  cables  can  also be used with Twin Express. However, it
  483.             is  not  possible  to  select  the high speed transmission mode
  484.             with  such  cables.  There  are  also  null-modem cables with a
  485.             wiring  pattern  different  from  that in the above table. Twin
  486.             Express  is  likely  to  "see"  them  as  3-wire cables. So, be
  487.             careful  before buying a pre-wired cable and compare the wiring
  488.             with the above table.
  489.             
  490.  
  491.  
  492.                                       4
  493.  
  494.             Twin Express                                       User's Guide
  495.  
  496.  
  497.  
  498.                     You  can also transform a modem cable into a null-modem
  499.             cable  with  a  null-modem  adapter.  You  can  get  an MF-DB25
  500.             adapter  (part  26-1496) or an MF-DB9 adapter (part 26-264) for
  501.             about  8  CAN$  from  Radio  Shack.  This might be a convenient
  502.             solution  if  your  cable  has the proper connectors (usually a
  503.             female connector at each end).
  504.             
  505.             WARNING 1: Do   not   use  a  cable  with  more  than  these  7
  506.                        connections  (extra  wires  should be disconnected).
  507.                        This  is very important on the AMIGA computers since
  508.                        they have a non-standard serial connector.
  509.             
  510.             WARNING 2: Cables  longer  than  20  meters should be used with
  511.                        caution.  You  might need to reduce the baud rate or
  512.                        use a more expensive low capacitance cable.
  513.             
  514.             WARNING 3: Avoid  putting the cable near appliances. This could
  515.                        add  noise to the signals. If this cannot be avoided
  516.                        you  might consider buying a more expensive shielded
  517.                        cable.
  518.             
  519.             1.5 RUNNING TWIN EXPRESS
  520.             
  521.                     You  can  start  up  the  program by typing TWIN at the
  522.             system prompt of the computer:
  523.             
  524.               C> TWIN <enter>
  525.             
  526.             The  program  should  now  display  its version number, a short
  527.             message about the help facility and the TWIN prompt:
  528.             
  529.              TWIN EXPRESS - Version 1.1 released on 1991/12/20 (shareware)
  530.              ~~~~~~~~~~~~   Copyright 1991 OMNICODE. All rights reserved.
  531.             
  532.              HELP:
  533.             
  534.                ... Some information on HELP ...
  535.             
  536.              TWIN>
  537.             
  538.             At  this  point,  Twin  Express  waits  for the user to type in
  539.             commands or to receive a request from the remote computer.
  540.             
  541.                     If  Twin Express is also running on the remote computer
  542.             and  a  cable is connected to the default ports (COM1 on the PC
  543.             and  SER  on the Amiga) you should get the following message on
  544.             both screens:
  545.             
  546.              >>> Communication is established with the remote computer <<<
  547.             
  548.             This  message indicates that you are ready to transfer files to
  549.             the  remote  computer.  If  it does not appear see sections 1.6
  550.             and 1.7 for help.
  551.             
  552.  
  553.  
  554.                                       5
  555.  
  556.             Twin Express                                       User's Guide
  557.  
  558.  
  559.  
  560.             1.6 OF PORTS AND BAUD RATES
  561.             
  562.                     By  default,  Twin  Express uses port COM1 on an IBM PC
  563.             and  SER  on  an  Amiga. In both cases the default baud rate is
  564.             115200.
  565.             
  566.                     It  is  possible  to  use  baud  rates  other  than the
  567.             default  value  and, on IBM compatible computers, to use a port
  568.             other  than  COM1.  Ports COM1, COM2, COM3 and COM4 can be used
  569.             on  the  IBM  PC or compatible systems. Only SER can be used on
  570.             the Amiga.
  571.             
  572.                     The  baud rates available on both machines are: 115200,
  573.             57600,  38400,  19200  and 9600. The Amiga version also accepts
  574.             the  following  baud  rates:  130000,  150000,  170000, 190000,
  575.             210000,   230000,   250000,   270000   and  290000  (190000  is
  576.             recommended).
  577.             
  578.                     To   change  a default value, the user must supply both
  579.             the  port and the baud rate as parameters to TWIN. For example,
  580.             to  communicate  at  57600  baud  using  port  COM2  on the IBM
  581.             compatible:
  582.             
  583.               C> TWIN  COM2  57600
  584.             
  585.             whilst the command for the Amiga is:
  586.             
  587.               1> TWIN  SER  57600
  588.             
  589.             1.7 STARTUP PROBLEMS
  590.             
  591.                     This  section  highlights the most common problems that
  592.             a  user  might  encounter  in  establishing  communication.  It
  593.             presents  error messages along with suggestions for solving the
  594.             problem. More general errors are discussed in appendix A.
  595.             
  596.             >>> Communication is established with the remote computer <<<
  597.             does not appear on the screen of computers.
  598.             
  599.               First,  verify  that  the  cable  is  connected to the serial
  600.               ports  on both computers. Second, make sure that Twin Express
  601.               has  been activated on both machines with the proper port and
  602.               baud   rate.   Third,  check  the  programs  running  in  the
  603.               background.  Some  of them might "steal" too many CPU cycles.
  604.               Fourth,  examine  the  cable.  Is  it  a null-modem cable? Is
  605.               there a bad connection (connectors, wires, etc)?
  606.             
  607.             Error: Unrecognized device
  608.             
  609.               An  invalid  serial  device  has  been used as a parameter to
  610.               Twin  Express.  Re-execute  the program with one of the valid
  611.               devices specified in section 1.6.
  612.             
  613.             Error: Unrecognized speed
  614.  
  615.  
  616.                                       6
  617.  
  618.             Twin Express                                       User's Guide
  619.  
  620.  
  621.  
  622.             
  623.               An  invalid  baud  rate  has been specified as a parameter to
  624.               Twin  Express.  Note that you must also specify a device when
  625.               you  indicate a baud rate. Re-execute the program with one of
  626.               the valid baud rates specified in section 1.6.
  627.             
  628.             Error: Cannot get pathname of current default directory
  629.             Error: Cannot establish an abort receiver
  630.             
  631.               These  are  internal  errors.  They  should not occur. Please
  632.               contact  OMNICODE  (fill  in and mail the problem report form
  633.               in appendix D).
  634.             
  635.             Error: This protocol cannot be used with a 3-wire cable
  636.             
  637.               This  error  may  occur  when  a  user selects the high speed
  638.               transmission  mode  with  the  SET  MODE  command.  This mode
  639.               requires  a  7-wire  cable  as defined in section 1.4. First,
  640.               check  your  cable.  Second,  use only the STANDARD mode with
  641.               3-wire cables.
  642.             
  643.             Error: Mode EXPRESS failed to initialize properly
  644.             
  645.               This  error  may  occur  when  a  user selects the high speed
  646.               transmission  mode  with  the  SET MODE command. It indicates
  647.               that  transfers would not be reliable using this mode. It may
  648.               occur  on  some  computers,  especially  with long cables. In
  649.               this case you must use the default STANDARD mode.
  650.             
  651.             >>> Non-present or non-standard device <<<
  652.             
  653.               The  selected  serial port was not found in the system or, if
  654.               found,  it  does not appear to be a serial device. This error
  655.               may  occur if the user selects a device that is not installed
  656.               (e.g.  COM4), if a serial device has been installed at a non-
  657.               standard  address  (e.g. COM1 address different from 3F8h) or
  658.               if  a  different  type  of  hardware has been installed at an
  659.               address  normally  assigned to a serial device. First, try to
  660.               execute  Twin  Express  with  a different device (e.g. COM2).
  661.               Second,  check the address of your serial port and compare it
  662.               with the addresses defined in section 1.3.
  663.             
  664.             >>> Malfunctionning serial device <<<
  665.             
  666.               The  serial  device does not appear to work correctly. First,
  667.               verify  that  your serial port works with a different type of
  668.               software.  Second,  compare the type of the UART chip of your
  669.               serial port with those listed in the installation section.
  670.             
  671.             >>> Selected serial device appears to be busy <<<
  672.             
  673.               The  serial  port seems to be connected to an external device
  674.               (e.g.  modem,  printer). This error is likely to occur if you
  675.               execute  Twin  Express with the default port and this port is
  676.  
  677.  
  678.                                       7
  679.  
  680.             Twin Express                                       User's Guide
  681.  
  682.  
  683.  
  684.               connected  to a device. It may also occur if you disconnected
  685.               an  external  device  from  a serial port in order to connect
  686.               the  null-modem  cable.  First,  make  sure  to  execute Twin
  687.               Express  with  the  appropriate  serial  port. Second, if the
  688.               message   appears  only  on  one  computer,  re-execute  Twin
  689.               Express  on  this  computer otherwise you will need to reboot
  690.               both systems.
  691.             
  692.             >>> Local computer is too slow for current baud rate <<<
  693.             >>> Remote computer is too slow for current baud rate <<<
  694.             
  695.               These  messages  indicate  that a computer is not fast enough
  696.               to  communicate at the current baud rate. It may occur if you
  697.               try  to  execute  Twin  Express  on  an  Amiga  500/1000/2000
  698.               computer  with  a baud rate exceeding 190000 or on a 4.77 MHz
  699.               PC-type  computer  with a baud rate of 115200. Try again with
  700.               a lower baud rate.
  701.             
  702.             >>> Remote computer appears to use a different baud rate <<<
  703.             
  704.               This  message  is  displayed  when  a  computer receives many
  705.               unrecognized  characters  from  the  serial  port. It usually
  706.               occurs  when  the  program is activated with a different baud
  707.               rate  on  each  computer.  Note  that  this  error is usually
  708.               displayed  on  the  screen of the computer having the fastest
  709.               baud  rate.  It  may  also  occur if you use a high baud rate
  710.               (e.g.  290000)  with a long cable or if your serial port does
  711.               not  use  a  standard  clock  rate.  First,  re-execute  both
  712.               programs  with  the same baud rate. Second, try to reduce the
  713.               baud  rate on the machine that does show this message. Third,
  714.               try  with  a  lower baud rate (e.g. 57600). Fourth, make sure
  715.               that  you  use  the  serial ports connected to the null-modem
  716.               cable.  Fifth,  compare  the  clock  rate of your serial port
  717.               with the value found in the installation section.
  718.             
  719.             1.8 REGISTRATION
  720.             
  721.                     Twin  Express  is  a  shareware package. It is not free
  722.             software  nor  public domain software. The main difference here
  723.             is  that  you  must  purchase  a  license  to  use  it after an
  724.             evaluation  period.  Note that the cost of the license is never
  725.             included   in  the  price  of  disks  from  public  domain  and
  726.             shareware software distributors. 
  727.             
  728.                      The  package  contains  files  that  can be evaluated,
  729.             free  of  charge,  during  a one-week period. During this week,
  730.             you  can  test the program and examine the documentation. After
  731.             this  period,  you  must decide if you want to keep the program
  732.             or  not.  If the product is found to be not useful, the package
  733.             must  be  removed from the system. However, if you do decide to
  734.             keep  it,  you  must  become  a registered user by purchasing a
  735.             license from OMNICODE.
  736.             
  737.                      The  cost  of  a  basic license for two machines is 30
  738.  
  739.  
  740.                                       8
  741.  
  742.             Twin Express                                       User's Guide
  743.  
  744.  
  745.  
  746.             CAN$  (including  Canadian taxes where applicable). Add to this
  747.             an  extra  fee  of 10 CAN$ for each additional machine. If Twin
  748.             Express  is  to  be  installed  on  a  server,  you will need a
  749.             license  for  every  computer  that can access the program from
  750.             the   server.  Upon  registration,  you  receive  a  manual,  a
  751.             diskette  containing  the  latest  version  of Twin Express, an
  752.             invoice  (as  proof  of  purchase)  and support for 6 months in
  753.             case  of problems. The registration and order form can be found
  754.             in appendix E.
  755.             
  756.             1.9 CUSTOMER SUPPORT
  757.             
  758.                     You  might  experience problems with the program or the
  759.             documentation  or  you  might  just  want  to obtain the latest
  760.             release.  Registered  users  can  contact OMNICODE to get help.
  761.             Just send a letter or a FAX to:
  762.             
  763.                                OMNICODE
  764.                                P.O. Box 128 Ahuntsic
  765.                                Montréal [Québec]
  766.                                CANADA H3L 3N7
  767.             
  768.                                FAX: (514)385-6455
  769.             
  770.             You  will  find  a problem report form in appendix D to be used
  771.             in  describing  your  problems and for making suggestions. Fill
  772.             in the form in appendix E in order to get the latest update.
  773.             
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.                                       9
  803.  
  804.             Twin Express                                       User's Guide
  805.  
  806.  
  807.  
  808.             
  809.                                        TUTORIAL
  810.             
  811.             
  812.                     This  chapter  introduces the new user to Twin Express.
  813.             The  experienced  user  is  referred  to  chapter  3  for  more
  814.             detailed information.
  815.             
  816.                     We   assume   here   that  the  installation  has  been
  817.             completed  and  that  a  cable  is  connected  between  the two
  818.             computers running Twin Express.
  819.             
  820.             2.1 VOCABULARY
  821.             
  822.                     D.O.S.  means  Disk  Operating  System. Throughout this
  823.             manual,  this  term  is  used  without designating a particular
  824.             implementation of this software (e.g. PC-DOS, UNIX).
  825.             
  826.                     A  null-modem  cable  is  a  cable that connects to the
  827.             serial  ports of two computers. This is not the same as a modem
  828.             cable (the wiring is different).
  829.             
  830.                     Serial  transfers  means  data transmission between two
  831.             computers by their serial devices through a null-modem cable.
  832.             
  833.                     Remote  system  indicates  the  computer  to which your
  834.             computer   (known   as  the  local  system)  is  connected.  By
  835.             extension,  remote  files,  remote directories, remote volumes,
  836.             remote   devices   and   remote   resources   indicates  files,
  837.             directories,  volumes,  devices  and  resources  located on the
  838.             remote system.
  839.             
  840.                     A  volume  is  a  structured  group  of directories and
  841.             files,  sometimes  called a file system, installed on a disk, a
  842.             disk partition or in a dedicated area of the main memory.
  843.             
  844.             2.2 PURPOSE OF A FILE TRANSFER PROGRAM
  845.             
  846.                     The  purpose  of a file transfer program is to transfer
  847.             files  between  two  computers.  It  allows  a user to exchange
  848.             files   between   computers  equipped  with  floppy  drives  of
  849.             different   sizes  or  to  exchange  files  with  a  floppyless
  850.             computer.  It  performs  this  job better than a communications
  851.             program  since  it  is usually much faster and adapted for this
  852.             task.  Finally,  it  is  also  simpler  and faster then using a
  853.             floppy  disk  to  transfer  files between the hard disks of two
  854.             computers  (especially  when  the size of a file is larger than
  855.             the capacity of the floppy disk).
  856.             
  857.                     A  file  transfer  program  needs  a  link  between the
  858.             computers  involved  in  these  transfers.  This can be done by
  859.             connecting  a  cable  to a serial port on each computer. Such a
  860.             port  works  with  fairly long cables, provides some protection
  861.             against noise and is inexpensive.
  862.  
  863.  
  864.                                      10
  865.  
  866.         Twin Express                                       User's Guide
  867.  
  868.  
  869.  
  870.             
  871.             2.3 COMMANDS AND ALIASES
  872.             
  873.                     The   user   interacts  with  Twin  Express  by  typing
  874.             commands  that  have  a  name  similar  to the commands of your
  875.             D.O.S.  For  example,  to  get  a list of the files kept in the
  876.             local current directory:
  877.             
  878.               TWIN> DIR <enter>
  879.             
  880.             The full set of commands is given in the table below:
  881.             
  882.               DIR    : Shows file(s) in a directory.
  883.               CHDIR  : Changes the default directory.
  884.               MKDIR  : Creates a directory.
  885.               RMDIR  : Removes a directory.
  886.               TREE   : Shows directory structure.
  887.               COPY   : Makes a copy of file(s).
  888.               DELETE : Deletes file(s).
  889.               RENAME : Changes the name of file(s).
  890.               TYPE   : Shows the contents of a text file.
  891.               HELP   : Provides help on Twin Express.
  892.               SET    : Changes the transmission mode.
  893.               SHOW   : Displays various information.
  894.               ECHO   : Outputs a string on the console.
  895.               QUIT   : Exits from Twin Express.
  896.             
  897.                     In  order  to  assist  the  users  who  transfer  files
  898.             between  systems  having  two  different  D.O.S.,  Twin Express
  899.             accepts  popular  aliases  for some commands and options. These
  900.             aliases are shown in the table below:
  901.             
  902.               DIR     : LIST, LS
  903.               CHDIR   : CD
  904.               MKDIR   : MD, MAKEDIR
  905.               RMDIR   : RD
  906.               COPY    : XCOPY, CP
  907.               DELETE  : DEL, ERASE, RM
  908.               RENAME  : REN, MV
  909.               TYPE    : MORE, CAT, DISPLAY
  910.               HELP    : ?
  911.               QUIT    : EXIT
  912.             
  913.               SUBDIR  : ALL, /S
  914.             
  915.             This  feature should help those who are used to PC-DOS, MS-DOS,
  916.             AmigaDOS  or  UNIX.  However,  Twin Express commands have their
  917.             own  behavior  and  options.  Therefore, they may not recognize
  918.             certain  options  or perform exactly like their counterparts in
  919.             these operating systems.
  920.             
  921.             2.4 LOCAL VERSUS REMOTE RESOURCES
  922.  
  923.  
  924.  
  925.  
  926.                                      11
  927.  
  928.             Twin Express                                       User's Guide
  929.  
  930.  
  931.  
  932.             
  933.                     All   the   commands   related  to  file  or  directory
  934.             operations  can  work  on  local  or  remote  resources.  These
  935.             resources may be: files, directories, volumes and devices.
  936.             
  937.                     Accessing  a local resource is simple. You just specify
  938.             the  name  of  the  resource  in  your command. For example, to
  939.             delete the local file OLDDEMO.C:
  940.             
  941.               TWIN> DELETE  OLDDEMO.C
  942.             
  943.             Unless  otherwise  specified,  Twin  Express  always uses local
  944.             resources.  In the example above, the program deletes the local
  945.             file  OLDDEMO.C  from  the  local default directory. You always
  946.             have  access  to  the  local resources even if no communication
  947.             has been established with a remote computer.
  948.             
  949.                     Accessing  a  remote resource is simple too! This time,
  950.             the  name  of  the  resource  must have a ~ prefix (tilde). For
  951.             example, to delete the remote file OLDDEMO.C:
  952.             
  953.               TWIN> DELETE  ~OLDDEMO.C
  954.             
  955.             In  this case, the request is sent to the remote computer where
  956.             it   is  executed.  In  the  example  above,  the  remote  file
  957.             OLDDEMO.C   is  deleted  from  the  remote  default  directory.
  958.             Communication  must  have been established with a remote system
  959.             before you can use commands specifying remote resources.
  960.             
  961.                     The  procedure  is the same with all the commands. Twin
  962.             Express  uses  a remote resource if the name has a ~ prefix and
  963.             a  local  resource  otherwise.  The commands themselves are the
  964.             same  for both the local and the remote operations. Note: there
  965.             must  be  no  space  between  the  ~ prefix and the name of the
  966.             resource.
  967.             
  968.             2.5 TRANSFERRING FILES WITH THE COPY COMMAND
  969.             
  970.                     The  main purpose of a file transfer program is to copy
  971.             files  from one computer to another. With Twin Express, this is
  972.             done by the COPY command.
  973.             
  974.                     This  command  can  work  with  both  local  and remote
  975.             files.  To  copy  a  file  between  two  computers it is just a
  976.             matter  of  using a local name and a remote name.  For example,
  977.             to  copy  the  local file ALPHA to the file Bravo on the remote
  978.             computer:
  979.             
  980.               TWIN> COPY  ALPHA  ~Bravo
  981.             
  982.             This  command actually transfers a copy of the local file ALPHA
  983.             to  the  remote  system  since  the ~ prefix specifies a remote
  984.             file.  The  new  file  is  stored  as  file Bravo in the remote
  985.             default   directory.  Note:  whenever  possible,  Twin  Express
  986.  
  987.  
  988.                                      12
  989.  
  990.             Twin Express                                       User's Guide
  991.  
  992.  
  993.  
  994.             preserves lower case letters used in file and directory names.
  995.             
  996.                     The  target  name  of the COPY command can be a device.
  997.             For  example,  to print the local file README.DOC, you can copy
  998.             it to the remote printer PRT:
  999.             
  1000.               TWIN> COPY  README.DOC  ~PRT:
  1001.             
  1002.             The  following  devices  are  available  on the Amiga computer:
  1003.             CON:,  PRT: and NIL:. SER: can also be used locally if the port
  1004.             is  not  connected  to a remote computer. The following devices
  1005.             are  available  on  the  IBM-PC  or  compatible  systems: CON:,
  1006.             COM1:, COM2:, LPT1:, LPT2:, LPT3:, PRN: and NUL:.
  1007.             
  1008.                     Of  course, you can also copy a remote resource to your
  1009.             local  system.  For example, to copy the remote file CHARLIE to
  1010.             the local file DELTA:
  1011.             
  1012.               TWIN> COPY  ~CHARLIE  DELTA
  1013.             
  1014.             This  time,  a copy of the file CHARLIE is transferred from the
  1015.             remote  to  the local system. The command is the same as before
  1016.             but the remote resource is now the source file.
  1017.             
  1018.                      The  source  file and the destination file may also be
  1019.             located  on  the  same computer. For example, to copy the local
  1020.             file ALPHA to the local file BRAVO:
  1021.             
  1022.               TWIN> COPY  ALPHA  BRAVO
  1023.             
  1024.             No  transfer  occurred  between  the  computers,  in this case,
  1025.             because  both  names  specified  local files. A remote copy can
  1026.             also  be  done if both names specify remote files. For example,
  1027.             to copy the remote file CHARLIE to the remote file DELTA:
  1028.             
  1029.               TWIN> COPY  ~CHARLIE  ~DELTA
  1030.             
  1031.             With  such  an  operation,  the  request  is sent to the remote
  1032.             system  where  it  is  executed locally. This kind of operation
  1033.             can  be useful if you have to perform some disk management on a
  1034.             distant remote system.
  1035.             
  1036.                     The  thing  to  remember  here:  COPY always performs a
  1037.             file  transfer whenever one name specifies a local resource and
  1038.             the  other  name  a  remote  resource. Otherwise, it is a plain
  1039.             copy.
  1040.             
  1041.             2.6 SYNTAX OF FILE AND DIRECTORY NAMES
  1042.             
  1043.                     By  using  only  simple  file  names, like CHESS.C, the
  1044.             user  can access only the files in the local and remote default
  1045.             directories.  These  directories  correspond to the directories
  1046.             in  use  on  the  local and remote system when Twin Express was
  1047.             activated.
  1048.  
  1049.  
  1050.                                      13
  1051.  
  1052.             Twin Express                                       User's Guide
  1053.  
  1054.  
  1055.  
  1056.             
  1057.                     Twin  Express  also  accepts  file names that specify a
  1058.             path  to  reach  the selected file or directory. Such names are
  1059.             often  called  pathnames.  The  path  may contain a volume name
  1060.             and/or directory names.
  1061.             
  1062.                     Directory  and file names must be separated by either /
  1063.             (slashes)  or  \  (back-slashes).  For  example, to delete file
  1064.             CHESS.C from subdirectory SOURCES in subdirectory GAMES:
  1065.             
  1066.               TWIN> DELETE  GAMES/SOURCES/CHESS.C               or
  1067.               TWIN> DELETE  GAMES\SOURCES\CHESS.C
  1068.             
  1069.             The  choice  between  / and \ is yours; you can use both on all
  1070.             the  systems. To specify the root directory (the main directory
  1071.             on  a  volume)  you can use, as well, the slash, the back-slash
  1072.             or  the  colon.  For  example:  to  change  the  local  default
  1073.             directory to the root directory of the current volume:
  1074.             
  1075.               TWIN> CHDIR  /                                    or
  1076.               TWIN> CHDIR  \                                    or
  1077.               TWIN> CHDIR  :
  1078.             
  1079.             However,  a path may start with a volume name. This name may be
  1080.             the   physical   name  of  a  disk  (e.g.  DH0,  E)  or,  where
  1081.             applicable,  the  volume  name  specified during a disk format.
  1082.             When  a  volume  name  is included in a path, this name must be
  1083.             followed  by a colon. For example, to remove directory TRASH on
  1084.             remote volume DH0:
  1085.             
  1086.               TWIN> RMDIR  ~DH0:TRASH
  1087.             
  1088.             A  volume  name  also  forces  the  path  to  start at the root
  1089.             directory  of  this  volume.  Note:  this behavior is different
  1090.             from  PC-DOS  and  MS-DOS  where the path starts at the current
  1091.             default  directory (unless a \ is used). Actually, Twin Express
  1092.             accepts  all  the  following  pathnames  to reach the directory
  1093.             DEMOS on volume C:
  1094.             
  1095.               TWIN> CHDIR  C:/DEMOS
  1096.               TWIN> CHDIR  C:\DEMOS
  1097.               TWIN> CHDIR  C:DEMOS
  1098.               TWIN> CHDIR  :/DEMOS
  1099.               TWIN> CHDIR  :\DEMOS
  1100.               TWIN> CHDIR  /DEMOS
  1101.               TWIN> CHDIR  \DEMOS
  1102.               TWIN> CHDIR  :DEMOS
  1103.             
  1104.             The  last  five  commands above assume that the directory DEMOS
  1105.             is  on  the  current default volume. Again, you have the choice
  1106.             of  selecting  the  pathname syntax that most resembles that of
  1107.             your  system  even  when you transfer files to/from a different
  1108.             D.O.S.
  1109.             
  1110.  
  1111.  
  1112.                                      14
  1113.  
  1114.             Twin Express                                       User's Guide
  1115.  
  1116.  
  1117.  
  1118.             2.7 FILE GROUPS AND WILDCARDS
  1119.             
  1120.                     Quite  often,  the user needs to transfer more than one
  1121.             file:  it  may  be all the files in a directory, C source files
  1122.             or  only  the  files  having  a  name starting with HOTEL. Some
  1123.             commands  (DIR,  COPY,  DELETE and RENAME) accept the popular *
  1124.             and  ?  wildcard  characters  in  order  to  specify a group of
  1125.             files.
  1126.             
  1127.                     The  ?  wildcard character matches any single character
  1128.             in  a  file name. For example, to list all the four-letter file
  1129.             names starting with L and ending with MA:
  1130.             
  1131.               TWIN> DIR  L?MA
  1132.             
  1133.             The  * wildcard character matches any number of characters in a
  1134.             file  name.  For  example,  to delete all the files ending with
  1135.             .BAK:
  1136.             
  1137.               TWIN> DELETE  *.BAK
  1138.             
  1139.             Twin  Express  also  lets  you specify the variable part of the
  1140.             file  name  with  a selection from a set of substrings. In this
  1141.             case,  the  substrings  are separated by | and the complete set
  1142.             is  enclosed  by (). For example, to list the .C files starting
  1143.             with TWIN and ending with either HOST, COMM or MAIN:
  1144.             
  1145.                TWIN> DIR  TWIN(HOST|COMM|MAIN).C
  1146.             
  1147.             Of  course  the  selection can be combined with wildcards; this
  1148.             can  be  quite  powerful.  For example, to delete all the files
  1149.             ending with .LST, .MAP or .BAK:
  1150.             
  1151.               TWIN> DELETE  *.(LST|MAP|BAK)
  1152.             
  1153.             However,  the  selection and wildcards can be used only in file
  1154.             names.  They  cannot  be  used  in  a path (i.e. volume name or
  1155.             directory name).
  1156.             
  1157.                     The  * wildcard character, alone, can also be used in a
  1158.             target  name.  For example, to copy all the .EXE files from the
  1159.             local subdirectory PROJECTS to the remote subdirectory TESTS:
  1160.             
  1161.               TWIN> COPY  PROJECTS/*.EXE  ~TESTS/*              or
  1162.               TWIN> COPY  PROJECTS/*.EXE  ~TESTS
  1163.             
  1164.             As  shown  above,  the  * wildcard character in the target name
  1165.             matches  the  corresponding files of the source name. Actually,
  1166.             this   is   equivalent  to  the  second  command  which  simply
  1167.             specifies  the  target  directory.  However,  when  the  target
  1168.             directory  is  a  default  directory,  the * wildcard character
  1169.             reduces  the number of characters to type. For example, to copy
  1170.             the local file CHESS.C to the remote default directory:
  1171.             
  1172.  
  1173.  
  1174.                                      15
  1175.  
  1176.             Twin Express                                       User's Guide
  1177.  
  1178.  
  1179.  
  1180.               TWIN> COPY  CHESS.C  ~*
  1181.             
  1182.                     It  may  be  useful  to abort a command when a group of
  1183.             files  is  specified.  This  may  occur,  for example, when you
  1184.             delete,  by  error, the wrong group of files! In this case, the
  1185.             command may be aborted by typing <CTRL-C>.
  1186.             
  1187.             2.8 MOVING TEXT FILES TO A DIFFERENT TYPE OF COMPUTER
  1188.             
  1189.                     An  important feature of Twin Express is its ability to
  1190.             transfer  files  between  different  types  of  computers (e.g.
  1191.             between  Amiga  and  IBM-PC  computers).  This is of particular
  1192.             interest  for  text files since binary files containing data or
  1193.             programs  are  almost  useless on a different type of computer.
  1194.             Text  files  contain  printable  characters.  They  are used to
  1195.             store letters, documents, ASCII data and source programs.
  1196.             
  1197.                     Unfortunately,  each  computer  has  its  own  internal
  1198.             organization  for  text  files. The end-of-line marker, end-of-
  1199.             file  marker  and  the  coding of special characters may change
  1200.             from one computer to another.
  1201.             
  1202.                     At  this  time, Twin Express handles the translation of
  1203.             the  end-of-line  marker,  the  end-of-file  marker and 50 non-
  1204.             standard  characters  common  to  both Amiga and IBM compatible
  1205.             computers.   The   changes   are  described  in  the  following
  1206.             paragraphs:
  1207.             
  1208.               1. The  end-of-line  marker  is  translated  between  NL (new
  1209.                  line)  on  the  Amiga  and  CR/LF  (carriage return / line
  1210.                  feed) on the IBM-PC or compatible computers.
  1211.             
  1212.               2. A  <CTRL-Z>  marker  is  appended  to  the end of all text
  1213.                  files  on  IBM-PC  or  compatible  computers.  Note:  this
  1214.                  marker  is  added  even  if the marker is missing from the
  1215.                  source file.
  1216.             
  1217.               3. The  Amiga  and IBM-PC machines share 50 characters having
  1218.                  the   same   typeface  but  a  different  code.  A  simple
  1219.                  translation  is  done  in this case. These characters are:
  1220.                  á,  à,  â, ä, é, è, ê, ë, í, ì, î, ï, ó, ò, ô, ö, ú, ù, û,
  1221.                  ü,  ÿ,  ç, Ç, É, Ä, Ö, Ü, ¿, ¡, ñ, Ñ, å, Å, æ, Æ, ß, µ, ¥,
  1222.                  ±,  £, ¢, ¬, °, ², «, »,  , Ø, ¼, ½. The remaining special
  1223.                  characters are left unmodified.
  1224.             
  1225.                     The  TEXT option of the COPY command indicates that the
  1226.             source  file  contains  text rather than binary or raw data. It
  1227.             enables  the  translation  process. It is not required when the
  1228.             transfer  is done to the same type of computer. For example, to
  1229.             transfer  the  text  file  TWIN.DOC from the local directory to
  1230.             the file TWIN.TXT on a different remote computer:
  1231.             
  1232.               TWIN> COPY  TWIN.DOC  ~TWIN.TXT  TEXT
  1233.             
  1234.  
  1235.  
  1236.                                      16
  1237.  
  1238.             Twin Express                                       User's Guide
  1239.  
  1240.  
  1241.  
  1242.                     The  TYPE  command displays on screen the contents of a
  1243.             text  file. Twin Express automatically translates the file to a
  1244.             format  compatible  with  the local computer when the file is a
  1245.             remote  file from a different type of computer. For example, to
  1246.             display the contents of the remote file SONGS.SPA:
  1247.             
  1248.               TWIN>  TYPE  ~SONGS.SPA
  1249.             
  1250.             The  TYPE  command  assumes  that  SONGS.SPA is a text file and
  1251.             translates it, if necessary.
  1252.             
  1253.                     A   word   of  caution  about  word  processors.  These
  1254.             programs  keep  some  formating information in your text files.
  1255.             This  information  may  change  from  one  type  of computer to
  1256.             another.   Twin   Express  does  not  translate  this  type  of
  1257.             information.  Therefore  you  may  want  to  transfer  the file
  1258.             without  the  TEXT option and then use a conversion program. On
  1259.             the  other hand, if the word processor output can be redirected
  1260.             to  an ASCII file, instead of the printer, this output file can
  1261.             be  transferred  with the TEXT option since it does not contain
  1262.             the formating information.
  1263.             
  1264.             2.9 ENABLING FAST TRANSFERS
  1265.             
  1266.                     The  main  feature  of  Twin Express is its speed. High
  1267.             speed  serial  transfers  can  be achieved by using a high baud
  1268.             rate and/or a special transmission mode.
  1269.             
  1270.                     On  the  Amiga computer, the hardware can transfer more
  1271.             than  1,000,000 bits per second (according to Commodore-Amiga).
  1272.             To   get   the  fastest  serial  transfers  between  two  Amiga
  1273.             computers  it  is  thus  a matter of selecting the highest baud
  1274.             rate  possible. In practice, this baud rate is actually limited
  1275.             by  CPU  speed  and  cable  capacitance  (ability  to oppose to
  1276.             changing  voltages).  The highest baud rate recommended for the
  1277.             Amiga  family  of computers is 190000. However, if you have two
  1278.             Amiga  3000  and  a short cable you may use baud rates of up to
  1279.             290000. For example, to execute Twin Express at 230000 baud:
  1280.             
  1281.               A> TWIN  SER  230000
  1282.             
  1283.             With  such  a  baud rate, the effective transfer speed is about
  1284.             22,000  bytes  per  second.  Raising  the  baud  rate, from its
  1285.             default  115200  baud,  is  the  recommended method to get high
  1286.             speed serial transfers between two Amiga computers.
  1287.             
  1288.                     On  a  12.5  MHz  AT-type  computer,  the  hardware can
  1289.             transfer  data  at  up  to  115200  bits  per  second. Speed is
  1290.             actually  limited  by  the  hardware,  not  by  the CPU. To get
  1291.             faster  speeds,  the  user  must  select a special transmission
  1292.             mode  (EXPRESS).  On  a 12.5 MHz AT-type computer, it transfers
  1293.             about  100%  more  data  than  the  default  STANDARD mode. For
  1294.             example, to enable the EXPRESS mode:
  1295.             
  1296.  
  1297.  
  1298.                                      17
  1299.  
  1300.             Twin Express                                       User's Guide
  1301.  
  1302.  
  1303.  
  1304.               TWIN> SET  MODE  EXPRESS
  1305.             
  1306.             This  allows a user to transfer files at about 22,000 bytes per
  1307.             second  using the default baud rate of 115200. You can also use
  1308.             this  mode with Amiga computers. However, with a high baud rate
  1309.             the increase in performance is lower.
  1310.             
  1311.                     The  EXPRESS  mode  is the recommended mode of transfer
  1312.             unless  you  are  using a 3-wire cable or you run into a lot of
  1313.             transmission errors.
  1314.             
  1315.             2.10 INPUT FROM A COMMAND FILE
  1316.             
  1317.                     Twin  Express  reads  its  commands  from  the standard
  1318.             input   file   used  upon  activation.  This  file  is  usually
  1319.             connected  to  the keyboard. However, it is possible to execute
  1320.             commands  from a disk file. The user just needs to redirect the
  1321.             standard  input  to  this  file.  For  example,  to execute the
  1322.             commands in file BACKUP.TNX:
  1323.             
  1324.               TWIN  <BACKUP.TNX
  1325.             
  1326.             The  file contains the same commands as would be entered from a
  1327.             keyboard, including the final QUIT command. For example:
  1328.             
  1329.               COPY  C:*.C  ~D:  SUBDIR  TEXT
  1330.               COPY  C:*.ASM  ~D:  SUBDIR  TEXT
  1331.               QUIT
  1332.             
  1333.             Note: commands files can be created with any text editor.
  1334.             
  1335.             
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.                                      18
  1361.  
  1362.             Twin Express                                       User's Guide
  1363.  
  1364.  
  1365.  
  1366.             
  1367.                                         COMMANDS
  1368.             
  1369.             
  1370.                     This  chapter  provides detailed information about each
  1371.             Twin Express command.
  1372.             
  1373.                     The  full  syntax  is  given  for  each command. Square
  1374.             brackets  ([])  indicate  optional  parameters.  Braces  ({  })
  1375.             indicate a choice from a list.
  1376.             
  1377.             3.1 CHDIR
  1378.             
  1379.             Syntax: CHDIR  [~]DirectoryName
  1380.             
  1381.                     Twin  Express  supports  two  default  directories: the
  1382.             local  directory and the remote directory. These are defined by
  1383.             the  volumes  and  directories  in  use  when  Twin Express was
  1384.             activated.
  1385.             
  1386.                     The  CHDIR command changes the default directory of the
  1387.             local  system  or  the  remote system. The default directory is
  1388.             used  whenever  the  user  specifies a name not starting at the
  1389.             root  directory  of  a  volume  (e.g.  CHESS.C  as  opposed  to
  1390.             /GAMES/SOURCES/CHESS.C).
  1391.             
  1392.                     The  name  of  a local directory is used with the CHDIR
  1393.             command  to change the local default directory. For example, to
  1394.             change the local default directory to IBMGAMES on volume B:
  1395.             
  1396.               TWIN> CHDIR  B:IBMGAMES                           or
  1397.               TWIN> CHDIR  B:/IBMGAMES                          or
  1398.               TWIN> CHDIR  B:\IBMGAMES
  1399.             
  1400.             The  default drive is changed when a volume is specified in the
  1401.             pathname,  as  in  the  example above. This also indicates that
  1402.             the  directory  specified can be found in the root directory of
  1403.             that  volume  even  though  a  slash  or  a  back-slash  is not
  1404.             specified  after  the  colon.  Note: This behavior is different
  1405.             from that of PC-DOS and MS-DOS.
  1406.             
  1407.                     A  remote  directory  name is used to change the remote
  1408.             default  directory.  Since this refers to a remote resource the
  1409.             name  must have the ~ prefix. For example, to change the remote
  1410.             default directory to AMIGAMES on volume DH0:
  1411.             
  1412.               TWIN> CHDIR  ~DH0:AMIGAMES                        or
  1413.               TWIN> CHDIR  ~DH0:/AMIGAMES                       or
  1414.               TWIN> CHDIR  ~DH0:\AMIGAMES
  1415.             
  1416.             3.2 COPY
  1417.             
  1418.             Syntax: COPY  [~]SourceOfData  [~]DestinationOfData  [SUBDIR]
  1419.                           [{BINARY|TEXT}]
  1420.  
  1421.  
  1422.                                      19
  1423.  
  1424.             Twin Express                                       User's Guide
  1425.  
  1426.  
  1427.  
  1428.             
  1429.                     The  COPY  command  creates copies of files. Source and
  1430.             destination files may be local or remote resources.
  1431.             
  1432.                     In  its  simplest  form, the command COPY uses a source
  1433.             file  and a destination file on the same computer. For example,
  1434.             to  copy  the  local  file  AUTOEXEC.BAT  into  the  local file
  1435.             AUTOEXEC.OLD  and  to  copy the remote file startup-sequence to
  1436.             remote file old-startup-sequence:
  1437.             
  1438.               TWIN> COPY  AUTOEXEC.BAT  AUTOEXEC.OLD
  1439.               TWIN> COPY  ~startup-sequence  ~old-startup-sequence
  1440.             
  1441.             As  shown  above,  the remote resources must have the ~ prefix.
  1442.             Note:  the  target file gets the same creation date and time as
  1443.             the source file.
  1444.             
  1445.                     A  more useful form, from a file transfer program point
  1446.             of  view,  is when the source file and the destination file are
  1447.             not  on  the  same system. This actually transfers the contents
  1448.             of  the source file to the destination system through the cable
  1449.             connected   to  the  serial  devices  of  both  computers.  For
  1450.             example,  to  copy the local file TITLES.LIB to file NEWHITS on
  1451.             the remote system:
  1452.             
  1453.               TWIN> COPY  TITLES.LIB  ~NEWHITS
  1454.             
  1455.                     Source  file  names  may contain wildcards. This allows
  1456.             the  user  to  copy  many  files  with  a  single  command. For
  1457.             example,  to  copy all the .C files of the current directory to
  1458.             the directory SOURCES:
  1459.             
  1460.               TWIN> COPY  *.C  SOURCES
  1461.             
  1462.             Note:   when  the  source  name  contains  wildcards  or  is  a
  1463.             directory  name,  the  target  name  must  be  the  name  of  a
  1464.             directory.
  1465.             
  1466.                     On   request,  COPY  can  also  process  the  files  of
  1467.             subdirectories.  This  is  indicated  by the SUBDIR option. For
  1468.             example,  to  copy  all  the  remote .EXE files from the remote
  1469.             directory   GAMES,  including  all  the  .EXE  files  found  in
  1470.             sudirectories  of  directory  GAMES,  to  the  local  directory
  1471.             DEMOS:
  1472.             
  1473.               TWIN> COPY  ~GAMES/*.EXE  DEMOS  SUBDIR           or
  1474.               TWIN> COPY  ~GAMES\*.EXE  DEMOS  SUBDIR
  1475.             
  1476.             In  this  case,  Twin Express first copies matching files found
  1477.             in  the  source  directory  to  the  target  directory. It then
  1478.             copies   matching   files   found   in   each   of  the  source
  1479.             subdirectories  to  subdirectories  of  the  same  name  in the
  1480.             target  directory.  If  a matching target subdirectory does not
  1481.             exist,  Twin  Express  creates the subdirectory and then copies
  1482.  
  1483.  
  1484.                                      20
  1485.  
  1486.             Twin Express                                       User's Guide
  1487.  
  1488.  
  1489.  
  1490.             the   corresponding   files  to  it.  This  produces  a  target
  1491.             directory having the same structure as the source directory.
  1492.             
  1493.                    The  TEXT option indicates that the source file contains
  1494.             text  (printable characters) rather than binary data. It allows
  1495.             Twin  Express  to  translate  your text files when you transfer
  1496.             them  between  an  Amiga  and  an IBM computer. For example, to
  1497.             transfer  all  the text files from the local directory BUSINESS
  1498.             to the remote directory LETTERS:
  1499.             
  1500.               TWIN> COPY  BUSINESS  ~LETTERS  TEXT
  1501.             
  1502.             More  information about the translation process can be found in
  1503.             section  2.8  of  this manual. By default, the BINARY option is
  1504.             used and no translation is done.
  1505.             
  1506.             3.3 DELETE
  1507.             
  1508.             Syntax: DELETE  FileName  [SUBDIR]
  1509.             
  1510.                     The  DELETE  command removes local or remote files from
  1511.             a file system.
  1512.             
  1513.                     A  local  file  name is used with the DELETE command to
  1514.             delete   a   local  file.  For  example,  to  delete  the  file
  1515.             REPORT.OLD in the default local directory:
  1516.             
  1517.               TWIN> DELETE  REPORT.OLD
  1518.             
  1519.             To  delete a remote file, the file name must have the ~ prefix.
  1520.             For  example,  to  delete  the  remote  file  REPORT.OLD in the
  1521.             default remote directory:
  1522.             
  1523.               TWIN> DELETE  ~REPORT.OLD
  1524.             
  1525.             Usage   of  wildcards  is  permitted  with  this  command.  For
  1526.             example,  to  delete  all  the  .MAP files in the local default
  1527.             directory:
  1528.             
  1529.               TWIN> DELETE  *.MAP
  1530.             
  1531.                     On  request,  DELETE  can be extended to files found in
  1532.             subdirectories.  This  is  indicated  by the SUBDIR option. For
  1533.             example, to delete all the .LST files on the remote volume C:
  1534.             
  1535.               TWIN> DELETE  ~C:*.LST  SUBDIR                    or
  1536.               TWIN> DELETE  ~C:/*.LST  SUBDIR                   or
  1537.               TWIN> DELETE  ~C:\*.LST  SUBDIR
  1538.             
  1539.             3.4 DIR
  1540.             
  1541.             Syntax: DIR  [~][PathName]  [SUBDIR]
  1542.             
  1543.                     The  DIR  command  displays the names of the files in a
  1544.  
  1545.  
  1546.                                      21
  1547.  
  1548.             Twin Express                                       User's Guide
  1549.  
  1550.  
  1551.  
  1552.             local  or  remote directory. The command provides the following
  1553.             data  regarding  these  files:  the  file size (bytes), date of
  1554.             last  modification,  time  of  last  modification  and the file
  1555.             attributes.  For  example,  DIR  might  display  the  following
  1556.             information:
  1557.             
  1558.               Listing of directory C:\GAMES\CHESS
  1559.             
  1560.               CHESS.BAT                193  91-03-31  09:10:47  --CA  RW-D
  1561.               CHESS.C               245002  91-09-26  15:28:18  ---A  RW-D
  1562.               CHESS.EXE             113247  91-09-26  15:31:58  ----  RWED
  1563.               CHESS.DOC              35831  91-09-27  11:55:16  ----  RW-D
  1564.               OPENINGS           Directory  91-05-25  16:29:31  ----  RWED
  1565.               CHESS.O                54645  91-09-26  15:31:04  ----  RW-D
  1566.             
  1567.               Total size of files:  448918
  1568.             
  1569.                     A  local  file name is used with the DIR command to get
  1570.             information  on  a  specific  local  file.  For example, to get
  1571.             information on the local file CHESS.C:
  1572.             
  1573.               TWIN> DIR  CHESS.C
  1574.             
  1575.             To  get  information  on a remote file, the file name must have
  1576.             the  ~  prefix.  For  example, to get information on the remote
  1577.             file GRAPHLIB:
  1578.             
  1579.               TWIN> DIR  ~GRAPHLIB
  1580.             
  1581.             Usage  of  wildcard  characters  is  permitted. For example, to
  1582.             display  information about all the files having a name starting
  1583.             with HOTEL:
  1584.             
  1585.               TWIN> DIR  HOTEL*
  1586.             
  1587.             To  get  the  complete  listing  of a particular directory, the
  1588.             user  must  supply a directory name instead of a file name. For
  1589.             example:  to  get  a  complete  listing  of  files in directory
  1590.             A:\BACKUP1:
  1591.             
  1592.               TWIN> DIR  A:BACKUP1                              or
  1593.               TWIN> DIR  A:\BACKUP1
  1594.               TWIN> DIR  A:/BACKUP1
  1595.             
  1596.             To  get a complete listing of a default directory, the user has
  1597.             the  choice  of  using  the  * wildcard character or no name at
  1598.             all.  For  example,  to  display  all  the  files of the remote
  1599.             default directory:
  1600.             
  1601.               TWIN> DIR  ~                                     or
  1602.               TWIN> DIR  ~*
  1603.             
  1604.             The  SUBDIR  option  can  be  used to also display the matching
  1605.             files  in subdirectories. For example: to get a list of all the
  1606.  
  1607.  
  1608.                                      22
  1609.  
  1610.             Twin Express                                       User's Guide
  1611.  
  1612.  
  1613.  
  1614.             files having the .OLD extension on the current volume:
  1615.             
  1616.               TWIN> DIR  :*.OLD  SUBDIR                        or
  1617.               TWIN> DIR  /*.OLD  SUBDIR                        or
  1618.               TWIN> DIR  \*.OLD  SUBDIR
  1619.             
  1620.                     The  file attributes define some characteristics of the
  1621.             file. Twin Express supports the following attributes:
  1622.             
  1623.               S: File is a system file.
  1624.               H: File is normally hidden.
  1625.               C: File is a command file (batch file, script file).
  1626.               P: File contains pure, re-entrant code.
  1627.               A: File has been archived since its last modification.
  1628.               R: File can be read (not read protected).
  1629.               W: File can be written, modified (not write protected).
  1630.               E: File can be executed (not execute protected).
  1631.               D: File can be deleted (not delete protected).
  1632.             
  1633.             Not  all  these attributes are supported on all of the systems.
  1634.             Twin  Express running on the IBM-PC or compatible machines does
  1635.             not  support the attribute P and simulates the attributes C, R,
  1636.             W, E, D.
  1637.             
  1638.             3.5 ECHO
  1639.             
  1640.             Syntax: ECHO UserText
  1641.             
  1642.                     ECHO  displays  on the screen the text that follows the
  1643.             command.  For  example, to get the message "Remote Backup" upon
  1644.             the execution of the command ECHO:
  1645.             
  1646.               TWIN> ECHO Remote Backup
  1647.             
  1648.             The  purpose  of  this  command is to display comments when the
  1649.             input  to  Twin  Express  comes from a command file rather than
  1650.             the keyboard.
  1651.             
  1652.             3.6 HELP
  1653.             
  1654.             Syntax: HELP  [{TWIN|CABLE|USAGE|COMMANDS|EXAMPLES}]
  1655.             
  1656.                     The  HELP  command  provides on-line information to the
  1657.             user.
  1658.             
  1659.                     The  command  may  be used with or without a parameter.
  1660.             Without  a  parameter,  it  is a request for information on the
  1661.             command itself. Example:
  1662.             
  1663.               TWIN> HELP
  1664.             
  1665.             In  this  case,  the command only displays the topics for which
  1666.             help  is  available.  Actually,  the  user  can get information
  1667.             about  registration (TWIN), information about the wiring of the
  1668.  
  1669.  
  1670.                                      23
  1671.  
  1672.             Twin Express                                       User's Guide
  1673.  
  1674.  
  1675.  
  1676.             null-modem  cable  used  for  the  serial transfers (CABLE), an
  1677.             introduction  to  the  basic  operations  (USAGE),  the command
  1678.             syntax (COMMANDS) and some typical examples (EXAMPLES).
  1679.             
  1680.                     For  more  detailed  information,  the  topic  must  be
  1681.             specified  in the command. For example, to display a summary of
  1682.             all the commands:
  1683.             
  1684.               TWIN> HELP  COMMANDS
  1685.             
  1686.             3.7 MKDIR
  1687.             
  1688.             Syntax: MKDIR  [~]DirectoryName
  1689.             
  1690.                     The  MKDIR  command creates a new directory in the file
  1691.             system of the local or the remote computer.
  1692.             
  1693.                     A  local  directory  name  is  used  to  create a local
  1694.             directory.  For  example, to create the subdirectory IBMNEWS in
  1695.             the current default directory:
  1696.             
  1697.               TWIN> MKDIR  IBMNEWS
  1698.             
  1699.             A  ~  prefix  is used at the beginning of the directory name to
  1700.             create   a   remote  directory.  For  example,  to  create  the
  1701.             directory AmiNews in the remote root directory:
  1702.             
  1703.               TWIN> MKDIR  ~/AmiNews                            or
  1704.               TWIN> MKDIR  ~\Aminews                            or
  1705.               TWIN> MKDIR  ~:AmiNews
  1706.             
  1707.             3.8 QUIT
  1708.             
  1709.             Syntax: QUIT
  1710.             
  1711.                     This   command  allows  the  user  to  exit  from  Twin
  1712.             Express.  Note  that you also exit from the remote program if a
  1713.             connection had been established with the remote.
  1714.             
  1715.                     After  exiting  from  the  program  you are left in the
  1716.             directory  from  which  you  activated  Twin  Express even if a
  1717.             different  default  directory  (via  CHDIR)  had  been selected
  1718.             during your session with the program.
  1719.             
  1720.             3.9 RENAME
  1721.             
  1722.             Syntax: RENAME  [~]SourceName  [~]TargetName  [SUBDIR]
  1723.             
  1724.                     The  RENAME command changes the current name of a local
  1725.             or a remote file to a new name.
  1726.             
  1727.                     The  current name and the new name are the two required
  1728.             parameters  to this command. For example, to change the name of
  1729.             the local file TEST.ASM to DONJON.ASM:
  1730.  
  1731.  
  1732.                                      24
  1733.  
  1734.             Twin Express                                       User's Guide
  1735.  
  1736.  
  1737.  
  1738.             
  1739.               TWIN> RENAME  TEST.ASM  DONJON.ASM
  1740.             
  1741.             You  can  also  "rename"  the  file  so as to change its parent
  1742.             directory.  This  actually moves the file to another directory.
  1743.             For example, to move file DONJON.ASM to the directory GAMES:
  1744.             
  1745.               TWIN> RENAME  DONJON.ASM  :GAMES                  or
  1746.               TWIN> RENAME  DONJON.ASM  /GAMES                  or
  1747.               TWIN> RENAME  DONJON.ASM  \GAMES
  1748.             
  1749.             Usually,  most systems won't allow the user to rename a file to
  1750.             a  different  volume. In this case, the user must copy the file
  1751.             to the new volume and delete the old file.
  1752.             
  1753.                     Both  the current name and the new name must have the ~
  1754.             prefix  to  rename  a  remote  file. For example, to change the
  1755.             name  of  remote  file  TEST.PAS to DRAGON.PAS in the directory
  1756.             GAMES of the remote computer:
  1757.             
  1758.               TWIN> RENAME  ~TEST.PAS  ~:GAMES/DRAGON.PAS       or
  1759.               TWIN> RENAME  ~TEST.PAS  ~:GAMES\DRAGON.PAS       or
  1760.               TWIN> RENAME  ~TEST.PAS  ~/GAMES/DRAGON.PAS       or
  1761.               TWIN> RENAME  ~TEST.PAS  ~\GAMES\DRAGON.PAS
  1762.             
  1763.             The  ~  prefix is required in both names, otherwise the meaning
  1764.             would  be  "move  file  to  another  system"  which  is not the
  1765.             purpose of this command.
  1766.             
  1767.                     The  command RENAME also supports the use of wildcards.
  1768.             This  is  used  to  move  a  selected group of files to another
  1769.             directory.  For  example, to move all the files ending in .C to
  1770.             the directory CSTUFF:
  1771.             
  1772.               TWIN> RENAME  *.C  :CSTUFF                        or
  1773.               TWIN> RENAME  *.C  /CSTUFF                        or
  1774.               TWIN> RENAME  *.C  \CSTUFF
  1775.             
  1776.             With  such a command, all the selected files are moved to a new
  1777.             directory. However, all of them keep their original name.
  1778.             
  1779.             3.10 RMDIR
  1780.             
  1781.             Syntax: RMDIR  [~]DirectoryName
  1782.             
  1783.                     The   RMDIR   command  removes  a  local  or  a  remote
  1784.             directory from the file system.
  1785.             
  1786.                     The  name  of  a local directory is used with the RMDIR
  1787.             command  to  delete  a  local  directory  from  the system. For
  1788.             example,  to  remove  the  local subdirectory OLDSTUFF from the
  1789.             current default directory:
  1790.             
  1791.               TWIN> RMDIR  OLDSTUFF
  1792.  
  1793.  
  1794.                                      25
  1795.  
  1796.             Twin Express                                       User's Guide
  1797.  
  1798.  
  1799.  
  1800.             
  1801.             A  remote  directory  name must have the ~ prefix. For example,
  1802.             to   delete   the  directory  OBSOLETE  from  the  remote  root
  1803.             directory:
  1804.             
  1805.               TWIN> RMDIR  ~:OBSOLETE                           or
  1806.               TWIN> RMDIR  ~/OBSOLETE                           or
  1807.               TWIN> RMDIR  ~\OBSOLETE
  1808.             
  1809.             Most  systems prohibit deletion of non-empty directories, which
  1810.             is  a good security feature. The user must remove all the files
  1811.             and any subdirectories from the directory before deleting it.
  1812.             
  1813.             3.11 SET
  1814.             
  1815.             
  1816.             Syntax: SET MODE {STANDARD|EXPRESS}
  1817.             
  1818.                     The  SET command allows a user to select one of the two
  1819.             serial  transmission  modes.  These  are:  STANDARD  (the basic
  1820.             mode) and EXPRESS (a high speed mode).
  1821.             
  1822.                     The  STANDARD  mode transmits data at the speed defined
  1823.             by  the current baud rate. At 115200 baud, it transfers data at
  1824.             about  11,000 bytes per second. This is the default mode. It is
  1825.             also  the  mode recommended when transmission errors occur with
  1826.             the high speed mode.
  1827.             
  1828.                     The  EXPRESS  mode  is a high speed mode that transmits
  1829.             more  data  than  the  standard  mode for a given baud rate. At
  1830.             115200  baud,  it  transfers  data  at  about  22,000 bytes per
  1831.             second on 12.5 MHz AT-type computers.
  1832.             
  1833.                     There  is  no  need  to  type  a  SET  command  on both
  1834.             machines.  Twin Express automatically puts the remote system in
  1835.             the  same mode. For example, to enable the EXPRESS mode on both
  1836.             computers:
  1837.             
  1838.               TWIN> SET  MODE  EXPRESS
  1839.             
  1840.             3.12 SHOW
  1841.             
  1842.             Syntax: SHOW {DEVICE|BAUD|SPEED|STATUS|PATH}
  1843.             
  1844.                     The  SHOW  command  allows  a  user  to get information
  1845.             about  the  current  device,  current baud rate, current speed,
  1846.             default directories or status.
  1847.             
  1848.                     The  DEVICE option indicates the current serial port in
  1849.             use on the local computer.
  1850.             
  1851.                     The  BAUD option indicates the current baud rate in use
  1852.             on the local computer.
  1853.             
  1854.  
  1855.  
  1856.                                      26
  1857.  
  1858.             Twin Express                                       User's Guide
  1859.  
  1860.  
  1861.  
  1862.                     The  SPEED  option  indicates  the  estimated  transfer
  1863.             speed  (in bytes per second) according to the current baud rate
  1864.             and selected mode.
  1865.             
  1866.                     The  PATH  option  indicates  the  default  directories
  1867.             (local and remote).
  1868.             
  1869.                     The  STATUS  option  displays the type of the local and
  1870.             the  remote  systems  (Amiga  or  IBM compatible), the names of
  1871.             local  and  remote ports and type of cable (3 or 7 wires) being
  1872.             used.
  1873.             
  1874.                     For   example,   to   display   information  about  the
  1875.             estimated transfer speed:
  1876.             
  1877.               TWIN> SHOW  SPEED
  1878.             
  1879.             3.13 TREE
  1880.             
  1881.             Syntax: TREE [~][DirectoryName]
  1882.             
  1883.                     The  TREE command displays the structure of a directory
  1884.             and  of all the subdirectories nested within it. For example, a
  1885.             GAMES directory might have the following structure:
  1886.             
  1887.               GAMES
  1888.                 ADVENTURE
  1889.                   MS-TREK
  1890.                   COMBAT
  1891.                 ARCADE
  1892.                   BRICKS
  1893.                   PINBALL
  1894.                 MISC
  1895.                   GAMBLING
  1896.                     BLACKJACK
  1897.                   BOARDS
  1898.                     CHESS
  1899.                     CHECKERS
  1900.                   CARDS
  1901.                     BRIDGE
  1902.             
  1903.                     A  local  directory  name is used with the TREE command
  1904.             to  display the structure of a local directory. For example, to
  1905.             view the directory structure of the local directory GAMES:
  1906.             
  1907.               TWIN> TREE GAMES
  1908.             
  1909.             The  directory name is not required to get the structure of the
  1910.             default directory.
  1911.             
  1912.                     A  directory  name  with  a ~ prefix is used to display
  1913.             the  structure  of a remote directory. For example, to view the
  1914.             directory structure of the remote directory GAMES:
  1915.             
  1916.  
  1917.  
  1918.                                      27
  1919.  
  1920.             Twin Express                                       User's Guide
  1921.  
  1922.  
  1923.  
  1924.               TWIN> TREE ~GAMES
  1925.             
  1926.             3.14 TYPE
  1927.             
  1928.             Syntax: TYPE TextFileName
  1929.             
  1930.                     The  TYPE command displays the contents of a local or a
  1931.             remote  text  file,  one page at a time. The user may abort the
  1932.             command by typing <CTRL-C>.
  1933.             
  1934.                     A  local  name is used with the TYPE command to display
  1935.         a  local  text  file.  For  example,  to display the local file
  1936.         AUTOEXEC.BAT:
  1937.  
  1938.           TWIN> TYPE  AUTOEXEC.BAT
  1939.  
  1940.             To  display a remote text file, the file name must have
  1941.         the   ~  prefix.  For  example,  to  display  the  remote  file
  1942.         startup-sequence:
  1943.  
  1944.           TWIN> TYPE  ~startup-sequence
  1945.  
  1946.         You  can  display remote text files even if the remote computer
  1947.         is  not  compatible  with the local computer (e.g. Amiga vs IBM
  1948.         PC).  In  this  case,  Twin  Express will translate the file as
  1949.         described in section 2.8 of this manual.
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.                                      28
  1981.  
  1982.             Twin Express                                       User's Guide
  1983.  
  1984.  
  1985.  
  1986.             
  1987.                                      ERROR MESSAGES
  1988.             
  1989.             
  1990.                     Errors  fall  in  three  classes: startup errors, usage
  1991.             errors and communication errors.
  1992.             
  1993.             Startup errors:
  1994.             
  1995.                     Startup  errors  are  problems detected upon activation
  1996.             of Twin Express. Section 1.7 describes these errors in detail.
  1997.             
  1998.             Usage errors:
  1999.             
  2000.                     Usage  errors indicate mistakes in a user command (e.g.
  2001.             bad  command,  missing  parameters) or an error detected during
  2002.             execution  of  a  command. These messages always start with the
  2003.             word  "Error".  For  example, an error message indicating a bad
  2004.             command:
  2005.             
  2006.               Error: Invalid command.
  2007.             
  2008.             A  usage  error always terminates the program when the input is
  2009.             from a command file.
  2010.             
  2011.             Communication errors:
  2012.             
  2013.                     Communication   errors   are   indicated   by  messages
  2014.             enclosed  between  >>>  and  <<<.  The  message  specifies some
  2015.             unusual  conditions  related  to  communication with the serial
  2016.             link. You should not see many of them under normal conditions.
  2017.             
  2018.                     Most  communication  error  messages  indicate  that an
  2019.             error  was found in a block of data. These errors are generated
  2020.             by   bad   connections,   high  baud  rates,  long  cables  and
  2021.             electrical  interference.  As  a  result, one or more bits have
  2022.             been  changed  in  a  block  of data transmitted via the serial
  2023.             cable.   This  condition  may  produce  one  of  the  following
  2024.             messages:
  2025.             
  2026.               >>> Last packet data transmitted with error <<<
  2027.               >>> Last packet header transmitted with error <<<
  2028.               >>> Last packet data received with error <<<
  2029.               >>> Last packet header received with error <<<
  2030.             
  2031.             In  this  case,  Twin Express retransmits the block of data and
  2032.             the  corrupted  block  is  discarded. It does not mean that the
  2033.             transmitted  files  contain these transmission errors. However,
  2034.             if  you  have  many  of these errors (say more than one error /
  2035.             million  bytes) you should consider using a slower transmission
  2036.             mode  or  a  slower  baud  rate  to  avoid  possible undetected
  2037.             errors.
  2038.             
  2039.                     Retransmission  of bad blocks of data may produce other
  2040.  
  2041.  
  2042.                                      A1
  2043.  
  2044.             Twin Express                                       User's Guide
  2045.  
  2046.  
  2047.  
  2048.             types  of messages under some circumstances. As before, it does
  2049.             not   mean   that   errors   have  been  introduced  into  your
  2050.             transmitted  files  (serious errors abort the program instead).
  2051.             These messages are:
  2052.             
  2053.               >>> Duplicate of a packet (packet ignored) <<<
  2054.               >>> Unexpected collision of two packets <<<
  2055.               >>> Collision of two packets (recovered) <<<
  2056.               >>> Fatal collision of two packets detected <<<
  2057.               >>> Fatal packet numbering errors <<<
  2058.             
  2059.             These  messages  might  also  appear  as a result of a software
  2060.             problem.  Please  contact  OMNICODE if you repeatedly get these
  2061.             messages at a low baud rate.
  2062.             
  2063.                     Once  in  a  while  you  might see one of the following
  2064.             messages:
  2065.             
  2066.               >>> Break detected: bad device or cable problem <<<
  2067.               >>> Remote computer does not respond <<<
  2068.               >>> Waiting for remote to reply <<<
  2069.             
  2070.             They  usually  indicate  a  cable with a bad connection, a dis-
  2071.             connected  cable  or  a  program  waiting  for  completion of a
  2072.             system  request.  You  should  check whether the cable is still
  2073.             properly  connected or whether you have a system request on the
  2074.             remote computer.
  2075.             
  2076.                  The  remaining  errors  are usually encountered during the
  2077.             debugging  of  the  communication  protocol  or with a very bad
  2078.             serial  link.  If  you get one of the following messages, check
  2079.             your  cable  and  try  to  execute  the program at a lower baud
  2080.             rate:
  2081.             
  2082.               >>> Sender got an out of sync ACK/NAK/SYN/CAN <<<
  2083.               >>> Receiver got an out of sync ACK/NAK/SYN/CAN <<<
  2084.               >>> Sender received an unrecognized reply <<<
  2085.               >>> Receiver got an unrecognized character <<<
  2086.               >>> Time-out while receiving packet header <<<
  2087.               >>> Receiver failed to acknowledge packet header <<<
  2088.               >>> Time-out while receiving packet data <<<
  2089.               >>> Sender failed to send data checksum <<<
  2090.               >>> Receiver failed to acknowledge packet data <<<
  2091.             
  2092.             
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.                                      A2
  2105.  
  2106.             Twin Express                                       User's Guide
  2107.  
  2108.  
  2109.  
  2110.             
  2111.                                    LICENSE AGREEMENT
  2112.             
  2113.             
  2114.                     In   consideration  of  payment  of  the  license  fee,
  2115.             OMNICODE   grants  the  licensee  the  following  non-exclusive
  2116.             rights:
  2117.             
  2118.               1. The  licensee  owns  the  media  on  which the software is
  2119.                  distributed.   However,   the   software  itself  and  the
  2120.                  documentation remain the property of OMNICODE.
  2121.             
  2122.               2. The  licensee may install and use this software on as many
  2123.                  computers  as  have  been  registered. The initial license
  2124.                  (registration) is valid for two computers.
  2125.             
  2126.               3. Each  of  the  computers  on  which  the software has been
  2127.                  installed may be used by any number of users.
  2128.             
  2129.               4. The  licensee  may  move the software from one computer to
  2130.                  another  as  long  as the number of computers that use the
  2131.                  software  does  not  exceed  the  number  of computers for
  2132.                  which the license costs have been paid.
  2133.             
  2134.                     All  rights not expressly granted in this agreement are
  2135.             reserved by OMNICODE.
  2136.             
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.                                      B1
  2167.  
  2168.             Twin Express                                       User's Guide
  2169.  
  2170.  
  2171.  
  2172.             
  2173.                                 DISTRIBUTION STATEMENT
  2174.             
  2175.             
  2176.                     For  the  purposes  of  this  distribution statement, a
  2177.             distributor   is  any  person,  organization,  club,  group  or
  2178.             company  making  the Twin Express package available to somebody
  2179.             else.
  2180.             
  2181.                     Permission  is  hereby  granted  to  any distributor to
  2182.             copy,  distribute,  or  store  this  package  in  a library, an
  2183.             information  system  or  a bulletin board system as long as all
  2184.             the following rules are respected:
  2185.             
  2186.               1.  The package may not be sold or leased out.
  2187.             
  2188.               2.  The  package  may  not  be bound, attached or linked to a
  2189.                   salable  product.  In particular, it may not be installed
  2190.                   on  the hard disk of a computer being sold or distributed
  2191.                   with any commercial product.
  2192.             
  2193.               3.  Notwithstanding  rule  2,  a  distributor  may  charge  a
  2194.                   reasonable  fee  to  cover  the cost of a diskette and/or
  2195.                   mailing and/or handling and/or connect time.
  2196.             
  2197.               4.  The  package  may not be distributed via a disk magazine.
  2198.                   For  the purposes of this rule, a disk magazine is either
  2199.                   a  magazine  normally sold with an accompanying disk or a
  2200.                   simple  advertising  cover  containing a disk. These disk
  2201.                   magazines  are  usually  found  in  bookstores with other
  2202.                   computer magazines.
  2203.             
  2204.               5.  Notwithstanding  rules  2  and  4,  the  publisher  of  a
  2205.                   standard  magazine  may  offer, as a separate service, to
  2206.                   send  a copy of this package to its readers or to make it
  2207.                   available  for  downloads. For the purposes of this rule,
  2208.                   a  standard  magazine  is  a  magazine  sold  without  an
  2209.                   accompanying disk.
  2210.             
  2211.               6.  Distribution  of  a printed copy of the documentation, in
  2212.                   whole or in part, is prohibited.
  2213.             
  2214.               7.  With  one  exception,  the  package  may not be modified.
  2215.                   That  is,  the  files  included in the package may not be
  2216.                   modified,  substituted,  deleted  or  mixed with files of
  2217.                   other  software.  However,  the distributor may add files
  2218.                   describing its distribution service to the package.
  2219.             
  2220.               8.  All  the  files  included  in the package must be distri-
  2221.                   buted  together.  The package shall be distributed via an
  2222.                   archive  file  (library  format)  or  as  files stored in
  2223.                   their own directory.
  2224.             
  2225.               9.  A  distribution  diskette  may have many archive files or
  2226.  
  2227.  
  2228.                                      C1
  2229.  
  2230.             Twin Express                                       User's Guide
  2231.  
  2232.  
  2233.  
  2234.                   directories  containing  other shareware or public domain
  2235.                   software.
  2236.             
  2237.               10. The  distributor  may  not distribute the package as free
  2238.                   software  or  public  domain software. Whenever possible,
  2239.                   the  distributor  shall  indicate  that  the  package  is
  2240.                   shareware software.
  2241.             
  2242.               11. The  distributor  agrees  to  stop  distribution  of this
  2243.                   package as soon as notified by OMNICODE.
  2244.             
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.                                      C2
  2291.  
  2292.             Twin Express                                       User's Guide
  2293.  
  2294.  
  2295.  
  2296.             
  2297.                                   PROBLEM REPORT FORM
  2298.             
  2299.             
  2300.             DATE           ________________________________________________
  2301.             NAME           ________________________________________________
  2302.             COMPANY        ________________________________________________
  2303.             ADDRESS        ________________________________________________
  2304.                            ________________________________________________
  2305.                            ________________________________________________
  2306.                            Country ___________ Zip code  __________________
  2307.             TEL            ___________________ FAX       __________________
  2308.             REGISTRATION # ___________________ (required for a reply...)   
  2309.             
  2310.             
  2311.             PRODUCT        Twin Express_______ RELEASE   __________________
  2312.             
  2313.             
  2314.             COMPUTER BRAND _______________ OPERATING SYSTEM _______________
  2315.             CPU TYPE       _______________ RELEASE          _______________
  2316.             CPU CLOCK      _______________ FLOPPY DISK TYPE _______________
  2317.             
  2318.             
  2319.             PROBLEMS,      ________________________________________________
  2320.             ENHANCEMENTS,  ________________________________________________
  2321.             SUGGESTIONS,   ________________________________________________
  2322.             REQUESTS...    ________________________________________________
  2323.                            ________________________________________________
  2324.                            ________________________________________________
  2325.                            ________________________________________________
  2326.                            ________________________________________________
  2327.                            ________________________________________________
  2328.                            ________________________________________________
  2329.                            ________________________________________________
  2330.                            ________________________________________________
  2331.                            ________________________________________________
  2332.                            ________________________________________________
  2333.             
  2334.             Note: if possible, indicate how to reproduce the problem.
  2335.             
  2336.             Send to OMNICODE
  2337.                     P.O. Box 128 Ahuntsic
  2338.                     Montréal [Québec]
  2339.                     CANADA H3L 3N7                 FAX: (514)385-6455
  2340.             
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.                                      D1
  2353.  
  2354.             Twin Express                                       User's Guide
  2355.  
  2356.  
  2357.  
  2358.             
  2359.                               REGISTRATION AND ORDER FORM
  2360.             
  2361.             
  2362.             DATE           ________________________________________________
  2363.             NAME           ________________________________________________
  2364.             COMPANY        ________________________________________________
  2365.             ADDRESS        ________________________________________________
  2366.                            ________________________________________________
  2367.                            ________________________________________________
  2368.                            Country ____________ Zip code  _________________
  2369.             TEL            ____________________ FAX       _________________
  2370.             REGISTRATION # ____________________ (required for items 2 - 3) 
  2371.             
  2372.             COMPUTER BRAND _______________ OPERATING SYSTEM _______________
  2373.             CPU TYPE       _______________ RELEASE          _______________
  2374.             CPU CLOCK      _______________ FLOPPY DISK TYPE _______________
  2375.             
  2376.             COMPUTER BRAND _______________ OPERATING SYSTEM _______________
  2377.             CPU TYPE       _______________ RELEASE          _______________
  2378.             CPU CLOCK      _______________ FLOPPY DISK TYPE _______________
  2379.             
  2380.             HOW DID YOU GET A COPY OF TWIN EXPRESS (a-g) ?  _______________
  2381.               a) Friend                         Name & address of d,e,f,g
  2382.               b) Office                         ___________________________
  2383.               c) Information system (e.g. BIX)  ___________________________
  2384.               d) Bulletin Board System (BBS)    ___________________________
  2385.               e) Users group - club             ___________________________
  2386.               f) Shareware distributor          ___________________________
  2387.               g) Other ________________________ ___________________________
  2388.             
  2389.             EXPECTED USAGE OF TWIN EXPRESS:
  2390.             _______________________________________________________________
  2391.             _______________________________________________________________
  2392.             _______________________________________________________________
  2393.             _______________________________________________________________
  2394.             _______________________________________________________________
  2395.             
  2396.             YOUR COMMENTS ABOUT TWIN EXPRESS:
  2397.             _______________________________________________________________
  2398.             _______________________________________________________________
  2399.             _______________________________________________________________
  2400.             _______________________________________________________________
  2401.             _______________________________________________________________
  2402.             
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.                                      E1
  2415.  
  2416.         Twin Express                                       User's Guide
  2417.  
  2418.  
  2419.  
  2420.             
  2421.             QTY                    PRODUCT                          PRICE  
  2422.             
  2423.             ___ Registration for 2 computers             (30.00 $) ________
  2424.                   (includes 1 manual and 2 diskettes)
  2425.             
  2426.             ___ Extra license for 1 computer             (10.00 $) ________
  2427.             
  2428.             ___ Extra manual                              (9.00 $) ________
  2429.             
  2430.             ___ Latest update diskettes                   (7.00 $) ________
  2431.             
  2432.                                                             Total: ________
  2433.             
  2434.             
  2435.             
  2436.             
  2437.             
  2438.             
  2439.             All prices are in Canadian dollars.
  2440.             Prices are subject to change without notice.
  2441.             Prices include Canadian taxes where applicable.
  2442.             Use a money order or a check drawn on a Canadian bank.
  2443.             
  2444.             
  2445.             
  2446.             
  2447.             
  2448.             
  2449.             Send to OMNICODE
  2450.                     P.O. Box 128 Ahuntsic
  2451.                     Montréal [Québec]
  2452.                     CANADA H3L 3N7
  2453.  
  2454.  
  2455.  
  2456.  
  2457.  
  2458.  
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.  
  2472.  
  2473.  
  2474.  
  2475.  
  2476.                                      E2
  2477.