home *** CD-ROM | disk | FTP | other *** search
/ The Arcade BBS / arcadebbs.zip / arcadebbs / bbstools / GSZ.DOC < prev    next >
Text File  |  1995-08-25  |  39KB  |  1,159 lines
  1.  
  2.  
  3.  
  4.  
  5.                                      CONTENTS
  6.  
  7.  
  8.       1.  ZMODEM Features at a Glance....................................   1
  9.  
  10.       2.  CUSTOMIZING GSZ................................................   3
  11.           2.1    Setting the GSZ Screen Size.............................   4
  12.           2.2    Speeding up GSZ.........................................   4
  13.  
  14.       3.  TUTORIAL INTRODUCTION..........................................   5
  15.  
  16.       4.  CALLING GSZ FROM COMM PROGRAMS.................................   6
  17.           4.1    USE AN INTERFACE PROGRAM?...............................   6
  18.           4.2    MSKermit 3.xx...........................................   6
  19.           4.3    PROCOMM PLUS............................................   7
  20.           4.4    Qmodem..................................................   8
  21.           4.5    TELIX...................................................  10
  22.  
  23.       5.  BULLETIN BOARD CONSIDERATIONS..................................  12
  24.  
  25.       6.  DESCRIPTION....................................................  13
  26.  
  27.       7.  COMMANDS.......................................................  15
  28.           7.1    List of Commands........................................  15
  29.           7.2    Interrupt Keys..........................................  21
  30.  
  31.       8.  NUMERIC PARAMETERS.............................................  22
  32.  
  33.       9.  ENVIRONMENT VARIABLES..........................................  26
  34.  
  35.      10.  EXIT STATUS....................................................  30
  36.  
  37.      11.  EXAMPLES.......................................................  31
  38.  
  39.      12.  BACKGROUND OPERATION...........................................  32
  40.           12.1   Microsoft Windows.......................................  33
  41.           12.2   VM......................................................  34
  42.  
  43.      13.  TERMINAL SERVERS...............................................  35
  44.                  13.0.1  PORT WATCHERS  36
  45.  
  46.      14.  FLOW CONTROL...................................................  37
  47.  
  48.      15.  ERROR MESSAGES.................................................  38
  49.           15.1   Got ZRPOS...............................................  39
  50.           15.2   Subpacket too Long......................................  40
  51.           15.3   Bad CRC.................................................  40
  52.           15.4   Garbled Data Subpacket..................................  40
  53.           15.5   Serial Input Error: Line Status Register xx ............  41
  54.           15.6   TIMEOUT.................................................  44
  55.           15.7   No Carrier Detect.......................................  44
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.           15.8   Port %d (%X) defective..................................  44
  65.           15.9   COMMAND NOT FOUND.......................................  44
  66.           15.10  Out of Environment......................................  44
  67.  
  68.      16.  SLOW TRANSFERS.................................................  46
  69.  
  70.      17.  IN CASE OF DIFFICULTY..........................................  47
  71.           17.1   LOCKUPS.................................................  47
  72.                  17.1.1  Insufficient Memory  47
  73.                  17.1.2  Environment TOO BIG  47
  74.                  17.1.3  Bad COM Port Configuration  47
  75.                  17.1.4  LAN Manager Conflicts  48
  76.           17.2   Incorrect Batch Files...................................  49
  77.           17.3   Cheap Internal Modems...................................  49
  78.           17.4   Commands Entered in Upper Case..........................  49
  79.           17.5   No Carrier Detect.......................................  49
  80.           17.6   DOS 3.x.................................................  50
  81.           17.7   Perstor Controllers.....................................  50
  82.           17.8   IBM PS/2 Model 50Z......................................  50
  83.           17.9   Brain Damaged UARTS.....................................  50
  84.                  17.9.1  Everex Internal Modems  52
  85.           17.10  Weird Iron..............................................  53
  86.           17.11  PKARC 3.6...............................................  53
  87.           17.12  Will the real YMODEM please stand up?...................  53
  88.           17.13  286 and 386 Extended Memory.............................  53
  89.           17.14  Disk Caches.............................................  54
  90.  
  91.      18.  ASSOCIATED DOCUMENTS...........................................  55
  92.  
  93.      19.  FILES..........................................................  56
  94.  
  95.      20.  Other Omen Technology Products.................................  58
  96.           20.1   Professional-YAM COMMS TOOLS............................  58
  97.           20.2   ZCOMM: Industrial Strength COMMS Shareware..............  58
  98.           20.3   ZMODEM Developer's Collection...........................  58
  99.  
  100.      21.  FAIR PLAY......................................................  59
  101.           21.1   Sharing GSZ Files.......................................  60
  102.           21.2   REGISTRATION............................................  61
  103.           21.3   Files on Registration Disk..............................  63
  104.           21.4   Bulletin Board Registration.............................  64
  105.  
  106.      22.  CHANGES........................................................  66
  107.  
  108.      23.  ACKNOWLEDGEMENTS...............................................  70
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.                                   Chuck Forsberg
  125.  
  126.                                Omen Technology Inc
  127.  
  128.  
  129.                                      ABSTRACT
  130.  
  131.  
  132.  
  133.                    ZMODEM-90(TM) - Not just another XMODEM hack
  134.  
  135.      GSZ is one of many available programs that implement the ZMODEM file
  136.      transfer protocol.  GSZ features the ZMODEM-90(TM) extensions including
  137.      ZMODEM compression and MobyTurbo(TM) accelerator.
  138.  
  139.      GSZ's ZMODEM provides advanced file management features including two
  140.      levels of Intelligent Crash Recovery(TM), and flexible control of
  141.      selective file transfers.
  142.  
  143.      The ZMODEM file transfer protocol provides reliable file and command
  144.      transfers with complete END-TO-END data integrity between application
  145.      programs.  GSZ's 32 bit CRC protects against errors that sneak by "error
  146.      free" modems and even the most advanced networks.
  147.  
  148.      ZMODEM safeguards all data and supervisory information with effective
  149.      error detection.  (XMODEM and many recently introduced protocols do not
  150.      protect vital supervisory data.)
  151.  
  152.      ZMODEM rapidly transfers files, particularly with modern modems,
  153.      timesharing systems, satellite relays, and packet switched networks.
  154.      ZMODEM's streaming operation eliminates delays caused by
  155.      Kermit/XMODEM/YMODEM/JMODEM block acknowledgements.  ZMODEM eliminates
  156.      traditional protocols' PACKET LENGTH compromises between transfer
  157.      efficiency and error recovery; ZMODEM's packet length is the entire
  158.      file.
  159.  
  160.      User Friendliness is an important ZMODEM feature.  ZMODEM
  161.      AutoDownload(TM) (Automatic file Download without user intervention)
  162.      provides a level of convenience unimaginable to users of traditional
  163.      protocols.
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.        GSZ - a ZMODEM-90(TM), True YMODEM(TM), XMODEM File Transfer Program
  179.  
  180.  
  181.                                Omen Technology Inc
  182.  
  183.  
  184.      1.  ZMODEM Features at a Glance
  185.  
  186.      _______________________________________________________________________
  187.      |   Feature              | ProCm | RZSZ | DSZ  | GSZ | ZCOMM | Pro-YAM |
  188.      |________________________|_______|______|______|_____|_______|_________|
  189.      |Security Verification   | no    | no   | no   | no  | no    | YES     |
  190.      |Cybnertic Data Recovery | no    | no   | YES  | YES | YES   | YES     |
  191.      |                        |       |      |      |     |       |         |
  192.      |Command Download        | no    | YES  | no   | no  | YES   | YES     |
  193.      |                        |       |      |      |     |       |         |
  194.      |Update Directory Tree   | no    | YES* | no   | no  | YES   | YES     |
  195.      | Create Directories     | no    | YES* | no   | no  | YES   | YES     |
  196.      | Newer files Only       | no    | YES  | YES  | YES | YES   | YES     |
  197.      | Protect files          | ?     | YES  | YES  | YES | YES   | YES     |
  198.      | Common files Only      | no    | YES  | YES  | YES | YES   | YES     |
  199.      |                        |       |      |      |     |       |         |
  200.      |Collision Avoidance     | ?     | no   | YES* | YES | YES   | YES     |
  201.      |                        |       |      |      |     |       |         |
  202.      |Crash Recoverey         | YES   | YES  | YES  | YES | YES   | YES     |
  203.      | Verified Accuracy      | no    | SZ   | YES  | YES | YES   | YES     |
  204.      |                        |       |      |      |     |       |         |
  205.      |ZMODEM-90(TM)           | no    | YES  | YES  | YES | YES   | YES     |
  206.      | Compression            | no    | YES  | YES  | YES | YES   | YES     |
  207.      | MobyTurbo(TM)          | no    | YES* | YES  | YES | YES   | YES     |
  208.      | 7-bit Paths OK         | no    | YES* | YES* | YES | YES   | YES     |
  209.      |                        |       |      |      |     |       |         |
  210.      |OPERATING SYSTEMS       |       |      |      |     |       |         |
  211.      | Text Translation       | no    | YES  | YES  | YES | YES   | YES     |
  212.      | Record Format Support  | no    | YES  | YES  | YES | YES   | YES     |
  213.      | DOS Shared Files       | ?     | -    | YES  | YES | no    | no      |
  214.      | VMS                    | no    | YES  | no   | no  | no    | YES     |
  215.      | Unix/Xenix             | no    | YES  | no   | no  | no    | YES     |
  216.      |                        |       |      |      |     |       |         |
  217.      |True YMODEM(TM)         | no    | YES  | YES  | YES | YES   | YES     |
  218.      |Demand Upgrade(TM)      | no    | YES  | YES  | YES | YES   | YES     |
  219.      |File Transfer Display   | YES   | no   | no   | YES | YES   | YES     |
  220.      | TOTAL File Xfer Data   | no    | YES  | YES  | YES | YES   | YES     |
  221.      |________________________|_______|______|______|_____|_______|_________|
  222.  
  223.      ProCm = ProComm Plus
  224.      * Not available on all flavors or platforms
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.      Chapter 1 Pg 2        GSZ Reference Rev Sep-18-94        Typeset 9-19-94
  238.  
  239.  
  240.      *************************************************************************
  241.                            GSZ registration is special.
  242.      With most programs, registration only applies only to today's version.
  243.      Not GSZ!
  244.  
  245.      GSZ registration bypasses the shareware announcement and unlocks
  246.      advanced features in all future versions of GSZ.  You don't have to pay
  247.      and pay again for new GSZ versions.  Omen's Demand Upgrade(TM)
  248.      technology allows you to download and activate future GSZ versions
  249.      without further registration!
  250.      *************************************************************************
  251.  
  252.  
  253.      DSZ Upgrade!!  Include your PAID REGISTRATION DSZ SNP CARD and take
  254.      $15.00 off the registration fee!!  (The card must be mailed with the
  255.      order.) (Be sure to copy your DSZ SNP for safe keeping.)
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.      Chapter 1 Pg 3        GSZ Reference Rev Sep-18-94        Typeset 9-19-94
  297.  
  298.  
  299.      2.  CUSTOMIZING GSZ
  300.  
  301.      The GCOLORS program customizes GSZ for your environment.  GCOLORS
  302.      performs the following functions:
  303.  
  304.        + Customize GSZ's color complement (registration not required).
  305.  
  306.        + Save and fetch the color selection separately to allow "colorizing"
  307.          new copies of GSZ
  308.  
  309.        + Insert your GSZ serial number and activation key
  310.  
  311.        + Initialize GSZ with your default communications port (registration
  312.          required).[1]
  313.  
  314.        + Initialize GSZ with your default download directory.  (registration
  315.          required).
  316.  
  317.      GCOLORS is menu driven and is mostly self explanatory.  First GCOLORS
  318.      asks for the file name to modify; answer GSZ.EXE.
  319.  
  320.      Sight impaired users can disable the blinking selection pointer by
  321.      calling "gcolors -q".
  322.  
  323.      The top menu provides several choices.
  324.  
  325.      Choose colors       Modify the GSZ file transfer display color scheme.
  326.  
  327.      Fetched saved colors Fetch the color scheme stored in GCOLORS.T.
  328.  
  329.      adjust for Monochrome display Adjust the color scheme for better
  330.                          visibility on monochrome displays.
  331.  
  332.      Register            Accept your GSZ activation key and insert it in GSZ.
  333.  
  334.      Save changes        Save the color scheme in GSZ and GCOLORS.T.
  335.  
  336.      Quit
  337.  
  338.      If your copy of GSZ is registered, two additional choices appear.
  339.  
  340.      set download Directory
  341.  
  342.  
  343.  
  344.  
  345.      __________
  346.  
  347.       1. The default port may be up to 7 characters, so portx definitions may
  348.          be used.  The validity of the port specification is not checked.
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.      Chapter 2 Pg 4        GSZ Reference Rev Sep-18-94        Typeset 9-19-94
  356.  
  357.  
  358.      set default Port
  359.  
  360.      Some Color Selection menu choices are not shown on the display:
  361.  
  362.      space     increment foreground color
  363.  
  364.      Enter     select the next field
  365.  
  366.      F         decrement foreground color (f increments)
  367.  
  368.      B         decrement background color (b increments)
  369.  
  370.      GCOLORS requires the file GREGDAT.$$$ to serialize GSZ.
  371.  
  372.  
  373.      2.1  Setting the GSZ Screen Size
  374.  
  375.      Some BBS programs display status information such as the name of the
  376.      caller at the bottom of the screen.  Normally GSZ clears all 25 screen
  377.      lines,  but this can be modified with the GSZWINDOW environment
  378.      variable:
  379.  
  380.      SET GSZWINDOW=24    protects the 25th line and disables the frame
  381.                          shadow.
  382.  
  383.      SET GSZWINDOW=23    protects the 24th and 25th lines and disables the
  384.                          frame and frame shadow.
  385.  
  386.      SET GSZWINDOW=21    Protects lines 22-25, disables the frame, frame
  387.                          shadow, and the static data GSZ normally shows in
  388.                          lines 22 and 23.
  389.  
  390.      SET GSZWINDOW=2     Starts the window at line 2.  This allows the
  391.                          calling program to protect information on the top
  392.                          line.  GSZWINDOW values of 3 and 4 also work.
  393.      Setting GSZWINDOW does not affect the GSZ t command.
  394.  
  395.      2.2  Speeding up GSZ
  396.  
  397.      GSZ has a V numeric parameter that can be set to 1 to use direct video
  398.      I/O for the status display.  This speeds up displays but may cause
  399.      serial input errors when CGA equipped computers are used at high speeds.
  400.  
  401.      EXAMPLE: GSZ pV1 t
  402.  
  403.      sets direct video output.
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.      Chapter 3 Pg 5        GSZ Reference Rev Sep-18-94        Typeset 9-19-94
  415.  
  416.  
  417.      3.  TUTORIAL INTRODUCTION
  418.  
  419.      If you are just starting out with GSZ, or if you have difficulty getting
  420.      GSZ to work, please follow the procedure given below.
  421.  
  422.      Do not run any TSR or other COMM program.  This includes LAN programs.
  423.      Reboot a clean DOS if necessary.
  424.  
  425.      Start with the following command given directly from the DOS prompt:
  426.  
  427.                              gsz port 1 speed 2400 d t
  428.  
  429.      Type it exactly as it appears above; do NOT use upper case.
  430.  
  431.      (Change the port number and speed as necessary.  Use only COM1 or COM2
  432.      for testing.)
  433.  
  434.      This connects you to the modem.  Dial a bulletin board by typing AT
  435.      commands to the modem ("ATDT621-3746 <enter>")[1] to make it dial the
  436.      BBS.  Log in as usual.  Then, request a ZMODEM download of a file you
  437.      don't already have.  The file will download automatically, you don't
  438.      have to do anything.  This procedure verifies the correct operation of
  439.      GSZ.
  440.  
  441.      Next you might try calling the BBS using a higher "baud rate".  This
  442.      requires setting a higher speed with the "speed" command.  A "handshake
  443.      on" command may be necessary along with commands to the modem to enable
  444.      hardware handshaking in the CTS and RTS leads.
  445.  
  446.      Perhaps you got some error messages before or during the download.  The
  447.      "ERROR MESSAGES" chapter explains all the commonly seen error messages
  448.      and suggests solutions to the underlying problems.
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.      __________
  461.  
  462.       1. If your modem has a non standard setting the ATDT621-3746 command
  463.          you type to the modem may not echo on the screen.
  464.  
  465.          If your telephone line requires pulse dialing, use ATDP621-3746 (DP
  466.          instead of DT).
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.      Chapter 4 Pg 6        GSZ Reference Rev Sep-18-94        Typeset 9-19-94
  474.  
  475.  
  476.      4.  CALLING GSZ FROM COMM PROGRAMS
  477.  
  478.      If you need to define a trigger string for automatic downloads, make the
  479.      program look for "Control-X B 0 0" without the spaces.
  480.  
  481.      It may be necessary to add the DOS command: SET COMSPEC=C:\COMMAND.COM
  482.      (change as needed) to your AUTOEXEC.BAT file to allow programs to call
  483.      GSZ.
  484.  
  485.      Note: NO SPACES in the SET command!
  486.  
  487.      Please note that gsz reads the hardware to get the speed.  The gsz speed
  488.      command is hardly ever needed when calling gsz from another program.
  489.  
  490.      4.1  USE AN INTERFACE PROGRAM?
  491.  
  492.      A number of third party programs have been developed to provide a
  493.      congenial interface to DSZ if you have enough memory to spare.  The
  494.      XFER, POE, PCALL, DSZ_ZAP, and PROZ programs have been popular in
  495.      interfacing DSZ to ProComm's editor gateway.  Many of these support GSZ
  496.      as well.  These programs are available on many bulletin boards.
  497.  
  498.      Hint: the DOS PATH environment variable must include ProComm's directory
  499.      to allow POE to locate all the POE files,.  The POE files should be
  500.      stored in the ProComm directory.  Setting the "PROCOMM" environment
  501.      variable is insufficient.
  502.  
  503.  
  504.      Calling DSZ with these programs requires more memory than calling DSZ
  505.      directly.
  506.  
  507.      4.2  MSKermit 3.xx
  508.  
  509.      The "push" command (^[p) in MSKermit 3.xx sends an XOFF character to the
  510.      modem before calling DOS.  Using this to activate GSZ's term mode with a
  511.      "gsz t" command causes most remote hosts to lock up.
  512.  
  513.      The remote host can be unwedged by using the gsz G command, or by
  514.      keyboarding XON (Ctrl-Q) from GSZ's terminal mode.
  515.  
  516.      You can add these macros to your MSKERMIT.INI file.  Courtesy Keith
  517.      Petersen W8SDZ
  518.  
  519.      define sx run gsz F port 2 G sx 1 2,define 1,define 2,
  520.      define rz run gsz F ha on port 2 G rz -r
  521.      define sz run gsz F ha bo port 2 G sz 1 2,define 1,define 2,
  522.      define t run gsz F ha on port 2 G t -r
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      Chapter 4 Pg 7        GSZ Reference Rev Sep-18-94        Typeset 9-19-94
  533.  
  534.  
  535.      4.3  PROCOMM PLUS
  536.  
  537.      It's easy to add GSZ to ProComm Plus 2.X.
  538.  
  539.      Datastorm has not licensed ZMODEM-90(TM) technology despite allegations
  540.      that DSZ is now "built in" to ProComm Plus version 2.  Many users of
  541.      ProComm Plus version 2.x use GSZ to get MobyTurbo(TM), Intelligent Crash
  542.      Recovery(TM), and other ZMODEM-90(TM) features.
  543.  
  544.      Make sure the GSZ program is in your search path.  If you don't see GSZ
  545.      announce itself when called from ProComm, GSZ is not in your search
  546.      path.
  547.  
  548.      Here are some handy settings for ProComm Plus.
  549.  
  550.      First, you may need to set the DOS environment before running ProComm.
  551.      Give these commands to DOS before running ProComm Plus.  (These lines
  552.      may be added to your AUTOEXEC.BAT file.)
  553.  
  554.      Note: NO SPACES in the SET command!
  555.      SET DSZPORT=2                   (Only needed for COM2)
  556.      SET DSZLOG=GSZ.LOG      (Only if you wish a log file)
  557.  
  558.      Then set ProComm's external protocol strings.  From terminal mode hit
  559.      ALT-S, then select the PROTOCOL OPTIONS menu item.
  560.  
  561.      From that menu select EXTERNAL PROTOCOL OPTIONS.  Then set ProComm's
  562.      external protocol strings to:
  563.      A- External protocol 1 upload filename:  ZMODEMU
  564.      B- External protocol 1 download filename: ZMODEMD
  565.      C- External protocol 2 download filename: ZMODEMMD
  566.  
  567.      The following batch files are included in the GSZ zipfile:
  568.      ZMODEMU.BAT (contains:  GSZ sz %1 %2 %3 %4 %5 %6 %7 %8 %9)
  569.      ZMODEMD.BAT (contains:   GSZ rz)
  570.      ZMODEMDR.BAT (contains:   GSZ rz -r)
  571.      ZMODEMMD.BAT (contains:   GSZ rz -mr)
  572.      ZMODEMAD.BAT (contains: GSZ t)
  573.  
  574.      !!!!IMPORTANT USE lower case (small letters) EXCEPT WHERE SHOWN!!!!
  575.  
  576.  
  577.      *******************************************************************
  578.      Select the ZMODEM PROTOCOL OPTIONS menu and turn off Auto downloading!
  579.      *******************************************************************
  580.  
  581.  
  582.      When sending (uploading) files with ZMODEMU.BAT give the ProComm window
  583.      the full pathname (c:/foo/bar/file.ext) for *each* file not residing in
  584.      the current directory.
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.      Chapter 4 Pg 8        GSZ Reference Rev Sep-18-94        Typeset 9-19-94
  592.  
  593.  
  594.      When downloading files with one of the other batch files shown above,
  595.      Procomm will also prompt for parameters; just hit ENTER.  Or, you can
  596.      enter options such as "-mr" if they are't included in the batch file
  597.      itself.
  598.  
  599.      Once you've got the hang of things the "ProComm way", try the "gsz t"
  600.      command described above to give you automatic ZMODEM-90(TM) downloads
  601.      (Look Ma, no keystrokes!!!)..
  602.  
  603.      You can also set the editor hot key (ALT-A) or view program hot key
  604.      (ALT-V) by using the ALT-S "FILE/PATH OPTIONS" menu.  The strings for
  605.      these keys are long enough to store an entire GSZ command line without
  606.      need for a batch file.
  607.  
  608.      COM3 and COM4 on Procomm Plus are non standard; in case of difficulty
  609.      use COM1 or COM2, or use the portx command.
  610.  
  611.      GSZ may not operate properly when called from ProComm if ProComm has
  612.      files open at the time.
  613.  
  614.      A number of reports have been received of problems running GSZ from
  615.      ProComm Plus because of insufficient memory.  Please refer to the
  616.      subchapter on LOCKUPS.
  617.  
  618.      When running under ProComm's Host mode, failure to use the GSZ CON
  619.      command may cause ProComm to interfere with file transfers or lock up
  620.      the computer.
  621.  
  622.      EXAMPLE: GSZ CON sz %1
  623.  
  624.  
  625.      Hint: the DOS PATH environment variable must include ProComm's directory
  626.      to allow POE to locate all the POE files,.  The POE files should be
  627.      stored in the ProComm directory.  Setting the "PROCOMM" environment
  628.      variable is insufficient.
  629.  
  630.  
  631.      4.4  Qmodem
  632.  
  633.      Changes in the Qmodem interface (arguments passed to the batch file) may
  634.      require changes in the batch files shown below, depending on which
  635.      version of Qmodem is used.
  636.  
  637.      If you need to define a trigger string for automatic downloads, make the
  638.      program look for "Control-X B 0 0" without the spaces.
  639.  
  640.      If you define a protocol with 'Z' as its letter, the latest Qmodem will
  641.      detect automatic ZMODEM downloads.  Defining an external 'Z' protocol
  642.      disables Qmodem's internal ZMODEM, allowing GSZ to be called.
  643.  
  644.      The following is based on a message from Mike Cody, sysop of HomePlate
  645.  
  646.  
  647.  
  648.  
  649.  
  650.      Chapter 4 Pg 9        GSZ Reference Rev Sep-18-94        Typeset 9-19-94
  651.  
  652.  
  653.      313-385-9969 3/12/24/96 HST
  654.  
  655.      Go into Qinstall and go to frame 3 Directories. Then select External
  656.      protocols #3 I think. Now you will see a definition area to tell Qmodem
  657.      the Letter,batchfile combo to use.
  658.  
  659.      Now put Z in the letter definition, Zup.bat in the u/l batch zdown.bat
  660.      in the d/l batch, and Y in the batch protocol. Now save it at the menu
  661.      with f10 and S.
  662.  
  663.      Then go to DOS and create the following batch files in your Qmodem
  664.      directory...
  665.  
  666.      zdown.bat: GSZ port %2 rz -rr
  667.  
  668.      zmdown.bat: GSZ port %2 rz -mrr ((FOR MOBYTURBO!!))
  669.  
  670.      zmdown2.bat: GSZ port %2 est 0 %3 rz -mrr
  671.  
  672.      zup.bat: GSZ port %2 sz %4
  673.  
  674.      !!!!IMPORTANT USE lower case (small letters) EXCEPT WHERE SHOWN!!!!
  675.  
  676.      These are the batch files that will be called by Qmodem.  If you did
  677.      everything right when you hit PGDN or PGUP you will see an external
  678.      protocol called Z) Zmodem in the box. For an easier time do a search for
  679.      either External.arc or maybe the string "Qmodem" in the file database as
  680.      there is a file with several external protocols and batch files
  681.      available in the Mahoney file section (EXEC-PC BBS).
  682.  
  683.      The following batch files for Qmodem are included in the GSZ zipfile:
  684.  
  685.      ZDOWN.BAT contains:     GSZ port %2 rz -rr
  686.      ZUP.BAT contains:       GSZ port %2 sz %4
  687.  
  688.      !!!!IMPORTANT USE lower case (small letters) EXCEPT WHERE SHOWN!!!!
  689.  
  690.      A variation on the receive batch file:
  691.      c:elecomqmodem\*y.com ha slow est 0 %3 rz -mrr
  692.      A variation on the send batch file:
  693.      c:elecomqmodem\*y.com ha cts est 0 %3 sz %4
  694.  
  695.  
  696.      If Qmodem says "unable to allocate swap space": QMODEM 4.2 will swap all
  697.      but approx. 5K to memory or disk when you shell out to GSZ. Go into
  698.      QINSTALL and make sure that /O /R Optimum Shell and Disk Shell are both
  699.      set to ON.
  700.  
  701.      For older Qmodem versions (before 4.2) change the %4 in upload scripts
  702.      to %3.
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.      Chapter 4 Pg 10       GSZ Reference Rev Sep-18-94        Typeset 9-19-94
  710.  
  711.  
  712.      4.5  TELIX
  713.  
  714.      Telix has an internal ZMODEM, but some users prefer to use GSZ for
  715.      performance and/or reliability reasons.  Mat Fisher has published a
  716.      Telix script to call GSZ for automatic downloads.
  717.  
  718.      For those of you who use GSZ with Telix, here is a sample script
  719.      file to use instead of batch files:
  720.  
  721.      //////////////////////////////////////////////////////////////////
  722.      //Protocol salt file for Telix's external protocols by Matt Fisher
  723.      //Last edited (02/24/90)
  724.      //used for the GSZ ZMODEM protocol.  (for u/ling & d/ling)
  725.      //////////////////////////////////////////////////////////////////
  726.  
  727.      str upload[80] = "c:\telix\DSZ port 1 ha on sz -m -rr ";
  728.  
  729.      str download[80]= "c:\telix\DSZ port 1 ha on rz -b -m -rr ";
  730.  
  731.      //////////////////////////////////////////////////////////////////
  732.  
  733.      Main ()
  734.      {
  735.       if (_ext_filespec == "")
  736.        { strcat(download,_down_dir); dos(download,0); }
  737.       else
  738.        { strcat(upload,_up_dir); strcat(upload,_ext_filespec); dos(upload,0); }
  739.      alarm(1);
  740.      }
  741.      //////////////////////// THE END //////////////////////////////////
  742.  
  743.      Simple but effective...
  744.      --- TAGMAIL v2.20
  745.       * Origin: CRIMP/John Galt [Node 1] (1:120/144)
  746.      INTERNET: Matt.Fisher@f144.n120.z1.FIDONET.ORG
  747.  
  748.      NOTE: The DSZ command strings given above are quite unusual.  Instead of
  749.      the  "pW1  ha  off"  one  would be more likely to use "ha on" or "ha sw"
  750.      depending on the modem's flow control settings.
  751.  
  752.  
  753.         From : Bill Logan
  754.      Subject : Help With Gsz For Telix
  755.  
  756.      I test and use a variety of terminal programs for individuals.
  757.      One of which is telix.  I found the script language to be less
  758.      than user friendly and installed GSZ via batch files and as an
  759.      external protocol.  Here are the batch files:
  760.  
  761.      ZMUP.BAT
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.      Chapter 4 Pg 11       GSZ Reference Rev Sep-18-94        Typeset 9-19-94
  769.  
  770.  
  771.      GSZ pV1 port %2 sz -mr %3
  772.  
  773.      ZMDN.BAT
  774.  
  775.      GSZ pV1 port %2 rz -mrr %3
  776.  
  777.      Then go to ALT O in Telix and insert those batch names in the protocols.
  778.  
  779.      They worked fine for me.
  780.  
  781.      Bill
  782.  
  783.      ---
  784.       * Origin: PCConsultingAgencyII {=Telecom Node=} (1:300/22)
  785.  
  786.      Use the Telix ALT-O screen to disable Telix's automatic ZMODEM download.
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.      Chapter 5 Pg 12       GSZ Reference Rev Sep-18-94        Typeset 9-19-94
  828.  
  829.  
  830.      5.  BULLETIN BOARD CONSIDERATIONS
  831.  
  832.      Note to the wise BBS operator: be sure you understand the restrict
  833.      command, how and WHY to use it!
  834.  
  835.      When installing GSZ on a bulletin board or host system, be sure to check
  836.      for proper operation when the caller hangs up while a file is being sent
  837.      or received.
  838.  
  839.      Some bulletin boards do not call GSZ to send a file until they have
  840.      verified the file's presence by actually opening the file.  If this
  841.      checking is done in DOS's default exclusive open mode, gsz's file
  842.      sharing will be defeated.
  843.  
  844.      If using a FOSSIL driver, you may need to call DSZ thru a batchfile.
  845.      That file should call XU to disable X00 before running DSZ and restart
  846.      X00 afterwards. Failure to take this precaution may cause FOSSIL to
  847.      steal the COM port from GSZ before file transfers are completed.
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.      Chapter 6 Pg 13       GSZ Reference Rev Sep-18-94        Typeset 9-19-94
  887.  
  888.  
  889.      6.  DESCRIPTION
  890.  
  891.      GSZ is a "protocol driver" that uses ZMODEM-90(TM), True YMODEM(TM), or
  892.      XMODEM to transfer files over a serial port with a variety of programs.
  893.  
  894.      GSZ has two main commands for ZMODEM transfers: "sz" sends file(s), and
  895.      "rz" receives them.
  896.  
  897.      When calling bulletin boards to download files with ZMODEM you can avoid
  898.      the bother of starting GSZ for each transfer by GSZ's terminal emulator,
  899.      before asking the BBS for the download.
  900.  
  901.                              gsz t
  902.  
  903.      The "t" command allows you to keyboard the file request directly to the
  904.      BBS.  (The "t" stands for "terminal emulation".) Just give the "gsz t"
  905.      command from DOS or your comms program's DOS GATEWAY.  GSZ's ZMODEM
  906.      AutoDownload then receives the file automatically, using the filename
  907.      provided by the BBS, without any wasted keystrokes or delay.  Try it,
  908.      you'll like it!  (The "t" command is described below.)
  909.  
  910.      YMODEM downloads are almost as easy.  Use the "t" command as shown
  911.      above, and hit the F3 key after telling the board to download a file
  912.      with YMODEM.
  913.  
  914.      ZMODEM and True YMODEM(TM) transfers preserve exact file length and
  915.      modification time.
  916.  
  917.      GSZ supports XMODEM-1k (XMODEM with 1024 byte blocks, sometimes
  918.      mislabeled as ymodem) and CRC-16 with the sx -k and rc commands.
  919.  
  920.      GSZ is usually called from a communications or bulletin board program.
  921.  
  922.      GSZ uses its own modem I/O.  The original interrupt vector, UART parity,
  923.      and interrupt configuration are restored on exit.  The original state of
  924.      the 8259 interrupt mask bit for this vector is also restored on exit.
  925.  
  926.      GSZ uses DOS standard output (stdout) for messages.  GSZ never writes
  927.      directly to the screen.  GSZ expects its standard output to point to the
  928.      console, a logging file, or NUL, but never the modem port.  If gsz's
  929.      standard output is redirected to the modem (as with ProComm's Host mode
  930.      DOS shell), the combination will lock up the computer.  When necessary,
  931.      gsz's standard output can be redirected back to the console device with
  932.      the CON command.
  933.  
  934.      DSZ and GSZ automatically support Doorway 2.2 without extra commands.
  935.  
  936.      The RZ.BAT and SZ.BAT files are supplied for convenience when operating
  937.      under Doorway.  RZ.BAT allows calling programs that emit an "rz" command
  938.      to automatically start GSZ from the DOS command prompt.  SZ.BAT is a
  939.      convenient command interface that complements RZ.BAT.  You may modify
  940.  
  941.  
  942.  
  943.  
  944.  
  945.      Chapter 6 Pg 14       GSZ Reference Rev Sep-18-94        Typeset 9-19-94
  946.  
  947.  
  948.      SZ.BAT and RZ.BAT with your favorite options.
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.      Chapter 6 Pg 15       GSZ Reference Rev Sep-18-94        Typeset 9-19-94
  1005.  
  1006.  
  1007.      7.  COMMANDS
  1008.  
  1009.            ***********************************************************
  1010.                                     NOTE WELL
  1011.       Except as noted, all commands and options must be typed in lower case.
  1012.                              DO NOT USE UPPER CASE!!
  1013.                                Case is significant!
  1014.            ***********************************************************
  1015.  
  1016.      Optional commands or arguments are shown in square brackets [].
  1017.  
  1018.      When used (in any combination), the A, CON, port, speed, handshake,
  1019.      estimate, and d commands must be used in exactly this order.
  1020.  
  1021.      gsz [CON] [F] [port N] [speed S] [handshake XX] [pxN... ] [z pxN... ]
  1022.      [D] [d] [restrict] [G] command
  1023.  
  1024.      The shareware program DOORWAY 2.2 interfaces well with DSZ, and provides
  1025.      many of the same functions, including the ability to run direct screen
  1026.      writing applications remotely.  DSZ and GSZ automatically support
  1027.      Doorway 2.2 without extra commands.
  1028.  
  1029.  
  1030.      7.1  List of Commands
  1031.  
  1032.      CON   Redirect message output to the DOS "CON" (console) device,
  1033.            overriding any previous redirections.  This is necessary to avoid
  1034.            lockups caused by ProComm host mode.  Most programs do not require
  1035.            this hack.
  1036.  
  1037.      F     Leave the 16550A UART FIFO enabled on exit.  Since GSZ has no way
  1038.            to read the 16550A DMA mode and trigger level bits, these values
  1039.            are not restored.
  1040.  
  1041.      port N select port N (n = 1,2,3,4,5,6,7,8, or 9) Default is 1 (COM1) or
  1042.            whatever is read from the DOS DSZPORT dos environment variable.
  1043.            COM11 to COM18 refer to the COM1 to COM8 ports on the PS/2.
  1044.  
  1045.            *****************************************************************
  1046.                                           NOTE
  1047.            Only COM1 and COM2 are standard on all PC compatible computers.
  1048.            Multiple standards exist for COM3 and above, so use only COM1 or
  1049.            COM2 when first installing GSZ.
  1050.            *****************************************************************
  1051.  
  1052.            GSZ COM3 uses 3E8 and IRQ4.  GSZ COM4 uses 2E8 and IRQ3.
  1053.  
  1054.            GSZ COM7 uses 3E8 and IRQ5.  GSZ COM8 uses 2E8 and IRQ5.
  1055.  
  1056.            If you wish to use COM3 or COM4 and your computer is not wired as
  1057.            shown above, you MUST use the "portx" command to specify the
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.      Chapter 7 Pg 16       GSZ Reference Rev Sep-18-94        Typeset 9-19-94
  1064.  
  1065.  
  1066.            actual base address and interrupt vector.
  1067.  
  1068.            EXAMPLE: to use COM2:
  1069.            gsz port 2 rz
  1070.  
  1071.            In multitasking operation, accessing a port used by another
  1072.            running program will hang the machine.
  1073.  
  1074.  
  1075.      portx base,irq[,divisor] To select an arbitrary port address and
  1076.            interrupt vector, the portx command must be used instead of the
  1077.            port command.  The portx command replaces the portcommand in the
  1078.            same place on the command line.  Please refer to DSZBG.DOC
  1079.            (provided on the Registration Diskette) or the Professional-YAM or
  1080.            ZCOMM (ZCOMMDOC.ZIP) manuals for details on this command.
  1081.  
  1082.            When the portx command is used, gsz will indicate COM9.
  1083.  
  1084.            EXAMPLE: gsz portx 3e8,15 speed 19200 handshake on rz
  1085.  
  1086.            Newer UART chips can use raw bit rate sources up to 8 MHz or more,
  1087.            more than 4 times as fast as the IBM standard 1.84320 MHz.  Some
  1088.            386 and 486 machines support MobyBaud(TM) operation above 115200
  1089.            bps.  To support a nonstandard bit rate source, multiply 5760 by
  1090.            the new raw bit rate source frequency in MHz divided by 1.84320.
  1091.  
  1092.            EXAMPLE: gsz portx 3e8,15,57600 speed 19200 handshake on rz
  1093.            supports the 18.432 MHz clock option on the Boffin Electronics
  1094.            "WinSport II" 2 port serial board.  Your hardware configuration,
  1095.            BIOS firmware, operating system, device drivers, and TSR programs
  1096.            will determine the maximum useful speed.
  1097.  
  1098.  
  1099.  
  1100.      speed S Set the specified speed.  This command is rarely needed because
  1101.            GSZ reads the port's current speed by default.  Please refer to
  1102.            the FLOW CONTROL, MAIN COMMANDS and SOFTWARE COEXISTENCE chapters
  1103.            in DSZBG.ZOO or the ZCOMM or Pro-YAM manual for important
  1104.            information about the speed command.
  1105.  
  1106.            Please study all the chapters of this document when using speeds
  1107.            above 2400 bps.
  1108.  
  1109.            With standard clocking, GSZ supports a maximum speed of 115200.
  1110.            Not all hardware can support that speed without errors.
  1111.  
  1112.  
  1113.      handshake XX Enable one of several choices of hardware handshake.  (The
  1114.            default is XOFF/XON software handshake).  This command is
  1115.            documented in the ZCOMM or Pro-YAM manual, and in DSZBG.DOC.  (The
  1116.            ZCOMM manual is available on all bulletin boards registered for
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.      Chapter 7 Pg 17       GSZ Reference Rev Sep-18-94        Typeset 9-19-94
  1123.  
  1124.  
  1125.            DSZ or GSZ as ZCOMMDOC.ZIP.) On GSZ the "handshake" command may be
  1126.            abbreviated to "ha".
  1127.  
  1128.      D     Disables the modem (drops Data Terminal Ready, DTR) if carrier is
  1129.            lost.  This may be used to prevent spurious events (phone ringing)
  1130.            from interfering with the calling bulletin board's recovery from
  1131.            carrier loss.
  1132.  
  1133.      d     Disables carrier dropout monitoring, for modems that do not
  1134.            properly drive the "Carrier Detect" input on the PC.  If you see a
  1135.            No Carrier Detect message, you need to give the d command.  Before
  1136.            using the d command, make sure you have the proper port
  1137.            selected!!!
  1138.  
  1139.  
  1140.      estimate length [speed] Use the specified length and/or optional
  1141.            specified effective transfer speed to estimate transfer time for
  1142.            the next file to be sent or received.  The length argument is
  1143.            mainly used with XMODEM downloads; YMODEM and ZMODEM normally
  1144.            transfer the file length in the filename packet.  The estimate
  1145.            command must come after any port, speed, or handshake commands.
  1146.  
  1147.            The estimate command does not affect actual throughput.  It only
  1148.            affects GSZ's prediction of how much time a file transfer will
  1149.            take.
  1150.  
  1151.            The following makes GSZ calculate file transfer times based on 290
  1152.            character per second throughput.  Some error correcting 2400 bps
  1153.            modems can attain this throughput when MobyTurbo(TM) is used.
  1154.  
  1155.            EXAMPLE: gsz port 2 speed 9600 estimate 0 2900 rz
  1156.  
  1157.  
  1158.  
  1159.            EXAMPLE: gsz port 2 speed 9600 estimate 0 2900