home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / ZCOMMDOC.ZIP / ZCOMMDOC.AJ < prev    next >
Text File  |  1995-03-21  |  77KB  |  1,771 lines
  1.  
  2.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  3.       ZCOMM User Manual                                                  271
  4.  
  5.       SEE ALSO: dA and dM test conditions, std.mk and 101.mk key mapping
  6.       script files.
  7.  
  8.       29.6  Display Operation
  9.  
  10.       When ZCOMM starts up, or regains control after a DOS Gateway, the
  11.       video mode and number of columns and rows are interrogated with a BIOS
  12.       interrupt call.  If the columns are less than 80, or if the BIOS video
  13.       mode is between 4 and 6, the video mode is changed to 3 (color,
  14.       80x25).  If other BIOS video modes cause problems, give a DOS "mode
  15.       co80" or "mode mono" command before starting ZCOMM.  Display boards
  16.       with more than 80 columns or more than 25 lines are supported by the #
  17.       and $ numeric parameters (q.v.).  By default, warpdrive is selected
  18.       for best performance.
  19.  
  20.       ZCOMM supports extended EGA displays with ANSI 132 column escape codes
  21.       and the V numeric parameter.  Special text video modes can be accessed
  22.       with the videobios command.
  23.  
  24.       If ZCOMM is started with a Topview or DESQview virtual screen, the
  25.       video memory pointers are adjusted.
  26.  
  27.       For special applications, the display may be completely inhibited with
  28.       a "display inhibit" command.  Updating of the display is reenabled by
  29.       a display NOinhibit command or a fatal error disgnostic.
  30.  
  31.       In addition, ZCOMM can emulate hard copy terminals by displaying
  32.       identical overstruck characters in bold (high intensity) and by
  33.       underlining characters when the overstrike involves the ASCII
  34.       underline character.  This is enabled with a "display overstrike"
  35.       command.  (With the Color/Graphics board, underlining is represented
  36.       by reverse video.) (A character position on the screen is overstruck
  37.       if the character position being written already contains a character.)
  38.  
  39.       If the applications used involve backspacing and overstriking for
  40.       character editing, overstrike will produce random bold characters and
  41.       may be shut off with a "display NOoverstrike" command.  Alternatively,
  42.       the term function subcommand ALT-O will toggle overstrike.
  43.  
  44.       Normally, a received linefeed causes vertical movement only.  If
  45.       nlmode is set with a "display nlmode" command, a received linefeed
  46.       also performs a carriage return.  Nlmode is useful for Unix(TM) and
  47.       similar systems.  ZCOMM's Nlmode setting must agree with Unix's nlmode
  48.       setting for screen oriented programs such as Berkeley Editor to
  49.       function properly.
  50.  
  51.       Normally ZCOMM autowraps if there are too many characters on a line.
  52.       This can be turned off with a "display noautowrap" command.
  53.  
  54.       Normally a received bell character will jangle the speaker with a
  55.       beep.  The command "display bell=visual" silently displays BEL as a
  56.  
  57.  
  58.       (C) 1994 Omen Tech Inc                   Chapter 29 Terminal Emulation
  59.  
  60.  
  61.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  62.       ZCOMM User Manual                                                  272
  63.  
  64.       flashing musical note without spacing to the next character position.
  65.  
  66.       Most display adapters allow DMA access to the video RAM without snow
  67.       (sometimes called Chromablizzard).
  68.  
  69.       When operating with older color/graphics display controllers (the
  70.       original IBM CGA board and clones), updating the display will cause
  71.       snow (sometimes called Chromablizzard).  to appear on the screen
  72.       unless warpdrive is disabled.
  73.  
  74.       EXAMPLE: display nowarpdrive
  75.  
  76.  
  77.       29.7  Non Standard Displays
  78.  
  79.       ZCOMM defaults to a 80 by 25 display, with the bottom line used for
  80.       status information.  Some displays support more than 25 lines and/or
  81.       more than 80 characters per line.  In other cases, ZCOMM might be run
  82.       in a small window in multitasking environments such as TopView,
  83.       DESQview, or Windows.
  84.  
  85.       The $ and # numeric parameters may be set to accomodate these
  86.       situations.  A cls command should be given after changing the $ or #
  87.       numeric parameter.  When ZCOMM starts up, the $ numeric parameter
  88.       (number of columns) is set according to the value returned by the
  89.       BIOS.  ANSI 132 column escape codes are not recognized in windowed
  90.       operation.  Chapter 24 describes these parameters.
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.       (C) 1994 Omen Tech Inc                      Chapter 29 Log Entry Codes
  118.  
  119.  
  120.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  121.       ZCOMM User Manual                                                  273
  122.  
  123.       30.  LOGGING ENTRIES
  124.  
  125.       ZCOMM can be set to keep various logs with the callers, calllog,
  126.       rcmdlog, rxlog, and txlog string parameters.  Entries in the log files
  127.       include a code in the first column to indicate the conditions of the
  128.       operation associated with the entry.  They are formatted as follows:
  129.  
  130.       *  An open file was implicitly closed when another file was opened or
  131.          as a result of a port or call command, or dialing a number.
  132.  
  133.       >  File skipped by receiver request.  Log entry made iff the v numeric
  134.          parameter is greater than 0.
  135.  
  136.       C  Successful completion of a Compuserve B protocol file transfer.
  137.  
  138.       C  Call terminated by loss of carrier detect, bye or off command, or
  139.          dialing another phone number.  Connect time is displayed in tenths
  140.          of minutes.
  141.  
  142.       c  An open file was closed with a close or ALT-C command.
  143.  
  144.       E  Operation terminated by error.  Partially transmitted file skipped
  145.          by request.
  146.  
  147.       F  A transmit file was closed as a result of an end of file
  148.          encountered as it was transmitted by the term function.
  149.  
  150.       g  A transmit file was closed as a result of an end of file
  151.          encountered by the grab command, file received with the fget
  152.          command.
  153.  
  154.       K  Successful Kermit file transfer.
  155.  
  156.       L  Log entry of a host state login, connect time in tenths of minutes.
  157.  
  158.       m  Message received with the message or private command.
  159.  
  160.       n  The file name shown is illegal for the local operationg system, and
  161.          has been changed to "rename.###".  The numeric value of ### is
  162.          shown in the count field.
  163.  
  164.       R  Successful file received with XMODEM family protocol.
  165.  
  166.       Q  Questionable filtransfer sent with XMODEM family protocol.  On
  167.          receive: an EOT character was received but could not be verified;
  168.          the file may be truncated.  On Send: All data blocks were
  169.          acknowledgd, but the EOT was not.
  170.  
  171.       S  Successful file sent with XMODEM or XMODEM BATCH protocol.
  172.  
  173.  
  174.  
  175.  
  176.       (C) 1994 Omen Tech Inc                      Chapter 30 Log Entry Codes
  177.  
  178.  
  179.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  180.       ZCOMM User Manual                                                  274
  181.  
  182.       t  File received with TWX convention (terminated by EOT, ETX, or ^Z).
  183.  
  184.       U  An incomplete received file was Unlinked (removed).
  185.  
  186.       X  Call terminated by off or x command or by software termination
  187.          signal.
  188.  
  189.       x  A file was closed implicitly when ZCOMM exited to the operating
  190.          system.
  191.  
  192.       Z  Successful file received with ZMODEM protocol.
  193.  
  194.       z  Successful file sent with ZMODEM protocol.
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.       (C) 1994 Omen Tech Inc                      Chapter 30 Log Entry Codes
  236.  
  237.  
  238.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  239.       ZCOMM User Manual                                                  275
  240.  
  241.       At the completion of a call, an entry in the call log is made
  242.       providing the calllog string variable is set to a suitable pathname.
  243.       A typical entry with 6.3 minutes connect time with a system called
  244.       cis02 is shown.  The phone number is that given to Zcomm for
  245.       autodialing, contained in the telno string parameter.
  246.       C 2143:22 01-25-84 1200 c:226-0627  63 cis02
  247.  
  248.       30.1  Performance Log
  249.  
  250.       The plog string parameter enables file transfer performance logging.
  251.       The default empty value disables this function.  Performance log
  252.       keeping does not affect the nolog command.
  253.  
  254.       A sample entry is shown below.  The fields are: effective speed[1],
  255.       log code, "L" for loss of carrier detect (otherwise blank), file name,
  256.       length, average transfer rate (characters per second), transfer time
  257.       in seconds (file open to file close), number of seconds required to
  258.       start the transfer, number of errors (retransmissions), flow control
  259.       transistions, block length/subpacket length (at end of file), measured
  260.       round trip delay time in hundredths of seconds, the command (or
  261.       facsimilie thereof), the other program's serial number (-1 if not
  262.       available), the directory entry or caller's name, and the hardware
  263.       handshake option.
  264.  
  265.       2400 Z  FOO.ARC 153760 186 826 1 20 260 256 234 sz 1171 guess who off
  266.  
  267.       The above example shows 1 second to start the transfer, 20
  268.       retransmissions, and 260 times that YAM had to wait for flow control
  269.       release.  This unusual set of figures is the result of a "networked"
  270.       transfer through the "cu" program on a Unix system to a PC, not a
  271.       normal connection or PC-Pursuit access.
  272.  
  273.       The count of flow control transitions gives an indication of flow
  274.       control restraint applied by the modem, network, or receiver.  Since
  275.       it counts the times YAM has entered a wait because of flow control
  276.       restraint and not the total amount of time spent in that state, it is
  277.       not an accurate quantitative measure.
  278.  
  279.       The file transfer time and throughput calculation excludes the time
  280.       required to start the transfer, since that time is often not under the
  281.       protocol's control.
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.       __________
  289.  
  290.        1. The transmission speed unless set by the estimate command.
  291.  
  292.  
  293.  
  294.       (C) 1994 Omen Tech Inc           Chapter 30 Error (and other) Messages
  295.  
  296.  
  297.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  298.       ZCOMM User Manual                                                  276
  299.  
  300.       31.  ERROR (and other) MESSAGES
  301.  
  302.       In the following messages, a %s refers to a filename or some other
  303.       name or string. %d or %ld refers to a decimal number.  %x refers to
  304.       hexadecimal number, usually a character received from the modem.
  305.  
  306.       Error messages referring to the XMODEM protocol and/or XMODEM/CRC
  307.       protocol also apply to the the YMODEM Batch protocol, which is an
  308.       extension of the XMODEM protocol.  Most of the XMODEM error messages
  309.       are preceded by the sector and error number.
  310.  
  311.       ; not allowed with while The while command does not allow any
  312.       semicolons to exist on the rest of the line.
  313.  
  314.       Aborting with error from remote: The remote Kermit program has aborted
  315.       the file transfer with the following message.
  316.  
  317.       Access Password When ZCOMM is in host operation, callers must enter an
  318.       access password to gain access to the system, unless the string
  319.       parameter Password is empty.
  320.  
  321.       Awaiting initial NAK When sending a file with the XMODEM protocol,
  322.       ZCOMM is waiting for the receiver to start the transfer with an
  323.       initial NAK character.
  324.  
  325.       Awaiting pathname NAK When sending a file in the the YMODEM Batch
  326.       protocol, ZCOMM is waiting for the receiver to request transmission of
  327.       the file name, and length.
  328.  
  329.       Bad Checksum An error was detected on the last block received with the
  330.       XMODEM or the YMODEM Batch protocol.  ZCOMM will request
  331.       retransmission of the block.
  332.  
  333.       Bad CIS ESC request %x ZCOMM has detected an undefined Compuserve
  334.       Protocol escape request.  Usually due to a line hit or an aborted
  335.       transfer.
  336.  
  337.       Bad CIS request %x ZCOMM has detected an undefined Compuserve Protocol
  338.       request.  Usually due to a line hit or an aborted transfer.
  339.  
  340.       Bad Command Please refer to Chapter 19 for legal commands.
  341.  
  342.       Bad Condition Please refer to Chapter 27 for legal conditions which
  343.       may be tested by the if or while commands.
  344.  
  345.       Bad CRC An error was detected on the last block received with the
  346.       XMODEM or the YMODEM Batch protocol.  ZCOMM will request
  347.       retransmission of the block.
  348.  
  349.       Bad CRC Length=n An error was detected on the last subpacket received
  350.       with ZMODEM.  ZCOMM will request retransmission of the block.  If the
  351.  
  352.  
  353.       (C) 1994 Omen Tech Inc           Chapter 31 Error (and other) Messages
  354.  
  355.  
  356.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  357.       ZCOMM User Manual                                                  277
  358.  
  359.       reported length is shorter than the nominal subpacket length the
  360.       problem may be incorrectly configured flow control at the sending end.
  361.  
  362.       Bad Directory The directory given in a cd command does not exist or is
  363.       unreadable.
  364.  
  365.       Bad Disk A command of the form D: attempted to change the default disk
  366.       to one that is not in the string parameter disks.
  367.  
  368.       Bad Term Option Please refer to Chapter 22 for a list of legal Term
  369.       Options.
  370.  
  371.       Bad Option Please refer to Chapter 20 for legal Options to the k, r
  372.       and s commands.
  373.  
  374.       Bad Parameter The p command was given with an unknown parameter
  375.       letter.  The parameters that can be set may be displayed with the p
  376.       command given without any parameter.
  377.  
  378.       Bad parity Setting The 7{eoms} term option must be be one of e o m s
  379.       (even, odd, marking, spacing).
  380.  
  381.       Bad SNP A valid and legal serial number-password must be entered with
  382.       the putsnp program.
  383.  
  384.       Call Terminated An attempt at connecting to a remote system has been
  385.       abandoned.
  386.  
  387.       Can't allocate buffer ZCOMM was unable to allocate memory for the
  388.       circular buffer, forcing an immediate exit.
  389.  
  390.       Can't find Directory entry for %s A call or gosub command for name
  391.       failed because name was not found in the directory.
  392.  
  393.       Can't open %s errno = %d The named file cannot be opened for reading
  394.       or writing (depending on the application).  The common reasons are
  395.       listed below:
  396.  
  397.       1   No such file or directory.
  398.  
  399.       4   Bad file number.
  400.  
  401.       5   Not enough core.
  402.  
  403.       6   Permission denied.
  404.  
  405.       7   File exists.
  406.  
  407.       8   Cross-device link.
  408.  
  409.  
  410.  
  411.  
  412.       (C) 1994 Omen Tech Inc           Chapter 31 Error (and other) Messages
  413.  
  414.  
  415.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  416.       ZCOMM User Manual                                                  278
  417.  
  418.       10  Too many open files.  (If this error appears when the specified
  419.           file is accessible, increase the number of available files with a
  420.           "FILES=20" statement in CONFIG.SYS.)
  421.  
  422.       11  No space left on device.
  423.  
  424.       14  Resource deadlock would occur.
  425.  
  426.       Can't send pathname %s The receiver did not accept the named pathname
  427.       in a batch transfer.
  428.  
  429.       No Carrier Detect The Carrier Detect signal from the modem (pin 8 of
  430.       the RS232 connector) is OFF.  This is often caused by a bad modem
  431.       cable, or improper modem strapping options.  Setting d term option
  432.       prevents ZCOMM from issuing this message.
  433.  
  434.       Changing pathname An illegal pathname has been received.  ZCOMM is
  435.       changing the pathname to one the local operating system will accept.
  436.  
  437.       Checksum Bad rx=%x cx=%x The last block was received with a bad
  438.       checksum.  The received checksum and the calculated checksum are
  439.       displayed.  A retransmission request will be made.
  440.  
  441.       Closing %s Reception of data for the named file has finished and ZCOMM
  442.       is closing out the file.
  443.  
  444.       Command not allowed remotely Certain commands may only be given from
  445.       the local keyboard as they would sever communications with a remote
  446.       user in host operation.
  447.  
  448.       Connected to Console Keyboard This message is sent to a caller when
  449.       the chat command is given in host operation.
  450.  
  451.       *** DISK FULL *** If this message appears, your problems may have just
  452.       started; DOS has been known to trash the disk file system when the
  453.       disk is filled up.  If the disk has been filled up as a result of
  454.       receiving data with the term function, use the t, b, w review
  455.       subcommands to store the unwritten data on disk.  The browse command
  456.       may be used to free up disk space.  The integrity of the disk file
  457.       system should be checked with chkdsk/f as soon as possible.
  458.  
  459.       Enter message up to 64 lines, type blank line when finished The
  460.       message or private command allows the user (local, or remote when is
  461.       host operation) to enter a message which will be appended to the
  462.       Messages or Private file.
  463.  
  464.       Error Checksum=%x Got %x An error was detected in a record received
  465.       from Compuserve.  ZCOMM will request retransmission.
  466.  
  467.       Error Recovery ZCOMM has detected a protocol error and is waiting for
  468.       the line to settle before proceeding.
  469.  
  470.  
  471.       (C) 1994 Omen Tech Inc           Chapter 31 Error (and other) Messages
  472.  
  473.  
  474.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  475.       ZCOMM User Manual                                                  279
  476.  
  477.       Exists. Replace/Append/Quit (r/a/q)??  The named file already exists
  478.       on the local system.  You have three options: Replace the old file
  479.       with the new data, Append the new data to the end of the old file, or
  480.       Quit the transfer.
  481.  
  482.       Exit chat with ^Z The remote should type Ctrl-Z to exit from chat back
  483.       to the ZCOMM prompt.
  484.  
  485.       Falling back to XMODEM/CRC An attempted XMODEM-CRC file receive has
  486.       failed because the sender has not responded to CRC Send requests, so
  487.       Zcomm will now try checksum XMODEM.
  488.  
  489.       FILES OPEN A transmit and/or receive file is open.  Files should be
  490.       closed before executing any commands that would modify data on disk
  491.       and/or any directories.
  492.  
  493.       Fetching pathname ZCOMM has requested the remote sender to transmit
  494.       the name and length of the next file in a the YMODEM Batch protocol
  495.       transfer.
  496.  
  497.       found %d %s This informational message is generated when the term
  498.       function matches a pattern and the v parameter is non zero.
  499.  
  500.       Garbled data subpacket An error was detected while attempting to
  501.       receive data with ZMODEM.  This is caused by loss or corruption of
  502.       transmitted characters between the sending and receiving program.
  503.       Line noise and flow control mismatch are the common culprits.
  504.  
  505.       Got %x for record ACK The Compuserve computer rejected the last record
  506.       sent.
  507.  
  508.       Got %x for sector ACK In the XMODEM protocol, a transmitted sector
  509.       elicited a response other than the expected ACK, or a NAK.  Perhaps
  510.       the receiving program has terminated and ZCOMM is trying to send the
  511.       record to the remote's operating system command prompt.
  512.  
  513.       Got %x for ACK to EOT The XMODEM protocol sends an EOT to terminate
  514.       each file transfer.  The proper response to the EOT is an ACK;
  515.       anything else is an error.  ZCOMM resends the EOT up to ten times if
  516.       an ACK is not received.
  517.  
  518.       Got %x sector header In the XMODEM protocol, A sector should start
  519.       with 01 or 02.  (02 signifies a 1024 byte block.) An EOT followed by
  520.       extraneous characters appears as a sector header of 04 (EOT).
  521.  
  522.       Got burst for sector ACK In the XMODEM protocol, sectors are
  523.       acknowledged with a single ACK (006) character.  ZCOMM detects an
  524.       invalid ACK response by waiting two character times to make sure no
  525.       noise burst accompanied the ACK.  It's far better to retransmit a
  526.       block which has been received correctly than it is to incorrectly
  527.       proceed to the next block, causing a synchronization error.
  528.  
  529.  
  530.       (C) 1994 Omen Tech Inc           Chapter 31 Error (and other) Messages
  531.  
  532.  
  533.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  534.       ZCOMM User Manual                                                  280
  535.  
  536.       Got record %x expecting %x A synchronization error has been detected
  537.       in the Compuserve protocol.  The file should be deleted as it will
  538.       have been truncated.
  539.  
  540.       Got ZCAN indicates the other program has encountered a fatal error and
  541.       has requested immediate termination of file transfer(s).  To determine
  542.       the cause of this error, you must inspect the error messages displayed
  543.       by the other program.
  544.  
  545.       Got ZRPOS indicates the receiving program has detected a transmission
  546.       error and has requested retransmission.  In other words, ZMODEM is
  547.       doing its job of detecting and correcting missing and garbled data.
  548.       Please refer to Chapter 14 for more information.
  549.  
  550.       Goto not in script context The goto command is valid only in a script.
  551.  
  552.       Hit F1 to End When receiving data with the fget command, hit F1 to end
  553.       data collection.  Any regular character is passed to the remote.
  554.  
  555.       Hit any Key to stop When sending a file with the fput command, ZCOMM
  556.       samples the keyboard every so often to allow the operator to abort the
  557.       transfer.  The keyboard is not scanned continuously because the
  558.       resulting overhead would impair the throughput available with the fput
  559.       command.
  560.  
  561.       Incorrect The password entered is not the correct password.
  562.  
  563.       Insufficient DOS FILES=# Add a FILES=20 line to the active CONFIG.SYS
  564.       file and reboot DOS to get a sufficient number of file handles to
  565.       support the level of script nesting required for your application.
  566.  
  567.       Internal Stack Failure The number and/or size of DOS 3.2 internal
  568.       stacks should be increased, or a better operating system should be
  569.       substituted.
  570.  
  571.       ioctl(m n) returned N: reason A Unix ioctl operation returned an
  572.       error.  The first ioctl argument refers to the file descriptor; 0, 1
  573.       or 2 indicate a problem with the controlling terminal.  Higher file
  574.       descriptor numbers (typically 6 or 7) refer to the dial-out serial
  575.       line.
  576.  
  577.       The second ioctl argument is the command, shown in hex.  This
  578.       corresponds to definitions in /usr/include/sys/ioctl.h and termio.h.
  579.  
  580.       %s Is Illegal Device Device is not one of the legal devices in the
  581.       string parameter Disks.
  582.  
  583.       Is Restricted Path When ZCOMM is Restricted, only the Home directory
  584.       and its subdirectories may be accessed.
  585.  
  586.       Label %s not found A goto label command was given, but label could not
  587.  
  588.  
  589.       (C) 1994 Omen Tech Inc           Chapter 31 Error (and other) Messages
  590.  
  591.  
  592.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  593.       ZCOMM User Manual                                                  281
  594.  
  595.       be found in the same file as the goto command.
  596.  
  597.       Loc 0 Corrupted An internal error (data stored into location 0 in the
  598.       data segment) has been detected.  If not caused by a hardware problem,
  599.       please report to Omen.
  600.  
  601.       Local Kermit Timed Out ZCOMM did not receive a Kermit packet from the
  602.       remote within the timeout specified by the Kermit t parameter.
  603.  
  604.       Must set top with t command first When using the w subcommand from
  605.       review, the top of the buffer segment to be written must be set with
  606.       the t subcommand.
  607.  
  608.       NAK on sector In the XMODEM protocol, the receiver detected a
  609.       transmission error and has requested retransmission.
  610.  
  611.       No ACK on EOT In the XMODEM protocol, and EOT is sent and acknowledged
  612.       after the data blocks have been sent.  This message indicates that the
  613.       EOT has not been acknowledged after 10 attempts.
  614.  
  615.       No ACK on sector The XMODEM transmit protocol has retransmitted the
  616.       sector 10 times without receiving an acknowledgement from the
  617.       receiver.  This is usually caused by a loss of connection, or by a
  618.       software or hardware problem that does not allow all characters to
  619.       pass without error.  For example, if the modem cannot pass a character
  620.       with the 8th bit set, the sector number cannot be sent.  Kermit should
  621.       be used under such conditions.
  622.  
  623.       No Carrier Detect The Carrier Detect signal from the modem (pin 8 of
  624.       the RS232 connector) is OFF.  This is often caused by a bad modem
  625.       cable, improper modem strapping options, bad port number selection, or
  626.       a defective or incorrectly configured serial interface.  Setting d
  627.       term option prevents ZCOMM from issuing this message.
  628.  
  629.       No such command The DOS Gateway handler was unable to load the proper
  630.       command and/or command.com.
  631.  
  632.       Not allowed to overwrite %s When ZCOMM is restricted, existing files
  633.       may not be overwritten.
  634.  
  635.       Nothing to read A read command was given and no file is open for
  636.       reading.
  637.  
  638.       Null Pathname An attempt was made to reference a file with an empty
  639.       file name.  This error sometimes results from a software bug in
  640.       Compuserve software attempting to download a file with a filename it
  641.       can't handle correctly, so it just leaves the filename empty.
  642.  
  643.       Obey Recursion = %d The main command parser has been called
  644.       recursively with too many script levels and/or invocations of the obey
  645.       command.
  646.  
  647.  
  648.       (C) 1994 Omen Tech Inc           Chapter 31 Error (and other) Messages
  649.  
  650.  
  651.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  652.       ZCOMM User Manual                                                  282
  653.  
  654.       Other end no longer in Kermit
  655.       Other side timed out.  The Kermit on the other computer has terminated
  656.       the file transfer.
  657.  
  658.       Out of Memory ZCOMM has exhausted the memory available to it.
  659.  
  660.       Output Flow Control Restraint RELEASED The network or modem did not
  661.       release flow control within the time limit set by the S numeric
  662.       parameter.  This message is usually caused by a spurious XOFF
  663.       character generated by line noise.  It may also be caused by missing
  664.       CTS (Clear To Send) signal on the data port.
  665.  
  666.       OVERRUN: DATA May Be Lost Data has been received from the Remote
  667.       faster than ZCOMM could process it.  Some of it has been rerouted to
  668.       the proverbial bit bucket.
  669.  
  670.       Pause (grab) Sending of data has been stopped by execution of the grab
  671.       command.
  672.  
  673.       Pause (handshake)
  674.       Pause (XOFF) Sending of data has been suspended by flow control.
  675.  
  676.       Pattern Flags Reset This message is a reminder that any "pattern
  677.       found" flags are being reset.  If this message appears after a phrase
  678.       has been "found", but before the phrase is expected, or before the
  679.       wait statement that should have "seen" the phrase, the script needs to
  680.       be modified.
  681.  
  682.       Port %d (%X) defective The indicated communications port (8250
  683.       integrated circuit) failed a simple diagnostic test.  Errors in the
  684.       option board switch or strap settings may prevent the port from being
  685.       accessible at the expected address.
  686.  
  687.       PRINTER SPOOLER BUSY The print spooler has been enabled with the l
  688.       term option, and had not finished outputting from the circular buffer
  689.       to the printer when you exited the term function.  To print the rest
  690.       of the data, return to the term function with F2.  You may exit ZCOMM
  691.       at this time, but the rest of the data you wanted to print will be
  692.       lost.
  693.  
  694.       Received dup Sector The last sector was apparently received twice.  In
  695.       the XMODEM protocol, a retransmission is requested in case the sector
  696.       number was garbled by an otherwise undetected error.  The duplicate
  697.       sector is accepted, discarded, and file transfer proceeds.
  698.  
  699.       %s removed A file received in error is removed to allow another
  700.       attempt at uploading it correctly.
  701.  
  702.       Restricted Command This command is not allowed when ZCOMM is
  703.       Restricted to protect the system from inadvertent and/or willful
  704.       tampering.
  705.  
  706.  
  707.       (C) 1994 Omen Tech Inc           Chapter 31 Error (and other) Messages
  708.  
  709.  
  710.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  711.       ZCOMM User Manual                                                  283
  712.  
  713.       Resynchronizing When ZCOMM is sending a file to another copy of ZCOMM
  714.       using CRC-16, recovery from sync errors is possible.
  715.  
  716.       Scripts nested too deep Too many levels of call, gosub, and source
  717.       commands are active.
  718.  
  719.       Sector number garbled An error has been detected in the sector number
  720.       of the last received packet.  A retransmission will be requested.  If
  721.       this error persists for all 9 retries, the transmission medium or the
  722.       remote software may be messing with the 8th bit and/or characters with
  723.       certain bit patterns.  Modems and networks often "eat" control
  724.       characters, especially XON and XOFF.  Switching to ZMODEM or Kermit
  725.       may solve the problem.
  726.  
  727.       Sender CANcelled The Remote has aborted file transfers by sending a
  728.       sequence of CAN characters.
  729.  
  730.       Serial Input Error: Line Status Register HH indicates a hardware
  731.       problem, slow device driver, TSR program, or other software is
  732.       disabling interrupts too long for the program to accept incoming data,
  733.       and some characters are lost.  A slow response to flow control also
  734.       triggers this message.
  735.  
  736.       The value of the line status register is displayed in HEX.  The
  737.       following error conditions are OR'ed into the Line Status Register.
  738.  
  739.  
  740.       01   The Interrupt level circular buffer has been overrun.  This
  741.            indicates a flow control problem.  The remote did not respond to
  742.            ZCOMM's XOFF or hardware flow control signal, and continued to
  743.            send characters after being told not to.  This problem is
  744.            alleviated by matching flow control between the sending computer,
  745.            modems, and the receiving computer.  Usually, the mismatch exists
  746.            between the sending computer and its modem.
  747.  
  748.  
  749.       02   An 02 value (or any even number) for the LSR indicates Data
  750.            Overrun.  "Data Overrun" means the computer was not able to
  751.            respond to an incoming character from the UART (modem) in time to
  752.            make room for the next incoming character.  Data Overruns are
  753.            caused by poorly designed software and/or ROM BIOS "firmware"
  754.            locking out interrupts for excessive periods.  These lockouts
  755.            prevent the communications program from responding to the
  756.            incoming characters in time to prevent data loss.
  757.  
  758.            Other chapters in this document give suggestions for working
  759.            around excessive interrupt latency by using the NS16550AN or
  760.            other buffered UART chips.  Please refer to the "Brain Damaged
  761.            UARTS" subchapter.
  762.  
  763.            Please try all the suggestions mentioned here before contacting
  764.  
  765.  
  766.       (C) 1994 Omen Tech Inc           Chapter 31 Error (and other) Messages
  767.  
  768.  
  769.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  770.       ZCOMM User Manual                                                  284
  771.  
  772.            Omen Technology about data overruns.
  773.  
  774.            Common causes of excessively long interrupt lockouts ("critical
  775.            code regions") are mouse drivers, disk drivers (BIOS), window
  776.            managers (Windows 3 is terrible), disk cache programs including
  777.            Microsoft SMARTDRV, TSR programs, and EGA/VGA board auto-select.
  778.  
  779.            Slowing the CPU to allow games and other time dependent programs
  780.            to be used can generate excessive interrupt latency.
  781.  
  782.            Some BIOS routines are written without regard to their effect on
  783.            high speed communications.  Better versions of the offending BIOS
  784.            ROMS may be made available if enough users complain about poor
  785.            performance.  In some cases disabling "multiple block transfer"
  786.            in the BIOS improves communications.
  787.  
  788.            Interrupt latency caused by EGA/VGA board auto-select can be
  789.            often corrected by disabling the board's Auto-Select.
  790.  
  791.            Device drivers and TSRs loaded in high memory sometimes cause
  792.            interrupt latency problems that can be corrected by moving them
  793.            into low memory.
  794.  
  795.            Poorly written disk caches and disk drivers cause interrupt
  796.            latency that affects protocols.  Some disk cache programs can be
  797.            set to cache disk reads only, avoiding the massive delayed writes
  798.            that interfere with file downloads.  With Microsoft SMARTDRV.EXE,
  799.            try using the /E option.
  800.  
  801.            Mouse drivers have been reported to cause loss of serial data.
  802.            If mouse movements interfere with file transfers, do not move the
  803.            mouse when transferrng files.
  804.  
  805.            To correct Data Overruns, you must correct the offending
  806.            condition(s) to allow the communications program to operate
  807.            properly.
  808.  
  809.            The handshake slow command can be used to stop reception during
  810.            disk transfers.  However, handshake slow is not always an
  811.            effective alternative to correcting the real problem.  When using
  812.            the handshake slow command, experiment with locking the modem to
  813.            different speeds.  Sometimes a higher speed actually works
  814.            better.
  815.  
  816.            The zmodem k numeric parameter can be set to flush the SMARTDRV
  817.            cache under controlled conditions.  This may be used to reduce
  818.            errors caused by SMARTDRV.  When used with SMARTDEV, set the
  819.            zmodem k numeric parameter to the number of kilobytes the should
  820.            be received before flushing SMARTDRV.  This number should be low
  821.            enough to flush SMARTDRV before SMARTDRV periodically flushes
  822.            itself.
  823.  
  824.  
  825.       (C) 1994 Omen Tech Inc           Chapter 31 Error (and other) Messages
  826.  
  827.  
  828.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  829.       ZCOMM User Manual                                                  285
  830.  
  831.            Downloading files temporarily to a RAMDISK may help.  Files on
  832.            the RAMDISK must be copied to a real disk before they are safely
  833.            stored.
  834.  
  835.            !=2  With DOS flavors of ZCOMM one can select a 16384 buffer
  836.            size, you may be able to avoid problems receiving by using a
  837.            large i/o buffer and forcing ZMODEM to stop when this buffer
  838.            fills:
  839.            pI16384 z pl16384
  840.            or
  841.            pI16384 z pk1
  842.  
  843.            If the I numeric parameter is non zero, it controls how often
  844.            SMARTDRV is flushed if the zmodem k parameter is non zero.   A
  845.            CASE STUDY: NEC UltraLite VERSA The NEC UltraLite VERSA provides
  846.            a case study of how brain damaged hardware and software
  847.            interferes with high speed communications, and what can be done
  848.            about it.  A NEC UltraLite VERSA with 8 MB of memory contains
  849.            about 70 million transistors and costs upwards of $5000.
  850.            Unfortunately this machine lacks the hundred transistors
  851.            necessary to buffer input on its built-in serial port.  This port
  852.            is built in, so replacing it with a better UART ship is out of
  853.            the question.  In normal operation interrupt latency caused by
  854.            the NEC's device drivers and DOS cause errors at 38400 bps and
  855.            above.
  856.  
  857.            Setting the zmodem k parameter to 50 or 100 reduced overruns by
  858.            stopping transmission briefly before disk writes.
  859.  
  860.            The best operation was obtained by hitting the F5 key while DOS 6
  861.            loads to bypass all device drivers and TSR programs.  Operating
  862.            this way there were no data overruns (LSR 02 errors) at 38400
  863.            bps.  Operation at 115200 bps was possible by setting a large I/O
  864.            buffer and using the zmodem k numeric parameter.  I was able to
  865.            download AM.DAT (a 15762427 byte FCC database of North American
  866.            AM broadcast stations provided on the "Ham Call" CDROM) with 3471
  867.            cps throughput using ZMODEM compression.  While nowhere near as
  868.            compressible as Columbia University's Kermit News compressible
  869.            benchmark file, this highly compressible file provides a stress
  870.            test for compressed transfers because of the resulting heavy disk
  871.            I/O.
  872.  
  873.  
  874.       08   Framing Error generally caused by line noise or an incorrect
  875.            transmission speed ("baud rate") or format (number of bits).
  876.            Also caused by some cheap internal modems.  Most protocols
  877.            require 8 bits no parity (-8n) for proper operation.  This is set
  878.            automatically by Omen Technology programs, but other programs may
  879.            not be so smart.
  880.  
  881.  
  882.  
  883.  
  884.       (C) 1994 Omen Tech Inc           Chapter 31 Error (and other) Messages
  885.  
  886.  
  887.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  888.       ZCOMM User Manual                                                  286
  889.  
  890.       10   Break Interrupt generally caused by line noise or an incorrect
  891.            transmission speed ("baud rate") or format (number of bits).
  892.            Also caused by some cheap internal modems.
  893.  
  894.  
  895.       18   Framing Error and Break Interrupt (see above) in combination.
  896.  
  897.            This error may also be caused by defective 8250 UART chips.  Some
  898.            internal modem cards have slow 8250 chips that do not operate
  899.            properly with computers faster than 4.77 mHz.  Replacing the 8250
  900.            with a NS16550AN is recommended.  Please refer to the "Brain
  901.            Damaged UARTS" subchapter for details.
  902.  
  903.  
  904.       Setab: %d %s The displayed string of length %d has been queued to be
  905.       sent to the remote as a result of a put, or putw command, or an
  906.       answerback request.  Setab is also used in sending entstr in response
  907.       to typing ENTER.
  908.  
  909.       *** STACK OVERFLOW *** Indicates ZCOMM has run out of memory for the
  910.       program stack.  Do not pass go, do not collect $200.  Reboot the
  911.       system with Ctrl-Alt-Del.  If you are using a large number of string
  912.       variables, or if you have a large DOS enviornment, decreasing the size
  913.       of ZCOMM's circular buffer with a DOS "set CBSIZE=" command may help.
  914.  
  915.       If this appears to be a ZCOMM software problem, please report it to
  916.       Omen Technology Inc.
  917.  
  918.       String too long The string would have been longer than the storage
  919.       space allocated for it.
  920.  
  921.       Sync Error: got %d In the XMODEM protocol, a sector was received whose
  922.       sector number does not match the expected sector number modulo 256, or
  923.       the last sector number received modulo 256.  This usually happens when
  924.       a transmission error causes the sender to receive a false ACK.
  925.  
  926.       Unless the o (OverThruster) or g option was used,[1] ZCOMM will
  927.       request retransmission in case the invalid sector number was a result
  928.       of a line hit.  If the file is being sent with CRC-16 by another copy
  929.       of ZCOMM, resynchronization will be attempted after ten retries.
  930.  
  931.       Term Function Recursion = %d The term function has been forced to call
  932.       itself recursively by f or t commands.  Use open or create commands
  933.       instead.
  934.  
  935.  
  936.  
  937.       __________
  938.  
  939.        1. These options prevent error recovery.
  940.  
  941.  
  942.  
  943.       (C) 1994 Omen Tech Inc           Chapter 31 Error (and other) Messages
  944.  
  945.  
  946.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  947.       ZCOMM User Manual                                                  287
  948.  
  949.       Timeout The Compuserve computer has not sent any data for a long time.
  950.       When things get this slow, it is best to disconnect and ask Compurerve
  951.       to credit you for wasted connect charges.
  952.  
  953.       Timeout on sector ACK In XMODEM protocol, ZCOMM times out waiting for
  954.       an acknowledgement to a transmitted sector.
  955.  
  956.       Too Few arguments The command needs more operands than were given it.
  957.  
  958.       Transaction ABORTED BY ERROR / successful The message indicates the
  959.       ending status of the last file transfer or command download.  If a
  960.       file transfer ended in error, the last file may be truncated.
  961.  
  962.       Transfer Aborted: %ld Characters Received The Compuserve protocol has
  963.       aborted file transfer due to an error.
  964.  
  965.       Transmit Data. When data has been sent, close it by typing ^Z When a
  966.       remote caller has created a file with the t filename command, ZCOMM
  967.       indicated readiness to receive data with this message.  When the file
  968.       has been transmitted to ZCOMM, a Ctrl-Z will close the file.
  969.  
  970.       Unknown Machine Type ZCOMM looks at the ROM BIOS location F000:FFFE to
  971.       determine whether it is running on a PC, XT, PC-jr, or PC-AT.  If the
  972.       byte fetched in not a standard IBM value, ZCOMM complains and assumes
  973.       the machine is equivalent to a PC or XT with respect to clock speed
  974.       and i/o overlap.  SEE ALSO: o numeric parameter
  975.  
  976.       Unterminated Quoted Token A string token was quoted with a leading "
  977.       (doublequote) character, but no matching " (doublequote) could be
  978.       found on the same line.
  979.  
  980.       Waiting for call %d ZCOMM is in host operation and is awaiting call N.
  981.       If n is greater than 1, then n-1 calls have been received since ZCOMM
  982.       was invoked.
  983.  
  984.       Warning: Old dport=%x ier=%x out2=%x mask=%x isr=%08lX When selecting
  985.       a port, ZCOMM has discovered that the port's interrupt enable bit was
  986.       already set.  Some programs use modem interrupts for their operation
  987.       but then fail to reset the interrupt enables when they exit.  When
  988.       another program overlays the old program's interrupt service routine,
  989.       an interrupt from the modem will transfer control to the overwritten
  990.       memory locations, with unpredicatable results.  If the interrupt was
  991.       set up by a memory resident program or device driver, this message may
  992.       be ignored.  This information might be useful in the event of
  993.       difficulties caused by such programs.  This message may be suppressed
  994.       by defining the DOS environment variable HOTPORT.
  995.  
  996.       EXAMPLE: C>set HOTPORT=1
  997.  
  998.  
  999.       SEE ALSO: port, portx commands
  1000.  
  1001.  
  1002.       (C) 1994 Omen Tech Inc           Chapter 31 Error (and other) Messages
  1003.  
  1004.  
  1005.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  1006.       ZCOMM User Manual                                                  288
  1007.  
  1008.       Wrong number of arguments The set command accepts 0 arguments (display
  1009.       current values) or two arguments, the parameter name and the new value
  1010.       for it.
  1011.  
  1012.       XON Timeout The Kermit protocol (with the x option set) has timed out
  1013.       waiting for an XON character.
  1014.  
  1015.       ZMODEM Garbage count exceeded The reciever has detected a CRC or other
  1016.       error and signalled the sender, but the sender apparently has not
  1017.       received and responded to the retransmission request in a timely
  1018.       manner.  Usually caused by transmission line noise corrupting the
  1019.       retransmission request as well as the file data, or by an excessive
  1020.       number of characters stored in the modems and networks.
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  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) 1994 Omen Tech Inc                      Chapter 31 Hints and Kinks
  1062.  
  1063.  
  1064.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  1065.       ZCOMM User Manual                                                  289
  1066.  
  1067.       32.  HINTS AND KINKS
  1068.  
  1069.       32.1  Recursive Function Key Definitions
  1070.  
  1071.       When defining function keys for use within the term function, do not
  1072.       use the t or f commands.  Instead use the create or open commands to
  1073.       prevent excessive recursion (term function chasing its tail).
  1074.  
  1075.       32.2  Noisy Data Lines
  1076.  
  1077.       Users have reported line noise caused by some types of telephones
  1078.       attached to the same line used by the modem.  When reporting line
  1079.       noise troubles to the phone company, remember you pay for the service
  1080.       call if the trouble is traced to your equipment.
  1081.  
  1082.       32.3  UUUUUUU from 212 modems
  1083.  
  1084.       Sometimes a 212 modem will send UUUUUU ad nauseam because it has
  1085.       received (or thinks it received) a command to enter remote digital
  1086.       loopback.  Disabling the modems' remote digital loopback feature (when
  1087.       possible) prevents this form of "lock-up".
  1088.  
  1089.       32.4  Funny Business with the Phones File
  1090.  
  1091.       When trying out new ideas in the Phones file, make sure that ZCOMM is
  1092.       actually reading the file you think it is by inspecting the value of
  1093.       the phones string parameter with the "set" command.  You might find
  1094.       that you were editing one file and ZCOMM was reading a different one.
  1095.  
  1096.       32.5  Losing Keyboard Characters
  1097.  
  1098.       Generally, ZCOMM does not throw away keyboarded characters that are
  1099.       typed before ZCOMM prompts for them.  However, many commands,
  1100.       especially wait, invoke the term function which sends any characters
  1101.       in the keyboard queue to the remote before returning to ZCOMM's
  1102.       command prompt.  In general, any time you see the term function's real
  1103.       time status line, keyboarded characters will be acted upon immediately
  1104.       (usually by being sent to the the remote).
  1105.  
  1106.       32.6  Browsing Through Messages
  1107.  
  1108.       The vast amount of information on bulletin boards requires some heroic
  1109.       measures on the part of a user desiring to keep current without
  1110.       spending all his time wading through the mass of mostly unintersting
  1111.       messages.
  1112.  
  1113.       ZCOMM addresses this problem with its script facility which can
  1114.       download messages from a number of bulletin boards on one or more
  1115.       systems with human intervention.
  1116.  
  1117.       The read command and "/" and "n" review subcommands can be used to
  1118.  
  1119.  
  1120.       (C) 1994 Omen Tech Inc                      Chapter 32 Hints and Kinks
  1121.  
  1122.  
  1123.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  1124.       ZCOMM User Manual                                                  290
  1125.  
  1126.       skip from one article to the next by searching for the subject line of
  1127.       each message.  Since the subject line of each message always appears
  1128.       at the top of the screen, you can keyboard the "n" key quite rapidly
  1129.       without waiting for the display to completely fill.  If you overshoot
  1130.       a message or two, the "N" command can be used to back up.  You'll be
  1131.       pleasantly surprised at how rapidly you can review message subjects
  1132.       this way.
  1133.  
  1134.       32.7  Splitting Up Files
  1135.  
  1136.       Sometimes it becomes necessary to split up a large file into smaller
  1137.       files, or to extract small pieces from such a file.  For example,
  1138.       Daisy Wheel printers sometimes jam the paper halfway through printing
  1139.       a file.  Rather than reprint the entire file, use ZCOMM's open and
  1140.       seek commands to locate the beginning of the desired segment, then
  1141.       read it into the circular buffer with the read command.  Then hit F2
  1142.       for review, place the top line on the first line desired, and type
  1143.       "t".  If the desired segment fits within the circular buffer, use the
  1144.       "b" subcommand followed by a "w" subcommand to write the segment to
  1145.       disk.
  1146.  
  1147.       If the segment is too large, use the "w" subcommand without a "b"
  1148.       subcommand to write the entire buffer beginning at the location of the
  1149.       "t" command.  Then kill the buffer with the "k" subcommand, returning
  1150.       to ZCOMM's command prompt.  Another read command can be given to get
  1151.       the next segment of the file into the buffer.  At this point, you can
  1152.       enter review as before to store another segment.  Alternatively, you
  1153.       can use the create command to open a receive capture file, then write
  1154.       the buffer contents to it with a w command.  Then use kill to clear
  1155.       the buffer, and repeat this cycle until the end of the file is
  1156.       reached.
  1157.  
  1158.       32.8  Refresher Courses
  1159.  
  1160.       After you've read the manual and used ZCOMM for a while, go back and
  1161.       skim the manual again.  You will grok new concepts that were so
  1162.       obscure the first time you didn't know you missed them.
  1163.  
  1164.       32.9  PC <--> Macintosh File Transfers
  1165.  
  1166.       I do transfers between IBM PC type machines to a Fat Mac and Mac Plus
  1167.       (one upgraded to the other) all the time.  I discovered the
  1168.       Macintosh's RS-422 port does not have enough signals coming out of it
  1169.       to properly drive the IBM PC RS-232 serial port without an adapter.
  1170.  
  1171.       So, get two female DB-25 connectors. On the PC side, tie pins 4-5
  1172.       together, and tie 6-8-20 together. This insures that the PC sees CTS,
  1173.       DSR and RLSD/DCD so your IBM comm program will see them.
  1174.  
  1175.       I prefer using the comm port on the Mac because you can go up to 56
  1176.       kilobits/sec on it (I use ProYAM on the PC and Microphone on the Mac,
  1177.  
  1178.  
  1179.       (C) 1994 Omen Tech Inc                      Chapter 32 Hints and Kinks
  1180.  
  1181.  
  1182.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  1183.       ZCOMM User Manual                                                  291
  1184.  
  1185.       which offers 38400 bit per second transfer capability with no errors).
  1186.       Between the two connectors, connect 7 to 7, 3 to 2, and 2 to 3. If you
  1187.       prefer to use the printer cable, connect 7 to 7, 2 to 2, and 3 to 3.
  1188.       Edited from a message by Stephen Satchell, Satchell Evaluations (used
  1189.       with permission)
  1190.  
  1191.       32.10  Acoustic Coupler for Portables
  1192.  
  1193.       Having a portable computer with a direct-connect internal modem is
  1194.       really great - until you try to use it at a pay phone in the airport.
  1195.       The modular jack does not connect to public telephones.
  1196.  
  1197.       I found one device that overcomes this problem (and it needs to be
  1198.       advertized more).  It is the acoustic adapter that 3M sells with their
  1199.       WhisperWriter portable terminals.  Model 1490 acoustic coupler
  1200.       connects the 3M teleprinter to public phone lines through a telephone
  1201.       handset.  It is recommended for applications where direct connection
  1202.       to phone lines is either not practical or not desirable.  The device
  1203.       consists of a pair of rubber cups, a modular jack, and a battery
  1204.       powered audio amplifier set.  You simply run a 3-foot modular line
  1205.       from it to your PC, and put the pay telephone's handset in it.  Price
  1206.       is less than $80, it works with 300 and 1200 baud internal modems, and
  1207.       should work at 2400.
  1208.  
  1209.       In the Silcon Valley, the distributer is 3M Data Systems (408)866-
  1210.       8811.
  1211.  
  1212.       This information comes via Usenet from Joe Smith at SU-SCORE.
  1213.  
  1214.       Another acoustic coupler is made by CP+ Inc (Computer Products Plus,
  1215.       Inc.) at 800-274-4277, 714-847-1799.  It connects to the modem with a
  1216.       standard modular plug.
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.       (C) 1994 Omen Tech Inc               Chapter 32 Hardware Compatibility
  1239.  
  1240.  
  1241.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  1242.       ZCOMM User Manual                                                  292
  1243.  
  1244.       33.  HARDWARE/SOFTWARE COMPATIBILITY
  1245.  
  1246.       33.1  Hardware Compatibility Notes
  1247.  
  1248.       IBM PS/2 Model 50Z Early samples of this machine have a design error
  1249.         on the motherboard that causes comms programs to lock up the
  1250.         machine.  Replacing the motherboard with a correctly functioning
  1251.         unit from current production corrects the problem.  The part number
  1252.         of the replacement PS2/50 Z motherboard is 35F5928.  (Information
  1253.         provided by John M. Choma 73047,3566) In the U.S. IBM has
  1254.         stonewalled on this issue, but in December 1988 agreed to replace
  1255.         the defective motherboards under warranty.
  1256.  
  1257.       Zenith Computers Older Zenith computers may need a ROM update to work
  1258.         properly with interrupt driven programs such as ZCOMM.
  1259.  
  1260.       NEC Multispeed The NEC Multispeed computer locks up unless STACKS is
  1261.         set in CONFIG.SYS.  In addition, one should disable floppy disk
  1262.         power save mode, and set popup program memory allocation to 0.  For
  1263.         best results, use the latest NEC software patches to the NEC MSDOS,
  1264.         and/or use an IBM PC-DOS instead of the DOS supplied by NEC.
  1265.  
  1266.       EGA/VGA Multimode Boards Some multimode EGA and VGA boards include an
  1267.         "auto select" feature designed to configure the board to various
  1268.         display standards using software trickery.  In the case of Paradise
  1269.         VGA and others, this feature causes excessive interrupt latency and
  1270.         loss of data at high speeds.  Disabling the auto select on the
  1271.         display board corrects this problem.
  1272.  
  1273.       EGA Wonder The BIOS in the ATI EGA Wonder has been observed to
  1274.         increase interrupt latency to the dismay of 9600 bps operation on an
  1275.         8 mHz no wait state AT clone.  There has also been a report
  1276.         (unexplained) that an EGA board has induced line noise in one
  1277.         instance.
  1278.  
  1279.       Tecmar Graphics Master To use ZCOMM with this display board, give a
  1280.         mode mono command before running ZCOMM.
  1281.  
  1282.       Leading Edge MODEMS and I/O BOARDS Some Leading Edge modems and
  1283.         interface boards use 8250 UART devices that do not respond correctly
  1284.         when the software turns the transmitter interrupts on and off.  High
  1285.         performance communications programs such as ZCOMM require properly
  1286.         functioning UART chips, such as the National Semiconductor 16450 or
  1287.         16550A.
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.       (C) 1994 Omen Tech Inc               Chapter 33 Hardware Compatibility
  1298.  
  1299.  
  1300.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  1301.       ZCOMM User Manual                                                  293
  1302.  
  1303.       33.2  Brain Damaged UARTS
  1304.  
  1305.       Omen Technology has received reports of problems with buggy 8250 type
  1306.       UART integrated circuits in Leading Edge modem boards, serial port
  1307.       interfaces, and computers.  The defective chip logic affects high
  1308.       performance software.  Replacing the buggy chip with a newer chip
  1309.       (NS16550AFN) corrects the problem.
  1310.  
  1311.       The UM82450 chip in the Zoom 2400HC also appears to cause problems.
  1312.       Zoom Telephonics advises that this problem is limited to their old
  1313.       model.  The old model has an external volume control.
  1314.  
  1315.       You can identify an old chip by inspecting the serial interface board
  1316.       for 8250 or UM82450 type devices.  A service technician or hardware
  1317.       hacker can help if you are not familiar with reading chip numbers.
  1318.  
  1319.       Dsz users can identify old chips with the following software command:
  1320.  
  1321.       EXAMPLE: dsz port 1 speed 2400 p
  1322.  
  1323.       The resulting value for the P numeric parameter should be 1.  A value
  1324.       of 0 indicates a non-buffered chip or a chip with a defective buffer.
  1325.  
  1326.       ZCOMM and Professional-YAM users can look at the printout produced by
  1327.       the s command;  old UART chips register as TYP 0.
  1328.  
  1329.       Some internal modems and PCMCIA cards use a firmware simulated UART
  1330.       that is not detected as a buffered UART.  Properly designed firmware
  1331.       UARTs provide excellent buffering.
  1332.  
  1333.       The National Semiconductor NS16550AFN is a pin compatible plug in
  1334.       replacement for 8250 and 16450 serial chips.  Omen Technology PCDOS
  1335.       software enables the FIFO buffer in the NS16550AFN to prevents loss of
  1336.       data from poorly written device drivers, TSR programs, etc.
  1337.  
  1338.       We are also using the Goldstar GM82C550 chip with a 9025 date code.
  1339.       This Goldstar chip is plug compatible with the National chips.  No
  1340.       problems have been discovered with this chip.
  1341.  
  1342.       The NS16550AFN has better electrical characteristics than the older
  1343.       UART chips.  386 and fast 286 machines should use the NS16550AFN for
  1344.       best results.  Omen Technology software has been written to allow time
  1345.       for the older UART chips to operate. However, there is a limit to how
  1346.       much the software can rearrange chip accesses without resorting to
  1347.       performance robbing wait loops.  Some other software is not as
  1348.       forgiving of slow chips.
  1349.  
  1350.       Fortunately the FIFO UART chip situation continues to improve.  As of
  1351.       this writing, the following plug compatible chips are known to work.
  1352.  
  1353.  
  1354.  
  1355.  
  1356.       (C) 1994 Omen Tech Inc               Chapter 33 Hardware Compatibility
  1357.  
  1358.  
  1359.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  1360.       ZCOMM User Manual                                                  294
  1361.  
  1362.          + Goldstar GM82C550,
  1363.  
  1364.          + National Semiconductor NS16550AN and NS16550AFN
  1365.  
  1366.          + Startech 16550
  1367.       Current Western Digital WD16C550 chips do not function properly at low
  1368.       speeds.
  1369.  
  1370.       The Startech 16C552 contains two UARTS and a buffered parallel
  1371.       interface.
  1372.  
  1373.       If your UART chip is soldered in or otherwise not replaceable, you
  1374.       will need a new plug-in board with a good UART chip.  Byte Runner
  1375.       Technologies 800-274-7897 offers a variety of boards and chips.
  1376.  
  1377.       Another is the KW-524E-1 Serial/Parallel/Game card, $30.90 from TSD
  1378.       Systems, 800-331-9130 (FAX 407-331-8130).  A board populated with two
  1379.       FIFO UARTS is $41.85.
  1380.  
  1381.       The Hayes ESP board comes with two serial ports with NS16550AFN
  1382.       devices.  The ESP definitions for COM3 and COM4 agree with the
  1383.       industry standard definitions used by Omen Technology.  All option
  1384.       switches on the ESP board should be OFF except those used to select
  1385.       the port number (COMn).
  1386.  
  1387.  
  1388.       The $99 "WinSport II" from Boffin LTD 612-894-0595 has two NS16550AFN
  1389.       FIFO UARTS and also supports MobyBaud (18.432 MHz clock).  This card
  1390.       also supports higher IRQ numbers, freeing up the low IRQs for other
  1391.       applications.
  1392.  
  1393.       Software Electronics 503-640-1946 sells a $59 board with two FIFO
  1394.       UARTS and a bidirectional enhanced parallel port.
  1395.  
  1396.       The following information comes from a number of people:
  1397.  
  1398.       "I have located a small dealer in New York who has the cards with or
  1399.       without the 16550.  I believe the price is around $50.00.  The company
  1400.       is RJK Consulting and the number is 718-968-9167. The gentleman to
  1401.       speak to is a Mr. RJ Kulman. ...  I got this information off the
  1402.       "Interlink" BBS system." Fm: Nick Braak [TRICON] 75156,1254
  1403.  
  1404.       Fry's - 415-770-FRYS.  This is a Silicon Valley electronic department
  1405.       store.
  1406.  
  1407.       Jameco Electronics at 415-592-8097 800-538-5000 sells National
  1408.       NS16550AFN chips mail order (credit card) in small quantities.
  1409.       Unfortunately, we received a number of reports (none recently) that
  1410.       their serial i/o card was supplied with the defective WD16C550
  1411.       soldered in, even when ordered with specific instructions to include
  1412.       16550AFN chips.
  1413.  
  1414.  
  1415.       (C) 1994 Omen Tech Inc               Chapter 33 Hardware Compatibility
  1416.  
  1417.  
  1418.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  1419.       ZCOMM User Manual                                                  295
  1420.  
  1421.       TSD Systems advertise a 2 serial/parallel/game card with one or two
  1422.       NS16550-AFN chips.  800-331-9130(voice) 407-331-8130(fax)
  1423.  
  1424.       Microprocessors Unlimited, 24000 South Peoria, Beggs, OK. (918) 267-
  1425.       4961. The price for the chip is $13.50 plus shipping costs.
  1426.  
  1427.       Consolidated Computers 4 Shoppers Lane Suite 121 Turnersville, NJ
  1428.       08012 (609)751-9595(voice) (609)751-3843(bbs) (609)751-3840(fax)
  1429.  
  1430.       Arrow Electronics at 800-932-7769 (516-467-1000).
  1431.  
  1432.       Willies Computer Software Company: 800/835-4832.
  1433.  
  1434.       N.B.: Current Western Digital WD16C550 chips do not function properly
  1435.       at low speeds.  This has been confirmed with samples received directly
  1436.       from Western Digital.  WD is aware of this problem, but has not
  1437.       informed us of a corrected chip.
  1438.  
  1439.  
  1440.       33.3  Software Compatibility
  1441.  
  1442.       Some programs and device drivers affecting the operation of PC-DOS may
  1443.       interfere with ZCOMM, especially when ZCOMM is operating at high baud
  1444.       rates.  Historically, loss and corruption of data have been caused by
  1445.       memory resident programs.  Some of these programs increase interrupt
  1446.       latency preventing ZCOMM from reading a character from the UART
  1447.       holding register before the next character comes in on top of it.  In
  1448.       other cases, programs do not properly restore the state of the machine
  1449.       when they exit from interrupts.
  1450.  
  1451.       If such a problem is suspected, run ZCOMM without any memory resident
  1452.       programs or special drivers to locate the source of the problem.  Once
  1453.       the offending program is identified, a call to the program's vendor
  1454.       may obtain a corrected version.
  1455.  
  1456.       The design of memory resident programs is a little known black art.
  1457.       Subtle bugs, non reproducible interactions, and magic combinations are
  1458.       commonplace results of attempts to impose various aspects of
  1459.       multitasking on top of an operating system that was not properly
  1460.       designed to permit such extensions.  Omen Technology Inc may be able
  1461.       to help identify these interactions if provided with the source code
  1462.       of the offending programs.
  1463.  
  1464.       Some of the known troublemakers are mentioned below.
  1465.  
  1466.       Smartdrive This disk cache program (Windows 3.1 version) has been
  1467.         observed to cause communications errors even when a FIFO UART is
  1468.         used.
  1469.  
  1470.       BREAK ON This DOS command causes ^C to be intercepted by DOS at
  1471.         various, sometimes awkward, times.  BREAK ON must be used with
  1472.  
  1473.  
  1474.       (C) 1994 Omen Tech Inc               Chapter 33 Software Compatibility
  1475.  
  1476.  
  1477.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  1478.       ZCOMM User Manual                                                  296
  1479.  
  1480.         extreme caution as interrupting most programs with ^C compromises
  1481.         the integrity of the file system.  If a program is interrupted by ^C
  1482.         or Ctrl-Break, the file system should be immediately checked with
  1483.         CHKDSK.  In some cases it may be necessary to reboot DOS with Ctrl-
  1484.         Alt-Del if DOS runs out of file descriptors.  A synonym for BREAK ON
  1485.         might be NUKE FILESYSTEM ON.
  1486.  
  1487.         Someday MicroSoft may discover what to do with ^C (DEC figured it
  1488.         out about two decades ago).  In the meantime, we recommend you not
  1489.         use it.  When ZCOMM starts up, it stores the status of the BREAK ON
  1490.         flag, then clears it.  On Exit, or when calling a DOS program, ZCOMM
  1491.         restores the BREAK ON flag to its previous state.
  1492.  
  1493.       Disk Cache Programs Microsoft SMARTDRVIVE Norton NCACHE Multisoft
  1494.         PCQWIK Many disk cache programs tie up the computer long enough to
  1495.         lose modem data.  (It only takes a few thousandths of a second!)
  1496.         Some disk cache programs are worse than others.  Some are so bad not
  1497.         even a FIFO UART can overcome them.
  1498.  
  1499.         Some programs (SMARTDRV) can be set to cache disk reads only,
  1500.         avoiding the delayed writes that disrupt file downloads.
  1501.  
  1502.       Mouse Drivers Some mouse drivers have been reported to interfere with
  1503.         file transfers.
  1504.  
  1505.       DOS append command The DOS append command allows one or more
  1506.         directories to be partially "grafted on" to a specified directory.
  1507.         Some DOS system calls "see" files in the new directory, some do not.
  1508.         This interferes with file transfer options such as -y, -r and -n.
  1509.         If the DOS append command must be used, use the /x:on switch.
  1510.  
  1511.       TOPDOS TOPDOS, ver 2.00i by Frontrunner Development Corp., has caused
  1512.         ZCOMM and other programs to lock up.  Disabling TOPDOS restores
  1513.         normal operation.
  1514.  
  1515.       DOS 3.2 DOS 3.2 introduces the concept of a fixed number of interrupt
  1516.         stacks.  The default value chosen is not always sufficient, and DOS
  1517.         3.2 sometimes prints the infamous Internal Stack Failure message and
  1518.         cheerfully halts the computer.  Adding the line STACKS=20,128 to the
  1519.         CONFIG.SYS file should correct the problem.  Lacking any useful
  1520.         documentation from Microsoft, you may wish to experiment with
  1521.         different values.
  1522.  
  1523.       Extended Memory RAMDISKS Extended Memory electronic disks (ramdisks)
  1524.         require the 80286 chip to switch in and out of protected mode during
  1525.         block transfers.  A hardware reset pulse is used to switch back to
  1526.         the "real mode" required for DOS.  This causes loss of modem data at
  1527.         high speeds.
  1528.  
  1529.         It may be possible to reduce excessive interrupt latency by reducing
  1530.         the length of protected mode block transfers to 128 or less.  In one
  1531.  
  1532.  
  1533.       (C) 1994 Omen Tech Inc               Chapter 33 Software Compatibility
  1534.  
  1535.  
  1536.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  1537.       ZCOMM User Manual                                                  297
  1538.  
  1539.         instance, replacing the ROM BIOS with a newer version increased the
  1540.         maximum transmission speed without losing characters to 9600 bps.
  1541.  
  1542.         This problem has not been observed with expanded memory
  1543.         (Intel/Lotus/AST/etc.) ramdisks.
  1544.  
  1545.         The new generation NS16550AN or 82510 serial interface circuits
  1546.         should be used instead of 8250's for best results at high speed.
  1547.         The NS16550AN allows operation at a communications speed of 115200
  1548.         bps compared to 9600 bps (typical) for the 8250 and 16450.
  1549.  
  1550.       Disk Drivers Disk drivers, especially hard disk drivers for 80286
  1551.         machines, lock out interrupts for varying periods of time.  The
  1552.         actual interrupt latency depends on the speed of the computer and
  1553.         the particular BIOS code used.  In one case, upgrading to a newer
  1554.         BIOS allowed operation at 38400 bps, compared to 4800 bps
  1555.         previously.  Such an improvement is well worth the small ($25
  1556.         typical) cost of a new set of ROM BIOS chips.
  1557.  
  1558.       DOS 3.x Each new version of PC-DOS adds new features and eats up more
  1559.         of the 8088's meager resources.  DOS 3.2 increases interrupt latency
  1560.         enough to interfere with ZCOMM's operation at 19200 bps on an IBM
  1561.         PC.  If this is a problem, switching to DOS 2.1 will reduce the
  1562.         interrupt latency.  Replacing 8250 and 16450 serial interface chips
  1563.         with the new NS16550AN chip allows ZCOMM to operate smoothly at high
  1564.         speeds.
  1565.  
  1566.       FANSI-Console Versions of this program before 1.07 did not maintain
  1567.         the pointer to the active display board in the IBM documented memory
  1568.         location.  A DOS mode command may cause ZCOMM to reference the wrong
  1569.         display adapter address.  This caused incorrect sync signals and
  1570.         possible damage to certain monitors.  Current versions (2.X)
  1571.         increase interrupt latency enough that the serial line drops
  1572.         characters when the keyboard is touched.
  1573.  
  1574.       Seaware Batch Versions of this program has been known to cause loss of
  1575.         data.
  1576.  
  1577.       Spotlight/Lotus Metro This TSR program has been reported to cause
  1578.         ZCOMM to lock up.
  1579.  
  1580.       Pathname Modifiers Programs such as FILEPATH and GLOBALS allow files
  1581.         to be visible in more than one directory at a time.  Such programs
  1582.         may interfere with security when ZCOMM is restricted, since that
  1583.         security is based on restricting access to directories.  In general,
  1584.         sensitive files should not be made global when ZCOMM is made
  1585.         accessible to outside callers.
  1586.  
  1587.         ZCOMM may not recognize file names generated by such programs unless
  1588.         the program traps the DOS FINDFIRST calls as well as the file open
  1589.         calls.
  1590.  
  1591.  
  1592.       (C) 1994 Omen Tech Inc               Chapter 33 Software Compatibility
  1593.  
  1594.  
  1595.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  1596.       ZCOMM User Manual                                                  298
  1597.  
  1598.         We have received various reports of strange behavior which have been
  1599.         traced to filesystem modifications caused by such programs,
  1600.         including damaged file systems.  We recommend such programs be
  1601.         phased out as soon as possible, as they may not operate at all with
  1602.         future versions of DOS or distributed file systems.
  1603.  
  1604.       BRKBOX This program locks out interrupts up to 17 milliseconds while
  1605.         waiting for the vertical retrace.  For a communications program, 17
  1606.         milliseconds is a very long time, and data will be lost at speeds
  1607.         above 300 bps.
  1608.  
  1609.       CGCLOCK Programs such as CGCLOCK.COM use clock interrupts to update a
  1610.         time display on the screen.  Some increase interrupt latency so much
  1611.         that ZCOMM cannot respond in time to accept characters from the
  1612.         remote, even at 1200 baud.
  1613.  
  1614.       Concurrent PC-DOS ZCOMM runs under Version 4.1 of Digital Research
  1615.         Concurrent PC-DOS (CPCDOS).  The - numeric parameter must be set to
  1616.         0.  The CPCDOS "addmem" command should be used to allocate extra
  1617.         memory if DOS Gateway are to be used.
  1618.  
  1619.       ANSI.SYS ZCOMM uses direct keyboard input from the ROM BIOS because
  1620.         the DOS keyboard input calls do not handle Ctrl-BREAK properly.  As
  1621.         a side effect, keyboard keys redefined by ANSI.SYS have no effect on
  1622.         ZCOMM's operation.  It is possible to program some of the keys to
  1623.         call ZCOMM with arguments.  The following file, reassigns ALT-C,
  1624.         ALT-H, and ALT-V to execute the commands shown below.  The $
  1625.         character represents ESCAPE.
  1626.  
  1627.               $[0;46;"cd \tmp";13;"ZCOMM call -200 cbbs-r";13p
  1628.               $[0;35;"ZCOMM call host";13p
  1629.               $[0;47;"cd \tmp";13;"ZCOMM call cissig";13p
  1630.  
  1631.         ZCOMM uses the ROM BIOS CRT functions and direct output to the
  1632.         display, bypassing any processing provided by ANSI.SYS.  Perhaps
  1633.         someday Microsoft will enhance ANSI.SYS to make it useful for
  1634.         programs like ZCOMM ...
  1635.  
  1636.       PRINT.COM Once the DOS PRINT program is memory resident, file
  1637.         downloads at high speeds (38kb on a PC) suffer from interference,
  1638.         even if a file is not currently being printed.
  1639.  
  1640.         With certain printers, the DOS PRINT command will preempt the
  1641.         running program for several seconds at a time.  These "swapouts" can
  1642.         be confusing when you are accessing an interactive application.
  1643.         They may interfere with file transfers, especially if the remote
  1644.         program uses "tight" timing.  If this happens, PRINT should be
  1645.         suspended during file transfers.  Operation of the PRINT command
  1646.         does not appear to cause loss of data downloaded from timesharing
  1647.         services at 1200 bps, as long as the interruptions last less than
  1648.         ten seconds.  Perhaps IBM or Microsoft will someday fix this bug in
  1649.  
  1650.  
  1651.       (C) 1994 Omen Tech Inc               Chapter 33 Software Compatibility
  1652.  
  1653.  
  1654.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  1655.       ZCOMM User Manual                                                  299
  1656.  
  1657.         the DOS PRINT command.  PRINT should not be invoked from ZCOMM for
  1658.         the first time as DOS memory allocation will become fragmented.
  1659.  
  1660.         If PRINT or some other spooler is outputting to a serial port using
  1661.         the BIOS INT 14h serial port driver, ZCOMM's "!~subprogram" command
  1662.         will redirect the printer output to the remote and thus should be
  1663.         avoided.
  1664.  
  1665.       SWITCHAR = -  ZCOMM will work properly when the DOS switch character
  1666.         is set to "-", allowing Unix style pathnames.  The - numeric
  1667.         parameter must be set non zero to allow ZCOMM DOS Gateway to use /
  1668.         to delimit directories.
  1669.  
  1670.         It may be necessary to remove this line from CONFIG.SYS and reboot
  1671.         DOS before using the IBM dump and restore commands.
  1672.         N.B.: DOS 3.0 does not support SWITCHAR in the config.sys file.  A
  1673.         short program, DASH, will set switchar to -.  It prevents many
  1674.         oaths.  Microsoft has removed all SWITCHAR support in DOS 5.0.  So
  1675.         much for POSIX compliance.
  1676.  
  1677.       For demanding applications requiring sophistication, power and support
  1678.       not provided by any user supported communications program, Omen
  1679.       Technology provides Professional-YAM Integrated Communications Tools.
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.       (C) 1994 Omen Tech Inc                 Chapter 33 Background Operation
  1711.  
  1712.  
  1713.       Version 18.18 TurboDial 2.41            Universal Line Printer Edition
  1714.       ZCOMM User Manual                                                  300
  1715.  
  1716.       34.  BACKGROUND OPERATION
  1717.  
  1718.       ZCOMM and the help processor YHP run under TopView, DESQview,
  1719.       Carousel, and Windows, PC-DOS based multiprogramming systems that
  1720.       support virtual video memory access.[1]
  1721.  
  1722.       These operating environments allow multiple programs to run
  1723.       concurrently on the same computer.  Vertical applications can use the
  1724.       high level menus to simplify the customer interface.
  1725.  
  1726.       The default "performance settings" allow nearly full speed file
  1727.       download and scripted data capture from dial-up services when other
  1728.       processes are not accessing the floppy disks.  Launching programs and
  1729.       manipulating windows may cause communications errors.
  1730.  
  1731.       NOTE: Do not run multiple windows with programs accessing the same
  1732.       COMM port.  If you wish to run more than one program accessing a
  1733.       specific serial port, close (terminate) the window running each
  1734.       program before opening a window for another program addressing that
  1735.       port.[2] It is not sufficient to merely suspend a comms program, it
  1736.       must be terminated before another program can access that port without
  1737.       interference.
  1738.  
  1739.       Tell DESQview to use the SPECIFIC port number you are using, and not
  1740.       "Y" to the question: "Uses serial Ports (Y, N, 1, 2)" DOS's file
  1741.       system semantics can cause unexpected results when one program is
  1742.       writing to a file while another program is reading the file.  Unlike
  1743.       Unix, data written by a program does not become visible until the file
  1744.       is closed.
  1745.  
  1746.       Program Information parameters: 256k is suggested for ZCOMM.  If
  1747.       memory is scarce, ZCOMM can run in about 196k with no DOS Gateway
  1748.       allowed and the circular buffer made smaller with a "set CBSIZE=4000"
  1749.       command given to DOS before starting HK.  ZCOMM* and YHP do not write
  1750.       directly to screen, do not access system keyboard buffer, run in the
  1751.       background, use their own colors (optional), accept keyboard
  1752.       typeahead, and the window may close on exit to DOS.  ZCOMM cannot be
  1753.       swapped because modem interrupts call ZCOMM directly.
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.       __________
  1760.  
  1761.        1. BIOS interrupt 10h, ah=0FF and ah=0FE
  1762.  
  1763.        2. Some programs, such as ProComm, lock two ports at the same time
  1764.           even when using only one port.  Such programs will interfere with
  1765.           comms programs running in other windows.
  1766.  
  1767.  
  1768.  
  1769.       (C) 1994 Omen Tech Inc                 Chapter 34 Background Operation
  1770.  
  1771.