CD-ROM Aktief 1995 #3/CDA3.iso/comm/ts3m.zip/XM.TXT

Text File | 1995-03-09 | 18KB | 458 lines

         TeleShare DOS  Remote Access  XM or XMODEM     Page 1


          Updated:  December, 1994

          This Product is Shareware, if you continue to use it

          Please Legalise your usage through Registration.


                        _______
                   ____|__     |               (R)
                --|       |    |-------------------
                  |   ____|__  |  Association of
                  |  |       |_|  Shareware
                  |__|   o   |    Professionals
                -----|   |   |---------------------
                     |___|___|    Member




          Table of Contents


            1. File Transfer
            2. Automatic File Transfer
            3. Creating Batch File(s) for Automatic Transfer(s)


          FILE TRANSFER

          TeleShare primarily uses a stand-alone DOS program called
          XM.EXE (indicating the XModem protocol) to perform file
          transfers.  This is in keeping with maintaining a small memory
          footprint in the PCs' limited available RAM.  You can also use
          other external file transfer programs as described elsewhere
          in this distribution.

          XM.EXE is run from the DOS command line and runs as dependent
          child process of the TeleShare Host/Remote modules.  XM.EXE
          will ONLY transfer files between 2 TeleShare systems.  It is
          written specifically to get along with the TeleShare TSR's.
          It is small, simple, reliable, and uses the most widely used
          file transfer protocol to get the job done with minimal fuss.
          You can use DSZ, PCZ, and HYDRA with TeleShare if you wish.
          They provide a variety of external protocols.


          Using XM.EXE, with the XModem protocol, is akin to the DOS
          COPY command but differs in important ways as follows:

          Let's say that you are using TeleShare on two PCs and would




         TeleShare DOS  Remote Access  XM or XMODEM     Page 2

          like to transfer a file called RESULTS.TXT from the Host PC to
          your local machine.


          1. While accessing the REMOTE HOST change to the area on that
          machine where XM.EXE is located.  This is not necessary if
          XM.EXE is in a sub-directory listed in the current PATH or
          environment statement(s) on the HOST PC where the system can
          easily find it for you.

          2. Enter 'XM S RESULTS.TXT' at the DOS prompt. Add any PATH
          characters necessary if RESULTS.TXT is not in the default
          sub-directory.  If XM.EXE is in the \TELE subdirectory, you
          can use '\TELE\XM S RESULTS.TXT' The 'S' stands for 'SEND'.

          3. If the file is found then the screen will clear and you
          will be informed that you have a certain amount of time to
          exit to your LOCAL DOS and run your own XM.EXE to receive the
          file.

          4. When the message appears that the HOST is ready to SEND
          press ALT-L ( or whatever you have set the hotkey to) and exit
          to your own local DOS.  Change to the area on your LOCAL PC
          where XM.EXE is located and enter 'XM R'.  This will allow the
          file to be RECEIVED into the default sub-directory with the
          same name as the file being sent. (You can change the name
          during the transfer.  See below).

          5. The Transfer progress screen will appear and show the
          progress of the file transfer.  Once back at your own local
          DOS prompt when the transfer is finished.

          6. When the transfer is completed then simply press ALT-R ( or
          whatever you have set the hotkey to ) and return to the REMOTE
          HOST session.  You will see the same transfer screen you saw
          locally on the REMOTE HOST.  It will say 'SEND' instead of
          'RECV' in the upper left corner of the screen.  This allows
          you to discover what the other side had to say about the
          progress of the transfer (just in case gremlins attacked).
          Simply clear the screen (CLS) and continue your session
          normally.


          How to use the XM.EXE Command format

          XM [R or S] [ somefile ] [@filelist]

          XM This is the transfer program itself, unless you have
          renamed it.

          R or S The first parameter should be 'S' if XM is to SEND




         TeleShare DOS  Remote Access  XM or XMODEM     Page 3

          files.  The first parameter should be 'R' if XM is to RECEIVE
          files.

          somefile File(s) to be transferred.  Wildcards are OK when 'S'
          is used to SEND files.  '*.DBF' is a wildcard for all the
          dBase files ending in .DBF in the current directory.

          @filelist The @filelist is a response file containing a list
          of files to be transferred in the following file format:

          anyfile
          C:\SOMEDIR\FILE1
          C:\OTHERDIR\FILE2
          D:\DOS\OTHER\FILE3 # a comment
          ; another comment

          You will notice that there is one file per line, and that the
          format is simple enough for various kinds of software to be
          programmed to produce such a file for your specific needs.
          You can include blank lines and add comments with a ;  or a #
          symbol to the left of any comment.  The @ can be used in place
          of the 'S', as in "XM @filelist".  Such a filelist can be of
          any length, and is a good way to backup or update specific
          files to another (off-site) location for security.  However,
          you should consider using an archiver like lha or pkzip if you
          need to minimise transfer times and/or add security.  Other
          Teleshare tools produce files with this format, and some add
          commands such as [transfer],[copy], [move], and [erase].  The
          lines following a [transfer] command are for file transfer to
          another computer.  Normally, xm will bypass portions of a
          response file that are not for file transfer.  You can create
          such files for use with the GATHER program, and gather will
          automatically follow the commands and will pass them to XM
          when the [transfer] is included.


          If you are RECEIVING files then this parameter is optional.
          You can simply enter 'XM R' and all files will be received
          using the SAME name as the one sent.  This works whether it's
          1 or 100 files being sent.

          If you are RECEIVING one file only and you wish to change its
          name on your side then go ahead and enter the desired
          new_filename after the 'R' parameter.  When the name arrives
          from the HOST the transfer box will tell you that it's
          'Receiving ORIGINAL_NAME as NEW_NAME'.  'NEW_NAME' will appear
          in your local directory.

          If you are receiving more than 1 file then you cannot enter an
          alternate filename after the 'R' parameter.  You must receive
          ALL the files using the names sent.




         TeleShare DOS  Remote Access  XM or XMODEM     Page 4

          Some important reminders...

          - You MUST separate the XM parameters with SPACES, so
          it will not become confused trying to find 'Ssomefile'
          when it should just be using the Send command to send
          the 'somefile'.

          - You cannot enter a LIST of different filenames
          one after the other in this version.
          Groups of files can only be sent if they can be
          distinguished with any normal DOS wildcard
          directory command.  Use a response file.

          - If your LOG files option is ON then the progress
          and results of each 'XM' request will be appended
          to either XMSEND.LOG or XMRECV.LOG.

          - You cannot access the remote PC while transferring
          files.  XM is a stand-alon