home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / zcmd1761.zip / ZCOMMDOC.AB < prev    next >
Text File  |  1990-06-26  |  72KB  |  1,771 lines
  1.  
  2.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  3.         ZCOMM User Manual                                                   31
  4.  
  5.         7.17  Prometheus ProModem 1200
  6.  
  7.         The following switch setting works with ZCOMM: 1-4,6,9 on; 5,7,8,10
  8.         off.[4] A custom "dial" script can be written to operate this modem in
  9.         its native mode.
  10.  
  11.  
  12.         7.18  Racal-Vadic Maxwell 2400V
  13.  
  14.         The Maxwell 2400V has long delays designed to allow switching between
  15.         data and voice operation on the same phone line.  Unfortunately, they
  16.         slow normal data operations.  The 2400VP reportedly does not have this
  17.         feature.
  18.  
  19.         Use the default mm224 dialing routine discussed above for this modem.
  20.  
  21.  
  22.         7.19  Standard 103/212
  23.  
  24.         The supplied "dial" script will present the number to the user and
  25.         wait for a success/fail response if the mprefix string parameter is
  26.         set empty.  Alternatively, one could change the script to loop waiting
  27.         for carrier detect while the keyboard is inactive.  The Data Set Ready
  28.         (DSR) signal may be connected to the modem's speed detect output (high
  29.         for 1200 bps, low for 300) allowing the dr test condition to sample
  30.         the DSR line to determine the speed of the incoming call.
  31.  
  32.  
  33.         7.20  Data Race BMX
  34.  
  35.         These modems have a switch selected interface speed, an AT style
  36.         command set, and switch options for software or hardware flow control.
  37.         Recommended settings are: AT commands, Dialup, 8 bit data (down),
  38.         disable XON (7 and 8 down), Echo on.  ZCOMM's handshake on command
  39.         should be used.
  40.  
  41.  
  42.         7.21  Strange Modems
  43.  
  44.         Most intelligent modems can be commanded to autodial with a suitable
  45.         mprefix and msuffix string.  Those modems that won't work with a
  46.         particular mprefix can be programmed with a custom "dial" script.  If
  47.         the modem can be configured to reset to a known condition when DTR is
  48.  
  49.  
  50.         __________
  51.  
  52.          4. Prometheus mode does not work with ZCOMM's built-in dialing
  53.             software because the "DIAL COMPLETED" message makes ZCOMM think
  54.             it's seen "CONNECT" (ZCOMM looks for a "T").
  55.  
  56.  
  57.  
  58.         (C) 1990 Omen Tech Inc                  Chapter 7 Unleashing the MODEM
  59.  
  60.  
  61.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  62.         ZCOMM User Manual                                                   32
  63.  
  64.         turned off, programming is usually straightforward.
  65.  
  66.         Otherwise, the script must determine what speed the modem is set to,
  67.         and then,  at its present speed, command the modem to change to the
  68.         desired speed.  The essential requirement is to write a script that
  69.         controls the modem and responds to its state.  The information on
  70.         scripts in Chapter 99 should prove useful.
  71.  
  72.  
  73.         7.22  Manual Dialing with Smart Modems
  74.  
  75.         Some hotels and exotic locales sport telephone systems with unusual
  76.         dialing requirements.  It may be necessary to dial the call with the
  77.         telephone, talk to an operator, and then activate the modem.  With
  78.         Hayes compatible modems, an ATD command may be given to the modem to
  79.         connect it to the line and attempt a data handshake.
  80.  
  81.  
  82.         7.23  Direct Connection
  83.  
  84.         ZCOMM works well communicating with locally connected microcomputers,
  85.         minicomputers, or mainframes with direct RS-232 connections.  For such
  86.         applications, only transmit and receive data data lines need be
  87.         connected to the computer.  The Carrier Detect line[5] should be
  88.         driven ON (+5 volts) to prevent noise on this line by strapping it to
  89.         Data Terminal Ready [6] if no other signal is available.
  90.  
  91.         For best high speed operation, replace 8250 or 16450 UART chips with
  92.         the NS16550AN chip.  ZCOMM enables the hardware buffering on this chip
  93.         to avoid data loss caused by TSR programs, special device drivers,
  94.         extended memory disks or caches, and DOS clock interrupts.
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.         __________
  110.  
  111.          5. Pin 8 on 25 pin RS-232 connector, pin 1 on PC-AT 9 pin connector.
  112.  
  113.          6. Pin 20 on RS-232 connector, pin 4 on PC-AT 9 pin connector.
  114.  
  115.  
  116.  
  117.         (C) 1990 Omen Tech Inc              Chapter 7 Your Telephone Directory
  118.  
  119.  
  120.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  121.         ZCOMM User Manual                                                   33
  122.  
  123.         8.  YOUR TELEPHONE DIRECTORY
  124.  
  125.         ZCOMM's telephone directory is a big flexibility advantage over
  126.         traditional communications programs which require one or more separate
  127.         files for each system called, or limit directory information to little
  128.         more than a telephone number.
  129.  
  130.         The telephone directory is a plain ASCII text file which can be edited
  131.         with standard text editors (brief, teco, EMACS, edlin, etc.).
  132.         Normally, ZCOMM expects to find the telephone directory in the file
  133.         /PHODIR.t on the current disk.  The pathname may be changed with the
  134.         PHONES environment variable.  Forward slashes should be used to
  135.         indicate directories.
  136.  
  137.         EXAMPLE: C>set PHONES=c:/yam/lib/PHODIR.t
  138.  
  139.  
  140.         EXAMPLE: $ PHONES=/u/flashg/bin/phones.t; export PHONES (for Unix)
  141.  
  142.  
  143.         The putsnp program may also be used to change ZCOMM's default
  144.         Telephone Directory pathname.
  145.  
  146.         The call command connects to another computer.  When you give a
  147.         call name command, ZCOMM prepares for a modem call and then searches
  148.         the telephone directory file for a line starting with name.
  149.  
  150.         It is not necessary to type the entire name as it appears in the file.
  151.         ZCOMM will find the first entry that name is a prefix of.
  152.  
  153.         EXAMPLE: call cis would access either the cis300 or cis1200 telephone
  154.         directory entry, whichever was first.
  155.  
  156.         When using two entries with similar names (such as "cis300" and
  157.         "cis1200"), place the favorite entry first.  This way you can just
  158.         type call cis to get the desired entry.
  159.  
  160.         If the search is successful, the call command copies the complete
  161.         directory entry name to the remote string parameter, where it can be
  162.         used for log entries and automatic password generation.  ZCOMM
  163.         executes the commands on the rest of the line (if any), and on
  164.         succeeding lines beginning with a space or tab, until the next
  165.         Telephone Directory entry or a return command is seen.
  166.  
  167.         There is no arbitrary limit to the size of the telephone directory.
  168.         Popular entries may be placed near the front to minimize searching
  169.         time.  When desired, Scripts can be placed in separate files
  170.         referenced with a source command from the Telephone Directory entry.
  171.  
  172.  
  173.  
  174.  
  175.  
  176.         (C) 1990 Omen Tech Inc              Chapter 8 Your Telephone Directory
  177.  
  178.  
  179.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  180.         ZCOMM User Manual                                                   34
  181.  
  182.         8.1  Customizing Your Telephone Directory
  183.  
  184.         8.1.1  TAKE A SHORTCUT WITH PHOMAST.T  This starter script was written
  185.         by Michael Ash of San Antonio, Texas.  It is easy to configure and use
  186.         by following the detailed instructions included in the file itself.
  187.  
  188.         8.1.2  CUSTOMIZING PHONES.T  Compared to phomast.t, phones.t is the
  189.         "industrial strength" prototype directory.  While not as easy to
  190.         configure as phomast.t, it is powerful enough to tame a TrailBlazer
  191.         and other complex modems.
  192.  
  193.         When ZCOMM begins execution, it searches the telephone directory for
  194.         the setup entry.  (A directory entry has the entry name starting at
  195.         the left margin.)
  196.  
  197.  
  198.         The setup telephone directory in the distributed phodir.t file invokes
  199.         a demonstration menu.  Once you have exercized the various
  200.         demonstration possibilities, search for the xsetup telephone directory
  201.         and change it to setup be removing the "x".  This will blank out the
  202.         oroginal setup entry which appears later in the file.
  203.  
  204.         setup     port 1
  205.  
  206.         The first line of the "setup" entry selects port 1.
  207.  
  208.              : if !c speed 1200 putw "ATZ\r"
  209.  
  210.         This line is commented out with a colon (:).  If the colon is removed,
  211.         the speed is changed to 1200 and ZCOMM sends an initialization command
  212.         to the modem if no carrier detect signal is present.  If a carrier
  213.         detect signal is present (modem still connected to the remote
  214.         computer), the speed is not changed, and no initialization command is
  215.         sent to the modem.
  216.  
  217.              pd1; pz480
  218.  
  219.         enables incoming time/date information provided by the ZMODEM and True
  220.         YMODEM protocols.  Time/date stamping of transmitted files provides
  221.         many advantages over traditional protocols, including the ability to
  222.         selectively transmit files if the source file is newer than receiver's
  223.         copy.  The number in the pz480 command should represent the local time
  224.         zone expressed as minutes behind GMT.[1]
  225.  
  226.         This line should be commented out with a leading colon (or removed) if
  227.  
  228.  
  229.         __________
  230.  
  231.          1. Pacific Standard Time is 480 minutes behind Greenwich Mean Time
  232.  
  233.  
  234.  
  235.         (C) 1990 Omen Tech Inc              Chapter 8 Your Telephone Directory
  236.  
  237.  
  238.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  239.         ZCOMM User Manual                                                   35
  240.  
  241.         you use a backup program that depends on the dates of files to
  242.         determine which to save.
  243.  
  244.              set mprefix "ATDP"
  245.  
  246.         sets the string parameter mprefix to ATDP, setting the Hayes modem to
  247.         use rotary (pulse) dialing.  If your phone uses tone dialing, comment
  248.         that line out (place a leading colon to make ZCOMM pass over it) and
  249.         uncomment the line containig "ATDT".
  250.  
  251.              set l "1"; set m "1"
  252.  
  253.         The l and m string parameters support the dynamic selection of one or
  254.         more ALDS alternate long distance carriers.  The default values for
  255.         these parameters is the digit 1.
  256.  
  257.         When making entries in your telephone directory, use %l- for numbers
  258.         with different area codes, and %m- for numbers with the same area code
  259.         as yours.
  260.  
  261.         If you use a long distance credit card or sometimes dial out from
  262.         hotel or PBX lines, be sure to modify the att, ddd, hotel9, and hotel8
  263.         telephone directory entries in phones.t to suit your needs.
  264.  
  265.         The set command sets the string parameter l (lower case L) to 1
  266.         (number), providing for normal long distance access.  If you have an
  267.         alternative long distance service, set this parameter to the required
  268.         access string for that service.[2] The "set m 1" command sets the
  269.         string parameter m to 1, providing for normal long distance access for
  270.         numbers in your same area code.  If you have an alternative long
  271.         distance service, set this parameter to the required access string for
  272.         that service, plus your area code if required. (Some alternate long
  273.         distance services require the area code for all calls, even those in
  274.         your own area code.)
  275.  
  276.              set answerback "YOUR NAME CITY\r\n\21"
  277.  
  278.         Change the answerback setting to reflect your name.[3] Be sure to keep
  279.         the \21 at the end of the string.[4]
  280.  
  281.         The next lines configure soft keys F3 to FS4.  Their functions are
  282.  
  283.  
  284.         __________
  285.  
  286.          2. Use the "setsavenet" entry in PHODIR.t as a prototype.
  287.  
  288.          3. Some timesharing systems may require a specific answerback string.
  289.  
  290.          4. See Chapter 25 for a description character escapes.
  291.  
  292.  
  293.  
  294.         (C) 1990 Omen Tech Inc              Chapter 8 Your Telephone Directory
  295.  
  296.  
  297.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  298.         ZCOMM User Manual                                                   36
  299.  
  300.         described at the end of Chapter 18.
  301.  
  302.              : display bell=visual
  303.  
  304.         Causes bell characters to be displayed as a flashing musical note
  305.         instead of sounding.  If you want a silent bell, uncomment this line.
  306.  
  307.              set quitcmd "\003\336off\r"
  308.  
  309.         This string is sent to the remote before disconnecting when an ALT-Q
  310.         is typed during a protocol file transfer.
  311.  
  312.              : set calllog c:/calllog
  313.              : set rxlog c:/tmp/rxlog
  314.              : set txlog c:/tmp/txlog
  315.  
  316.         The above lines set the pathnames for logs of calls, files received,
  317.         and files transmitted.
  318.  
  319.              set f10 "@help"
  320.              if fyamhelp.t set helpfile "yamhelp.t"
  321.              if f/umanh.hlp set helpfile "@yhp /umanh.hlp"
  322.              if fumanh.hlp set helpfile "@yhp umanh.hlp"
  323.  
  324.         The above lines locate the help file and program F10 to summon the
  325.         help processor if available.  These lines may be changed if you keep
  326.         these files in other directories.
  327.  
  328.              : if dc ps4 pn2 pr97
  329.  
  330.         If a color display is used on DOS, uncommenting this line selects red
  331.         status line (ps4), green normal text (pn2), and a blue/yellow for
  332.         reverse video (pr97).  These colors may be more suitable than the
  333.         default black and white.  Another possibility is "pn3" which selects
  334.         blue-green for normal text.  You may wish to experiment with these
  335.         values to find ones best suited for your particular combination of
  336.         display equipment and visual preferences.  Changing the colors from
  337.         time to time may prolong display tube life.  The colors Telephone
  338.         Directory entry* displays the colors generated by the possible numeric
  339.         parameter values:
  340.  
  341.         EXAMPLE: gosub colors
  342.  
  343.         Some programs, including the "DEC Store" demonstration, will not
  344.         display exactly as intended with some combinations of the above
  345.         display parameters.
  346.  
  347.         You may wish to keep your phone numbers etc.  in one file and relegate
  348.         information specific to each computer to a separate file.  The setup
  349.         entry in phones.t checks for the existience of a phones.ts file and
  350.         executes it of found.
  351.  
  352.  
  353.         (C) 1990 Omen Tech Inc              Chapter 8 Your Telephone Directory
  354.  
  355.  
  356.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  357.         ZCOMM User Manual                                                   37
  358.  
  359.              set s0 ""
  360.              setc pho "%PHONES\&s";  if f%pho source %pho
  361.              if %s0 return
  362.  
  363.         The supplied phones.ts file is used on Omen's 386 Xenix system, and
  364.         may be used as an example.  On DOS, if you use VT100 emulation with
  365.         keyboard mapping most of the time, you can add the contents of the
  366.         keyboard mapping file std.mk, xen.mk, or 101.mk to your phones.ts
  367.         file.
  368.  
  369.         While editing your telephone directory, you might wish to add some
  370.         entries for your favorite systems in the same format used by the
  371.         "amrad", "amsat", or "denver" directory entries.
  372.  
  373.         When the PHODIR.t file is ready, type "ZCOMM<ENTER>" to run ZCOMM.
  374.         ZCOMM will print several lines of greeting and then silently execute
  375.         the commands in the setup directory entry.
  376.  
  377.         If ZCOMM can't open PHODIR.t, exit ZCOMM with "x<ENTER>" and copy
  378.         PHODIR.t to the correct directory, or set the DOS PHONES environment
  379.         variable to the actual pathname (see Chapter 15).  Also check that the
  380.         DOS CONFIG.SYS files contains FILES=20 to allow ZCOMM a sufficient
  381.         number of open files for proper script operation.  If using DOS 3.2 or
  382.         later, you may need to add a STACKS line to your CONFIG.SYS file, as
  383.         described in Chapter 33.
  384.  
  385.         EXAMPLE: STACKS=20,128
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.         (C) 1990 Omen Tech Inc                 Chapter 8 Tutorial Introduction
  413.  
  414.  
  415.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  416.         ZCOMM User Manual                                                   38
  417.  
  418.         9.  HANDS ON TUTORIAL
  419.  
  420.         As a first order of business, run the demonstration program by typing
  421.         ZCOMMDEMO at the DOS prompt.  The demo asks certain questions about
  422.         your system, and then allows you to exercise a few of ZCOMM's features
  423.         from a menu.  It's a good way to get a first "feel" for ZCOMM before
  424.         getting down to business with the industrial strength software you
  425.         will be using.
  426.  
  427.         Remember to turn off the CAPS LOCK key when running ZCOMM.
  428.  
  429.         ASSUMPTIONS: In addition to the minimum hardware requirements for
  430.         ZCOMM, this tutorial assumes the use of a Hayes Smartmodem 1200 (or
  431.         equivalent) connected to the COM1 port in accordance with the
  432.         instructions in Chapter 7.  The tutorial assumes that ZCOMM.EXE,
  433.         YHP.EXE, UMANH.HLP, and PHODIR.t are copied to the root directory of
  434.         your working disk, and that ZCOMM.EXE has been serialized with the
  435.         putsnp program.  If your system configuration is different, you will
  436.         have to read the manual carefully to learn how to adjust for your
  437.         configuration.
  438.  
  439.         After typing ZCOMM from the DOS prompt to load ZCOMM, type F10 to
  440.         activate the flash-up help processor.  Browse through it to
  441.         familiarize yourself with the information available via the F10 (help)
  442.         key.
  443.  
  444.         To make a call without using a directory entry, type speed 1200 (or
  445.         whatever) and then the phone number:
  446.  
  447.         speed 1200 123-4567
  448.  
  449.         The modem then dials the number.  When you are connected, ZCOMM will
  450.         return to its command prompt.  Keyboard F2 to begin talking with the
  451.         remote.  Give some commands to the remote until several screens' worth
  452.         of text have scrolled by.
  453.  
  454.         Now press the PgUp function key.  The screen will now display text
  455.         that had scrolled off before.  Use the PgUp, Home, PgDn, and End
  456.         function keys to move around in the review buffer.
  457.  
  458.         Look for a moderately interesting nugget of wisdom, and use the up
  459.         arrow and down arrow function keys on the numeric keypad to place the
  460.         interesting part at the top of the screen.
  461.  
  462.         Hit "t" to set the top marker.  This causes all the text to display in
  463.         high intensity.  Now move down using the down arrow key to place the
  464.         first line of unwanted text at the top of the screen.
  465.  
  466.         Hit the "b" key to set the bottom pointer.  This will change the
  467.         displayed text back to normal intensity.
  468.  
  469.  
  470.  
  471.         (C) 1990 Omen Tech Inc                 Chapter 9 Tutorial Introduction
  472.  
  473.  
  474.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  475.         ZCOMM User Manual                                                   39
  476.  
  477.         Now hit "w" and ZCOMM will prompt for a filename to write to.  Type
  478.         the filename followed by <ENTER>, and ZCOMM will write the selected
  479.         data.  When the write operation is finished, the screen will redisplay
  480.         the text.
  481.  
  482.         When you have the feel of it, type F1 to return to the term function
  483.         and conversational connection to the remote computer.
  484.  
  485.         The demonstration disk circular buffer search/cut/paste menu choice
  486.         demonstrates many of the review subcommands.
  487.  
  488.         Next, log off the remote computer.  When it drops the line, ZCOMM
  489.         displays No Carrier Detect in reverse video to announce that the
  490.         connection has been lost.  At this time you are still in the term
  491.         function.
  492.  
  493.         Hit F1 to return to ZCOMM's command prompt.  Then type "off<ENTER>" to
  494.         disconnect the modem and exit back to the operating system.
  495.  
  496.         Now is a good time to read the rest of the manual to discover the
  497.         power of ZCOMM.  Chapter 9 presents some unusual sessions
  498.         demonstrating more of ZCOMM's capabilities.
  499.  
  500.         9.1  Sample Sessions
  501.  
  502.                           Direct connection to COM2 at 19kb
  503.  
  504.          unix  port 2 speed 19200 source 101.mk; t
  505.           |         |         |      |
  506.           |         |         | Map keyboard, Invoke term function
  507.           |         |         ___ Set 19200 bits per second
  508.           |         ______________ Select port COM2
  509.           _________________________ System name
  510.  
  511.                                 Typical bulletin board
  512.  
  513.          rcpm   port 1 speed 1200 123-4567 t -8g
  514.           |         |      |         |     |
  515.           |         |      |         |     _ Term function, graphics
  516.           |         |      |         _______ Number to call
  517.           |         |      __________________ 1200 baud
  518.           |         _________________________ Select COM1
  519.           ____________________________________ System name
  520.  
  521.                                A Not so Typical Session
  522.  
  523.         The example below assumes a Hayes modem connected to a radio receiver
  524.         tuned to the W1AW ASCII bulletins.  Refer to a recent issue of QST
  525.         Magazine for a W1AW schedule.  to select the best signal.  Usually,
  526.         the error rate is lowest when receiving a strong signal near the
  527.         Maximum Useable Frequency (MUF).  Set the radio for Upper Sideband
  528.  
  529.  
  530.         (C) 1990 Omen Tech Inc                       Chapter 9 Sample Sessions
  531.  
  532.  
  533.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  534.         ZCOMM User Manual                                                   40
  535.  
  536.         (USB) reception.  Tune it so the resulting audio frequencies make the
  537.         RD (Received Data) light turn on about 50 percent of the time.  Reset
  538.         the modem by powering it down before attempting regular calls.
  539.  
  540.         w1aw speed 110 putw "ATS10=255 C0 H2 D\r" t -v
  541.                  |                  |                |
  542.                  |                  |        -v prints control chars
  543.                  |                  |        as ^C so they won't
  544.                  |                  |        erase the screen, etc.
  545.                  |   Ignore Carrier Detect, Carrier Off, Special Off
  546.                  |   Hook (Don't close relay), Originate, Online
  547.                  |________ W1AW ASCII transmissions are at 110 bps
  548.  
  549.         A>ZCOMM call unix   Connect to a local system named unix
  550.         jabber jabber ...   Login to system, change directory
  551.         <ALT-2>Command:     Get a ZCOMM command prompt
  552.         sz prg?.? prghlp.mm Upload some files
  553.         jabber jabber ...
  554.         sz *.c *.h          Download some source files
  555.         Receiving ...       ZMODEM AutoDownload accepts them
  556.         kermit -ix          Start the Unix Kermit server
  557.         <F1>>>>c:           Get ZCOMM's command prompt
  558.         remote dir          Get a directory listing
  559.         Directory...        Directory listing on screen
  560.         get f2              Get (fetch) a file
  561.         f2 Open ...         File arrives
  562.         send myfile         Send myfile to server
  563.         finish              Finish server access
  564.         t                   Enter term function
  565.         kermit send f1      Start a Kermit file transfer
  566.         f1 Open...          File is received AUTOMAGICALLY!
  567.         jabber jabber ...   Log off local system
  568.         <F1>>>>c:           Get ZCOMM's command prompt
  569.         port 1              Select modem on COM1
  570.         call rcpm           Dial a system called "rcpm"
  571.         jabber jabber ...   Keyboarding with remote
  572.         <Home>              Review function at top of text
  573.         /to superhacker     Search for beginning of message to you
  574.         t                   Set top pointer
  575.         /to j. fred muggs   Search for beginning of next message
  576.         b                   Set bottom pointer
  577.         w                   Write selected text to a disk file
  578.         <F1>                Return to term function
  579.         E<ENTER>            Tell the rcpm to enter a message
  580.         <ALT-2>Command:     Get a ZCOMM command prompt
  581.         open -pt letter     Open "letter" and send to bbs, using
  582.                             prompt and throttle modes to slow
  583.                             transmission so the remote system won't
  584.                             drop characters.
  585.         dir                 Find out what files are on the RCPM
  586.         xmodem s foo.bqr    Command RCPM to download a file
  587.  
  588.  
  589.         (C) 1990 Omen Tech Inc                       Chapter 9 Sample Sessions
  590.  
  591.  
  592.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  593.         ZCOMM User Manual                                                   41
  594.  
  595.         <ALT-2>Command:     Get a ZCOMM command prompt
  596.         rc foo.bqr          Download a file with XMODEM/CRC
  597.         PgUp PgUp ...       Flip back to the first part of
  598.                             directory previously listed
  599.         <ENTER>             Back to term function
  600.         xmodem s dr.who     Download a critical file
  601.         <ALT-2>Command:     Get a ZCOMM command prompt
  602.         rc \misc\dr.who     Download the file
  603.         jabber jabber ...   More keyboarding, logoff
  604.         <F1>>>>c:           Get ZCOMM's command prompt
  605.          Connect the modem to the radio's audio and tune in W1AW
  606.         create rtty.tmp     Create a disk file for the bulletins
  607.         call w1aw
  608.         bleep twort sneep   Static on the radio - pure line hits until
  609.                             W1AW is received while sending ASCII
  610.         <F2>k               Review/k command clears the buffer
  611.         QST DE W1AW ...
  612.         END ... AR
  613.         <ALT-C>             Close the capture file
  614.         <F1>>>>c:off        Return to DOS
  615.  
  616.  
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.         (C) 1990 Omen Tech Inc            Chapter 9 Accessing Computer Systems
  649.  
  650.  
  651.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  652.         ZCOMM User Manual                                                   42
  653.  
  654.         10.  ACCESSING COMPUTER SYSTEMS
  655.  
  656.         10.1  Dialing
  657.  
  658.         Once you modem is interfaced per Chapter 7, you can connect to a
  659.         remote system with the call command referencing an entry in your
  660.         telephone directory.
  661.  
  662.         EXAMPLE: call kgbvax
  663.  
  664.  
  665.         If a telephone directory entry has not been set up, TurboLearn(TM) may
  666.         be invoked to dial a phone number and then learn your login procedure
  667.         by keyboarding the F4 key.  You may choose to add the resulting script
  668.         to your telephone directory, or retain it as a separate file acessible
  669.         with the source command.  Please refer to the learn command in Chapter
  670.         18.
  671.  
  672.         If you just want to call a number without ZCOMM learning anything,
  673.         just type the telephone number from the command prompt already.[1]
  674.  
  675.         EXAMPLE: 123-4567
  676.  
  677.         When the modem connects, ZCOMM returns to the command prompt.  You can
  678.         then keyboard the F2 key to connect your keyboard to the remote
  679.         system.  If you wish to use "bulletin board graphics", use t -8g
  680.         instead.
  681.  
  682.         10.2  Telenet/PC-Pursuit
  683.  
  684.         For best results, identify with D1 when Telenet asks for your terminal
  685.         type.  This selection prevents the network from adding padding
  686.         characters, which are just a waste of time with ZCOMM.
  687.  
  688.         To use XMODEM, YMODEM, Telink, and other traditional protocols on PC
  689.         Pursuit, type
  690.  
  691.         SET 1:0,4:2,5:0,7:8,12:0
  692.  
  693.         after connecting to the PC-Pursuit target city.  This command prevents
  694.         Telenet from "eating" control characters or breaking the connection
  695.         when files containing certain patterns are transmitted.  This command
  696.         disables Telenet's "<ENTER>@<ENTER>" escape.
  697.  
  698.         For ZMODEM or Sliding Windows Kermit a better alternatitive is:
  699.  
  700.  
  701.         __________
  702.  
  703.          1. You may wish to add the /mnp modifier described in Chapter 7.
  704.  
  705.  
  706.  
  707.         (C) 1990 Omen Tech Inc           Chapter 10 Accessing Computer Systems
  708.  
  709.  
  710.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  711.         ZCOMM User Manual                                                   43
  712.  
  713.         SET 4:2,5:1,12:1
  714.  
  715.         Please refer to Chapter 13 for network flow control considerations.
  716.  
  717.         10.3  Tymnet
  718.  
  719.         If using Tymnet, type Ctrl-R Ctrl-X just before the host computer name
  720.         to enable software flow control with XOFF and XON characters.  "Half
  721.         Duplex" may be activated with Ctrl-H.  Check with your network's
  722.         documentation for further details or updates to this information.
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.         (C) 1990 Omen Tech Inc                           Chapter 10 File Names
  767.  
  768.  
  769.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  770.         ZCOMM User Manual                                                   44
  771.  
  772.         11.  FILE NAMES Good and Bad
  773.  
  774.         The pathnames of downloaded files must be legal PC-DOS file names as
  775.         described in The File Specification in chapter 2 of the PC-DOS manual.
  776.         When choosing file names, remember that PC-DOS does not distinguish
  777.         between uppercase and lowercase characters in pathnames.
  778.  
  779.         The Compuserve-B, ZMODEM, YMODEM, and Kermit protocols use pathnames
  780.         generated by the sending program.  File names transmitted from other
  781.         systems may not be legal for DOS, or they may reference directories
  782.         that cannot be created.[1]
  783.  
  784.         When ZCOMM receives a pathname from the sending program, ZCOMM first
  785.         checks for the existence of a file with the same name.  If no such
  786.         file is found, ZCOMM attempts to open the named file for writing.  If
  787.         the file cannot be created because directories specified in the
  788.         pathname do not exist, ZCOMM attempts to create the directories.  A
  789.         pathname that cannot be opened for reading or writing is considered
  790.         illegal.
  791.  
  792.         EXAMPLE: foo..bar is illegal for DOS because it contains two dots.
  793.  
  794.         An Illegal pathname is translated to name.NNN where name is the
  795.         filename portion of the given file name restricted to 8 characters,
  796.         and NNN is an assigned three digit number starting with 001 and
  797.         incremented after each file download.  If a file with this new name
  798.         already exists, the number is incremented up to 999, until a unique
  799.         file name is found.  The open fails if a unique number cannot be
  800.         found.
  801.  
  802.         EXAMPLE: A downloaded file with the name newprog.patch.1 might
  803.         actually be downloaded as newprog.001.
  804.  
  805.         This check for illegal file names is made whenever ZCOMM attempts to
  806.         create an output file.
  807.  
  808.         EXAMPLE: t foo.bar.baz given from the command prompt would invoke file
  809.         name translation.
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.         __________
  819.  
  820.          1. A cirectory cannot be created if a regular file with the same
  821.             pathname is present.
  822.  
  823.  
  824.  
  825.         (C) 1990 Omen Tech Inc                           Chapter 11 File Names
  826.  
  827.  
  828.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  829.         ZCOMM User Manual                                                   45
  830.  
  831.         11.1  Pathname Translations
  832.  
  833.         Files affected by the dirrx, dircx and dirpx string variables have
  834.         their directory paths and/or device specifier stripped if the string
  835.         variable ends in a "/".  Otherwise a file specification with an
  836.         absolute path overrides the string variable.  The pathname of the
  837.         incoming file is checked before any of these transformations, allowing
  838.         a host system to place all files received with a protocol in a private
  839.         directory.
  840.  
  841.         EXAMPLE: C>set DIRRX=C:/download
  842.         places files received with a protocol in the download directory on
  843.         drive C unless the file specification included an absolute path or
  844.         device letter.
  845.  
  846.         dirrx     File Stored Location
  847.         (empty)   any  (same)
  848.         C:/a f    C:/a/f
  849.         C:/a /f   /f
  850.         C:/a A:f  A:f
  851.         C:/a/     f    C:/a/f
  852.         C:/a/     /f   C:/a/f
  853.         C:/a/     A:f  C:/a/f
  854.  
  855.  
  856.         Parameter Affected commands
  857.         dirrx     r{bcotwx7}, fget, get, bdump, usq, ZMODEM/Kermit
  858.         AutoDownload
  859.         dirsx     s{bctx7}, send, B protocol sends[2]
  860.         dircx     create, t, message, private, >, bro/a
  861.                   ap[d] (2nd argument)
  862.         dirpx     review/w
  863.         dirfx     f, open
  864.  
  865.         To show the possible pathname translations, consider the pathmame:
  866.         A:/spy/kgb/sabotage/666 sent between two copies of ZCOMM with the
  867.         ZMODEM protocol.
  868.  
  869.         The sending program command: sz A:/spy/kgb/sabotage/666 sends the file
  870.         name 666.
  871.  
  872.         The command sz -f A:/spy/kgb/sabotage/666 sends the complete pathname
  873.         /spy/kgb/sabotage/666.
  874.  
  875.  
  876.  
  877.         __________
  878.  
  879.          2. If the dirsx parameter is set, ambiguous or wild card file names
  880.             cannot be used.
  881.  
  882.  
  883.  
  884.         (C) 1990 Omen Tech Inc                           Chapter 11 File Names
  885.  
  886.  
  887.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  888.         ZCOMM User Manual                                                   46
  889.  
  890.         The command sz ONAME=hogwash A:/spy/kgb/sabotage/666 sends the
  891.         pathname hogwash.
  892.  
  893.         sz PREFIX=C:/fbi/security/intelligence A:/spy/kgb/sabotage/666
  894.         sends the pathname C:/fbi/security/intelligence/666.  Note that a disk
  895.         identifier (C:) is being sent.
  896.  
  897.         On reception with ZMODEM AutoDownload or the rz command, the last
  898.         example (C:/fbi/security/intelligence/666) would normally be stored
  899.         under that exact pathname, creating the directories C:/fbi,
  900.         C:/fbi/security, and C:/fbi/security/intelligence if needed.
  901.  
  902.         If the dirrx string variable had contained C:/downloads the incoming
  903.         drive specifier would still have overidden the dirrx specification.
  904.  
  905.         If the dirrx string variable had contained C:/ollie/to_do/ the file
  906.         would have ended up as C:/ollie/to_do/666 to the consternation of all.
  907.  
  908.         The command rz foobar could have been used to rename this file to
  909.         foobar in the current directory.
  910.  
  911.         The oncloserx and onclosetx string parameters may be used to specify
  912.         commands to execute after each file received or sent with file
  913.         transfer protocols.  Their use is described in Chapter 12.
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.         (C) 1990 Omen Tech Inc              Chapter 11 Protocol File Transfers
  944.  
  945.  
  946.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  947.         ZCOMM User Manual                                                   47
  948.  
  949.         12.  PROTOCOL FILE TRANSFERS
  950.  
  951.         With many different ways to transfer files with ZCOMM, your choice of
  952.         file transfer methods could make the difference between efficient,
  953.         error free data and slow or error prone transfers.  This chapter gives
  954.         an overview of the different ways to transfer files with emphasis on
  955.         their relative merits.
  956.  
  957.         A file transfer protocol should have high integrity (assurance of
  958.         accurate data) and high robustness (low probability of aborting a
  959.         transfer).
  960.  
  961.         The following subchapters discuss these file transfer methods in more
  962.         detail.
  963.  
  964.         12.1  ZMODEM-90
  965.  
  966.         ZMODEM was developed for the public domain under contract by Telenet,
  967.         a major packet switched network.  ZMODEM has been submitted to the
  968.         ANSI X12C committee.
  969.  
  970.         ZMODEM-90(TM) is a refinement of ZMODEM with increased performance,
  971.         reliability and compatibility with a wider variety of environments.
  972.  
  973.         ZMODEM provides a greatly simplified user interface.  The file name is
  974.         entered once, and transfer options may be given to the sending
  975.         program, even those that apply to the receiver.  ZMODEM
  976.         AutoDownload(TM) allows menu and mouse driven programs to download
  977.         files and commands with no extra keyboarding required.
  978.  
  979.         ZMODEM transfers one or more files with a single command.  The size
  980.         and transfer time for each file is displayed, and the total number of
  981.         files, size, and transmission time is displayed when more than one
  982.         file remains to be sent on a command.
  983.  
  984.         Keyboarding ALT-F allows the receiver to bypass an individual file
  985.         without having to restart the batch.
  986.  
  987.         ZMODEM transfers both files and commands.  Command download allows one
  988.         of the computers to take positive control of the session.  A security
  989.         challenge (activated by ZMODEM AutoDownload(TM)) guards against Trojan
  990.         Horse messages.*
  991.  
  992.         ZMODEM file transfers preserve the file date and the exact file
  993.         contents, unlike traditional protocols that append garbage to files.
  994.  
  995.         Streaming transmission provides full throughput over satellite links
  996.         and packet switched networks.  One of three ZMODEM streaming control
  997.         methods may be used with systems that allow the sender to monitor the
  998.         received data for error correction packets without interrupting
  999.         transmission.  ZMODEM's "block length" is the entire file!
  1000.  
  1001.  
  1002.         (C) 1990 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1003.  
  1004.  
  1005.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1006.         ZCOMM User Manual                                                   48
  1007.  
  1008.         Individually acknowledged packets support other systems.
  1009.  
  1010.         ZMODEM allows programs to adjust the protocol parameters for optimum
  1011.         efficiency as the file is being sent.  ZMODEM-90 allows programs to
  1012.         adjust character encoding for best results with a variety of systems.
  1013.  
  1014.         Some programs support ZMODEM compression for even faster file
  1015.         transfers under appropriate conditions with the Z file transfer option
  1016.         (q.v.).
  1017.  
  1018.         ZMODEM is immune to conditions that prevent reliable, accurate file
  1019.         transfers with traditional protocols:
  1020.  
  1021.          + ZMODEM data transfers are protected by the Federal Standard 32 bit
  1022.            CRC to assure reliable transfers.  This 32 bit CRC gives an
  1023.            undetected error rate five orders of magnitude better than XMODEM's
  1024.            16 bit CRC, and more than a billion times better than checksum
  1025.            XMODEM.  ZMODEM uses 16 bit CRC for file transfers with programs
  1026.            that do not support 32 bit CRC.
  1027.  
  1028.          + Most important, all ZMODEM protocol transactions are protected by
  1029.            CRC.  Other protocols advertising 16 or 32 bit CRC sometimes fail
  1030.            under stress because critical control messages are not protected by
  1031.            CRC.
  1032.  
  1033.         Omen Technology Inc's Intelligent Crash Recovery(TM) and advanced file
  1034.         management.  If you've ever been disconnected when a huge file
  1035.         transfer was almost finished, you'll appreciate resuming/recovering
  1036.         the file transfer with the ZMODEM r option.
  1037.  
  1038.         You can use the ZMODEM n option to transfer only those files that have
  1039.         changed since the last time they were transferred.  With the p option,
  1040.         you can unconditionally protect files that already exist on the
  1041.         destination system.  To update only the files you already have while
  1042.         skipping the rest, use the Yn options.
  1043.  
  1044.         To send a file with ZMODEM, the command sz file1 can be given from
  1045.         either the main command prompt, or from the term function via a
  1046.         secondary command prompt obtained with ALT-2.  Multiple files and wild
  1047.         cards may be used.
  1048.  
  1049.         EXAMPLE: sz file1 file2 *.lst
  1050.  
  1051.  
  1052.         12.1.1  ZMODEM AutoDownload  If Z mode has been enabled (the default),
  1053.         ZCOMM's term function will detect a ZMODEM transmission and receive
  1054.         the file(s) automatically, after a security check.  File transfer
  1055.         options for ZMODEM automatic downloads may be specified with the
  1056.         adlopts string parameter.
  1057.  
  1058.         The rz command may be also given from a command prompt.
  1059.  
  1060.  
  1061.         (C) 1990 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1062.  
  1063.  
  1064.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1065.         ZCOMM User Manual                                                   49
  1066.  
  1067.         Please refer to the sz and zcommand commands described in Chapter 18
  1068.         for examples and information.
  1069.  
  1070.         Rz and sz programs for Unix and VAX/VMS are available in rzsz.zoo.
  1071.  
  1072.         12.1.2  Tuning ZMODEM Parameters  Chapter 23.2 describes a number of
  1073.         ZMODEM numeric parameters which may be adjusted for extraordinary
  1074.         situations, or to fine tune the last 0.1 per cent of possible
  1075.         performance.
  1076.  
  1077.         The ZMODEM subpacket length (zmodem L parameter) and the ZMODEM frame
  1078.         length (zmodem l parameter) deserve special mention.  People tend to
  1079.         confuse these with the familiar 128 and 1024 byte block length used in
  1080.         XMODEM transfers.
  1081.  
  1082.         When a ZMODEM frame length of 0 is specified (the default), a single
  1083.         frame will span the entire file if there are no errors.  This is the
  1084.         main source of ZMODEM's reputation for fast transfers.
  1085.  
  1086.         Setting the ZMODEM frame length to a number between 64 and 16384
  1087.         restricts the frame length to that value.  At the end of each frame,
  1088.         the sender stops sending and waits for an acknowledgement from the
  1089.         receiver.  When set, the ZMODEM frame length corresponds in function
  1090.         to the 128 or 1024 byte block length of XMODEM based protocols.
  1091.  
  1092.         Each ZMODEM frame consists of one or more subpackets of 32 to 1024
  1093.         bytes.  Since the subpackets within a frame are sent without pause, a
  1094.         short subpacket length does not exact the terrible throughput penalty
  1095.         associated with short XMODEM and Kermit blocks.  In the absence of
  1096.         transmission errors, a 256 byte subpacket length has about two per
  1097.         cent more overhead than a 1024 byte subpacket length.  However, the
  1098.         longer subpacket length does increase error recovery time.
  1099.  
  1100.         ZCOMM dynamically adjusts the ZMODEM subpacket length on the basis of
  1101.         transmission speed and observed error rate.  If you know what the
  1102.         error rate on a particular call will be before starting a ZMODEM file
  1103.         transfer, setting the zmodem L numeric parameter will provide a small
  1104.         but noticeable improvement in performance, with 1024 best for clean
  1105.         lines and smaller numbers better for noisy lines.
  1106.  
  1107.         When sending files over noisy phone lines not involving networks, the
  1108.         speed of error recovery may be increased by decreasing the values of
  1109.         the ZMODEM t and p numeric parameters.
  1110.  
  1111.         Fascinating information about ZMODEM and other protocols is provided
  1112.         in ymodem.doc and zmodem.doc, part of yzmodem.zoo (yzmodem.arc).
  1113.  
  1114.         12.1.3  MobyTurbo  Standard ZMODEM escapes network control characters.
  1115.         This causes a slight drop in throughput when sending compressed files.
  1116.         When transferring compressed files over circuits that pass all 256 8
  1117.         bit codes, Moby Turbo(TM) may be used to optimize speed.  MobyTurbo
  1118.  
  1119.  
  1120.         (C) 1990 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1121.  
  1122.  
  1123.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1124.         ZCOMM User Manual                                                   50
  1125.  
  1126.         increases transfer speed without sacrificing ZMODEM flexibility or
  1127.         robustness.
  1128.  
  1129.         MobyTurbo is activated with the m option.  The m option may be used
  1130.         with the sz or rz command.
  1131.  
  1132.         EXAMPLE: sz -m *.zip
  1133.  
  1134.         MobyTurbo may be used with ZMODEM AutoDownloads by adding the m option
  1135.         to the adlopts string.
  1136.  
  1137.         EXAMPLE: set adlopts m
  1138.  
  1139.  
  1140.         12.1.4  Receiver Window Size Override  ZMODEM-90(TM) allows the
  1141.         receiver to specify the window size, with the Wn option, overriding
  1142.         the sender's window size.
  1143.  
  1144.         SEE ALSO: Wn option
  1145.  
  1146.         12.1.5  Almost 8 bit Environments  The e and m options may be used in
  1147.         conjunction with the xmtxesc and zmrxesc string parameters may to
  1148.         specify one or more control characters which cannot be passed over the
  1149.         serial line.
  1150.  
  1151.         SEE ALSO: zmtxesc, zmrxesc string parameters for details
  1152.  
  1153.         12.1.6  7 Bit Environments  ZMODEM-90 automatically detects 7 bit
  1154.         environments and adjusts accordingly.  When transferring files with a
  1155.         large number of bytes with the 8th bit set, the P ("pack") option may
  1156.         be used to optimize 7 bit encoding.
  1157.  
  1158.         12.1.7  Manual ABORT  If a ZMODEM transfer fails abruptly under
  1159.         exceptional conditions the program on the remote machine may be
  1160.         manually terminated by repeatedly typing Ctrl-X characters at it until
  1161.         the program exits.
  1162.  
  1163.         12.2  XMODEM Family Protocols
  1164.  
  1165.         12.2.1  TRUE YMODEM(TM)  Developed in 1981, YMODEM is finding its way
  1166.         into many communications programs.  With Omen's Enhanced Data
  1167.         Recovery(TM), YMODEM gives excellent efficiency, integrity, and good
  1168.         robustness in many applications.
  1169.  
  1170.         True YMODEM transfers one or more files in a batch, without alteration
  1171.         or added garbage characters.  True YMODEM also preserves the file date
  1172.         across multiple time zones.  ZCOMM and the Unix(TM) rb and sb programs
  1173.         preserve the file modification date.[1]
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.         (C) 1990 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1180.  
  1181.  
  1182.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1183.         ZCOMM User Manual                                                   51
  1184.  
  1185.         12.2.2  YMODEM-1k  The sb k option (1024 byte blocks) may be used to
  1186.         enhance throughput, especially when using timesharing systems,
  1187.         satellite links, or packet networks that can support the longer
  1188.         blocks.
  1189.  
  1190.  
  1191.         EXAMPLE: sb -k *.c *.h sends all .c and .h files in the current
  1192.         directory with 1024 byte blocks.[2]
  1193.  
  1194.         YMODEM and YMODEM-1k transfers can be received with the rb or F3
  1195.         commands.
  1196.  
  1197.         YMODEM file transfers with Unix and VMS systems are discussed later in
  1198.         this chapter.
  1199.  
  1200.         A few obsolete programs claiming to support YMODEM actually use XMODEM
  1201.         with 1024 byte blocks; use ZCOMM's sx -k and rc commands when
  1202.         necessary to exchange data with these non standardized products.
  1203.  
  1204.         12.2.3  YMODEM with OverThruster  YMODEM and YMODEM-1k file
  1205.         downloading from networks and timesharing systems is slowed by
  1206.         response times.  This slowing may be significant even when 1k blocks
  1207.         are used.  With some systems, one can speed up YMODEM downloads by
  1208.         using the o option with the rb command to receive the file.  Because
  1209.         OverThruster(TM) defeats error recovery, a line hit will usually abort
  1210.         a download.  OverThruster(TM) may be used with X.PC or MNP error
  1211.         correcting link level protocols.
  1212.  
  1213.         EXAMPLE: rb -o
  1214.  
  1215.  
  1216.         SEE ALSO: O numeric parameter
  1217.  
  1218.         12.2.4  XMODEM-1k  The XMODEM-1k protocol transfers one file per
  1219.         command with 1024 byte blocks and a nominal 16 bit CRC.  The file name
  1220.         must be entered for both the sender and the receiver.  Programs
  1221.         lacking ZCOMM's Cybernetic Data Recovery(TM) logic are less likely to
  1222.         transfer data accurately under marginal conditions.  XMODEM's use of
  1223.         every possible 8 bit code limit its effectiveness in many
  1224.         applications.
  1225.  
  1226.         The end of the file may be padded by up to 127 or 1023[3] garbage
  1227.  
  1228.  
  1229.         ______________________________________________________________________
  1230.  
  1231.          1. Controlled by the d and z numeric parameters
  1232.  
  1233.          2. ZCOMM switches to 128 byte blocks at the end of a file when the
  1234.             length warrants.
  1235.  
  1236.  
  1237.  
  1238.         (C) 1990 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1239.  
  1240.  
  1241.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1242.         ZCOMM User Manual                                                   52
  1243.  
  1244.         characters.
  1245.  
  1246.         To send a file with XMODEM-1k: sx -k file1
  1247.  
  1248.         To receive a file with XMODEM-1k: rc file1
  1249.  
  1250.         12.2.5  XMODEM-CRC (with fallback)  The XMODEM-CRC protocol transfers
  1251.         one file per command.  The XMODEM-CRC protocol requires the receiving
  1252.         program to initiate an XMODEM-CRC transfer.
  1253.  
  1254.         The file name must be entered for both the sender and the receiver.
  1255.         Even with CRC-16, programs lacking ZCOMM's Cybernetic Data
  1256.         Recovery(TM) are less likely to transfer data under marginal
  1257.         conditions.  XMODEM-CRC's short data blocks and use of every possible
  1258.         8 bit code limit its effectiveness in many applications.
  1259.  
  1260.         The end of the file may be padded by up to 127 garbage characters.
  1261.  
  1262.         To send a file with XMODEM (or XMODEM-CRC): sx file1
  1263.  
  1264.         To receive a file with XMODEM-CRC: rc file1
  1265.  
  1266.         12.2.6  Classic XMODEM  The original MODEM protocol, developed by Ward
  1267.         Christensen, is supported by a large and growing number of programs
  1268.         operating on a variety of micros and minis.  The base level XMODEM
  1269.         protocol gives good results when used over low error rate direct
  1270.         telephone connections.  XMODEM's short data blocks and use of every
  1271.         possible 8 bit code preclude its application in many environments.
  1272.  
  1273.         File transfers with this protocol add up to 127 garbage characters to
  1274.         transferred files.  The XMODEM protocol can transfer one file per
  1275.         command.  The file name must be entered at both the sender and the
  1276.         receiver.
  1277.  
  1278.         To send a file with XMODEM: sx file1
  1279.  
  1280.         To receive a file with Classic XMODEM: rx file1
  1281.  
  1282.         12.2.7  Relaxed XMODEM  ZCOMM's XMODEM and YMODEM support has been
  1283.         optimized for maximum reliability with a wide variety of systems under
  1284.         a wide variety of conditions.
  1285.  
  1286.         The default XMODEM and YMODEM timeout parameterss are "relaxed"
  1287.         timings.  They rarely need to be lengthened except under the most
  1288.         sluggish of conditions.  The zmodem t, T, and p numeric parameters
  1289.  
  1290.  
  1291.         ______________________________________________________________________
  1292.  
  1293.          3. Some programs (including ZCOMM) limit this padding to 127 bytes.
  1294.  
  1295.  
  1296.  
  1297.         (C) 1990 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1298.  
  1299.  
  1300.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1301.         ZCOMM User Manual                                                   53
  1302.  
  1303.         (q.v.) control timeouts for XMODEM, YMODEM, and ZMODEM.  The default
  1304.         values allow 10 seconds for a packet to appear and a 10 second pause
  1305.         within a packet before starting error recovery.
  1306.  
  1307.         EXAMPLE: zmodem pt200 pp150  :: Set more relaxed X/Y/ZMODEM timing
  1308.  
  1309.  
  1310.         For best reliability, Omen Technology does not recommend tightening
  1311.         these timings for XMODEM and YMODEM transfers on noisy lines.
  1312.  
  1313.         12.2.8  XMODEM with OverThruster  XMODEM file downloading from
  1314.         networks and timesharing systems is slowed by short blocks and long
  1315.         response times.  With some systems, one can speed up downloads by
  1316.         using the ro command to receive the file.  Because OverThruster(TM)
  1317.         defeats error recovery, a line hit will usually abort a download.
  1318.         With nearly error free connections, one can save enough time from the
  1319.         increased throughput to make up for the failed transfers.
  1320.         OverThruster(TM) may be used with X.PC or MNP error correcting link
  1321.         level protocols.
  1322.  
  1323.         EXAMPLE: ro file1
  1324.  
  1325.  
  1326.         EXAMPLE: rb -o
  1327.  
  1328.  
  1329.         SEE ALSO: O numeric parameter
  1330.  
  1331.         12.2.9  YMODEM-g: Traditional Overdrive  The proliferation of error
  1332.         correcting modems has sparked a proliferation of YMODEM-g programs,
  1333.         more and more of which actually meet minimal YMODEM protocol
  1334.         specifications.
  1335.  
  1336.         YMODEM-g transmits 0 or more files per batch with an ACK-less variant
  1337.         of YMODEM-1k.  The sender does not wait for individual data blocks to
  1338.         be acknowledged, allowing high speed transfers with error correcting
  1339.         modems.
  1340.  
  1341.         YMODEM-g assumes an error free communications channel.  A single
  1342.         transmission error or character lost because of DOS or TSR interrupt
  1343.         latency ruins the entire transfer, and YMODEM-g does not support Crash
  1344.         Recovery(TM).
  1345.  
  1346.         ZCOMM supports True YMODEM-g with the sb and rb -g commands.
  1347.  
  1348.         EXAMPLE: sb *.old Sends files in the current directory with YMODEM or
  1349.         YMODEM-g protocol.  The receiver controls whether YMODEM or YMODEM-g
  1350.         is used for the transfer.
  1351.  
  1352.  
  1353.         EXAMPLE: rb -g Receives with YMODEM-g protocol.
  1354.  
  1355.  
  1356.         (C) 1990 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1357.  
  1358.  
  1359.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1360.         ZCOMM User Manual                                                   54
  1361.  
  1362.         12.2.10  XMODEM Mutants Misrepresented as YMODEM  Despite continuing
  1363.         education efforts, a few lazy software providers insist on identifying
  1364.         their mutant XMODEM protocols as "ymodem".  They choose to ignore the
  1365.         definition of YMODEM that Ward Christensen wrote when he coined the
  1366.         term YMODEM in his April 1985 message:
  1367.  
  1368.            (a) a record 0 containing filename date time and size
  1369.            (b) a 1K block size option
  1370.            (c) CRC-16.
  1371.  
  1372.         In case of questions, please refer to ymodem.doc, part of yzmodem.zoo
  1373.         (yzmodem.arc) for for the official YMODEM protocol.
  1374.  
  1375.         12.2.11  Qmodem-G/Streaming XMODEM  The Qmodem program and certain
  1376.         bulletin boards provide an ACKless XMODEM mutant protocol selected
  1377.         with the Qmodem G protocol menu choice.
  1378.  
  1379.         The sx and rx -g commands support this mutant XMODEM.
  1380.  
  1381.         EXAMPLE: rx -g qmodem.fil
  1382.  
  1383.  
  1384.         12.2.12  WXMODEM (People-Link)  ZCOMM supports WXMODEM protocol
  1385.         downloads with the rw command.  On the People-Link timesharing
  1386.         service, WXMODEM downloads are faster than XMODEM downloads.
  1387.         Throughput, reliability, accuracy, and amenities are not as good as
  1388.         ZMODEM or SuperKermit, but neither of these protocols are currently
  1389.         available on that system.  WXMODEM adds up to 127 garbage bytes to
  1390.         transferred files.  Omen Technology does not recommend WXMODEM for use
  1391.         over noisy phone lines.
  1392.  
  1393.         EXAMPLE: rw file1
  1394.  
  1395.  
  1396.         12.2.13  MODEM7 Batch  The MODEM7 batch protocol passes CP/M file
  1397.         names from the sending program to the receiver one character at a
  1398.         time.  The compatibility, throughput, and reliability problems of this
  1399.         kluge prompted the development of YMODEM.  Nonetheless, when it
  1400.         becomes necessary to transfer files with a program lacking more
  1401.         advanced protocols, MODEM7 batch is better than nothing.
  1402.  
  1403.         File names transmitted with the MODEM7 batch protocol must obey the
  1404.         restrictions of both 8 bit CP/M and DOS.  The f option cannot be used
  1405.         with MODEM7 batch.  Data transfer within MODEM7 batch uses XMODEM
  1406.         protocol, and all of XMODEM's weaknesses discussed above apply to
  1407.         MODEM7 batch.  MODEM7 batch does not preserve the modification date or
  1408.         exact file contents.
  1409.  
  1410.         EXAMPLE: s7 file1.ext *.baz sends files with MODEM7 batch.
  1411.  
  1412.  
  1413.  
  1414.  
  1415.         (C) 1990 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1416.  
  1417.  
  1418.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1419.         ZCOMM User Manual                                                   55
  1420.  
  1421.         EXAMPLE: r7 receives one or more files with MODEM7 batch.
  1422.  
  1423.  
  1424.         12.2.14  Telink/FIDO  The Telink protocol expands upon the MODEM7
  1425.         batch kluge with a specially formatted block containing the length of
  1426.         the file and the local DOS time and date.  All of the MODEM7 batch
  1427.         compatibility and reliability problems apply to Telink.[4] The zmodem
  1428.         Z numeric parameter or the z file transfer option may be used to
  1429.         correct the time/date stamping of files transferred between different
  1430.         time zones.
  1431.  
  1432.         EXAMPLE: zmodem pZ120;  st file1.ext *.baz Sends the specified files
  1433.         with a 2 hour time zone adjustment.
  1434.  
  1435.  
  1436.         EXAMPLE: rt -z60 Receives one or more files with a 60 minute time zone
  1437.         adjustment.
  1438.  
  1439.  
  1440.         12.2.15  SEAlink  When transferring files with the CLINK 1.13
  1441.         compatible programs, ZCOMM's rb and sb commands recognize SEAlink's
  1442.         modified Telink protocol.  The rb command allows a transmitting
  1443.         SEAlink program to use sliding windows.  Telink time zone and file
  1444.         name considerations apply to SEAlink.  In addition, because SEAlink
  1445.         uses all 256 of the possible 8 bit codes for both data transfer and
  1446.         protocol management, some modems and networks that operate with XMODEM
  1447.         will not accommodate SEAlink.  As with the MODEM7 and Clink protocols
  1448.         mentioned above, the SEAlink protocol is included for convenience in
  1449.         situations where the YMODEM and ZMODEM protocols are not
  1450.         implemented.[5]
  1451.  
  1452.         EXAMPLE: zmodem pZ120;  sb file1.ext *.baz Sends the specified files
  1453.         to a SEAlink program with a 2 hour time zone adjustment.
  1454.  
  1455.  
  1456.         EXAMPLE: rb -z60 Receives one or more files from a SEAlink program
  1457.         with a 60 minute time zone adjustment.
  1458.  
  1459.  
  1460.  
  1461.         __________
  1462.  
  1463.          4. ZCOMM's rt and st commands were verified with Minitel 3.0 by Tom
  1464.             Jenning's Fido Software; other Programs may not produce the same
  1465.             results.
  1466.  
  1467.          5. ZCOMM's SEAlink was verified with CLINK 1.13 by Systems
  1468.             Enhancement Associates.  Other Programs may not produce the same
  1469.             results because of ambiguities in the SEAlink documentation and
  1470.             undocumented protocol variants.
  1471.  
  1472.  
  1473.  
  1474.         (C) 1990 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1475.  
  1476.  
  1477.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1478.         ZCOMM User Manual                                                   56
  1479.  
  1480.         12.3  Kermit
  1481.  
  1482.         12.3.1  ZCOMM Kermit Capabilities At a Glance
  1483.          Local operation..................Yes
  1484.          Remote operation.................Yes
  1485.          Transfers text files.............Yes
  1486.          Transfers binary files...........Yes
  1487.          Wildcard send....................Yes
  1488.          Filename collision avoidance.....Yes
  1489.          Can time out.....................Yes
  1490.          8th-bit prefixing................Yes
  1491.          8 bit serial data................Yes
  1492.          Sliding Windows..................Yes
  1493.          Long Packets.....................Yes
  1494.          Repeat count prefixing...........Yes
  1495.          Alternate block checks...........Yes
  1496.          Terminal emulation...............Multiple
  1497.          Communication settings...........Yes
  1498.          Transmit BREAK...................Yes
  1499.          IBM mainframe communication......Yes
  1500.          Transaction logging..............Yes
  1501.          Act as server....................no
  1502.          Talk to server...................Yes
  1503.          Advanced commands for servers....Yes
  1504.          Handle file attributes...........no
  1505.          Programmable reset string........Yes
  1506.  
  1507.         Kermit operates with a wide range of computer systems, including those
  1508.         whose restrictive terminal interfaces prevent XMODEM transfers.
  1509.         Kermit uses an encoding technique called quoting to represent control
  1510.         characters and (if necessary) parity bits with standard printable
  1511.         characters.  It is one of the few asynchronous error correcting
  1512.         protocols that work properly with half duplex IBM front ends.  Because
  1513.         of the overhead from character quoting, Kermit is less efficient
  1514.         (slower) than ZMODEM.
  1515.  
  1516.         Kermit can transfer one or more files per command, preserving the
  1517.         exact file length.
  1518.  
  1519.  
  1520.         EXAMPLE: kermit sb file1 file2
  1521.  
  1522.  
  1523.         EXAMPLE: kermit rb
  1524.  
  1525.  
  1526.         12.3.2  Incompatible Kermit Dialects  When sending files with the
  1527.         Kermit Protocol, ZCOMM uses all 8 bits for the transfer unless a 7 bit
  1528.         parity mode (e.g., ena -7e) is used, the kermit 7 numeric parameter is
  1529.         non zero, or the other program requests 8th bit qouting.  If ZCOMM is
  1530.         using a 7 bit parity mode (such as ena -7m), ZCOMM requests 8th bit
  1531.  
  1532.  
  1533.         (C) 1990 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1534.  
  1535.  
  1536.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1537.         ZCOMM User Manual                                                   57
  1538.  
  1539.         quoting unless the kermit 8 numeric parameter is non zero.
  1540.  
  1541.         -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  1542.                         Both programs must use the same parity
  1543.                         for Kermit file transfers to succeed.
  1544.         -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  1545.  
  1546.         Kermit does not provide an automatic means of forcing both the sender
  1547.         and receiver to use the same dialect.  Files cannot be transferred if
  1548.         the two programs disagree on parity handling, Such failures are quite
  1549.         commonplace.  A common symptom is a transfer that starts up normally
  1550.         but always fails at the same block.  Setting appropriate parity
  1551.         corrects these Kermit failures.
  1552.  
  1553.         ZCOMM's Kermit AutoDownload(TM) (enabled with the K mode) allows the
  1554.         term function to sense the beginning of a Kermit file download, make
  1555.         the proper determination on whether to use 8 bit serial data, and
  1556.         execute the file download without user intervention.
  1557.  
  1558.         12.3.3  Kermit Performance Enhancements  Super-Kermit (Kermit with
  1559.         Sliding Windows) transmits multiple packets before waiting for a
  1560.         response, increasing throughput with timesharing systems and networks.
  1561.         ZCOMM uses sliding windows and CRC error detection if the other
  1562.         machine's Kermit supports them.
  1563.  
  1564.         ZCOMM also supports long packets for increased throughput with
  1565.         suitable systems, including many that do not support sliding windows.
  1566.         ZCOMM allows Kermit long packets up to 1000 characters on DOS, up to
  1567.         2048 on 32 bit Unix systems.
  1568.  
  1569.         The maximum send packet length is set by the kermit l numeric
  1570.         parameter.  ZCOMM will ask for sliding windows if this is set to 94 or
  1571.         less.
  1572.  
  1573.         EXAMPLE: k pl94
  1574.  
  1575.  
  1576.         The maximum receive packet length is set by the kermit L numeric
  1577.         parameter.  ZCOMM will ask for sliding windows if this is set to 94 or
  1578.         less.
  1579.  
  1580.         EXAMPLE: k pL94
  1581.  
  1582.  
  1583.         With the default values for the kermit l and kermit L parameters,
  1584.         ZCOMM will choose long packets over sliding windows when a choice is
  1585.         possible.
  1586.  
  1587.         ZCOMM supports 12 bit Kermit checksums and 16 bit Kermit CRC for
  1588.         professional error detection performance.  ZCOMM uses the most
  1589.         reliable Kermit error correction available.  Shorter checksums may be
  1590.  
  1591.  
  1592.         (C) 1990 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1593.  
  1594.  
  1595.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1596.         ZCOMM User Manual                                                   58
  1597.  
  1598.         forced by changing the kermit b numeric parameter.
  1599.  
  1600.         12.3.4  Accessing Kermit Servers  The commands to start up a Kermit
  1601.         server vary from system to system.  Unix C-Kermit can be started in
  1602.         server mode with kermit -ix given to Unix or VMS.  When the Kermit
  1603.         server is active, the ZCOMM get, send, and remote ...  commands may be
  1604.         used.  The ZCOMM finish command causes the remote Kermit server to
  1605.         exit to its operating system.
  1606.  
  1607.         12.3.5  Kermit Caveats  Some versions of Kermit translate files as
  1608.         they are sent, by default!  Typical modifications include CR/LF to NL
  1609.         transformations and CPMEOF stripping.  Before transferring binary
  1610.         files, such editing must be disabled with SET FILE TYPE BINARY or
  1611.         similar commands given to the other program.  The demonstration in
  1612.         Chapter 9 includes several Kermit server access and file transfer
  1613.         commands.
  1614.  
  1615.         If the Kermit protocol doesn't work with IBM mainframe communications,
  1616.         incorrect ASCII/EBCDIC translate tables may be the problem.
  1617.  
  1618.         Some mainframe "front ends" require special characters or a break
  1619.         signal to recover from transmission errors ("line hits").  The
  1620.         kermreset string parameter (q.v.) may be programmed with the required
  1621.         sequence.
  1622.  
  1623.         SEE ALSO: kermreset string parameter
  1624.  
  1625.         When downloading files from some versions of Kermit, best results may
  1626.         sometimes be obtained by starting ZCOMM's kermit receive before typing
  1627.         the carriage return that starts the sender on the remote.  If the
  1628.         other program includes an adjustable initial delay, you can save time
  1629.         by setting it to zero.
  1630.  
  1631.         SEE ALSO: kermit d numeric parameter
  1632.  
  1633.         SEE ALSO: K mode (Kermit AutoDownload(TM))
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.         (C) 1990 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1652.  
  1653.  
  1654.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1655.         ZCOMM User Manual                                                   59
  1656.  
  1657.         12.4  Uploading Files to Unix Systems
  1658.  
  1659.         Files may be uploaded to Unix systems conveniently and quickly with
  1660.         ZMODEM.  Unix flavors of Professional-YAM support the full ZMODEM-
  1661.         90(TM) feature set including Crash Recovery and selective transfers
  1662.         with the rz command, a hard link to the /usr/bin/yam program.
  1663.  
  1664.         The undos program may be used to remove carriage returns files
  1665.         uploaded to Unix machines.
  1666.  
  1667.         When accessed over a network, some systems require additional control
  1668.         characters to be escaped.  The sz command e option may be used to
  1669.         escape all control characters.
  1670.  
  1671.         SEE ALSO: e option
  1672.  
  1673.         Individual control characters can be escaped with the zmtxesc string
  1674.         parameter.
  1675.  
  1676.         SEE ALSO: zmtxesc string parameter
  1677.  
  1678.         If the Unix system is operating with 7 bits, the sender's zmodem d
  1679.         parameter may have to be increased to allow the rz program time to
  1680.         change Unix to 8 bits for the transfer.
  1681.  
  1682.         SEE ALSO: zmodem d numeric parameter
  1683.  
  1684.         Pro-YAM may not be available on a particular system.  The rz program
  1685.         supports a subset of ZCOMM's ZMODEM features.[6]
  1686.  
  1687.  
  1688.  
  1689.         __________
  1690.  
  1691.          6. If rz is not installed on the Unix system, unpack the rzsz.zoo
  1692.             file on your MSDOS system with: looz -e rzsz.zoo given from the
  1693.             DOS prompt.  On Unix systems with Professional-YAM installed, the
  1694.             rzsz source files and man pages are located in
  1695.             /usr/src/command/rzsz.  Next, the command source zupl.t calls the
  1696.             zupl.t script to upload the bootstrap file minirb.c, compile it,
  1697.             and use it to upload the remainder of the source files.
  1698.  
  1699.             After the rest of the files have been uploaded, compile rz.c and
  1700.             sz.c using the directions given in the README file and in the C
  1701.             source files.
  1702.  
  1703.             The manual "pages" rz.1 and sz.1 may be formatted with nroff
  1704.             commands such as
  1705.  
  1706.                     nroff -Tlp -man rz.1 sz.1
  1707.  
  1708.  
  1709.  
  1710.         (C) 1990 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1711.  
  1712.  
  1713.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1714.         ZCOMM User Manual                                                   60
  1715.  
  1716.         12.5  Downloading Files from Unix Systems
  1717.  
  1718.         To download files from Unix(TM) systems, use the Unix sz command to
  1719.         send the desired files to ZCOMM.  To Unix keyboard: sz file ...
  1720.         ZCOMM's ZMODEM AutoDownload(TM) takes care of the rest for you, saving
  1721.         unnecessary keystrokes.
  1722.  
  1723.         If one or more of the files already exists on the destination disk,
  1724.         use sz -y file ...  instead, to replace the old copies on your
  1725.         computer.
  1726.  
  1727.         Another useful option sends only the files that exist on both
  1728.         computers (Y), and furthermore sends only those that are newer (n):
  1729.         sz -Yn file ...
  1730.  
  1731.         When files are long and transmission slow, you can save time by
  1732.         squeezing them first with sq.  Source for a Unix compatible version of
  1733.         sq is available in xsq.cq.[7] The zoo program, available for DOS and
  1734.         Unix, may also be used to compress file(s) before transmission.
  1735.  
  1736.         Omen Technology products support ZMODEM compression with the Z option.
  1737.         All Omen Technology products support compression by Run Length
  1738.         Encoding (RLE).  Unix flavors of Professional-YAM also support LZW
  1739.         compression.
  1740.  
  1741.         Unix source files normally do not contain carriage returns used by
  1742.         CP/M and DOS.  Some CP/M or DOS programs, such as C compilers, do not
  1743.         require carriage returns in the source files.  Others, such as the
  1744.         Microsoft Macro Assembler, become quite confused by such files,
  1745.         although such files fully meet the requirements of the ASCII standard.
  1746.  
  1747.         Carriage Returns may be added before downloading with the todos or
  1748.         tocpm programs.  Carriage returns may be added during the transfer
  1749.         with the sz a option.  Carriage Returns may be added after the
  1750.         transfer by some program editors, including uEMACS.  (Other editors,
  1751.         such as DOS edlin may crash trying to edit such files.) Short files
  1752.         (less than 64kb) may be converted using ZCOMM's read and create
  1753.         commands to pass the data through ZCOMM's capture buffer.
  1754.  
  1755.         Text files may also be downloaded using the capture buffer if sz has
  1756.         not been installed on the Unix machine.
  1757.  
  1758.         If a file or set of files are to be transported between two Unix
  1759.         systems, it may be helpful to place them in a tar or cpio archive (and
  1760.         possibly squeeze the archive) before transmission.  This procedure
  1761.  
  1762.  
  1763.         __________
  1764.  
  1765.          7. /usr/src/cmd/xsq.c on Unix systems.
  1766.  
  1767.  
  1768.  
  1769.         (C) 1990 Omen Tech Inc              Chapter 12 Protocol File Transfers
  1770.  
  1771.