home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / comm / zcmd1761.zip / ZCOMMDOC.AA < prev    next >
Text File  |  1990-06-26  |  71KB  |  1,771 lines
  1.  
  2.  
  3.                                     Chuck Forsberg
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                                    User Manual for
  14.                                         ZCOMM
  15.  
  16.                             Universal Line Printer Edition
  17.  
  18.  
  19.                             ZCOMM Communications Software
  20.  
  21.                                       Featuring
  22.                             TurboLearn(TM) Script Writer,
  23.                  Cybernetic Data Recovery(TM), Error Containment(TM),
  24.                                          and
  25.                                    OverThruster(TM)
  26.  
  27.                      User Supported Communications Software Tools
  28.  
  29.  
  30.  
  31.                                    User Manual for
  32.                                         ZCOMM
  33.                             Universal Line Printer Edition
  34.  
  35.  
  36.                           Copyright 1990 Omen Technology Inc
  37.                                  All Rights Reserved
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                              Omen Technology Incorporated
  44.  
  45.  
  46.  
  47.                             The High Reliability Software
  48.                             Box 4681 Portland Oregon 97208
  49.                               VOICE: 503-621-3406 :VOICE
  50.                   TeleGodzilla Modem: 621-3746 Speed 1200,2400,19200
  51.                    Compuserve:70007,2304  GEnie:CAF  BIX:cforsberg
  52.                           UUCP: ...!tektronix!reed!omen!caf
  53.            Copyright 1984 to 1990  Omen Technology INC All Rights Reserved
  54.  
  55.  
  56.  
  57.  
  58.         (C) 1990 Omen Tech Inc                                      Chapter 0
  59.  
  60.  
  61.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  62.         ZCOMM User Manual                                                    2
  63.  
  64.         1.  INTRODUCTION
  65.  
  66.                                         ZCOMM
  67.                    Industrial Stength Communications Shareware(TM)
  68.  
  69.         ZCOMM helps collect, control, and transmit information with a minimum
  70.         of time, hassle, and expense.  Concise commands and unobtrusive
  71.         displays facilitate telecommunications instead of distracting.
  72.  
  73.         When it comes to file transfers, just remember who wrote YMODEM and
  74.         ZMODEM.  Two decades of telecommunications knowledge are distilled in
  75.         ZCOMM.
  76.  
  77.  
  78.         1.1  Data Capture
  79.  
  80.         ZCOMM's Full-Time Capture Buffer(TM) saves scrolled data other
  81.         programs lose.  You can scroll, page, and string search to cut and
  82.         paste captured information.
  83.  
  84.         Omen's Error Containment(TM) technology minimizes errors caused by
  85.         line hits and their effects on automatic scripts.
  86.  
  87.         ZCOMM captures text with many choices of parity bit and control
  88.         character editing.  ZCOMM can capture binary data without protocols.
  89.         ZCOMM does not limit the length of captured files.
  90.  
  91.         1.2  File Transfer Protocols
  92.  
  93.         Years of communications experience distilled in ZCOMM provide rapid
  94.         file transfers with unmatched reliability.  Unsolicited customer
  95.         testimonials chronicle accurate file transfers under conditions that
  96.         crash the other programs, thanks to Omen Technology's Cybernetic Data
  97.         Recovery(TM) compatible logic enhancements and thorough protocol
  98.         stress testing.
  99.  
  100.         ZCOMM's protocols are more cost effective than the minimal, unreliable
  101.         XMODEM support available with other programs.  They are easier to find
  102.         and more useful than undocumented proprietary protocols.
  103.  
  104.         1.3  ZMODEM-90(TM) Sate of the Art File Transfers
  105.  
  106.         "ZMODEM is the overall winner"
  107.                                -BYTE Magazine, Feb 1989
  108.  
  109.         How often has your modem disconnected when you were within the last
  110.         few bytes of a long, expensive file transfer?  With ZCOMM's ZMODEM
  111.         file transfers, you can resume the transfer from where you were cut
  112.         off, without wasted time or phone charges!  And, if the transfer
  113.         aborted because you ran out of disk space, ZMODEM can recover from
  114.         that too!
  115.  
  116.  
  117.         (C) 1990 Omen Tech Inc                          Chapter 1 Introduction
  118.  
  119.  
  120.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  121.         ZCOMM User Manual                                                    3
  122.  
  123.         ZMODEM transfers files and commands with a uniquely user friendly
  124.         interface.  Unlike traditional protocols, only one command or menu
  125.         choice is needed to transfer files or download commands.
  126.  
  127.         "Pro-YAM's Autodownload feature for ZMODEM (and KERMIT) has got me
  128.         completely addicted."
  129.  
  130.         A 32 bit Cyclic Redundancy Check, five orders of magnitude more
  131.         sensitive than CRC-16 and billions of times more sensitive than XMODEM
  132.         checksum protects your data.
  133.  
  134.         ZMODEM provides high throughput with full integrity even with
  135.         timesharing systems, high speed buffered modems, and packet switched
  136.         networks.  Unlike other "high speed protocols", ZMODEM's high speed
  137.         does not compromise reliability.
  138.  
  139.         Omen Technology's ZMODEM-90(TM) enhancements provide unmatched ZMODEM
  140.         transfer speeds and additional flexibility.
  141.  
  142.         ZMODEM compression provides spectacular throughput increases on
  143.         suitable files.
  144.  
  145.         Other ZMODEM features include text file translation, selective
  146.         transfer of modified files, and remote file maintenance.  Security
  147.         authentication* disables Trojan Horse attacks.  ZMODEM supports global
  148.         operations by preserving the exact file contents and modification
  149.         date, unaffected by crossing time zones.
  150.  
  151.         "Here's the simple fact. Zmodem is the state-of-the-art protocol for
  152.         microcomputers.  It's the protocol of choice.  Forget the old dogs.
  153.         It's fast and bullet-proof."
  154.                  -John C. Dvorak, INSIDE TRACK, PC Magazine June 1989
  155.  
  156.         "without doubt the number one protocol"
  157.                           -Boardwatch Magazine January 1990
  158.  
  159.         ZMODEM's convenience, speed and reliability have made it the protocol
  160.         of choice with bulletin boards, BIX, GEnie, Portal Unison, and other
  161.         information utilities.  While competitors hype the performance of
  162.         their undocumented proprietary protocols, experienced BBS operators
  163.         know ZMODEM is the only high performance protocol that survives on the
  164.         streets.
  165.  
  166.         Source code for complementary Unix and VMS programs is provided.
  167.  
  168.         1.4  XMODEM: The Lingua Franca of Traditional Programs
  169.  
  170.         ZCOMM supports the ubiquitous Ward Christensen "XMODEM" protocol with
  171.         Cybernetic Data Recovery(TM) and automatic file name generation.  Omen
  172.         Technology's exclusive Cybernetic Data Recovery(TM) transfers files
  173.         under conditions that crash other programs.
  174.  
  175.  
  176.         (C) 1990 Omen Tech Inc                          Chapter 1 Introduction
  177.  
  178.  
  179.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  180.         ZCOMM User Manual                                                    4
  181.  
  182.          + XMODEM CRC-16 Even today, few commercial programs support 16 bit
  183.            CRC, the standard of XMODEM file transfer technology since 1981.
  184.            CRC-16 error detection is orders of magnitude more accurate than
  185.            checksum.  Cybernetic Data Recovery(TM) catches and corrects
  186.            transmission errors that confound other programs.
  187.  
  188.          + True YMODEM(TM) batch file transfers preserve the exact file name,
  189.            file length and creation date.
  190.  
  191.          + XMODEM-1k and YMODEM-1k 1024 byte packets increase XMODEM/YMODEM
  192.            throughput.
  193.  
  194.         1.5  Kermit: A Cure for Brain Damage
  195.  
  196.         Kermit transfers ASCII and binary files with IBM, CDC, Cray, DEC, ICL,
  197.         Harris, Honeywell, Pr1me, Tandem, Univac and other mainframes that do
  198.         not support XMODEM.
  199.  
  200.         While not as fast as ZMODEM, Kermit is more reliable than
  201.         XMODEM/YMODEM.  ZCOMM's 16 bit Kermit CRC is thousands of times more
  202.         sensitive to errors than other programs' 6 bit checksum.
  203.  
  204.          + Convenient Kermit AutoDownload adjusts to the sending program's
  205.            Kermit dialect, saving keystrokes and frustration.  (Dialect
  206.            incompatibilities often confound users of other programs.)
  207.  
  208.          + Long Packet Kermit speeds file transfers with IBM, CDC, and Cray
  209.            mainframe systems.  Sliding Windows Kermit speeds other transfers.
  210.  
  211.          + Kermit Server Access functions support low cost networking.
  212.  
  213.         1.6  Swiss Army Knife for Protocols
  214.  
  215.          + Extended Quick-B streaming protocol slashes CompuServe download
  216.            costs up to 60 per cent or more.
  217.  
  218.          + OverThruster(TM) Speeds XMODEM and YMODEM downloads
  219.  
  220.          + ZCOMM supports bulletin boards and traditional communications
  221.            programs with MODEM7 batch, Telink/FIDO, and Clink/SEAlink file
  222.            transfer protocols.
  223.  
  224.          + WXMODEM (Windowed XMODEM) speeds People-Link(TM) timesharing
  225.            service downloads.
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.         (C) 1990 Omen Tech Inc                          Chapter 1 Introduction
  236.  
  237.  
  238.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  239.         ZCOMM User Manual                                                    5
  240.  
  241.         1.7  Controlling Information
  242.  
  243.         ZCOMM's Full-Time Capture Buffer(TM) lets you flip back and forth or
  244.         search, scanning two hundred messages from bulletin boards in a couple
  245.         of minutes.  (It has to be seen to be believed.) To compose a reply,
  246.         call your favorite editor (the one you've already learned!) as a
  247.         subroutine without losing your place.
  248.  
  249.         ZCOMM's high speed screen driver makes life pleasant:
  250.  
  251.         + Easy on the eyes: ZCOMM supports No Flicker displays, up to 450 per
  252.           cent faster than DOS
  253.  
  254.         + VT220, VT102, VT100, Wyse, TTY 5425, ANSI, Z19, VT52, TI 940, IBM
  255.           3101, Televideo 9xx, and ADM3a emulation.
  256.  
  257.         + Supports 132 columns and advanced displays (114x60, etc.)
  258.  
  259.         + VT100 character graphics and keyboard mapping support "visual"
  260.           programs.  Unlike most "VT100" emulators, ZCOMM correctly displays
  261.           EDT, AllIn1, SCO setcolor, and DEC Store on an XT even at 19200
  262.           baud.
  263.  
  264.         + Hardcopy Terminal Emulation previews printer output.
  265.  
  266.         + Visual (silent) bell preserves domestic tranquillity
  267.  
  268.         + Settable number of lines and columns, border color, default colors,
  269.           autowrap, keyboard mapping enable.
  270.  
  271.         Full pathnames, directories, and wildcards support file transfers and
  272.         utility commands.
  273.  
  274.         ZCOMM can search files for lines matching a string, insensitive to
  275.         case.
  276.  
  277.  
  278.         1.8  Transmitting Information
  279.  
  280.         + Dual stack Command Recall saves your keyboarded host commands in a
  281.           history file for search, recall, editing, and reentry.
  282.         + Convenient Split Screen option allows responsive local editing of
  283.           input lines before transmission.
  284.         + A rich palette of editing and timing modes permit file and message
  285.           upload, even to fussy microcomputer Bulletin Boards.
  286.         + Remote access for file transfers and DOS program execution with baud
  287.           rate detection and three passworded security levels.
  288.         + Outcall Queue intersperses scheduled outgoing calls with incoming
  289.           messages on one modem line.
  290.  
  291.  
  292.  
  293.  
  294.         (C) 1990 Omen Tech Inc                          Chapter 1 Introduction
  295.  
  296.  
  297.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  298.         ZCOMM User Manual                                                    6
  299.  
  300.         1.9  Other Features
  301.  
  302.  
  303.         Interrupt driven modem input allows High speed operation with file
  304.         transfer and conversational terminal operation at 19200 bps and above.
  305.         ZCOMM fully exploits advanced features of the new UART chips for best
  306.         operation at high speeds.
  307.  
  308.         A real-time status line displays column, row, time, elapsed time,
  309.         transmission speed, and other important information.
  310.  
  311.         Soft keys provide convenient execution of common commands.
  312.  
  313.         ZCOMM is written in C for performance, portability and
  314.         maintainability.  ZCOMM loads quickly from a moderately sized
  315.         executable file with no cumbersome overlays.
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.         (C) 1990 Omen Tech Inc                          Chapter 1 Registration
  354.  
  355.  
  356.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  357.         ZCOMM User Manual                                                    7
  358.  
  359.         2.  ZCOMM REGISTRATION
  360.  
  361.         ZCOMM is a user supported program developed and supported by Chuck
  362.         Forsberg.  ZCOMM is not and never has been public domain.
  363.  
  364.         Registration buys you:
  365.  
  366.            + Your own unique ZCOMM Serial Number Password (ZSNP).  Your ZSNP
  367.              may be applied to copies of ZCOMM to be run on a single machine.
  368.  
  369.                 + Serialized of ZCOMM deactivates the registration request
  370.                   display and the pause afterwards.
  371.  
  372.                 + Serialization activates the egrep, egrepm, expand, split,
  373.                   and ss commands and the outcall queue.  Features denoted
  374.                   with ** are available in serialized copies of ZCOMM.
  375.  
  376.                 + Serialization more than doubles the circular buffer size.
  377.  
  378.            + A software disk with the current version of ZCOMM, the putsnp
  379.              program to serialize your copy of ZCOMM with your ZSNP, and the
  380.              tree structured "flash-up" help processor and help file included
  381.              in ZCOMMHLP.ARC.
  382.  
  383.            + The complete Professional-YAM User Manual, more than 200 Typeset
  384.              pages, with many chapters not included here, ready for insertion
  385.              into a PC size binder.
  386.  
  387.            + The Pro-YAM Crib Sheet.
  388.  
  389.            + A ZCOMM registration is worth $40.00 when upgrading to
  390.              Professional-YAM.  The $99.00 upgrade includes the Pro-YAM
  391.              software disks and license.  You will already have the manual
  392.              from your ZCOMM registration package.
  393.  
  394.            + A warm fuzzy feeling arising from the knowledge you have
  395.              supported the advancement of ZMODEM.
  396.  
  397.         REGISTRATION DETAILS:
  398.  
  399.            + Basic registration (ZSNP, disk, manual pages): $40.00
  400.  
  401.            + Optional Custom Binder: $10.00
  402.  
  403.            + Optional 3.5 inch diskette: $5.00
  404.  
  405.            + Domestic/Canada Surface Shipping: Free with prepaid orders
  406.  
  407.            + International Air Mail (most countries): $15.00[1]
  408.  
  409.  
  410.  
  411.  
  412.         (C) 1990 Omen Tech Inc                          Chapter 2 Registration
  413.  
  414.  
  415.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  416.         ZCOMM User Manual                                                    8
  417.  
  418.            + Optional Domestic UPS Second Day AIR: $5.00
  419.  
  420.            + Credit Card/C.O.D. S&H:  $5.00
  421.  
  422.         Don't bother scrounging for an envelope, use the INSTANT MAILER
  423.         included in this archive!
  424.  
  425.  
  426.         2.1  Legal Necessities
  427.  
  428.         ZCOMM may not be modified, patched, hacked, disassembled, decompiled,
  429.         or otherwise reverse engineered, or sold, without prior written
  430.         permission by Omen Technology Inc.  This prohibition applies to any
  431.         theft of the intellectual property and trade secrets contained in
  432.         ZCOMM by decompilation, disassembly, or any other form of reverse
  433.         engineering including but not limited to profiling, tracing, data
  434.         analysis, or monitoring the operation of ZCOMM.
  435.  
  436.         The only legitimate way to disable the opening advertisement in ZCOMM
  437.         is to insert an authorized SNP obtained from Omen Technology into
  438.         ZCOMM with the putsnp program.  Any other suppression or modification
  439.         of the opening screen is illegal, unethical, and prohibited.
  440.  
  441.         Distribution of programs and/or instructions on how to modify, patch,
  442.         disassemble, decompile, or otherwise reverse engineer ZCOMM without
  443.         prior written permission by Omen Technology Inc is a theft of services
  444.         and a violation of federal copyright law, and will be referred to the
  445.         FBI for investigation and prosecution under federal conspiracy
  446.         statutes.  Applicable RICO law provides for treble damages and
  447.         recovery of attorney's fees.
  448.  
  449.         Distribution of ZCOMM in any medium without this documentation file
  450.         constitutes an unauthorized modification.
  451.  
  452.         Students may use unregistered copies of ZCOMM in the discharge of
  453.         assigned coursework for the duration of the course without obligation
  454.         to register.  Otherwise, individuals may use ZCOMM with only a moral
  455.         obligation to register their copy with Omen Technology once they find
  456.         it useful.  You may distribute the unmodified ZCOMM*.ARC archive
  457.         files[2] to as many as you wish, or post them on bulletin boards, etc.
  458.         Businesses must register their copies of ZCOMM.
  459.  
  460.  
  461.  
  462.         ______________________________________________________________________
  463.  
  464.          1. $25.00 to Australia etc. if binder included due to higher cost.
  465.  
  466.          2. The archives may be converted to other storage or archive formats,
  467.             including "zipping", provided no files are modified or removed.
  468.  
  469.  
  470.  
  471.         (C) 1990 Omen Tech Inc                          Chapter 2 Registration
  472.  
  473.  
  474.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  475.         ZCOMM User Manual                                                    9
  476.  
  477.         3.  ZCOMM's Big Brother
  478.  
  479.         ZCOMM is the Little Brother of Professional-YAM.  As powerful as ZCOMM
  480.         is, more powerful than other user supported software, it pales beside
  481.         Omen Technology's commercial Professional-YAM software.
  482.  
  483.         Pro-YAM's TurboDial(TM) script language provides state of the art real
  484.         time pattern recognition, "regular expiression" string parsing, script
  485.         development aids, script encryption, queue management, extensive
  486.         logging facilities, and finely tuned security control unmatched in the
  487.         industry.
  488.  
  489.         Fortune 500 corporations use these exclusive features to support large
  490.         PC based telecommunications projects involving attended and unattended
  491.         operation.
  492.  
  493.         Specialized utility commands allow Pro-YAM and a PC or DG/One portable
  494.         to replace data line monitors in many applications.  Pro-YAM supports
  495.         Echoplex uploads and high speed data dumps in addition to the uniquely
  496.         accurate and robust XMODEM, YMODEM, ZMODEM, and Kermit protocol
  497.         transfers shared with ZCOMM.  Pro-YAM has many powerful utility
  498.         commands that earn it the sobriquet Integrated Communications Tools.
  499.  
  500.         Pro-YAM is available with the Tymnet X.PC link level protocol for
  501.         multiple, concurrent data transfers.
  502.  
  503.         Omen Technology also markets highly compatible Unix and Xenix flavors
  504.         of Pro-YAM.
  505.  
  506.         Omen Technology's Demand Upgrade(TM) technology and small company
  507.         responsiveness meet the support needs of a growing base of demanding
  508.         customers.
  509.  
  510.         Professional-YAM is a superset of ZCOMM; applications and scripts
  511.         developed on ZCOMM will operate with Pro-YAM.
  512.  
  513.         This ZCOMM manual omits descriptions of many Pro-YAM features not
  514.         included in ZCOMM.  The special symbol * denotes Pro-YAM features not
  515.         included in ZCOMM.
  516.  
  517.         Pro-YAM features not included in ZCOMM include X.PC, encryption,
  518.         CryptoScript(TM) capability, Password Guardian(TM), logs, the ap, apd,
  519.         fget, fput, kbdmon, link, on, portx, purgek, quit, restime, restrict,
  520.         timestamp, trs, and usq commands, and certain vertical application and
  521.         security related features.  (Newer versions of ZCOMM include the
  522.         logging facility.)
  523.  
  524.         In some places you will see references to a fake Chapter 99.  Pro-YAM
  525.         manual chapters not included in this document are designated by
  526.         Chapter 99.
  527.  
  528.  
  529.  
  530.         (C) 1990 Omen Tech Inc                                 Chapter 3 ZCOMM
  531.  
  532.  
  533.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  534.         ZCOMM User Manual                                                   10
  535.  
  536.         ZCOMM registration can be upgraded to Pro-YAM as described in the
  537.         previous chapter.
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.         (C) 1990 Omen Tech Inc                     Chapter 3 Design Philosophy
  590.  
  591.  
  592.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  593.         ZCOMM User Manual                                                   11
  594.  
  595.         4.  DESIGN PHILOSOPHY
  596.  
  597.         ZCOMM is a Communications Tool.  Once learned, ZCOMM's command
  598.         interface is more powerful, faster, and less cumbersome than a menu
  599.         interface.  Indeed, menus comprehensive enough to describe all the
  600.         nuances of ZCOMM's capabilities would take up more memory than most
  601.         microcomputers can afford.  In addition, remote operation of ZCOMM
  602.         would be excruciatingly slow due to transmission delays displaying the
  603.         appropriate menu pages.
  604.  
  605.         ZCOMM's look and feel has been influenced by the MODEM series of
  606.         programs, the Unix(TM) Operating System, the Berkeley Editor (vi),
  607.         CP/M(TM), PC-DOS, and ANSI standards.
  608.  
  609.         Function keys F1 and F2 have been assigned with a logical grouping.
  610.         Wherever meaningful, F1 exits from a function, and F2 enters the
  611.         logical "next" function.  From the command prompt, F2 enters the term
  612.         function, and from there another F2 enters the review function.  Once
  613.         in the review function (assuming it was called from the term
  614.         function), F1 exits back to the term function, from where another F1
  615.         exits to the command prompt.
  616.  
  617.         Another ethic guiding ZCOMM's design is respect for the user's
  618.         information.  The user's data is, after all, precisely what a modem
  619.         program is all about.  Status information is limited to one CRT line
  620.         to allow maximum screen size for data.  Fancy display modes such as
  621.         reverse video are used sparingly to avoid distracting from the user's
  622.         work.
  623.  
  624.         If you seek a video arcade modem game, ZCOMM will disappoint you.
  625.  
  626.         4.1  Circular Buffer
  627.  
  628.         The circular buffer remotely resembles the linear "capture buffer"
  629.         used by other modem programs.  Many ZCOMM commands involve the
  630.         circular buffer, including the t, f, wait, ki, kill, w, review, and
  631.         close commands.
  632.  
  633.         The term function uses the circular buffer as a first in, first out
  634.         (FIFO) buffer for data arriving from the remote.  The circular
  635.         organization of this buffer makes the most recent data always
  636.         available for review and arbitrary writing to disk files.
  637.  
  638.         When the circular buffer has been filled and the XOFF character sent
  639.         to the remote, ZCOMM writes the contents of the circular buffer to the
  640.         capture file if a capture file has been opened.  ZCOMM then checks
  641.         whether any characters remain to be written to the printer.  When both
  642.         of these checks are satisfied, ZCOMM then sends an XON character to
  643.         the remote to resume the transmission of data.
  644.  
  645.         Keyboarding ALT-W or enabling j mode writes the contents of the
  646.  
  647.  
  648.         (C) 1990 Omen Tech Inc                       Chapter 4 Circular Buffer
  649.  
  650.  
  651.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  652.         ZCOMM User Manual                                                   12
  653.  
  654.         circular buffer to the capture file without waiting for the circular
  655.         buffer to fill up first.
  656.  
  657.         The large storage capacity of the circular buffer may be used to
  658.         review the most recent data captured from the remote.  The review
  659.         command allows one to page back and forth through the data captured
  660.         from the remote.  Forward and backward string searches make it easy to
  661.         locate important text.  The review command also allows segments of the
  662.         data in the circular buffer to be selectively saved on disk (cut and
  663.         pasted).  Scripts can search and mark text captured from the remote
  664.         with the full power of regular expression pattern matching.
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.         (C) 1990 Omen Tech Inc                         Chapter 4 Rosetta Stone
  708.  
  709.  
  710.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  711.         ZCOMM User Manual                                                   13
  712.  
  713.         5.  ROSETTA STONE
  714.  
  715.         Alphanumeric An alphanumeric character is either a letter or a decimal
  716.             digit 0 to 9.
  717.  
  718.         Baud A baud is a signaling unit conveying one or more bits of
  719.             information.  Baudrate is commonly (and usually incorrectly)
  720.             interchanged with bits per second.
  721.  
  722.         BPS is an abbreviation for "bits per second", a measure of
  723.             transmission speed.  ASCII Asynchronous transmission generally
  724.             uses 10 bits to transmit each character, so the speed in
  725.             characters per second is one tenth the speed measured in bits per
  726.             second.
  727.  
  728.         Capture The term function captures data from the remote into the
  729.             circular buffer.  This data may be paged back and forth with the
  730.             review function, or written to a disk file.
  731.  
  732.         Character Escape is a sequence of characters initiated by a backslash
  733.             character used to represent a control character or programmable
  734.             string using printable characters.  Character escapes are
  735.             described in Chapter 25.
  736.  
  737.         CPMEOF A control character (hex 1A) added to the end of text files by
  738.             traditional microcomputer programs.  This practice was popular
  739.             with the Digital Research CP/M 8 bit operating system.
  740.  
  741.         Crash Recovery(TM) refers to the ZMODEM File Transfer Protocol's
  742.             ability to resume file transfers that have been interrupted by a
  743.             line disconnect from the point where the transfer was interrupted.
  744.  
  745.         Cyclical Redundancy Check (CRC) is a datum (16 or 32 bits) generated
  746.             by a cyclic code.  The CRC-16 extension to the Ward Christensen
  747.             XMODEM protocol provides a high level of data integrity.  CRC-16
  748.             guarantees detection of all single and double bit errors,  all
  749.             errors with an odd number of error bits, all burst errors of
  750.             length 16 or less, 99.9969% of all 17-bit error bursts, and
  751.             99.9984 per cent of all possible longer error bursts.  The actual
  752.             performance is even better because the errors that sneak by CRC-16
  753.             are often detected by the other error checks simultaneously
  754.             applied by ZCOMM's Cybernetic Data Recovery(TM).  ZMODEM's 32 bit
  755.             CRC provides five orders of magnitude more accurate error
  756.             detection than XMODEM's CRC-16 a billion times more accurate than
  757.             8 bit checksum used by standard XMODEM..
  758.  
  759.         Download is the transfer of data from the host system down to your
  760.             computer.
  761.  
  762.         DTR is an abbreviation for Data Terminal Ready.  Data Terminal Ready
  763.             is a signal sent by the computer to the modem to condition it to
  764.  
  765.  
  766.         (C) 1990 Omen Tech Inc                         Chapter 5 Rosetta Stone
  767.  
  768.  
  769.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  770.         ZCOMM User Manual                                                   14
  771.  
  772.             accept commands or answer an incoming call.  When DTR is "dropped"
  773.             (switched off), the modem should disconnect from the line.
  774.  
  775.         Execute When a string parameter is executed, it is normally sent to
  776.             the remote (modem).  If it begins with "@", the remainder is
  777.             executed as a ZCOMM command.
  778.  
  779.         Filespec Some ZCOMM commands instruct a remote Kermit server program
  780.             to send, receive, print, type, or delete one or more files.  The
  781.             syntax of this specification is defined by the remote Kermit
  782.             server program, not ZCOMM.  If filespec contains spaces, filespec
  783.             must be enclosed by double quotes.
  784.  
  785.         Flow Control restrains the speed of transmission to prevent loss of
  786.             data when a fast sender must send to a slower receiver.  Hardware
  787.             signals, control characters, and protocol handshakes can be used
  788.             to provide restraint, singly or in combinations.
  789.  
  790.             SEE ALSO: handshake command, zmodem w parameter, Flow Control
  791.             Chapter 13
  792.  
  793.         Functions are operations supported by ZCOMM, such as a dir, type, s,
  794.             r, or t (term) command.  A command may set or reset mode[s],
  795.             change a parameter, or perform a function.
  796.  
  797.         Host Operation allows remote access of files and programs.
  798.  
  799.         Iff If and only if.
  800.  
  801.         Integrity in a data transfer protocol refers to the ability of the
  802.             protocol to guarantee a correct data transfer provided both sender
  803.             and receiver report a successful transfer.  Integrity is a
  804.             different measure of a file transfer protocol than robustness,
  805.             which is a measure of a protocol's ability to complete the
  806.             requested transfers in the presence of errors, independent of the
  807.             probability of undetected errors.
  808.  
  809.         Kermit ia an error correcting batch file transfer protocol developed
  810.             at Columbia University and elsewhere.  The Kermit protocol
  811.             supports text and binary file transfers with many mainframe
  812.             computers whose hardware and operating software preclude
  813.             implementation of high performance protocols.
  814.  
  815.         Line Hit A burst of noise on a telephone line may generate modem data
  816.             errors.  A single "line hit" may garble dozens of characters.
  817.             ZCOMM's Error Containment(TM) technology may be used to reduce the
  818.             number of characters garbled by each line hit in terminal
  819.             emulation data capture.
  820.  
  821.         Modes Many modes are available to modify the way the term function
  822.             receives, displays, transmits, and stores data.
  823.  
  824.  
  825.         (C) 1990 Omen Tech Inc                         Chapter 5 Rosetta Stone
  826.  
  827.  
  828.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  829.         ZCOMM User Manual                                                   15
  830.  
  831.         N.B. Nota Bene, Latin for "note well" or "take notice".
  832.  
  833.         Options Options apply to the Kermit, s, sx, sb, s7, st, r, rx, r7, rb,
  834.             and rc protocol file transfer commands.
  835.  
  836.         q.v. Quod Vide is Latin for "which see", an invitation to consult
  837.             information on the subject mentioned.
  838.  
  839.         Pathname is a complete file name, including disk and directories.
  840.  
  841.             EXAMPLE: c:/ZCOMM/PHODIR.t
  842.  
  843.  
  844.         Pathspec ... A pathspec consists of zero or more pathnames.
  845.  
  846.             Unambiguous and ambiguous (with wildcard characters) pathnames may
  847.             be specified in any combination.  The wildcard filename characters
  848.             * and ?  are allowed as described in the IBM DOS manual chapter
  849.             "Global Filename Characters".  In DOS, only the filename portion
  850.             of the pathname may contain wildcards.
  851.  
  852.             EXAMPLE: src/cmd/*.c is legal; src/*/foo.c is not.
  853.  
  854.  
  855.             On 32 bit Unix systems, ZCOMM expands "*" and "?" the way the
  856.             shell does.  All the shell wildcards may be used including
  857.             multiple wildcards, wildcards in directories, and ranges.  ~user
  858.             expands to the login directory of user, and ~ expands to your home
  859.             directory.  In addition, `command` takes the output of command as
  860.             a series of pathnames.
  861.  
  862.             EXAMPLE: dir */[a-i]* displays all files starting with "a" to "i"
  863.             in all subdirectories immediately below the current directory.
  864.  
  865.  
  866.             An empty pathspec represents all files in the current directory on
  867.             the current disk.  A disk identifier without any file names
  868.             represents all files on that disk's current directory.  A
  869.             directory pathname expands to all files in the specified
  870.             directory.
  871.  
  872.             Sequences of the form %svar are replaced by the value (possibly
  873.             empty) of the string parameter svar.  If svar is not a string
  874.             parameter, no substitution is made.
  875.  
  876.             A pathspec may contain any combination of the above, separated by
  877.             spaces or tabs.
  878.  
  879.             If pathspec includes a disk specifier (such as a: or b:), ZCOMM
  880.             checks the disk specifier against the list of permissible disk
  881.             specifiers in the string parameter disks.
  882.  
  883.  
  884.         (C) 1990 Omen Tech Inc                         Chapter 5 Rosetta Stone
  885.  
  886.  
  887.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  888.         ZCOMM User Manual                                                   16
  889.  
  890.             The various filename expansions are especially useful in the
  891.             context of commands such as wc, sum, crc, find, sb, and sz.  For
  892.             example, wc applies to all files in the current directory, and
  893.             wc dir applies to all files in dir.
  894.  
  895.             ZCOMM pathnames may use / or \ to delimit directories.
  896.  
  897.         Regular Expressions control pattern matching and grouping of text by
  898.             the ss and egrep commands.  "Magic" characters specify the pattern
  899.             matching and grouping processes.
  900.  
  901.         Remote refers to the machine or terminal with which ZCOMM is
  902.             communicating.  This could be a direct RS-232 connection to a
  903.             local terminal, micro, mini, or mainframe, or a timesharing system
  904.             accessed through a modem and a global packet switched network.
  905.  
  906.         Restraint See "Flow Control" above.
  907.  
  908.         Restricted For security reasons, ZCOMM is restricted to prevent
  909.             unauthorized dial-in users from accessing private data or crashing
  910.             the system.  Certain commands are illegal when ZCOMM is
  911.             restricted, and only specified disk drives and directories may be
  912.             accessed.
  913.  
  914.         Review Function Characters output from the remote may be paged and
  915.             searched online with the review function.  This data may also be
  916.             cut and pasted to disk files.
  917.  
  918.         Robustness in a file transfer protocol refers to the protocol's
  919.             ability to complete transfers in the presence of errors induced by
  920.             line noise or other sources.  Robustness is a different measure of
  921.             a file transfer protocol than integrity, a measure of the
  922.             probability of correct data transfer given a successful completion
  923.             of the transfer process.
  924.  
  925.         Script A script is a set of commands that control dialogues with the
  926.             user or a remote system.
  927.  
  928.         Script Level refers to the degree of nesting of scripts.  Level 0 is
  929.             called by the user directly, and each higher level is executed by
  930.             a gosub or other command from the previous level.
  931.  
  932.         Shell Escape is a DOS command or program called as a subroutine from
  933.             ZCOMM via a DOS Gateway.  The phrase "shell escape" comes from the
  934.             Unix(TM) Operating System, whose command interpreter is called
  935.             "the shell".
  936.  
  937.         Soft Keys Strings or commands may be assigned to the Soft Keys with
  938.             set commands, including those in the telephone directory "setup"
  939.             entry executed each time ZCOMM starts.  ZCOMM recognizes the forty
  940.             function key codes produced by the function keys F1 to F12.  FS1
  941.  
  942.  
  943.         (C) 1990 Omen Tech Inc                         Chapter 5 Rosetta Stone
  944.  
  945.  
  946.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  947.         ZCOMM User Manual                                                   17
  948.  
  949.             to FS12 are obtained with a Shift key, FC1 to FC12 are obtained
  950.             with the Ctrl key, and FA1 to FA12 are obtained with the Alt key.
  951.             The cursor keys and extra function keys on 101 key Extended
  952.             Keyboards are also recognized.
  953.  
  954.             Strings or commands may be assigned to BS, ESC, Ins, Del, Home,
  955.             End, Up, Down, Left, Right, PgUp, and PgDn, overriding their
  956.             normal functions in the term function.
  957.  
  958.         String Some commands take a string argument.  If a string argument
  959.             contains spaces, tabs, and a semicolon, it must be enclosed by
  960.             double quotes (shift single quote on the IBM PC keyboard).
  961.             Control characters may be included in strings with character
  962.             escapes similar to those used by the C Programming Language.
  963.  
  964.         Term Function ZCOMM's Term Function provides the conversational
  965.             "connection" between the user and the remote.  The term function
  966.             captures data from the remote into ZCOMM's circular buffer from
  967.             whence it may be displayed, printed, stored in a disk file, or
  968.             searched, cut and pasted by the review function.
  969.  
  970.         TWX Teletypewriter Exchange (Teletype Corp. TM).  A simple protocol
  971.             used to transmit files or paper tapes between dial-up
  972.             teleprinters.
  973.  
  974.         Upload is a transfer of data from your computer up to the host system.
  975.  
  976.         Wild Card Many commands allow wild card file names in their pathspec
  977.             (q.v.).
  978.  
  979.         Writing When a receive file is open as a result of a create or t
  980.             filename command, data in the circular buffer is written out to
  981.             the receive file when the circular buffer fills up or when a w or
  982.             ALT-W command is given.
  983.  
  984.         XMODEM The Ward Christensen file transfer protocol uses 128 byte
  985.             packets, one byte control messages, and a one byte arithmetic
  986.             checksum.
  987.  
  988.         XMODEM/CRC A synonym for the enhanced Ward Christensen XMODEM protocol
  989.             using a Cyclic Redundancy Check (CRC-16).  Newer programs support
  990.             CRC-16 for better data integrity, but reliability is still
  991.             compromised by one byte control messages.
  992.  
  993.         XMODEM-1k XMODEM protocol with 1024 byte data packets, CRC-16, and one
  994.             byte control messages, sometimes incorrectly called ymodem.
  995.  
  996.         YMODEM YMODEM is a batch file transfer protocol with pathname, date,
  997.             file length and other file data in block 0, CRC-16 default, and
  998.             optional 1024 byte packets.  Many programs claiming to support
  999.             YMODEM actually use XMODEM with 1024 byte blocks; use ZCOMM's sx
  1000.  
  1001.  
  1002.         (C) 1990 Omen Tech Inc                         Chapter 5 Rosetta Stone
  1003.  
  1004.  
  1005.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1006.         ZCOMM User Manual                                                   18
  1007.  
  1008.             -k and rx commands with these XMODEM mutants.
  1009.  
  1010.         XOFF, XON ASCII control characters control the flow of data.  XOFF
  1011.             (Ctrl-S) stops and XON (Ctrl-Q) resumes the flow of data.  Chapter
  1012.             36 provides an ASCII code chart with the names for the control
  1013.             characters.
  1014.  
  1015.         ZCOMM is a shareware (User Supported) subset of Professional-YAM.
  1016.  
  1017.         ZMODEM An advanced public domain file transfer protocol with
  1018.             simplified human interface, crash recovery, high speed streaming,
  1019.             sensitive 32 bit CRC, command download, security features, and
  1020.             important file management functions.
  1021.  
  1022.         {arg1 | arg2} One of the arguments separated by | is required.
  1023.  
  1024.         []  Optional argument.
  1025.  
  1026.         *   The special symbol * denotes features not included in ZCOMM.  **
  1027.             Denotes features not included in userialized (unregistered) copies
  1028.             of ZCOMM.
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.         (C) 1990 Omen Tech Inc                      Chapter 5 Installing ZCOMM
  1062.  
  1063.  
  1064.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1065.         ZCOMM User Manual                                                   19
  1066.  
  1067.         6.  INSTALLING ZCOMM
  1068.  
  1069.         If you have registered your copy of ZCOMM, make yourself a working
  1070.         copy of the ZCOMM distribution disk using the DOS diskcopy command.
  1071.         Keep the distribution disk in a safe place away from nasty killers
  1072.         such as disk drives, displays, computers, magnets, motors, and coffee
  1073.         cups.  The only time the distribution diskette should be out and about
  1074.         is when you are cloning your working copies.
  1075.  
  1076.  
  1077.         6.1  Installation from Registration Disk
  1078.  
  1079.         Before installing ZCOMM, you may wish to create a directory for the
  1080.         ZCOMM files.  If so, you must include this dorectory in the DOS PATH.
  1081.         Otherwise the files may be extracted to the root directory.
  1082.  
  1083.         The ZCOMM software files are contained in the ZCOMMEXE.ZIP and
  1084.         ZCOMMHLP.ZIP archives on the distribution disk.  Use a standard
  1085.         "unzip" program such as PKUNZIP to extract files from these archives.
  1086.  
  1087.         The putsnp program inserts your ZCOMM Serial-Number-Password (ZSNP)
  1088.         into your working copiy of ZCOMM.  Installing a legal serial number
  1089.         suppresses the pause after the opening message, enlarges the circular
  1090.         buffer, and enables new commands.  The putsnp program prompts for your
  1091.         Serial/Number/Password (SNP) of the form X123456789.  Putsnp checks
  1092.         for keyboarding mistakes and then verifies that you understand and
  1093.         agree to the licensing conditions.  When you understand and agree to
  1094.         the licensing conditions, respond with yes (not just y).
  1095.  
  1096.         Then putsnp prompts for the name of a file to insert the serial number
  1097.         into.  This should be a ZCOMM.EXE file that you have transferred to a
  1098.         scratch disk, or to an appropriate directory on your hard disk.  Do
  1099.         not write on the distribution diskette unless a nuclear attack is in
  1100.         progress.
  1101.  
  1102.         After inserting the serial number in the given file, putsnp asks if
  1103.         you wish to change the default value for the phone directory pathname
  1104.         (string parameter phones).  This is normally /PHODIR.t.  If you wish
  1105.         to keep the phones file elsewhere, answer "yes".[1] Putsnp then
  1106.         searches for the location in your copy of ZCOMM that contains this
  1107.         information.  When found, you may enter a new pathname,[2] up to 64
  1108.         characters.
  1109.  
  1110.  
  1111.         __________
  1112.  
  1113.          1. The default value may also be overidden with the PHONES DOS
  1114.             environment variable.
  1115.  
  1116.          2. Such as c:/zcomm/PHODIR.t.
  1117.  
  1118.  
  1119.  
  1120.         (C) 1990 Omen Tech Inc                      Chapter 6 Installing ZCOMM
  1121.  
  1122.  
  1123.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1124.         ZCOMM User Manual                                                   20
  1125.  
  1126.         Afterwards, you should copy the help processor files YHP.EXE and
  1127.         ZMANH.HLP from the disk.
  1128.  
  1129.  
  1130.         6.2  Installation from ZCOMM*.ARC
  1131.  
  1132.  
  1133.         If you are using the software provided in ZCOMM*.ARC, be sure to save
  1134.         the original files for backup, and pass them on to your friends to
  1135.         fill their communications needs.  There are currently three ZCOMM
  1136.         archive files:
  1137.  
  1138.           + ZCOMMEXE.ARC contains the executable program and demonstration
  1139.             files.
  1140.  
  1141.           + ZCOMMDOC.ARC contains this documentation.
  1142.  
  1143.           + ZCOMMHLP.ARC contains ZCOMM's tree structured help file and random
  1144.             access flash-up help processor.
  1145.  
  1146.  
  1147.         6.3  Installation Continued
  1148.  
  1149.  
  1150.         The second order of business is to read this manual.  There is just no
  1151.         way you can get your money's worth out of ZCOMM without reading, or at
  1152.         least carefully scanning, this manual.  After all, didn't you get
  1153.         ZCOMM because you needed something more powerful than that cumbersome,
  1154.         unreliable, brain-damaged menu driven crock you've been using?
  1155.         (Perhaps you shouldn't answer that question just yet ...)
  1156.  
  1157.         You can then edit PHODIR.t to suit your own needs by inserting
  1158.         directory entries for the systems you wish to call and changing the
  1159.         phone numbers, account numbers, and passwords on the "standard"
  1160.         entries for popular timesharing services that you have accounts with.
  1161.         Be sure to check the setup entry and make any changes you feel
  1162.         appropriate.  Once you have the "feel" of ZCOMM, you will want to
  1163.         remove the automatic menu invocation at the end of the setup directory
  1164.         entry.
  1165.  
  1166.         Chapter 9 gives a line by line tutorial for setting up your telephone
  1167.         directory assuming you are using a standard modem.
  1168.  
  1169.         If you are using a computer that runs at non standard clock rates
  1170.         (e.g., 8 mHz 8088 instead of 4.77 mHz) or with an enhanced CPU chip
  1171.         (NEC V20), you will need to set special values for the a and b numeric
  1172.         parameters as described in Chapter 23.
  1173.  
  1174.         **** WARNING **** Although ZCOMM is well behaved as communications
  1175.         programs go, some memory resident programs, special keyboard
  1176.         modifiers, print spoolers, or special display drivers, may cause
  1177.  
  1178.  
  1179.         (C) 1990 Omen Tech Inc                      Chapter 6 Installing ZCOMM
  1180.  
  1181.  
  1182.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1183.         ZCOMM User Manual                                                   21
  1184.  
  1185.         problems.  The POLYTRON memory-resident desktop organizer PolyWindows
  1186.         DeskPlus as well as POLYBoost work with ZCOMM.
  1187.  
  1188.         **** WARNING **** Since ZCOMM uses interrupts to read data from the
  1189.         serial ports, each serial port must be strapped for its proper
  1190.         interrupt vector.  Some communications programs assign both IRQ3 and
  1191.         IRQ4 while operating, so they will operate even if the serial ports
  1192.         are not strapped properly.  Since ZCOMM only assigns the interrupt
  1193.         vector of the port in use, incorrect IRQ level strapping will crash
  1194.         ZCOMM.  Check the serial port addresses and vectors with the
  1195.         information given ith the port command in Chapter 18 if you encounter
  1196.         trouble starting ZCOMM.
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.         (C) 1990 Omen Tech Inc                  Chapter 6 Unleashing the MODEM
  1239.  
  1240.  
  1241.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1242.         ZCOMM User Manual                                                   22
  1243.  
  1244.         7.  UNLEASHING THE MODEM
  1245.  
  1246.         7.1  Hardware Interface
  1247.  
  1248.         DOS ZCOMM accesses serial ports at the standard COM1 and COM2 address,
  1249.         as well as COM3-COM18 as described under the port command.  The portx
  1250.         command may be used to access 8250 family serial ports at non standard
  1251.         port addresses.
  1252.  
  1253.         When a port is selected, a quick hardware check is made to verify the
  1254.         existience and minimal functionality of the port.  If this test fails,
  1255.         the message Port N Defective is displayed.  An incorrect port switch
  1256.         or strap (jumper) configuration is the usual cause of this message.
  1257.  
  1258.         This check does not guarantee the port is connected to the proper IRQ
  1259.         line.  If the port is not configured to use the proper IRQ line, the
  1260.         computer may lock up when the port is used.
  1261.  
  1262.         Some 8250 UART devices (used by serial interface adapters and internal
  1263.         modems) do not respond correctly when the software turns the
  1264.         transmitter interrupts on and off.  High performance communications
  1265.         programs such as ZCOMM require properly functioning UART chips, such
  1266.         as the National Semiconductor 16450 or 16550A.
  1267.  
  1268.         7.2  MODEM environment variable
  1269.  
  1270.         The mm224 dialing routine uses the MODEM environment variable to
  1271.         indicate the type of modem it is driving.  Except for ZCOMM, the value
  1272.         inherited from the environment may be overridden with a set command.
  1273.         Currently supported values for MODEM are:
  1274.  
  1275.         AX9624  MicroCom AX/9624c with MNP Class 6.  This modem includes a
  1276.                 pseudo full duplex 9600 bps speed.
  1277.  
  1278.         HST     U S Robotics HST Dual Standard
  1279.  
  1280.         HV96    Hayes V series Smartmodem 9600
  1281.  
  1282.         MM224   MultiModem 224 without MNP.  This works with many other 2400
  1283.                 bps modems with little or no modification.
  1284.  
  1285.         MM224E  MultiModem 224E with MNP.
  1286.  
  1287.         MMV32   MultiModem V32 with MNP.
  1288.  
  1289.         SM1200  Hayes SmartModem 1200
  1290.  
  1291.         TB      Telebit TrialBlazer
  1292.  
  1293.         These values must be entered in UPPER CASE (all capital letters).
  1294.  
  1295.  
  1296.  
  1297.         (C) 1990 Omen Tech Inc                  Chapter 7 Unleashing the MODEM
  1298.  
  1299.  
  1300.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1301.         ZCOMM User Manual                                                   23
  1302.  
  1303.         EXAMPLE: C>set modem=MM224E      (DOS)
  1304.  
  1305.  
  1306.  
  1307.         EXAMPLE: $ MODEM=MM224E; export MODEM      (Unix)
  1308.  
  1309.  
  1310.         When setting up for a particular modem type, be sure to configure the
  1311.         modem's switches and Non Volatile RAM (NVRAM) for use with ZCOMM.  If
  1312.         nonstandard NVRAM settings interfere with ZCOMM's initialization scrip
  1313.         for that modem, you may have to manually restore the NVRAM contents to
  1314.         the factory default.  The supplied scripts expect to see the factory
  1315.         default VERBAL RESULT CODES (not result digits).
  1316.  
  1317.         The mm224 dialing script supports a number of modems under control of
  1318.         the MODEM environment variable.
  1319.  
  1320.  
  1321.         7.3  Carnival of the MODEMS
  1322.  
  1323.         Modem manufacturers are constantly refining their products, adding new
  1324.         features and making subtle subtle changes in existing features.
  1325.  
  1326.         To obtain the full performance your modem provides, you can edit
  1327.         initialization strings in the dialing scripts to take advantage of new
  1328.         modem features as they are developed.
  1329.  
  1330.         If MODEM is not set, changing the X3 string sent by the dialing script
  1331.         to X1,X3 or X4 enables extra features on some modems.  Some modems do
  1332.         not emulate the Hayes Xn commands exactly, requiring a change to the
  1333.         Xn value emitted by the dialing script for proper operation.  The line
  1334.         in mm224 to modify is:
  1335.  
  1336.              if !%MODEM put "ATX3\r";  wait -f2 :: Change this for your modem
  1337.  
  1338.         If your modem is not listed in one of the following subchapters,
  1339.         please read all the subchapters and use the suggestions that apply to
  1340.         modems similar to yours.
  1341.  
  1342.         7.4  Tone Dialing
  1343.  
  1344.         If your telephone line supports Tone Dialing, set mprefix to ATDT with
  1345.         a command in the setup telephone directory entry.  If your telephone
  1346.         line only supports rotary (pulse) dialing, set mprefix to ATDP.  This
  1347.         procedure is detailed in Chapter 8.
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.         (C) 1990 Omen Tech Inc                  Chapter 7 Unleashing the MODEM
  1357.  
  1358.  
  1359.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1360.         ZCOMM User Manual                                                   24
  1361.  
  1362.         7.5  MNP, V.42, X.PC, AFT
  1363.  
  1364.         More and more modems support one or more error correcting link level
  1365.         protocols such as MNP and V.42.  Modem to modem link level protocols
  1366.         correct most transmission errors reducing the frequency of garbled
  1367.         text and file transfer retries.  Modern link level protocols increase
  1368.         transmission speed by eliminating start/stop bits and redundant
  1369.         information.
  1370.  
  1371.         When MNP is enabled, the calling modem sends control characters to
  1372.         interrogate the answering modem for MNP.  These characters can prevent
  1373.         logging in to some timesharing systems, packet switched networks, and
  1374.         bulletin boards.  Non streaming protocols such as XMODEM, YMODEM, and
  1375.         Kermit usually give faster transfers without the delays introduced by
  1376.         MNP and other link level protocols.  Accordingly, ZCOMM's dialing
  1377.         scripts are designed to place calls with MNP disabled by default.
  1378.  
  1379.         The mm224 dialing script allows an optional link level modifier to be
  1380.         appended to each telephone number.  There is no modifier to enable the
  1381.         Hayes AFT link protocol because we have not experienced log-in
  1382.         problems with leaving it enabled all the time.  We expect similar
  1383.         results with V.42.
  1384.  
  1385.         The currently supported modifiers are:
  1386.  
  1387.         /300     Force a connection at 300 bps.  Dropping down to 300 bps may
  1388.                  be necessary to get a reliable connection in the Oregon Rain
  1389.                  Forest.
  1390.  
  1391.         /1200    Force a connection at 1200 bps.
  1392.  
  1393.         /2400    Force a 2400 bps connection.
  1394.  
  1395.         /nop     Suppress the detection of call progress reporting.  This may
  1396.                  be used to prevent the modem from misinterpreting an unusual
  1397.                  ringing sound as a busy signal.
  1398.  
  1399.         /fast    Force a high speed connection (refuse a slow speed
  1400.                  connection).
  1401.  
  1402.                  EXAMPLE: 123-4567/fast
  1403.  
  1404.  
  1405.         man      Some modems incorrectly abandon a call attempt when they
  1406.                  "hear" sounds they aren't programmed to understand.  For
  1407.                  example, some TrailBlazer modems abort the call with a
  1408.                  spurious "NO CARRIER" message when they hear the sound of the
  1409.                  telephone "ringing". If that doesn't dump the call, the
  1410.                  TrailBlazer may dump the call when the answering modem emits
  1411.                  an echo suppressor disabling tone before sending the standard
  1412.                  Bell 103 answer tone.  Under these circumstances the only
  1413.  
  1414.  
  1415.         (C) 1990 Omen Tech Inc                  Chapter 7 Unleashing the MODEM
  1416.  
  1417.  
  1418.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1419.         ZCOMM User Manual                                                   25
  1420.  
  1421.                  solution is to listen to the sounds youself and tell the
  1422.                  modem exactly when to start listening.
  1423.  
  1424.                  With the man modifier, the modem remains in command mode
  1425.                  after dialing the phone number and ZCOMM enters the term
  1426.                  function to display messages from the modem.  When you hear
  1427.                  the called modem's answer tone, hit F1 to exit the term
  1428.                  function.  The mm224 dialing script then sends an "ATO" to
  1429.                  the modem to attempt a normal data connection.
  1430.  
  1431.                  Some practice may be necessary before you get the right
  1432.                  timing.  If you hit F1 too late the answering modem may give
  1433.                  up before the modems can handshake and enter data mode.
  1434.  
  1435.         mnp      Require MNP link level connection.  Do not connect if MNP
  1436.                  fails.
  1437.  
  1438.                  EXAMPLE: 123-4567/mnp
  1439.  
  1440.  
  1441.         /mnp_s   Require MNP link level connection, use software flow
  1442.                  control.[1] Do not connect if MNP fails.
  1443.  
  1444.         /a_mnp   Request MNP link level connection.
  1445.  
  1446.         /a_mnp_s Request MNP link level connection, use software flow control.
  1447.  
  1448.         /xmodem  Enable "XMODEM spoofing" on Trailblazer modems.
  1449.  
  1450.         /kermit  Enable "Kermit spoofing" on Trailblazer modems.
  1451.  
  1452.         /v22     Use V.22 modulation (effective for 1200 bps calls).
  1453.  
  1454.         Most modems do not support all these modifiers.
  1455.  
  1456.  
  1457.         7.6  High Speed Modems
  1458.  
  1459.         The new generation of high speed dial-up modems presents special
  1460.         oppurtunities and challenges to users and system integrators.
  1461.  
  1462.         These modems transmit data at speeds from 110 to 38400 or more bits
  1463.         per second.  This range of speeds poses special problems communicating
  1464.         between the computer and the modem.  Lower speed modems examine the
  1465.  
  1466.  
  1467.         __________
  1468.  
  1469.          1. Software flow control in the modem is not compatible with XMODEM,
  1470.             YMODEM, Sealink, Clink, or WXMODEM.
  1471.  
  1472.  
  1473.  
  1474.         (C) 1990 Omen Tech Inc                  Chapter 7 Unleashing the MODEM
  1475.  
  1476.  
  1477.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1478.         ZCOMM User Manual                                                   26
  1479.  
  1480.         traditional "AT" command prefix bit by bit to lock onto the computer's
  1481.         transmission speed instantly.  Many modems which recognize commands at
  1482.         widely varying speeds can not use this technique.  A number of
  1483.         alternate techniques have been developed, each with its own advantages
  1484.         and problems.
  1485.  
  1486.           + Lock the interface to the highest tranmsission rate.  This aviods
  1487.             the programming required to synchronize the modem's and computer's
  1488.             speeds.  Flow control must be used when the interface speed is
  1489.             locked to prevent the computer from sending data more rapidly than
  1490.             the modem can buffer and transmit it.  This local flow control is
  1491.             usually accomplished with hardware signals.  When such an
  1492.             arrangement is used to communicate over networks that must assert
  1493.             their own flow control (with XON and XOFF), data flow regulation
  1494.             must respond to both hardware (RTS) and software (XOFF) signals.
  1495.             The handshake both command should be used whenever the modem's
  1496.             interface speed is locked and transmission over networks or to
  1497.             timesharing systems is desired.
  1498.  
  1499.             Locking the interface speed to 9600 or 19200 bps while
  1500.             communicating at 1200 and 2400 bps should be avoided unless all
  1501.             links in the transmission path have low error rates.
  1502.  
  1503.             Most modems do not recognize XOFF characters from the remote
  1504.             computer, so characters stored in the modem's buffer will be
  1505.             transmitted for a period of time after an XOFF is received.  This
  1506.             causes loss of data with some computer services.
  1507.  
  1508.             When the interface speed is locked at a higher speed than the
  1509.             actual data transmission, an excessive amount of data may be
  1510.             stored in the modem's memory awaiting transmission.  This is
  1511.             inefficient when a streaming file transfer protocol is used
  1512.             because the data stored in the buffer must be drained before error
  1513.             recovery can commence.  The ZMODEM b and w muneric parameters
  1514.             should be used to manage the modem's data storage.
  1515.  
  1516.  
  1517.           + Autobaud to adjust the modem and computer speed.  With this
  1518.             method, the modem is optioned to enter a search mode whenever it
  1519.             becomes idle.  The dialing script calls the waketb phone directory
  1520.             subroutine to train the modem to the computer's transmission
  1521.             speed.  The waketb subroutine may be optimized for the particular
  1522.             modem used.
  1523.  
  1524.             After dialing or answering a call, the modem handshakes with the
  1525.             remote modem and reports the connect speed with a message such as
  1526.             "CONNECT 1200" or "CONNECT FAST".  The dialing script recognizes
  1527.             the string, and sets the computer to the correct speed.  If the
  1528.             connection is made at high speed, the dialing script may need to
  1529.             enable hardware flow control with a handshake command.
  1530.  
  1531.  
  1532.  
  1533.         (C) 1990 Omen Tech Inc                  Chapter 7 Unleashing the MODEM
  1534.  
  1535.  
  1536.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1537.         ZCOMM User Manual                                                   27
  1538.  
  1539.         7.7  TELEBIT TrailBlazer
  1540.  
  1541.         The Telebit TrailBlazer modem uses 68000 and TMS320 processors to
  1542.         transmit serial data at rates up to 14000 bps over standard phone
  1543.         lines.  The modems also operate at speeds of 2400, 1200, 300 and
  1544.         slower.  The TrailBlazer is one of the most complex modems to fully
  1545.         exploit, a worthy challenge for a TurboDialTm script.  Use the mm224
  1546.         dialing routine discussed above for this modem.  The mm224 dial
  1547.         routine has special provisions to exploit this modem's features.  Set
  1548.         the MODEM environment variable to TB (caps are important) to support
  1549.         the TrailBlazer's MNP, speed and flow control features.
  1550.  
  1551.         Before making calls, use the inittb phone entry to initialize the
  1552.         modem's non volatile memory with proper settings for ZCOMM.
  1553.  
  1554.         EXAMPLE: call inittb
  1555.  
  1556.  
  1557.         ZMODEM provides optimum file transfer speeds with these modems.
  1558.         ZMODEM avoids interference with the modem's flow control.
  1559.  
  1560.         This posting is intended for those who use Pro-Yam for access to
  1561.         Xenix/Vpix with wyse 60 terminal emulation mode. These modem register
  1562.         settings are in use on a Telebit T1000 calling a Telebit trailblazer
  1563.         modem. The host modem has register 58=3 (xon/xoff).  While these may
  1564.         not be the optimal settings..  they work !!.
  1565.  
  1566.         E1 F1 M1 Q0 T V1 W0 X1 Y0 &P0 &T4     Version FA2.00
  1567.         S00:010 S01=000 S02=043 S03=013 S04=010 S05=008 S06=002 S07:045
  1568.         S08=002 S09=006 S10=007 S11=070 S12=050 S18=000 S25=005 S38:020
  1569.         S41=000 S45:255 S47=004 S48:001 S49=000 S50=000 S51=255 S52:002
  1570.         S54:003 S55=000 S56=017 S57=019 S58:002 S59=000 S60=000 S61=150
  1571.         S62=003 S63=001 S64=000 S65=000 S66=000 S67=000 S68=255 S69=000
  1572.         S90=000 S91=000 S92:001 S94=001 S95:002 S96=001 S100=000 S101=000
  1573.         S104=000 S111=255 S112=001 S121=000 S130:000 S131:001 S255=001
  1574.         Courtesy Dr. Adam Orden
  1575.  
  1576.         7.8  MultiTech MultiModem 224E
  1577.  
  1578.         Special features of this modem are accessed with the mm224 dial
  1579.         script.  Set the MODEM environment variable to MM224E (caps are
  1580.         important) to support the MM224E's MNP, speed and flow control
  1581.         features.
  1582.  
  1583.         Set dip switch 1 on the bottom of the modem to up (DTR Normal), the
  1584.         reverse of the factory setting.  For high speed operation, CTS flow
  1585.         control should be enabled with internal switches and jumpers.
  1586.  
  1587.         Before making calls, use the initmm phone entry[2] to initialize the
  1588.  
  1589.  
  1590.  
  1591.  
  1592.         (C) 1990 Omen Tech Inc                  Chapter 7 Unleashing the MODEM
  1593.  
  1594.  
  1595.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1596.         ZCOMM User Manual                                                   28
  1597.  
  1598.         modem's non volatile memory with proper settings for ZCOMM.
  1599.  
  1600.         EXAMPLE: call initmm
  1601.  
  1602.         This disables automatic error correction under mnp.  If you wish to
  1603.         enable this setting by default, merely type, from the terminal mode,
  1604.         'AT &E1 &W', and the 'OK' which will ensue tells you that the command
  1605.         was accepted and stored in non-volatile memory.
  1606.  
  1607.         The initmm script also disables MNP compression.  MNP compression
  1608.         slows transfers of compressed files.  If you do not transfer many
  1609.         compressed files, change the &E14 in the initmm script to &E15.
  1610.  
  1611.         7.9  MultiTech MultiModem 224
  1612.  
  1613.         The autobaud feature of this and most other 2400 bps modems is
  1614.         accessed with the mm224 dial script.  This dialing script is the
  1615.         default choice in the distribution phones.t file.  Set the MODEM
  1616.         environment variable to MM224 (caps are important) to support the
  1617.         MM224.
  1618.  
  1619.  
  1620.         7.10  U.S. Robotics Courier 2400e
  1621.  
  1622.         Unlike most medium and high speed modems, the Courier 2400e does not
  1623.         recognize the computer's transmission speed when given "AT" commands.
  1624.  
  1625.         This modem is accessed with the mm224 dial script.  This dialing
  1626.         script is the default choice in the distribution phones.t file.  Set
  1627.         the MODEM environment variable to C2400E (caps are important) to
  1628.         support the C2400E.
  1629.  
  1630.         This modem should be initialized with the initc24e entry in the
  1631.         telephone directory.  Switch settings are off, off, on, off, on, off,
  1632.         off, on, on, off.
  1633.  
  1634.  
  1635.         7.11  U S Robotics HST Dual Standard
  1636.  
  1637.         The inithst phone directory entry should be run to initialize the HST
  1638.         properly.
  1639.  
  1640.         The HST firmware design requires the MNP DTE speed set in the first
  1641.         HST line of mm224 to match the speed used in inithst.  If you wish to
  1642.         change the interface speed, the speed must be changed in both the
  1643.  
  1644.  
  1645.         ______________________________________________________________________
  1646.  
  1647.          2. Information courtesy Earle Robinson
  1648.  
  1649.  
  1650.  
  1651.         (C) 1990 Omen Tech Inc                  Chapter 7 Unleashing the MODEM
  1652.  
  1653.  
  1654.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1655.         ZCOMM User Manual                                                   29
  1656.  
  1657.         inithst directory entry and the first HST line in mm224, and then the
  1658.         inithst directory entry must be rerun.
  1659.  
  1660.         When making MNP calls to CompuServe and certain other modems, a /2400
  1661.         modifier may be required with the HST.
  1662.  
  1663.         EXAMPLE: compuserve     speed 2400 123-4567/mnp/2400
  1664.  
  1665.  
  1666.  
  1667.         7.12  Hayes Smartmodem V9600
  1668.  
  1669.         This modem should be initialized with the inithv96 entry in the
  1670.         telephone directory.  The AFT link level is enabled by default because
  1671.         it does not appear to interfere with connections to modems not
  1672.         supporting AFT.
  1673.  
  1674.         7.13  Hayes Smartmodem 2400
  1675.  
  1676.         The Hayes Smartmodem 2400 presents the same considerations as the
  1677.         Smartmodem 1200 described below.  Unlike the 1200, the 2400 uses a non
  1678.         volatile memory to store configuration parameters instead of the
  1679.         switches used in earlier models.  The sequence AT&C1 &D2 &R1 &S1 &T5
  1680.         &W should be sent to the modem to set normal operation for DCD, DTR,
  1681.         CTS, and DSR.  The T5 command disables remote loopback request, a
  1682.         source of failed file transfers on noisy lines.  Finally, the &W
  1683.         command writes this information to the non volatile memory.  Please
  1684.         consult your Hayes manual for more information on these commands.
  1685.  
  1686.  
  1687.         7.14  Hayes Smartmodem 1200
  1688.  
  1689.         The Smartmodem 1200 and similar 1200 bps modems are compatible with
  1690.         the mm224 telephone directory entry.  Some modems may require a change
  1691.         in the X1 command to a higher Xn digit for proper autobaud operation.
  1692.  
  1693.         The Smartmodem 1200(TM) should be configured as follows by setting
  1694.         S1-S8, located under the front panel.  These switches may be accessed
  1695.         by gently prying the ears of the front bezel, allowing the bezel to
  1696.         pop off the front of the unit.
  1697.  
  1698.         S1 Up Support DTR Lead
  1699.         S2 Up Verbal result codes (Verbose) [3]
  1700.         S3 Down Result codes are sent
  1701.  
  1702.  
  1703.         __________
  1704.  
  1705.          3. If other options are necessary (to support other software) a
  1706.             custom dial routine may be used as described in Chapter 99.
  1707.  
  1708.  
  1709.  
  1710.         (C) 1990 Omen Tech Inc                  Chapter 7 Unleashing the MODEM
  1711.  
  1712.  
  1713.         Version 17.61 TurboDial 2.33            Universal Line Printer Edition
  1714.         ZCOMM User Manual                                                   30
  1715.  
  1716.         S4 Up Echoes characters in command state
  1717.         S5 Down Modem does not answer calls initially
  1718.         S6 Up Carrier Detect line reads status
  1719.         S7 ????  See Hayes manual
  1720.         S8 Down Enables Smartmodem 1200 command recognition
  1721.  
  1722.         The modem cable should connect the following RS-232 circuits: AA BA BB
  1723.         AB CF CD which use pins 1,2,3,7,8, and 20 on the Hayes modem.  Some
  1724.         programs require pins 5 and 6 connected to the modem.
  1725.  
  1726.         NOTE: Some Hayes modems require mprefix to be in upper case only.
  1727.         "Hayes Compatible" modems not manufactured by Hayes generally work
  1728.         with the same mprefix, but some of the other modem control strings
  1729.         that appear in the distributed PHODIR.t file may not work properly
  1730.         with a particular brand of modem.
  1731.  
  1732.  
  1733.         7.15  Microcom AX9624c
  1734.  
  1735.         Microcom AX modems have a configuration switch to select Hayes style
  1736.         "AT" commands.  The AX/9624c front dip switch should be set 1, 4, 6, 7
  1737.         UP, 2, 3, 5, 8 DOWN, and A/S OUT (asynchronous).  The rear switches
  1738.         are all UP.  Of all these switches, it is vital that front switch 2 be
  1739.         DOWN (AT commands) and rear switch 6 be UP; the initax9624 script
  1740.         should override the others.
  1741.  
  1742.         Set the MODEM environment variable to AX9624 (caps are important) to
  1743.         support the Microcom AX9624's MNP and flow control features.  Before
  1744.         making calls, use the initax9624 phone entry to initialize the modem's
  1745.         non volatile memory with proper settings for ZCOMM.
  1746.  
  1747.         EXAMPLE: call initax9624
  1748.  
  1749.  
  1750.  
  1751.         7.16  Microcom SX Series
  1752.  
  1753.         Older Microcom SX series modems have a unique command set incompatible
  1754.         with Hayes modems.  Careful attention must be paid to flow control
  1755.         issues to obtain reliable operation.  When using XMODEM or other
  1756.         protocols, the modem must be set to pass all 8 bits and all 256 code
  1757.         combinations of those 8 bits.  The dialsx script sets the modem to
  1758.         "transparent software flow control" as described in Chapter 13.
  1759.         Change the line
  1760.              set mcommand "gosub dial"
  1761.         to
  1762.              set mcommand "gosub dialsx"
  1763.         in the setup telephone directory entry.
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.         (C) 1990 Omen Tech Inc                  Chapter 7 Unleashing the MODEM
  1770.  
  1771.