home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / CO / CO030A.ZIP / CA28-2.ZIP / COM-AND.DOC < prev    next >
Text File  |  1991-07-22  |  202KB  |  6,106 lines
  1. COM-AND: IBM PC Communications and Accessories
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.           -----------------------------------------
  18.           COM-AND:    Communications and integrated
  19.           communications accessories for the IBM PC
  20.           -----------------------------------------
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.     COM-AND is distributed freely and may be copied by anyone for
  33.     any number of machines, for purposes of evaluation.  The author
  34.     offers COM-AND and its accessory programs as a package, as
  35.     "shareware".  If you USE the program a registration of $50.00 is
  36.     required.  The author may be reached:
  37.  
  38.  
  39.                  CABER Software
  40.                  R. (Scott) McGinnis
  41.                  P.O. Box 3607 Mdse Mart
  42.                  Chicago, IL 60654-0607
  43.  
  44.                  PLINK, GEnie id: TARTAN
  45.                  CIS id: 73147,2665
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54. Version 2.8: 910716
  55.  
  56. COM-AND: IBM PC Communications and Accessories
  57.  
  58.  
  59.  
  60.     COM-AND version 2.8 is copyright 1991 CABER Software (R.  Scott
  61.     McGinnis).  All rights are reserved world wide, excepting redistri-
  62.     bution under the ShareWare concept.  COM-AND is distributed freely
  63.     and may be copied by anyone for any number of machines, under the
  64.     ShareWare concept.  Restrictions on redistribution are discussed in
  65.     the accompanying document VENDOR.DOC.
  66.  
  67.  
  68.     COM-AND is distributed as ShareWare.  You may use COM-AND without
  69.     charge for the purposes of evaluating its usefulness.  It is sug-
  70.     gested that this evaluation period be limited to a few days of actual
  71.     use.  If you find COM-AND to be worth continued use, then you must
  72.     pay for it.  Please complete the form REGISTER.DOC and mail it with
  73.     your payment.
  74.  
  75.  
  76.     Registration of COM-AND includes all published accessory programs
  77.     (which currently are PC-VCO, CCHESS, CBRIDGE, and CCOLOR), and
  78.     several utilities (unPACKIT and unSTUFIT).  Accessories and utili-
  79.     ties are published separately.    One registration covers the use of
  80.     any and all of these programs.
  81.  
  82.  
  83.     By registering your copy of COM-AND (or any ShareWare product), you
  84.     are promoting and supporting the convenient distribution method and
  85.     free evaluation policy that brought you this copy of COM-AND.
  86.  
  87.  
  88.     If you have received this copy from a Users' Group, "Software
  89.     Library" or "SIG", and have paid a small fee (usually $3 to $10),
  90.     you have NOT acquired a registration or continued right to use
  91.     COM-AND.  This fee was for the convenience of obtaining the diskette
  92.     with COM-AND on it.  The fee does NOT apply to the registration fee.
  93.  
  94.  
  95.     You may NOT distribute COM-AND or its documentation in connection
  96.     with ANY commercial venture, product, publication or service without
  97.     written approval.  COM-AND may not be disassembled or modified
  98.     without express written consent of its author.
  99.  
  100.  
  101.     COM-AND is supplied "as-is" with no warranties expressed or implied.
  102.     Neither CABER Software nor the author will be liable for any damages
  103.     or lost revenues incurred through the use of this program or any of
  104.     its accessories and utilities beyond the registration price paid.
  105.  
  106.  
  107.  
  108.  
  109. Version 2.8: 910716
  110.  
  111. COM-AND: IBM PC Communications and Accessories
  112.  
  113.  
  114.  
  115.     COM-AND version 2.8 is available as shareware through PLINK, GEnie,
  116.     UNISON, NWI, Delphi and CIS.  COM-AND is also available through many
  117.     Bulletin Board systems.  Individuals are welcome to download COM-AND
  118.     for purposes of evaluation, and to upload COM-AND (in its entirety)
  119.     to Bulletin Board systems.
  120.  
  121.     Commercial users of COM-AND must register COM-AND with the author or
  122.     one of the individuals listed on this page.  Site licenses (multiple
  123.     copy registrations) are available from:
  124.  
  125.         CABER Software
  126.         R. (Scott) McGinnis
  127.         P.O. Box 3607 Mdse Mart
  128.         Chicago, IL 60654-0607
  129.  
  130.         PLINK, GEnie, Delphi ID: TARTAN
  131.         CIS id: 73147,2665
  132.  
  133.     A COM-AND BBS (using a version of COM-AND's BBS script) is operated
  134.     by SupportWare of Long Beach, CA.  SupportWare is licensed to nego-
  135.     tiate COM-AND commercial and site licenses, and provide COM-AND
  136.     support.  SupportWare offers considerable expertise in the field of
  137.     communications consultation.  Contact SupportWare through:
  138.  
  139.         SupportWare
  140.         Mike Todd
  141.         P.O. Box 14927
  142.         Long Beach, CA 90803-1449
  143.  
  144.         Voice: (213) 439-6104
  145.         BBS:   (213) 439-7714 (1200/2400 8n1)
  146.  
  147.     In Japan, COM-AND may be downloaded as shareware from PC-VAN.  It
  148.     is also available in Japan as a commercial product tailored for
  149.     specific machines through:
  150.  
  151.         Discotel Japan (Ciari Soft)
  152.         Kurakuen 3 ban-cho 2-50
  153.         Nishinomiya 662
  154.         Japan
  155.  
  156.         Contact: Claude Ciari
  157.         Tel (0798)73-0052
  158.         PC-VAN NEC by Ciari
  159.         ID: CCIARI
  160.  
  161.  
  162.  
  163.  
  164. Version 2.8: 910716
  165.  
  166. COM-AND: IBM PC Communications and Accessories
  167.  
  168.  
  169.     THE ASSOCIATION OF SHAREWARE PROFESSIONALS (ASP)
  170.  
  171.         ┌─────────┐
  172.       ┌─────┴───┐      │          (R)
  173.     ──│        │o      │──────────────────
  174.       │   ┌─────┴╨──┐ │  Association of
  175.       │   │     │─┘  Shareware
  176.       └───│    o    │    Professionals
  177.     ──────│    ║    │────────────────────
  178.           └────╨────┘    MEMBER
  179.  
  180.  
  181.     In 1987 Shareware authors founded the Association of Shareware
  182.     Professionals (ASP).  In forming this industry association, these
  183.     Shareware authors had several primary goals in mind, including:
  184.  
  185.        .  To inform users about Shareware programs and about Shareware as
  186.           a method of distributing and marketing software.
  187.  
  188.        .  To foster professionalism amongst Shareware authors by setting
  189.           programming, marketing, and support standards for ASP members.
  190.  
  191.        .  To encourage broader distribution of Shareware through user
  192.           groups and disk dealers who agree to identify and explain the
  193.           nature of Shareware.
  194.  
  195.        .  To provide a forum through which ASP members may communicate,
  196.           share ideas, and learn from each other.
  197.  
  198.     ASP OMBUDSMAN STATEMENT
  199.  
  200.     CABER Software (R.  Scott McGinnis) is a member of the Association of
  201.     Shareware Professionals (ASP).    ASP wants to ensure that the Share-
  202.     ware principle works for you.  If you are unable to resolve a Share-
  203.     ware-related problem with an ASP member by contacting the member
  204.     directly, ASP may be able to help.  The ASP Ombudsman can help you
  205.     resolve a dispute or problem with an ASP member, but does not provide
  206.     technical support for members' products.
  207.  
  208.     Please write to the ASP Ombudsman at:
  209.  
  210.        ASP Ombudsman
  211.        Association of Shareware Professionals
  212.        545 Grover Road
  213.        Muskegon, MI  49442-9427
  214.  
  215.     or send a CompuServe message via CompuServe MAIL to ASP Ombudsman
  216.     70007,3536.
  217.  
  218.  
  219. Version 2.8: 910716
  220.  
  221. COM-AND: IBM PC Communications and Accessories
  222.  
  223.  
  224.                  Table of Contents
  225.                  -----------------
  226.  
  227. I.    Introduction  .............................................. page 1
  228.  
  229.     A. What is COM-AND ......................................... page 1
  230.     B. Version 2? .............................................. page 2
  231.     C. This document ........................................... page 2
  232.  
  233. II.    Running the program  ....................................... page 3
  234. III.    CRT Display  ............................................... page 6
  235. IV.    Accessory Programs ......................................... page 8
  236. V.    Menu mode .................................................. page 10
  237. VI.    Commands: available in CRT and accessory modes ............. page 12
  238. VII.    Commands: CRT mode only .................................... page 15
  239. VIII.    Commands: Accessory only ................................... page 18
  240. IX.    Dialing (Alt-D, Alt-R and Alt-H) ........................... page 19
  241.  
  242.     A. Dialing (Alt-D) ......................................... page 19
  243.     B. Dialing directory maintenance (Alt-D) ................... page 20
  244.     C. Redial (Alt-R) .......................................... page 21
  245.     D. Hangup (Alt-H) .......................................... page 21
  246.     E. A note on modem speed ................................... page 21
  247.  
  248. X.    Macros (Alt-M and Alt-0/9) ................................. page 22
  249.  
  250.     A. Revise entry (0-9) ...................................... page 22
  251.     B. Load a new file (Alt-M subcommand F) .................... page 23
  252.     C. Clear entries (Alt-M subcommand C) ...................... page 24
  253.     D. Execute entry (Alt-0 through Alt-9) ..................... page 24
  254.  
  255. XI.    Encryption/Decryption (Alt-N) .............................. page 25
  256. XII.    Program Configuration (Alt-S, Alt-P, Alt-O and Alt-J) ...... page 28
  257.  
  258.     A. Setup (Alt-S) ........................................... page 28
  259.     B. Communications Parameters (Alt-P) ....................... page 32
  260.     C. Options (Alt-O) ......................................... page 34
  261.     D. Colors (Alt-J) .......................................... page 41
  262.  
  263. XIII.    File Transfer (PgUp, PgDn, Alt-F, F4) ...................... page 42
  264.  
  265.     A. XMODEM Up/Download ...................................... page 44
  266.     B. YMODEM Up/Download ...................................... page 45
  267.     C. ZMODEM Up/Download ...................................... page 46
  268.     D. KERMIT Up/Download ...................................... page 47
  269.     E. CIS-B and Quick CIS-B Up/Download ....................... page 48
  270.  
  271.  
  272.  
  273.  
  274. Version 2.8: 910716
  275.  
  276. COM-AND: IBM PC Communications and Accessories
  277.  
  278.  
  279.                  Table of Contents
  280.                  -----------------
  281.  
  282. XIII.    File Transfer (continued)
  283.  
  284.     F. ASCII Upload ............................................ page 49
  285.     G. ASCII Download .......................................... page 51
  286.     H. File directory (Alt-F) .................................. page 52
  287.     I. Default download path (F4) .............................. page 52
  288.  
  289. XIV.    Logging and Call-logging (F7, F9, Alt-U) ................... page 53
  290.  
  291.     A. Disk logging [transcripting] (F7) ....................... page 56
  292.     B. Log hold [transcripting] (F9) ........................... page 56
  293.     C. Annotate call-log (Alt-U) ............................... page 56
  294.  
  295. XV.    Miscellaneous Functions .................................... page 57
  296.  
  297.     A. Default Drive:Subdirectory (F3) ......................... page 57
  298.     B. Keyboard display (F8) ................................... page 57
  299.     C. Chat mode (Alt-A) ....................................... page 57
  300.     D. Redisplay [backscreen] (Alt-B) .......................... page 57
  301.     E. Clear screen (Alt-C and received TOF) ................... page 58
  302.     F. Echo (Alt-E) ............................................ page 58
  303.     G. Blank line suppression (Alt-G) .......................... page 58
  304.     H. 43/25 line toggle (Alt-L) ............................... page 58
  305.     I. Kermit Parameters (Alt-K) ............................... page 58
  306.     J. Time and Alarms (Alt-T) ................................. page 59
  307.     K. Playback (Alt-W) ........................................ page 59
  308.     L. Program termination (Alt-X) ............................. page 59
  309.     M. Parity (hi-bit) mask (Alt-Z) ............................ page 60
  310.  
  311. XVI.    DOS Gateway (Alt-F10) ...................................... page 61
  312. XVII.    Emulation (Alt-V)  ......................................... page 62
  313.  
  314.     A. Display Emulation ....................................... page 62
  315.     B. Translation ............................................. page 63
  316.     C. Remapping ............................................... page 64
  317.     D. Other related settings .................................. page 65
  318.  
  319. XVIII.    Script Language ............................................ page 66
  320. XIX.    Program Requirements ....................................... page 67
  321. XX.    Program and Author Information    ............................ page 68
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329. Version 2.8: 910716
  330.  
  331. COM-AND: IBM PC Communications and Accessories
  332.  
  333.  
  334.                 Appendices
  335.                 ----------
  336.  
  337. A.    Switches and Parameters .................................... page 69
  338. B.    COM-AND Error display ...................................... page 72
  339. C.    Files ...................................................... page 73
  340. D.    Windowed XMODEM (WXMODEM) .................................. page 74
  341. E.    ANSI ,VT100, and VT52 sequences ............................ page 75
  342.  
  343.     1. ANSI sequences .......................................... page 75
  344.     2. VT100 sequences ......................................... page 77
  345.     3. VT52 sequences .......................................... page 79
  346.  
  347. F.    Vidtex and RLE files ....................................... page 80
  348.  
  349.     1. Vidtex .................................................. page 80
  350.     2. RLE Files ............................................... page 81
  351.  
  352. G.    External Protocol drivers .................................. page 82
  353. H.    Modem Configuration ........................................ page 84
  354.  
  355.     1. DTR (Data Terminal Ready) ............................... page 84
  356.     2. CD (Carrier Detect) ..................................... page 84
  357.  
  358. I.    Environment variables ...................................... page 85
  359.  
  360.     1. COM-AND= ................................................ page 85
  361.     2. COMSPEC= ................................................ page 85
  362.     3. Other variables ......................................... page 85
  363.  
  364. J.    Background operation ....................................... page 87
  365. K.    Encoded music .............................................. page 88
  366. L.    BIOS Comm Read/Write ....................................... page 89
  367. M.    MODEM Initialization ....................................... page 90
  368. N.    COM-AND's Backscreen ....................................... page 93
  369. O.    Customizing COM-AND ........................................ page 94
  370. P.    BIOS (INT 14h) communications .............................. page 97
  371. Q.    16550A(N) UARTs ............................................ page 99
  372. R.    High-Speed communications .................................. page 100
  373. S.    Doorways ................................................... page 101
  374. T.    Command Index .............................................. page 104
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384. Version 2.8: 910716
  385.  
  386. COM-AND: IBM PC Communications and Accessories                 Page   1
  387.  
  388.  
  389. I.    Introduction
  390.  
  391.  
  392.     A. What is COM-AND?
  393.  
  394.  
  395.        COM-AND for the IBM PC and compatibles is a communications
  396.        program that may be used by itself, or with several integrated
  397.        accessory programs (which themselves may be used independent of
  398.        COM-AND).  COM-AND provides standard comm program functions:  a
  399.        dialing directory, macros, disk logging, binary and ASCII file
  400.        transfers, scripted execution and so on.
  401.  
  402.  
  403.        Four accessories are available for use with Version 2.8 of COM-
  404.        AND.  These accessories are for use over conferencing services
  405.        such as People/Link's PARTY, GEnie's RTC and CIS's CB:
  406.  
  407.         PC-VCO provides a way to 'see' and 'hear' people talking.
  408.         CCHESS supports chess games with another conference user.
  409.         CBRIDG supports bridge games with other conference users.
  410.         CCOLOR tracks conference users, coloring each speaker's
  411.                received text differently
  412.  
  413.  
  414.        These accessories are available uploaded separately, not as a
  415.        part of COM-AND's release.  Please refer to the accessory
  416.        documents for more detailed discussions of their function.
  417.  
  418.  
  419.        COM-AND Version 2.8 executes as a CRT based comm program either
  420.        in 25 line text mode on a CGA or monochrome screen, or 25/43 line
  421.        mode on an EGA display.  When an accessory is loaded through
  422.        COM-AND (or when COM-AND is loaded by an accessory), most of the
  423.        functions of COM-AND are available through the accessory.
  424.  
  425.  
  426.        COM-AND and its accessories (PC-VCO, CCHESS, CBRIDG, and CCOLOR)
  427.        may be copied freely and distributed to anyone for any number of
  428.        machines, for purposes of evaluation.  The author offers COM-AND
  429.        as "shareware".  If the program is USED, a registration of $50.00
  430.        is asked for the entire package.
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439. Version 2.8: 910716
  440.  
  441. COM-AND: IBM PC Communications and Accessories                 Page   2
  442.  
  443.  
  444. I.    Introduction (continued)
  445.  
  446.  
  447.     B. Version 2?
  448.  
  449.  
  450.        Version 1 of this software was released more than four years ago
  451.        as PC-VCO.  In other words, the accessory and communications pro-
  452.        gram were one program.
  453.  
  454.  
  455.        Creation of version 2.0 of PC-VCO necessitated splitting the
  456.        original software into two executable programs.  From that point
  457.        in time, accessories have been released as individual programs,
  458.        using this or future versions of COM-AND as base.
  459.  
  460.  
  461.        Version 2.8 is the ninth release.
  462.  
  463.  
  464.     C. This document
  465.  
  466.  
  467.        This document describes the features of COM-AND, both standard
  468.        communications features and as much of the accessory program
  469.        features as may be appropriate.  For the most part, however, the
  470.        discussion of accessory functions will be limited.
  471.  
  472.  
  473.        Accessories are released separately.  For detailed discussions of
  474.        accessories, please refer to each accessory's documentation.
  475.  
  476.  
  477.        For details of the script language, please refer to the file
  478.        CASCRIPT.DOC included with this release.  THIS document addresses
  479.        manual use of COM-AND.  Automated use is discussed in CASCRIPT.
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494. Version 2.8: 910716
  495.  
  496. COM-AND: IBM PC Communications and Accessories                 Page   3
  497.  
  498.  
  499. II.    Running the program
  500.  
  501.  
  502.     Generally, COM-AND is invoked at the DOS prompt with the command:
  503.  
  504.     -----------------------------------------------------------------
  505.     "d>" COM-AND <options>
  506.  
  507.     Where "d>" is the DOS prompt, and
  508.           <options> is/are (<parm> (<parm> ...))
  509.           and <parm> is either a switch or a parameter
  510.  
  511.     Refer to Appendix A for a description of switches and parameters.
  512.     -----------------------------------------------------------------
  513.  
  514.     COM-AND could be invoked with a command such as:
  515.  
  516.            "d>" COM-AND
  517.  
  518.     to simply start COM-AND, or, for example, the command:
  519.  
  520.            "d>" COM-AND DIAL 1
  521.  
  522.     to dial dialing directory entry #1 as soon as COM-AND is loaded.
  523.  
  524.     The command:
  525.  
  526.            "d>" COM-AND /FSCRIPT
  527.  
  528.     would be used to perform the commands contained in the file SCRIPT
  529.     (or SCRIPT.CMD or SCRIPT.ENF, whichever is first in the directory).
  530.  
  531.  
  532.     COM-AND requires no other file for its execution.  It will create
  533.     a parametrization file, dialing directory, and macro definition if
  534.     none are present.  If files (.DFT, .DIR, and .MAC) from previous
  535.     versions of PC-VCO (1.31 and before) are renamed COM-AND.* they
  536.     will be converted to the new format.
  537.  
  538.  
  539.     Note that once loaded, COM-AND does not require its executable disk
  540.     file again.  No program disk need be retained in the default drive if
  541.     loaded from floppy diskette (though it will be needed again to change
  542.     the dialing directory, or macro, or accessory definitions).
  543.  
  544.  
  545.     Files used by COM-AND are discussed in Appendix C.  Default pathing
  546.     of file names is discussed in Appendix I.
  547.  
  548.  
  549. Version 2.8: 910716
  550.  
  551. COM-AND: IBM PC Communications and Accessories                 Page   4
  552.  
  553.  
  554. II.    Running the program (continued)
  555.  
  556.  
  557.     The first time COM-AND is loaded, it will establish default settings
  558.     (as described in Appendix A).  The comm port used as a default (COM1)
  559.     may on some machines be unusable as a serial port.  If this happens,
  560.     boot the machine and reload COM-AND thusly:
  561.  
  562.            "d>" COM-AND /I
  563.  
  564.     The /I switch directs COM-AND to NOT issue a modem initialization
  565.     string.  When COM-AND is loaded in this manner, the serial port is
  566.     unused until a character is to be transmitted.    Alt-P may then be
  567.     used to change the default port (remember to save the setting).
  568.  
  569.  
  570.     The very first time COM-AND is loaded:
  571.  
  572.     1) Use DOS to make the current subdirectory the subdirectory where
  573.        you will install COM-AND...    where previous versions have been
  574.        installed.
  575.  
  576.     2) DeARC the distribution files onto the selected subdirectory.
  577.        Have a care not to overwrite files you want to keep!
  578.  
  579.     3) Load COM-AND (as above)
  580.  
  581.        If COM-AND is loaded on a subdirectory where no COM-AND.DFT
  582.        resides AND if the environment variable COM-AND= does not point to
  583.        a subdirectory where COM-AND.DFT may be found, COM-AND will create
  584.        a new .DFT file.
  585.  
  586.        A script named INSTALL.CMD is included with this release.  If
  587.        COM-AND creates its .DFT file (as opposed to updating an existing
  588.        one), and if the script INSTALL.CMD is available, INSTALL will be
  589.        invoked automatically upon completion of initialization.
  590.  
  591.        INSTALL takes over some of the decision process, and some of the
  592.        work required to configure COM-AND for use.    It is in no way
  593.        necessary to the execution of COM-AND, however.
  594.  
  595.        INSTALL performs the following functions (all steps in INSTALL are
  596.        optional):
  597.  
  598.        o  Adding a COM-AND= environment variable to the AUTOEXEC.BAT
  599.        o  Setting (and searching for possible) serial ports
  600.        o  Setting the default speed for the serial port selected
  601.        o  Setting modem command strings according to modem model
  602.  
  603.  
  604. Version 2.8: 910716
  605.  
  606. COM-AND: IBM PC Communications and Accessories                 Page   5
  607.  
  608.  
  609. II.    Running the program (continued)
  610.  
  611.  
  612.     5) Review settings in COM-AND
  613.  
  614.        o  Check Alt-P
  615.  
  616.           .. Check the COM port you use (1/2/3/4).
  617.           .. Check the default speed selection.  It is not important if
  618.          you always use the dialing directory.    Set it anyway.
  619.           .. Remember to save new settings.
  620.  
  621.        o  Check Alt-S
  622.  
  623.           .. Check that modem parms are set for your particular modem,
  624.           .. The backscreen buffer size defaults to 4K.  You can set it
  625.          up to 64K, for redisplay and transcripting.
  626.           .. Remember to save the new settings.
  627.  
  628.        o  Check Alt-O
  629.  
  630.           .. Set flags the way you want them (e.g. exit query on, d*mned
  631.          advert off, and so on;  Note BIOS/DIRECT and PCJr settings)
  632.           .. Remember to save new settings.
  633.  
  634.     6) Review the accessories (F1).
  635.  
  636.        You may review the contents of accessory definitions with the 'r'
  637.        subcommand.    You may wish to add entries for a listing program and
  638.        editor..  perhaps PC-VCO...    perhaps CCOLOR...
  639.  
  640.     7) Exit COM-AND with Alt-X.
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659. Version 2.8: 910716
  660.  
  661. COM-AND: IBM PC Communications and Accessories                 Page   6
  662.  
  663.  
  664. III.    CRT Display
  665.  
  666.  
  667.     When COM-AND is loaded, a pop-up informs that initialization is
  668.     occurring.  Initialization of the modem is performed automatically
  669.     by COM-AND.  The modem initialization string specified through the
  670.     Setup function (Alt-S) is issued to the modem when COM-AND is
  671.     loaded, after the modem port is set to the default rate, parity,
  672.     data and stop values specified (at run time or through Alt-P).
  673.  
  674.  
  675.     Other initialization includes:    looking for a mouse, and loading
  676.     files (dialing directory, macro, and accessory definitions).
  677.  
  678.  
  679.     Once initialization is complete, the PC serves as a 24 (CGA and mono-
  680.     chrome) or 24/42 line (EGA/VGA) CRT.  The first 24(42) lines are a
  681.     scrolling region for received text.  The 25th(43rd) line is used for
  682.     program identification, status and keyboard display.  Carriage
  683.     return/line feed combinations received cause the text area to scroll.
  684.  
  685.  
  686.     Text typed in at the keyboard is transmitted out the COM port.    What
  687.     is received through the COM port is displayed on the screen.  Special
  688.     escape sequences are performed by COM-AND (optional).  Control char-
  689.     acters (except null) are displayed according to the IBM character set
  690.     (optional).  Received characters may be masked to 7 bits (optional).
  691.  
  692.  
  693.     In order to connect to a host, the first step would usually be to
  694.     dial the phone number of the Network node you wish to access.  For
  695.     example, with a Smartmodem, typing the following directs the modem
  696.     to dial the phone:
  697.  
  698.          AT E1 DT 245-9110 <return>
  699.  
  700.  
  701.     This sequence instructs the Smartmodem to echo entry (E1) and dial
  702.     using tone dialing (DT) PLINK Chicago (245-9110) as a local call.
  703.     Modem initialization could be done between the E1 and DT as needed.
  704.  
  705.  
  706.     This sequence is automated in COM-AND through a dialing directory
  707.     (Alt-D).  Phone numbers and parameters are maintained in the
  708.     directory.  Services are called through the same Alt-D command.
  709.  
  710.  
  711.  
  712.  
  713.  
  714. Version 2.8: 910716
  715.  
  716. COM-AND: IBM PC Communications and Accessories                 Page   7
  717.  
  718.  
  719. III.    CRT Display (continued)
  720.  
  721.  
  722.     Many people prefer to make connection to a host with a script, how-
  723.     ever.  Scripts for dialing and connecting to several popular services
  724.     are included with this release of COM-AND.  A script is a 'program'
  725.     written for another program, in this case for COM-AND.
  726.  
  727.  
  728.     Whether the connection is made manually or through a script, every-
  729.     thing that happens appears in the text area of the CRT display.
  730.  
  731.  
  732.     The keyboard on the IBM PC provides ordinary typewriter-like keys and
  733.     other keys (e.g.  F1, F2...).  The 'other' keys are used by COM-AND
  734.     for control purposes, as the mention of Alt-D above shows.  The Alt-
  735.     key, when held down while another key is pressed, is treated as a
  736.     special keystroke.  Press Alt-D and a window pops-up displaying the
  737.     current dialing directory.  Press F2 and a window pops-up displaying
  738.     the scripts available on the current subdirectory for execution.
  739.  
  740.  
  741.     The remaining chapters of this document describe the functions of
  742.     COM-AND as they may be manually invoked.  A separate document
  743.     (SCRIPT.DOC) summarizes the scripts released with this version of
  744.     COM-AND.  [An individual script may or may not have its own document
  745.     covering its use.] A separate document (CASCRIPT.DOC) describes the
  746.     script language and concepts.
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769. Version 2.8: 910716
  770.  
  771. COM-AND: IBM PC Communications and Accessories                 Page   8
  772.  
  773.  
  774. IV.    Accessory Programs
  775.  
  776.  
  777.     Released with the 2.8 version of COM-AND are four programs that are
  778.     labelled 'accessories':  PC-VCO, CCHESS, CBRIDG and CCOLOR.  PC-VCO,
  779.     CCHESS, CBRIDG, and CCOLOR are programs in their own right, and may
  780.     be used with or without the COM-AND program (according to your pre-
  781.     ference in comm program).
  782.  
  783.  
  784.     Accessory programs are usually loaded with COM-AND for a special
  785.     purpose (such as PC-VCO: Visual Conferencing), after connection has
  786.     been established through COM-AND.  When COM-AND is loaded as above
  787.     (i.e.  "d> COM-AND"), accessories would be loaded 'on top' of
  788.     COM-AND through the F1 Menu.
  789.  
  790.  
  791.     However:  the accessory program may be loaded first.  When PC-VCO is
  792.     run from the DOS prompt without the '/P' switch, it looks for the
  793.     COM-AND program on the current subdirectory (or in the subdirectory
  794.     indicated by a 'COM-AND=' environment variable).  PC-VCO will not run
  795.     without the '/P' switch unless it can find COM-AND.  PC-VCO loads
  796.     COM-AND, and the F1 menu in COM-AND is made unavailable for use.
  797.  
  798.  
  799.     The integration of accessory programs into COM-AND means that:
  800.  
  801.     (1) the accessory loads COM-AND if COM-AND isn't loaded already
  802.         (unless the accessory was loaded "/P"),
  803.  
  804.     (2) COM-AND functions such as macros and dialing directory are
  805.         available in the accessory when COM-AND is loaded, and
  806.  
  807.     (3) settings made in COM-AND carry over to the accessory when it
  808.         is loaded, and settings made in the accessory carry over to
  809.         COM-AND when the accessory terminates.
  810.  
  811.  
  812.     When an accessory program loads COM-AND, COM-AND is limited to the
  813.     use of just that one accessory (and no other, although it will gate-
  814.     way to DOS).  When COM-AND is loaded first, a menu of accessories,
  815.     arranged somewhat like the dialing directory, is presented.  One
  816.     accessory after another may be selected, each new accessory selec-
  817.     tion terminating the previous one.
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824. Version 2.8: 910716
  825.  
  826. COM-AND: IBM PC Communications and Accessories                 Page   9
  827.  
  828.  
  829. IV.    Accessory Programs (continued)
  830.  
  831.  
  832.     An accessory is loaded by pressing F1, and selecting the entry you
  833.     wish to execute.  [The F1 menu is available only on the CRT side,
  834.     only when COM-AND is loaded first.]
  835.  
  836.  
  837.     The F1 menu defines an accessory as:
  838.  
  839.     o    A title which is displayed in the menu
  840.     o    A subdirectory for use during the accessory (optional)
  841.     o    A script file to be performed (optional)
  842.     o    A program to be loaded, along with parameters (optional)
  843.  
  844.  
  845.     An accessory to COM-AND, therefore, might be any COM-AND script, or
  846.     most any program, or both.  You are not limited to the ones coded for
  847.     COM-AND.  If you have a favorite editor that you'd like to use to
  848.     keep notes on-line, define it as an accessory...  If you like to look
  849.     at READMAC (or GIF) graphics during conferences, define an accessory
  850.     for each of several favorite pictures...
  851.  
  852.  
  853.     To create a new entry, use the revise subcommand ("R").  You are
  854.     prompted for each of the above values.    The subdirectory specified
  855.     will be used as the default for all program and file accesses when
  856.     you invoke the accessory.  The program name must be given in full
  857.     (e.g.  XXX.COM or YYY.EXE).  Batch files are not executable as
  858.     accessories (at this time); however, you may use "COMMAND.COM /C
  859.     FILE.BAT" to effect the execution of a batch file.
  860.  
  861.  
  862.     Accessories integrated into COM-AND (such as PC-VCO) permit switching
  863.     between CRT and accessory modes.  A loaded accessory is terminated
  864.     with the "T" subcommand of F1, or by simply loading a new accessory.
  865.  
  866.  
  867.     COM-AND supports multiple accessory directory files.  A new accessory
  868.     directory is manually selected with the 'F' subcommand of the F1
  869.     window.  Note that the new file name is also reflected in the Alt-S
  870.     window (but isn't saved for the next time).
  871.  
  872.  
  873.     External protocol drivers may easily be implemented as accessories.
  874.     Refer to the Appendix G for a discussion of one such driver's
  875.     implementation as an accessory (DSZ for file transfers).
  876.  
  877.  
  878.  
  879. Version 2.8: 910716
  880.  
  881. COM-AND: IBM PC Communications and Accessories                 Page  10
  882.  
  883.  
  884. V.    Menu mode
  885.  
  886.  
  887.     An easy way to get to know a new program is through a summary of
  888.     functions it provides.    In COM-AND, the F10 key provides a command
  889.     summary.  Like most communications programs, COM-AND ties its func-
  890.     tions to special keys (Alt-D for dialing, Alt-F for file directory,
  891.     and so on).  This is done for purposes of speed...  host services
  892.     charge by the minute... every keystroke counts!
  893.  
  894.  
  895.     However, beginning with version 2.5, almost every function of COM-AND
  896.     is also available through a 'menu mode'.  When COM-AND is run with
  897.     the /V switch (or if menu mode is set permanently through Alt-O,
  898.     Options), the top line of the screen will be given to a 'menu bar'.
  899.     Each item on the top bar may be selected in turn, and a menu pulled
  900.     down to list functions.  The equivalent keystroke is displayed for
  901.     every item in the pull-downs.
  902.  
  903.  
  904.     In menu mode, items from the top bar may be selected with the mouse,
  905.     or the cursor keys.  Pull-down windows are opened in the same way.
  906.     Keystrokes active on the top bar (when no pull-down is open) are:
  907.  
  908.     Mouse        Keystroke    Menu mode ON    Menu mode OFF
  909.     --------------- --------------- --------------- ----------------
  910.     Left motion    Cursor left    Top bar select    Backspace sent
  911.     Right motion    Cursor right    Top bar select    Space transmitted
  912.     Downward motion Cursor down    Open pull-down    It beeps
  913.     Upward motion    Cursor up    Open pull-down    It beeps
  914.  
  915.  
  916.     Once an item from the top bar is 'opened' or 'pulled-down', the usage
  917.     changes slightly.  Within a pull-down, keystrokes are:
  918.  
  919.     Mouse            Keystroke        Menu mode ON
  920.     ------------------- --------------- ---------------------------
  921.     Left motion        Cursor left     Open pull-down to left
  922.     Right motion        Cursor right    Open pull-down to right
  923.     Downward motion     Cursor down     Select next successive item
  924.     Upward motion        Cursor up        Select previous item
  925.  
  926.     Left button click   PgDn        Select next successive item
  927.     Right button click  PgUp        Select previous item
  928.     Left double click   Carriage rtn    Execute selected item
  929.     Right double click  ESCAPE        Cancel window
  930.  
  931.  
  932.  
  933.  
  934. Version 2.8: 910716
  935.  
  936. COM-AND: IBM PC Communications and Accessories                 Page  11
  937.  
  938.  
  939. V.    Menu mode (continued)
  940.  
  941.  
  942.     Within function 'windows' (such as Alt-D dialing), the above key-
  943.     strokes and mouse actions have the same general meaning. [Only in
  944.     menu mode pull-downs do left/right motions/cursor keys open new
  945.     windows, however.]
  946.  
  947.  
  948.     At this point, a note on mouse usage seems appropriate... COM-AND
  949.     will use a Microsoft Mouse (or equivalent) if it finds one, if the
  950.     /M run-time switch is not set.    Even for the miceless, left, right,
  951.     up, and down motions should be self-explanatory.  However, mention
  952.     of 'buttons' and 'double clicks' requires some discussion.
  953.  
  954.  
  955.     The Microsoft Mouse has two buttons that may be pressed.  COM-AND
  956.     implements the left button as PgUp and the right button as PgDn, as
  957.     shown in the table above.  However, when a button is pressed, it is
  958.     not 'executed' immediately.  COM-AND will wait for a short moment to
  959.     determine if the button is being pressed once, or twice in rapid
  960.     succession.  A left 'double click' is taken as a carriage return, and
  961.     a 'right double click' is taken as ESCAPE.  The interval after which
  962.     COM-AND takes a button press as a single press may be changed through
  963.     Alt-S, Setup.
  964.  
  965.  
  966.     All of this is to say that in any COM-AND window where there are
  967.     multiple items, one of which is to be selected, the cursor keys,
  968.     mouse up/down motions, and mouse buttons may be used to select an
  969.     item.  [Every window where this is the case 'highlights' the current
  970.     selection.]   A double click on the mouse left button will execute
  971.     the selection (just as a carriage return), and a double click on the
  972.     mouse right button will cancel the function (just as ESCAPE).
  973.  
  974.  
  975.     The menu mode of COM-AND allows all 'customary' functions, such as
  976.     dialing, hanging up, toggling disc capture, exiting the program, and
  977.     so on, to be performed entirely with a mouse (or the cursor keys
  978.     even).    Of course, someone somewhere must have done the typing to
  979.     update the dialing directory, to define the macros...
  980.  
  981.  
  982.     But as stated at the outset, its an easy way to get to know the
  983.     program.
  984.  
  985.  
  986.  
  987.  
  988.  
  989. Version 2.8: 910716
  990.  
  991. COM-AND: IBM PC Communications and Accessories                 Page  12
  992.  
  993.  
  994. VI.    Commands:  available in both COM-AND and Accessory
  995.  
  996.  
  997.     COM-AND provides the following command keys both on the CRT side, and
  998.     during an accessory:
  999.  
  1000.     F1    Switch between text (CRT) and accessory modes:    As described
  1001.         above, the F1 key behaves differently, according to the way
  1002.         COM-AND was loaded.  When COM-AND is directly loaded, F1
  1003.         provides a menu of accessories and functions.  When an
  1004.         accessory loads COM-AND by default, the F1 key is restricted
  1005.         to switching back and forth between CRT and accessory modes.
  1006.  
  1007.     F10    Help screen:  All currently implemented commands are summar-
  1008.         ized on this screen.  Any command may be executed directly
  1009.         while this screen is displayed.  The help screen displayed is
  1010.         either by COM-AND or from the accessory, according to the
  1011.         current mode.
  1012.  
  1013.     Alt-F10 DOS Gateway:  If sufficient memory is available, COM-AND
  1014.         executes a shell program.  This is normally a second copy
  1015.         COMMAND.COM for full access to DOS while a communication
  1016.         session is in progress.
  1017.  
  1018.     Ctl-End Break:    This sends a true 'break' signal.
  1019.  
  1020.     Ctl-Prt Printer:  Toggle (i.e. turn on/off) printing to LP1.
  1021.  
  1022.     Alt-C    Clear: Clear the text area of the screen.
  1023.  
  1024.     Alt-D    Dialing directory:  Enter, change, execute, and print
  1025.         dialing directory entries through the Alt-D menu.
  1026.  
  1027.     Alt-E    Echo: Toggle full/half duplex.    [This function may also be
  1028.         controlled through the dialing directory (echo on).] In full
  1029.         duplex (echoplex), the host must echo back what is typed for
  1030.         it to be seen.    In half duplex, COM-AND echoes what is typed
  1031.         immediately.
  1032.  
  1033.     Alt-F    File directory:  A display similar to the DOS DIR command
  1034.         command is displayed in a window.
  1035.  
  1036.     Alt-G    Blank line suppression:  Toggle.  COM-AND will suppress blank
  1037.         lines (double spacing) if you wish.  This may be made a pro-
  1038.         gram default through the Alt-O options menu.
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044. Version 2.8: 910716
  1045.  
  1046. COM-AND: IBM PC Communications and Accessories                 Page  13
  1047.  
  1048.  
  1049. VI.    Commands: available in both COM-AND and Accessory (continued)
  1050.  
  1051.  
  1052.     Alt-H    Hangup:  Hangup the phone.
  1053.  
  1054.     Alt-I    Program information:  Author information.  Propaganda.
  1055.  
  1056.     Alt-M    Macros: Define a macro for Alt-0 through Alt-9.
  1057.  
  1058.     Alt-N    Encrypt/decrypt a file:  This function implements the
  1059.         Federal Data Encryption Standard; secure but slow (I'll
  1060.         work on that!).  Encrypted files may be used as scripts.
  1061.         Files cannot be encrypted/decrypted in place!!!
  1062.  
  1063.         Note: Should the encrypted file be modified in any way, or
  1064.         the password be lost, there is little chance of recovery.
  1065.         Neither CABER Software nor the author will be liable for any
  1066.         damages or lost revenues incurred through the use of this
  1067.         function beyond the registration price paid for COM-AND.
  1068.  
  1069.     Alt-O    Options:  Set controlling flags for COM-AND.  Note that
  1070.         although this menu may be used from either COM-AND or
  1071.         accessory, it really only effects COM-AND settings.
  1072.  
  1073.     Alt-P    Comm Parameters:  Set baud rate, parity, number of data
  1074.         and stop bits for use when COM-AND is initially loaded.
  1075.         These settings are overridden by run-time switches.  What-
  1076.         ever the current setting, the dialing directory overrides.
  1077.  
  1078.         Note: Although this menu may be used from either COM-AND or
  1079.         accessory, it really only effects COM-AND settings.  Each
  1080.         accessory has an Alt-P function as well accessible only when
  1081.         the accessory is loaded with the '/P' switch.
  1082.  
  1083.     Alt-R    Redial the last number dialed:    The program will redial the
  1084.         last number dialed until the function is terminated (with
  1085.         ESC), or connection is made.
  1086.  
  1087.     Alt-S    Setup:    Define initial program values, such as Modem initial-
  1088.         ization, the Modem Hangup sequence, and file names.
  1089.  
  1090.         Note: Although this menu may be used from either COM-AND or
  1091.         accessory, it really only effects COM-AND settings.  Each
  1092.         accessory has an Alt-S function as well which may or may not
  1093.         be accessible when COM-AND is loaded.
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099. Version 2.8: 910716
  1100.  
  1101. COM-AND: IBM PC Communications and Accessories                 Page  14
  1102.  
  1103.  
  1104. VI.    Commands: available in both COM-AND and Accessory (continued)
  1105.  
  1106.     Alt-T    Elapsed time:  The time the program was loaded, and the time
  1107.         the last call (Alt-D or Alt-R) was placed are displayed.
  1108.         The 'last call time' may be reset.  A real-time alarm may be
  1109.         set (for one time use, or permanently).
  1110.  
  1111.     Alt-U    Annotate call-log:  COM-AND will (if you wish) keep a log of
  1112.         calls, hangups, disconnects and so on.    You may enter free-
  1113.         form notes into the log through this window.
  1114.  
  1115.     Alt-X    Exit the program:  If the modem you use reports 'carrier'
  1116.         and you exit without hanging-up, you will be asked if a
  1117.         hangup is desired.
  1118.  
  1119.         NOTE:  a script may override the Alt-X function.  When this
  1120.         happens, after Alt-X is pressed (and after the hangup query
  1121.         if it is needed) a script may start!
  1122.  
  1123.     Alt-Z    Parity mask:  Toggle.  The high bit mask is used only for
  1124.         text received and displayed.  It has no effect on file
  1125.         transfers (XMODEM, YMODEM, ZMODEM, KERMIT, and CIS-B).
  1126.  
  1127.     Alt-0/9 Send a Macro:  A string of characters defined through the
  1128.         Alt-M command described above is transmitted.
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154. Version 2.8: 910716
  1155.  
  1156. COM-AND: IBM PC Communications and Accessories                 Page  15
  1157.  
  1158.  
  1159. VII.    Commands: CRT mode only
  1160.  
  1161.  
  1162.     COM-AND provides the following command keys only in CRT mode:
  1163.  
  1164.  
  1165.     F2    Execute a script:  A window is opened to request the name of
  1166.         the script file.  The extension ".CMD" is attempted if the
  1167.         given name does not have an extension, and the given name is
  1168.         not found.  Similarly, the extension ".ENF" will be tried.
  1169.  
  1170.     F3    Set current drive:path:  You may change the default disk
  1171.         drive and path from within COM-AND using this feature.
  1172.         The current drive:path affect uploaded files and file name
  1173.         searches (Alt-F), when no qualification is provided.
  1174.  
  1175.         NOTE: The F3 setting is retained even after COM-AND is
  1176.         terminated.
  1177.  
  1178.     F4    Set default drive:path for downloads:  All download file
  1179.         transfers (XMODEM, YMODEM, ZMODEM, KERMIT, CIS-B, ASCII,
  1180.         logging, and RLE) will use this setting if the target file
  1181.         name supplied (one way or another) does not specify the drive
  1182.         and/or path.
  1183.  
  1184.         NOTE: The F4 setting is retained for the next time COM-AND
  1185.         is used.  Each change to F4 is saved!
  1186.  
  1187.     F5    ASCII upload:  Files may be transferred to a system using a
  1188.         simple 'send' (as if they were entered by hand).  Transfer
  1189.         may occur with or without a host prompt (some special char-
  1190.         acter issued for every line).  Transfer may be timed (paced)
  1191.         in either case.  Line feeds may or may not be suppressed.
  1192.         Tabs may or may not be expanded as blanks, as you wish.
  1193.  
  1194.         This function is also available through PgUp.
  1195.  
  1196.     F6    ASCII download:  This differs from transcripting in that no
  1197.         extra characters are added to the file (such as line feeds
  1198.         after received carriage returns, or an end-of-file byte).
  1199.         Transcripting is intended to result in an ASCII edit file, or
  1200.         a printed log.    ASCII download may be used to save sessions
  1201.         (or parts of sessions) exactly as received.
  1202.  
  1203.         This function is also available through PgDn.
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209. Version 2.8: 910716
  1210.  
  1211. COM-AND: IBM PC Communications and Accessories                 Page  16
  1212.  
  1213.  
  1214. VII.    Commands: CRT mode only (continued)
  1215.  
  1216.  
  1217.     F7    Logging or transcripting:  Log received text to a disk file
  1218.         or device.  You specify the file to be used.  If not empty,
  1219.         new logging will be appended to the end of existing data.
  1220.  
  1221.         You will next be asked if the backscreen (the last text
  1222.         received) is to be saved.  Logging need not be started before
  1223.         an event that you wish to record.
  1224.  
  1225.         What is logged is not exactly what is displayed on the
  1226.         screen.  If hi-bit masking is turned on, characters will be
  1227.         logged with their high bit turned off.    An ASCII end-of-file
  1228.         is added when the file is closed.
  1229.  
  1230.         Opening and closing the log marks the log with date and
  1231.         time.  Transcript marking may be turned off with the
  1232.         Alt-O function.  Log hold (below) does not mark the log.
  1233.  
  1234.     F8    Toggle display of typed characters (for use with half duplex
  1235.         connections, otherwise known as 'no echo').  The keyboard
  1236.         display takes over the 25th (CGA) or 43rd (EGA) line.
  1237.  
  1238.     F9    Hold the log: no entry will be made to the log from this
  1239.         point until hold is turned off (by pressing F9 again) or the
  1240.         log is closed.    The fact that the log is held is displayed
  1241.         on the status line.
  1242.  
  1243.     PgUp    Upload: A menu of all available protocols for file transfer
  1244.         is displayed.  One must be selected, and the upload then
  1245.         proceeds as below (under "File Transfer").
  1246.  
  1247.     PgDn    Download: A menu of all available protocols for file
  1248.         transfer is displayed.    One must be selected, and the
  1249.         download then proceeds as below (under "File Transfer").
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264. Version 2.8: 910716
  1265.  
  1266. COM-AND: IBM PC Communications and Accessories                 Page  17
  1267.  
  1268.  
  1269. VII.    Commands: CRT mode only (continued)
  1270.  
  1271.  
  1272.     Alt-A    Toggle split screen 'chat mode' on and off:  The screen is
  1273.         split in chat mode, one window for received text, and one
  1274.         for typed.  The size of the chat window is set through Alt-S
  1275.         setup.    Some accessories also support Alt-A.
  1276.  
  1277.     Alt-B    Redisplay (backscreen):  You may review the backscreen
  1278.         buffer page by page.  Some accessories also support Alt-B.
  1279.  
  1280.     Alt-J    Set screen colors:  You may set foreground and background
  1281.         color values for the CRT screen, the status line, and menu
  1282.         windows.  Some accessories have their own Alt-J.
  1283.  
  1284.     Alt-K    Set KERMIT parameters:    The values as supplied are suitable
  1285.         for most systems.  It is not recommended that you change
  1286.         these settings unless you fully understand their meaning.
  1287.  
  1288.     Alt-L    Toggle EGA/CGA (43/25 line) modes:  Some accessories have
  1289.         their own Alt-L.
  1290.  
  1291.     Alt-V    Emulation:  You may select terminal emulation, and enable/
  1292.         disable translation and/or remapping through Alt-V.  Note
  1293.         that both translate and remap require prepared data.
  1294.  
  1295.     Alt-W    Playback:  Display text from a file in the CRT screen area.
  1296.         This may be used to set screen colors using ANSI controls
  1297.         (overriding the screen colors set through Alt-J).
  1298.  
  1299.     Alt =    Menu mode:  Alt-Equal toggles the menu mode interactively
  1300.         (see chapter V, 'Menu Mode').
  1301.  
  1302.     Alt -    Alt-Minus toggles remote function key use (see Appendix S,
  1303.         'Doorways').
  1304.  
  1305.  
  1306.     ---------------------------------------------------------------
  1307.     Note also functions defined above under "Commands: both modes".
  1308.     ---------------------------------------------------------------
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319. Version 2.8: 910716
  1320.  
  1321. COM-AND: IBM PC Communications and Accessories                 Page  18
  1322.  
  1323.  
  1324. VIII.    Commands: Accessory only
  1325.  
  1326.  
  1327.     A discussion of accessory commands must properly be referred to the
  1328.     accessory document.  However, a few comments are in order here.
  1329.  
  1330.  
  1331.     Each accessory must have an Alt-P function similar to COM-AND's
  1332.     Alt-P Comm Parms Menu, to allow setting of default parameters.    The
  1333.     defaults have effect when the accessory is NOT run 'piggyback' ('/P'
  1334.     switch) through the DOS gateway of another communications program.
  1335.  
  1336.  
  1337.     Each accessory must have some kind of Alt-S setup command which
  1338.     defines accessory-specific flags and values.  In all accessories
  1339.     currently released, the accessory setup function is available through
  1340.     the 'Controls' pull-down.  When the accessory is loaded '/P', the
  1341.     Alt-S key is enabled to access the accessory setup as well.  [When
  1342.     loaded with COM-AND, Alt-S calls up COM-AND's Setup window.]
  1343.  
  1344.  
  1345.     Each accessory integrated into COM-AND defines Alt-X as program
  1346.     termination:  not accessory termination, but process termination!
  1347.     Use Alt-X from an accessory to terminate the accessory AND the
  1348.     COM-AND program.  Alt-X from COM-AND terminates COM-AND and any
  1349.     loaded accessory.  The F1 key is used to switch between COM-AND and
  1350.     an accessory, and may be used to terminate the accessory without
  1351.     terminating COM-AND.
  1352.  
  1353.  
  1354.     As of version 2.6 of COM-AND, certain accessories will allow COM-AND
  1355.     scripts to be performed while the accessory is active.    This includes
  1356.     scripts executed automatically through Alt-D dialing.
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374. Version 2.8: 910716
  1375.  
  1376. COM-AND: IBM PC Communications and Accessories                 Page  19
  1377.  
  1378.  
  1379. IX.    Dialing (Alt-D, Alt-R, and Alt-H)
  1380.  
  1381.  
  1382.     A. Dialing (Alt-D)
  1383.  
  1384.        . Dial from directory
  1385.  
  1386.          The dialing directory is invoked with the Alt-D command, in
  1387.          either CRT or accessory mode.  After the directory window is
  1388.          opened, an entry may be dialed by selecting the appropriate
  1389.          number.  The directory entry does not have to be on screen.
  1390.  
  1391.          The entry number you give may be prefixed and/or suffixed with
  1392.          a long distance entry code (+,-,#,@).  A prefix is transmitted
  1393.          before the number dialed, and the suffix is transmitted after
  1394.          the dialed number.  Both prefix and suffix may be used, or one
  1395.          alone, or none.  Timing commands (e.g.  Smartmodem use of ","
  1396.          to pause for a fixed time) may be included.
  1397.  
  1398.          The modem dialing string specified through the Alt-S window
  1399.          is issued; the long distance number (if given) is issued; the
  1400.          telephone number is issued; and finally the dialing suffix
  1401.          string specified through the Alt-S screen is sent.
  1402.  
  1403.          Communications parameters are selected when the dialing direc-
  1404.          tory entry is created.  Each service requires certain settings
  1405.          for comprehensible communications.  However, one note:  COM-AND
  1406.          will change settings to 8 data bits, no parity and 1 stop bit
  1407.          when file transfer commences, if appropriate.  When transfer
  1408.          completes, previous settings are reinstated.  You only need to
  1409.          know what the specific service requires for conversational mode.
  1410.  
  1411.  
  1412.        . Manual dialing (M)
  1413.  
  1414.          From the Alt-D dialing directory, you may invoke manual dialing
  1415.          with the command "M".  You will be asked to enter a number to
  1416.          be dialed.  Enter the number you wish to dial; it will be
  1417.          prefixed with the modem dialing string (specified through the
  1418.          Alt-S window) suffixed with the dialing suffix, and issued.
  1419.  
  1420.          Manually dialed numbers use the communications parameters in
  1421.          effect at the time the number is dialed.  The rule for comm
  1422.          parameters is:  The Comm Parms window (Alt-P) is overridden by
  1423.          run-time parameters; the setting specified by the (last)
  1424.          dialing directory entry used (if any) overrides both.
  1425.  
  1426.  
  1427.  
  1428.  
  1429. Version 2.8: 910716
  1430.  
  1431. COM-AND: IBM PC Communications and Accessories                 Page  20
  1432.  
  1433.  
  1434. IX.    Dialing (continued)
  1435.  
  1436.  
  1437.     B. Dialing directory maintenance (Alt-D)
  1438.  
  1439.        . Revise entry (R)
  1440.  
  1441.          A directory entry is revised with the "R" command.  You will be
  1442.          prompted for an entry number (you may use the command "Rn" too,
  1443.          where "n" is the entry number).  Answer each prompt as you want
  1444.          the value to be.  You may cancel the change at any prompt with
  1445.          the ESC key.  When all the prompts are completed you will be
  1446.          asked whether the change is to be saved to disk.  If you say no
  1447.          the change will not be available the next time you use COM-AND.
  1448.  
  1449.        . Delete entry (D)
  1450.  
  1451.          A directory entry is deleted with the "D" command on the Alt-D
  1452.          window.  You will be prompted for the entry number (you may use
  1453.          the command "Dn" too, where "n" is the entry number).  The
  1454.          chosen entry is displayed.  If you answer "y" to the query, the
  1455.          entry will be deleted in memory and on disk.
  1456.  
  1457.        . Revise Long distance directory (L)
  1458.  
  1459.          The Long distance directory is a directory within a directory.
  1460.          Four entries may be created (labelled:  "+", "-", "#", and "@")
  1461.          and used to prefix or suffix a dialing command (or to suffix).
  1462.  
  1463.          The Long distance entry is free form.  Any string that your
  1464.          modem will accept may be entered.    The Long distance directory
  1465.          is pulled-up from the Alt-D window with the command "L".  An
  1466.          entry may be modified by selecting its label ("+","-","#","@").
  1467.  
  1468.        . Print directory (P)
  1469.  
  1470.          The dialing directory (current in memory) is printed from the
  1471.          Alt-D window with the command "P".  Printer output is directed
  1472.          to the standard output device (PRN).  You are prompted to ready
  1473.          the printer.  Strike any key except ESC to begin printing.  ESC
  1474.          cancels the request.
  1475.  
  1476.          The printed directory is two pages, each of 50 lines (plus
  1477.          heading).    Top-of-forms (decimal 12) are issued at the start of
  1478.          each page.  Column headings are similar to the Alt-D headings.
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484. Version 2.8: 910716
  1485.  
  1486. COM-AND: IBM PC Communications and Accessories                 Page  21
  1487.  
  1488.  
  1489. IX.    Dialing (continued)
  1490.  
  1491.  
  1492.     B. Dialing directory maintenance (continued)
  1493.  
  1494.        . Load file (F)
  1495.  
  1496.          A new dialing directory may be loaded with the 'F' command at
  1497.          any time.    Note that when you change the directory file, the
  1498.          change also is reflected in the Alt-S window (but isn't saved
  1499.          for the next time unless you save the values in Alt-S).
  1500.  
  1501.  
  1502.     C. Redial (Alt-R)
  1503.  
  1504.        The last dialing directory entry used to dial (or manual number
  1505.        as entered) may be recalled and redialed.  The redial sequence
  1506.        cycles.  It waits for the "Connect string" (as specified through
  1507.        the Alt-S window) for a fixed period, then resets the modem using
  1508.        the "Escape string" and tries again.  Time spent redialing is
  1509.        updated every time a redial is attempted.
  1510.  
  1511.        You may force a new attempt with the space-bar.  You may change
  1512.        the delay interval by pressing the END key:    you will be prompted
  1513.        for a new value (in seconds).
  1514.  
  1515.  
  1516.     D. Hangup (Alt-H)
  1517.  
  1518.        The connection (if any) may be interrupted and the "Hangup string"
  1519.        (specified through the Alt-S window) issued (or DTR dropped,
  1520.        according to your Alt-O preference), using the Alt-H command.
  1521.  
  1522.        One note about Alt-H hangup:  According to your modem and your
  1523.        setup of COM-AND, it is possible that the connection may not be
  1524.        properly broken.  A second Alt-H may or may not finish the job.
  1525.        Modems configured to follow DTR always respond to dropping DTR.
  1526.  
  1527.        Through Alt-O, you may opt to re-initialize the modem after
  1528.        hangup. The re-initialization will take some time, but insures
  1529.        that the modem is left in a uniform state.
  1530.  
  1531.     E. A note on modem speed
  1532.  
  1533.        Some new modems connect to the PC at one speed and connect to the
  1534.        host at a second speed.  If you use a modem of this type, remember
  1535.        to set the speed in the dialing directory to the speed used modem-
  1536.        to-PC.  Usually this is a higher rate.
  1537.  
  1538.  
  1539. Version 2.8: 910716
  1540.  
  1541. COM-AND: IBM PC Communications and Accessories                 Page  22
  1542.  
  1543.  
  1544. X.    Macros (Alt-M and Alt-0/9)
  1545.  
  1546.  
  1547.     A. Revise entry (0-9)
  1548.  
  1549.        COM-AND is distributed with an empty Macro directory.  Entries are
  1550.        displayed and modified through the Alt-M command.  A macro entry
  1551.        is any string of text which is to be transmitted on-line with one
  1552.        keystroke.  Carriage returns may be embedded in the string (as
  1553.        exclamation points "!" ...  Exclamation points themselves must be
  1554.        entered doubly:  "!!").  Control characters may be embedded in the
  1555.        string (as caret/letter "^x" ...  ^a = 1, ^b = 2, and so on...
  1556.        Carets themselves, too, must be doubled:  "^^").  The grave (`)
  1557.        forces the next character (may be used in place of doubling).
  1558.  
  1559.        The macro definition window is invoked with Alt-M.  Select the
  1560.        entry number to be revised by entering its number (0...9).  You
  1561.        will be prompted for the new entry.
  1562.  
  1563.        One interesting note:  COM-AND keystrokes may be programmed into
  1564.        macros themselves.  For example, the macro:
  1565.  
  1566.         "^@<SOURCE!"
  1567.  
  1568.        actually invokes the F2 (execute script) window, and passes the
  1569.        name "SOURCE" with a terminating carriage return to the F2 window.
  1570.        The ^@ indicates that the following character is to be interpreted
  1571.        as an 'extended keystroke', i.e. not-ASCII.  The extended charac-
  1572.        ter set is:
  1573.  
  1574.        Macro seq    Key    Macro seq    Key    Macro seq    Key
  1575.        ---------    ---    ---------  -----    ---------  -----
  1576.        ^@;         F1    ^@^^       Alt-A    ^@1       Alt-N
  1577.        ^@<         F2    ^@1       Alt-B    ^@^X       Alt-O
  1578.        ^@=         F3    ^@.       Alt-C    ^@^Y       Alt-P
  1579.        ^@>         F4    ^@ (space) Alt-D    ^@^P       Alt-Q
  1580.        ^@?         F5    ^@^R       Alt-E    ^@^S       Alt-R
  1581.        ^@@         F6    ^@!       Alt-F    ^@^_       Alt-S
  1582.        ^@A         F7    ^@"        Alt-G        ^@^T       Alt-T
  1583.        ^@B         F8    ^@#       Alt-H    ^@^V       Alt-U
  1584.        ^@C         F9    ^@^W       Alt-I    ^@/       Alt-V
  1585.        ^@D        F10    ^@$       Alt-J    ^@^Q       Alt-W
  1586.        ^@I           PgUp    ^@%       Alt-K    ^@-       Alt-X
  1587.        ^@Q           PgDn    ^@&       Alt-L    ^@^U       Alt-Y
  1588.        ^@u        Ctl-End    ^@2       Alt-M    ^@,       Alt-Z
  1589.  
  1590.        Note, too, that Alt-A (requiring "^^") is unprogrammable.  It may
  1591.        be entered as decimal 30 (use Alt and numeric pad keys).
  1592.  
  1593.  
  1594. Version 2.8: 910716
  1595.  
  1596. COM-AND: IBM PC Communications and Accessories                 Page  23
  1597.  
  1598.  
  1599. X.    Macros (continued)
  1600.  
  1601.  
  1602.     A. Revise entry (continued)
  1603.  
  1604.        In the above example, the F2 key was represented by "^@<".  When
  1605.        the F2 key is pressed a window is opened and a search for all
  1606.        files *.CMD and *.ENF takes place.  In simpler terms, pressing the
  1607.        F2 key takes TIME.  COM-AND defines the ASCII value 255 as a short
  1608.        cut to execute a script or script statement.  The macro:
  1609.  
  1610.         " SOURCE!"
  1611.  
  1612.        where the first character (displayed as blank) is ASCII 255, will
  1613.        perform the same sequence... without opening the F2 window.
  1614.  
  1615.  
  1616.        DOS provides an obscure method for entering characters by their
  1617.        ASCII value.  To enter the ASCII value 255:    hold down the
  1618.        Alt-key, type '2' on the numeric pad, then type '5' on the numeric
  1619.        pad, then type '5' again on the numeric pad, and finally, release
  1620.        the Alt-key.  The Alt-key must be held for the duration of the
  1621.        2-5-5.  The numeric pad must be used.
  1622.  
  1623.  
  1624.        If the first character following the 255 is ".", the text will be
  1625.        executed as a single script command.  Otherwise, the text is
  1626.        interpreted as a script file name to be executed.  In this way
  1627.        single script statements or entire script files may be tied to a
  1628.        macro key (Alt-0 through Alt-9).
  1629.  
  1630.     B. Load a new file (Alt-M subcommand F)
  1631.  
  1632.        When COM-AND is loaded, the Macro Definition file as named through
  1633.        the Alt-S setup menu is loaded.  You may load a different file of
  1634.        macros after that point with the (F)ile subcommand of Alt-M.  Note
  1635.        that when you change the macro definition file, the change also is
  1636.        reflected in the Alt-S window (but isn't saved for the next time
  1637.        unless you save the values in Alt-S).
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649. Version 2.8: 910716
  1650.  
  1651. COM-AND: IBM PC Communications and Accessories                 Page  24
  1652.  
  1653.  
  1654. X.    Macros (continued)
  1655.  
  1656.  
  1657.     C. Clear entries (Alt-M subcommand C)
  1658.  
  1659.        You may clear all macro definitions in COM-AND's memory (but not
  1660.        in the current file) with the (C)lear command.  To clear the file,
  1661.        make blank entries (blank, <cr>) for 0-9.
  1662.  
  1663.  
  1664.     D. Execute entry (Alt-0 through Alt-9)
  1665.  
  1666.        Macros are issued with the commands Alt-0 through Alt-9, outside
  1667.        of Alt-M.  The entry indicated by the number will be immediately
  1668.        issued.  What happens after that is strictly up to what you've
  1669.        entered, the service you're on, and the people around you.
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  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. Version 2.8: 910716
  1705.  
  1706. COM-AND: IBM PC Communications and Accessories                 Page  25
  1707.  
  1708.  
  1709. XI.    Encrypt/Decrypt (Alt-N)
  1710.  
  1711.  
  1712.     Beginning with version 2.2, COM-AND performs file encryption and
  1713.     decryption.  COM-AND encrypted script files are automatically
  1714.     recognized and decrypted in memory.  Dialing directory, Macro
  1715.     definition and Accessory definition files are not automatically
  1716.     decrypted, but might be decrypted and reloaded through a script.
  1717.  
  1718.  
  1719.     COM-AND implements three encryption methods:
  1720.  
  1721.     o full Federal Data Encryption Standard;  the DES algorithm in
  1722.       software is not fast but may be considered fairly secure.  The
  1723.       DES is appropriate for files you wish to exchange publicly,
  1724.       but wish to secure.  However, it is SLOW.
  1725.  
  1726.     o a simple encryption method;  this method is appropriate for
  1727.       script files which you plan to keep on your own machine, and
  1728.       only wish to protect from casual perusal (e.g. passwords).
  1729.  
  1730.     o a one-way encryption method;    this method is only for scripts.
  1731.       No password is required for this encryption.    When a script
  1732.       file encrypted this way is encountered, no password prompt is
  1733.       issued to the screen.  COM-AND will not decrypt one-way encrypted
  1734.       files from Alt-N.
  1735.  
  1736.  
  1737.     The Federal Data Encryption encodes data in 64-bit 'chunks'; each
  1738.     bit of each byte goes through many transformations, and may end up
  1739.     anywhere in the 64-bit area.  The simpler methods also encode in
  1740.     chunks, but do not 'smear bits'.
  1741.  
  1742.  
  1743.     DES encryption is most secure.    'Simple' encryption is less secure.
  1744.     One-way encryption is least secure (it is present because transparent
  1745.     script decryption was requested).
  1746.  
  1747.  
  1748.     Encrypted files are slightly larger that the original file.  Infor-
  1749.     mation as to true file size, file date/time and CRC checking is added
  1750.     to the file.  When the file is decrypted, the method used to encrypt
  1751.     is recognized automatically, and the file is restored to its original
  1752.     size, date and time.  The decrypted file is deleted immediately if
  1753.     a CRC check fails.
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759. Version 2.8: 910716
  1760.  
  1761. COM-AND: IBM PC Communications and Accessories                 Page  26
  1762.  
  1763.  
  1764. XI.    Encrypt/Decrypt (continued)
  1765.  
  1766.  
  1767.     When you encrypt or decrypt a file (or when the script processor
  1768.     recognizes an encrypted file with the exception of one-way encryp-
  1769.     tion) you will be asked for a password.  COM-AND accepts up to 32
  1770.     characters for the password, and uses them to derive a 'key' for
  1771.     the file.  The password you supply is not the decrypting key.  For
  1772.     maximum protection, it is recommended that you use the full 32
  1773.     characters for the password.
  1774.  
  1775.     ---------------------------------------------------------------------
  1776.     However, you must be able (somehow) to remember the password.  Should
  1777.     you lose the password, or if the encrypted file is modified in any
  1778.     manner, there is very little chance of recovering the data.  Neither
  1779.     CABER Software nor the author will be liable for any damages or lost
  1780.     revenues incurred through the use of this function beyond the
  1781.     registration price paid for COM-AND.
  1782.     ---------------------------------------------------------------------
  1783.  
  1784.  
  1785.     Encryption and decryption must be performed from one (input) file to
  1786.     another different (output) file.  Do not attempt to encrypt or
  1787.     decrypt a file over itself.  If there is insufficient space on the
  1788.     target disk for the file, you will be told, and allowed to select a
  1789.     new target disk or diskette or to abort.
  1790.  
  1791.  
  1792.     Alt-N invokes a menu allowing selection of Encryption or Decryption.
  1793.     You will be prompted for each required parameter.  When the process
  1794.     begins, a display similar to file transfers provides an estimate for
  1795.     the time required and a measure of its performance.
  1796.  
  1797.  
  1798.     The COM-AND script processor searches for the extension ".ENF" as
  1799.     well as ".CMD".  The script processor searches first for the given
  1800.     file name.  If no match is found it then searches for the same file
  1801.     name with the extension ".CMD".  If no match is found the second
  1802.     time, it searches for the same file name with the extension ".ENF".
  1803.     [If the name was unqualified with drive:subdirectory and if there
  1804.     is a COM-AND= environment variable, another three searches will be
  1805.     performed on the drive:subdirectory indicated by the COM-AND=
  1806.     variable.]
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814. Version 2.8: 910716
  1815.  
  1816. COM-AND: IBM PC Communications and Accessories                 Page  27
  1817.  
  1818.  
  1819. XI.    Encrypt/Decrypt (continued)
  1820.  
  1821.  
  1822.     Thus, if you wish to encrypt a script file with no extension or with
  1823.     the extension ".CMD", you must use one of two strategies:
  1824.  
  1825.     o  encrypt the file using a DIFFERENT name... and use the
  1826.        different name when invoking the script (F2)... or
  1827.  
  1828.     o  encrypt the file to the same name with the extension ".ENF"
  1829.        and then delete the original (after backup of course).
  1830.  
  1831.  
  1832.     It is suggested that either the 'simple' method or 'one-way' method
  1833.     be used to encode script files.  Script files encoded with these
  1834.     methods are decrypted and executed transparently...  there will be
  1835.     perceptible delays if the DES encryption is used for a large script.
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869. Version 2.8: 910716
  1870.  
  1871. COM-AND: IBM PC Communications and Accessories                 Page  28
  1872.  
  1873.  
  1874. XII.    Program Configuration (Alt-S, Alt-P, Alt-O, and Alt-J)
  1875.  
  1876.  
  1877.     A. Setup Screen (Alt-S)
  1878.  
  1879.        1. Modem control
  1880.  
  1881.           . Modem initialization string
  1882.  
  1883.         The modem initialization string is issued when COM-AND is
  1884.         first loaded.  It is not issued when the port is changed
  1885.         during execution.  If blank, it will be ignored.  Carriage
  1886.         returns and control characters are specified as with macros.
  1887.         Refer to Appendix M (Modem Configuration) for examples.
  1888.  
  1889.           . Modem dialing prefix
  1890.  
  1891.         The Modem dialing prefix commands the modem to begin a
  1892.         dialing sequence.  It is followed by a number from the
  1893.         dialing directory (and long distance string, if specified).
  1894.  
  1895.           . Modem dialing suffix
  1896.  
  1897.         The Modem dialing string terminates each dialing command.
  1898.         For Hayes type modems it should be a "!" (translated by
  1899.         COM-AND to be a <cr>).    It may be any string appropriate to
  1900.         your modem.  Carriage returns and control characters are
  1901.         specified as with macros.
  1902.  
  1903.           . Hangup string
  1904.  
  1905.         The hangup string is issued through the Alt-H command (after
  1906.         a modem escape is issued), if "drop DTR" is not set in Alt-O.
  1907.         Carriage returns and control characters are specified as
  1908.         with macros.  Delays of 1/2 second each may be specified
  1909.         with a tilde (~) (see "modem delay char" below).
  1910.  
  1911.           . Escape string
  1912.  
  1913.         The modem escape is issued before the hangup string (Alt-H),
  1914.         and before each redial (Alt-R).  Delays of 1/2 second each
  1915.         are specified with a tilde (~).  Carriage returns and
  1916.         control characters are specified as with macros.
  1917.  
  1918.           . Connect string
  1919.  
  1920.         The connect string is used by the Alt-D dial and Alt-R redial
  1921.         commands to determine when connection has been made.
  1922.  
  1923.  
  1924. Version 2.8: 910716
  1925.  
  1926. COM-AND: IBM PC Communications and Accessories                 Page  29
  1927.  
  1928.  
  1929. XII.    Program Configuration (continued)
  1930.  
  1931.  
  1932.     A. Setup Screen (continued)
  1933.  
  1934.        2. Files
  1935.  
  1936.           All files specified here are searched under the current
  1937.           drive:subdirectory, and under the drive:subdirectory
  1938.           indicated through the COM-AND= environment variable, unless
  1939.           the name given is explicitly qualified.
  1940.  
  1941.           . Call-log file name
  1942.  
  1943.         The call-log file name determines the file to be opened
  1944.         to receive call-logging (if call-logging is enabled, see
  1945.         below, Alt-O Options).
  1946.  
  1947.           . Dialing directory
  1948.  
  1949.         The dialing directory file is used to initialize the
  1950.         program's dialing directory.  The current dialing directory
  1951.         may be changed at any time from within COM-AND.
  1952.  
  1953.           . Macro Directory
  1954.  
  1955.         The macro directory file is used to initialize the
  1956.         program's macro definitions.  You may change the current
  1957.         macro definition at any time from within COM-AND.
  1958.  
  1959.          .    Accessory directory
  1960.  
  1961.         The COM-AND accessory function F1 requires a file to contain
  1962.         definitions for accessories.  You may have several files of
  1963.         definitions and change at any time from within COM-AND.
  1964.  
  1965.           . RLE temporary file
  1966.  
  1967.         COM-AND will recognize RLE graphics images when they are
  1968.         encountered in the received stream, and buffer the image to
  1969.         disk.  This file name specifies the temporary file name.
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979. Version 2.8: 910716
  1980.  
  1981. COM-AND: IBM PC Communications and Accessories                 Page  30
  1982.  
  1983.  
  1984. XII.    Program Configuration (continued)
  1985.  
  1986.  
  1987.     A. Setup Screen (continued)
  1988.  
  1989.        3. Timings and Values
  1990.  
  1991.           . Backscreen buffer size
  1992.  
  1993.         Up to 64K for the backscreen buffer may be selected (or turn
  1994.         it off altogether by setting it to 0K).  This buffer is used
  1995.         by the Alt-B redisplay, and by the F7 transcript command.
  1996.  
  1997.           . Break delay
  1998.  
  1999.         COM-AND issues a true break through the Ctl-End key.  The
  2000.         duration of the break is controlled here.  "Break delay"
  2001.         specifies the number of milliseconds the comm line is held.
  2002.  
  2003.           . Alarm duration
  2004.  
  2005.         The alarm duration value gives the number of seconds the
  2006.         alarm tune sounds when a function is terminated.  Set this
  2007.         to zero to inhibit the special termination alarm.
  2008.  
  2009.           . Modem char delay
  2010.  
  2011.         The modem char delay gives the number of milliseconds COM-
  2012.         AND delays after each character of a modem control sequence
  2013.         (e.g.  dialing, hangup, initialization).  Certain modems
  2014.         require their control sequences be enunciated slowly.
  2015.  
  2016.           . Reconnect delay
  2017.  
  2018.         The interval between Alt-R redial (and scripted dialing)
  2019.         attempts is established here.  45 seconds is recommended for
  2020.         long distance dialing.    30 seconds is usual for local calls.
  2021.  
  2022.           . Chat Window
  2023.  
  2024.         The size of the lower window of chat mode (where what you
  2025.         type appears) may be changed.  The size of the chat window
  2026.         is limited to between 2 and 10 lines.
  2027.  
  2028.           . Bell tone
  2029.  
  2030.         COM-AND implements its own bell sound.    You may set the tone
  2031.         to any frequency (in Hz) that pleases.
  2032.  
  2033.  
  2034. Version 2.8: 910716
  2035.  
  2036. COM-AND: IBM PC Communications and Accessories                 Page  31
  2037.  
  2038.  
  2039. XII.    Program Configuration (continued)
  2040.  
  2041.  
  2042.     A. Setup Screen (continued)
  2043.  
  2044.        3. Timings and Values
  2045.  
  2046.           . Mouse vertical sensitivity
  2047.  
  2048.         The vertical sensitivity of the mouse may be set here.
  2049.         The higher the value used, the less sensitive the mouse.
  2050.         The most sensitive value is 0.
  2051.  
  2052.           . Mouse horizontal sensitivity
  2053.  
  2054.         The horizontal sensitivity of the mouse may be set here.
  2055.         The higher the value used, the less sensitive the mouse.
  2056.         The most sensitive value is 0.
  2057.  
  2058.           . Mouse double click interval
  2059.  
  2060.         The double click interval of the mouse may be set here.
  2061.         When a mouse button is pressed twice within this interval a
  2062.         different action is taken than when it is only pressed once.
  2063.  
  2064.           . Modem delay character
  2065.  
  2066.         The modem delay character defaults to a tilde (ASCII 126).
  2067.         It represents a 1/2 second display in strings sent to the
  2068.         modem (above) and strings sent with the script command
  2069.         TRANSMIT.  It may be redefined here if you wish.
  2070.  
  2071.           . Xfer Screen Update Interval
  2072.  
  2073.         At 9600 baud and above, the time taken to paint the status
  2074.         screen becomes a significant percentage of the overall time
  2075.         required for a file transfer.  Setting the screen update
  2076.         interval to '5' will have a visible impact even at 2400 baud.
  2077.  
  2078.  
  2079.        4. Save
  2080.  
  2081.           You may change values for one execution of COM-AND, or you
  2082.           may change them for all subsequent executions of COM-AND.  If
  2083.           you save values, the values you've saved will be set the next
  2084.           time you use COM-AND.
  2085.  
  2086.  
  2087.  
  2088.  
  2089. Version 2.8: 910716
  2090.  
  2091. COM-AND: IBM PC Communications and Accessories                 Page  32
  2092.  
  2093.  
  2094. XII.    Program Configuration (continued)
  2095.  
  2096.  
  2097.     B. Communications Parameters (Alt-P)
  2098.  
  2099.        Do not change the current setting after you've connected to a ser-
  2100.        vice.  XMODEM, YMODEM, ZMODEM, and CIS-B transfers can change (and
  2101.        do change) to no parity (if necessary), but you shouldn't.
  2102.  
  2103.        1. Port speed (baud)
  2104.  
  2105.           Baud rate is specified through the first selections of the
  2106.           Alt-P window.  Other parameters (parity, data bits, and stop
  2107.           bits) may be set individually or in combination (below).
  2108.  
  2109.        2. E,7,1 and N,8,1
  2110.  
  2111.           For convenience, the combinations Even parity/7 data bits/1
  2112.           stop bit, and No parity/8 data bits/1 stop bit are provided
  2113.           after the port speed selections.
  2114.  
  2115.        3. Parity, Data bits and Stop bits
  2116.  
  2117.           Individual settings for parity, number of data bits and number
  2118.           of stop bits comprise the next items of this menu.  You also
  2119.           set these values when you create a dialing directory entry.
  2120.  
  2121.        4. COM ports
  2122.  
  2123.           The last items on this menu are the candidates for COM ports.
  2124.           Select the appropriate port for your modem.  This item is
  2125.           usually selected once, and then left alone.
  2126.  
  2127.           NOTE:  If your computer is equipped with fewer than four serial
  2128.           ports, an attempt to configure a missing port results in the
  2129.           report that the port speed is 115k baud.    When a board is added
  2130.           with the additional port (e.g.  an internal modem set to work
  2131.           as COM3 or COM4), COM-AND will recognize it.
  2132.  
  2133.        -----------------------------------------------------------------
  2134.        Note:  All parameters may be set through the command parameters.
  2135.        These parameters override the Alt-P default settings.  Example:
  2136.  
  2137.           "d>" COM-AND COM3 1200 DATA8 STOP1 NONE
  2138.  
  2139.        Refer to Appendix A for the list of run-command parameters.
  2140.        -----------------------------------------------------------------
  2141.  
  2142.  
  2143.  
  2144. Version 2.8: 910716
  2145.  
  2146. COM-AND: IBM PC Communications and Accessories                 Page  33
  2147.  
  2148.  
  2149. XII.    Program Configuration (continued)
  2150.  
  2151.  
  2152.     B. Communications Parameters (continued)
  2153.  
  2154.        5. Save
  2155.  
  2156.           Current settings for the next execution of COM-AND are saved
  2157.           through the "Save" selection.  Settings are saved to disk.
  2158.  
  2159.        6. Set Base/IRQ
  2160.  
  2161.           COM-AND defaults the four supported comm ports to the values:
  2162.  
  2163.           COM1:  base address: 0x3f8, interrupt request # 4
  2164.           COM2:  base address: 0x2f8, interrupt request # 3
  2165.           COM3:  base address: 0x3e8, interrupt request # 4
  2166.           COM4:  base address: 0x2e8, interrupt request # 3
  2167.  
  2168.           These may be changed through a submenu of the Alt-P menu.
  2169.           Select 'Set Base/IRQ', and the submenu is opened.  Current
  2170.           values are displayed.  Select a port and you will be prompted
  2171.           for new values.
  2172.  
  2173.           Each port's base address is limited to the values 0-1023 (or
  2174.           0 through 0x3ff).  Each port's interrupt request number is
  2175.           limited to the values 0-7.
  2176.  
  2177.           The default values are appropriate for most applications.
  2178.           Most people will never need to change these settings.  How
  2179.           ever, should you need to do so, the capability is available.
  2180.  
  2181.           DO NOT CHANGE these assignments unless you are sure you have
  2182.           need to do so, and have the correct values at hand.  If you
  2183.           do not save the changes, COM-AND will revert to the defaults
  2184.           the next time it is loaded (after a Control-Alt-Delete, for
  2185.           example!).
  2186.  
  2187.           If COM-AND is directed to use a comm port address that does not
  2188.           exist in fact, the result may range from:  nothing happening
  2189.           whatsoever, to complete machine lockup (if there IS in fact a
  2190.           device at that address able to respond to interrupt requests).
  2191.           It is recommended that new settings be tried before saved.
  2192.  
  2193.           The meaning of the 'names' COM1, COM2, COM3, and COM4, as far
  2194.           as COM-AND is concerned, are determined simply by these
  2195.           assignments.
  2196.  
  2197.  
  2198.  
  2199. Version 2.8: 910716
  2200.  
  2201. COM-AND: IBM PC Communications and Accessories                 Page  34
  2202.  
  2203.  
  2204. XII.    Program Configuration (continued)
  2205.  
  2206.  
  2207.     C. Options (Alt-O)
  2208.  
  2209.        1. Settings otherwise available
  2210.  
  2211.           . Echo  (also Alt-E)
  2212.  
  2213.         Some services turn around what you type so that you see it
  2214.         (full duplex or echoplex), and some don't (half duplex).
  2215.         You may force COM-AND to display what you enter in the CRT
  2216.         window by toggling echo.  Setting echo on (through the Alt-O
  2217.         window) will turn echo on now.    Saving it will cause echo to
  2218.         be turned on the next time you run COM-AND.  Echo is toggled
  2219.         dynamically with the Alt-E command.
  2220.  
  2221.           . Parity mask (also Alt-Z)
  2222.  
  2223.         You may mask parity from received text by setting the parity
  2224.         mask on permanently through the Alt-O window.  I've found
  2225.         this to be useful; mandatory when I've needed it.  Parity
  2226.         masking is toggled dynamically with the Alt-Z command.
  2227.  
  2228.           . Keyboard display  (also F8)
  2229.  
  2230.         Some talk systems are more friendly when what you type is
  2231.         not mixed in with what you receive.  Turning system echo off
  2232.         (if the system echoes key-entry) is accomplished in a number
  2233.         of ways (note that this is different from Alt-E above), each
  2234.         unique to the particular system.
  2235.  
  2236.         However, all of a sudden there is a new problem: you don't
  2237.         see what you're typing!  Keyboard display in COM-AND is one
  2238.         attempt to solve this problem.    What you type will be
  2239.         displayed on the status line when keyboard display is turned
  2240.         on.  You may enable it on permanently through this option.
  2241.         Keyboard display may be toggled dynamically with F8.
  2242.  
  2243.           . Chat mode (also Alt-A)
  2244.  
  2245.         Chat mode is another attempt to allow you to see what you've
  2246.         typed when echo has been turned off.  Instead of just one
  2247.         line of keyboard display, chat mode allows you to see the
  2248.         last few (up to 10) lines you have typed.  Chat mode is
  2249.         toggled dynamically with Alt-A.
  2250.  
  2251.  
  2252.  
  2253.  
  2254. Version 2.8: 910716
  2255.  
  2256. COM-AND: IBM PC Communications and Accessories                 Page  35
  2257.  
  2258.  
  2259. XII.    Program Configuration (continued)
  2260.  
  2261.  
  2262.     C. Options (Alt-O) (continued)
  2263.  
  2264.        1. Settings otherwise available (continued)
  2265.  
  2266.           . Blank line suppression (also Alt-G)
  2267.  
  2268.         You may enable blank line suppression on when COM-AND is
  2269.         loaded, through this selection.  Blank line suppression is
  2270.         dynamically toggled with Alt-G.
  2271.  
  2272.           . In/Out Translate (also Alt-V)
  2273.  
  2274.         You may turn on in/out character translation on when COM-AND
  2275.         is loaded, through this option.  Note that the file COM-AND.
  2276.         XLT must be prepared prior to the use of this function.
  2277.         COM-AND.XLT is prepared with the script XLATE.CMD.
  2278.  
  2279.           . Remapping (also Alt-V)
  2280.  
  2281.         You may turn on keyboard remapping on when COM-AND is loaded,
  2282.         through this option.  Note that the file COM-AND.RMP must be
  2283.         prepared prior to the use of this function.  Please refer to
  2284.         to the script REMAP.CMD and its documentation REMAP.DOC.
  2285.  
  2286.        2. Settings available only through Alt-O
  2287.  
  2288.           . Nondestructive Backspace
  2289.  
  2290.         You may toggle a destructive/nondestructive backspace func-
  2291.         tion through this option.  Nondestructive backspaces are not
  2292.         required by many systems, but now and then it comes up.
  2293.  
  2294.           . Backspace sent as delete
  2295.  
  2296.         You may toggle the character transmitted as a backspace func-
  2297.         tion through this option.  Either backspace (decimal 8), or
  2298.         delete (decimal 127, a.k.a. rubout) may be transmitted.
  2299.  
  2300.           . CR -> CRLF received
  2301.  
  2302.         You may toggle a CR/CRLF on received CR function through this
  2303.         option.  Most systems generate a CR and a LF to terminate a
  2304.         line, but a few only generate a CR.
  2305.  
  2306.  
  2307.  
  2308.  
  2309. Version 2.8: 910716
  2310.  
  2311. COM-AND: IBM PC Communications and Accessories                 Page  36
  2312.  
  2313.  
  2314. XII.    Program Configuration (continued)
  2315.  
  2316.  
  2317.     C. Options (Alt-O) (continued)
  2318.  
  2319.        2. Settings available only through Alt-O (continued)
  2320.  
  2321.           . Alarm noise
  2322.  
  2323.         An alarm tune (of sorts) sounds when the Alt-R redial makes
  2324.         connection, and when file transfer is complete.  The noise
  2325.         is also played when certain error conditions occur.
  2326.  
  2327.         When disabled, the alarm window is held open without noise.
  2328.         The duration of the noise (or noiseless pause) is controlled
  2329.         through Alt-S Setup.
  2330.  
  2331.           . Exit query
  2332.  
  2333.         Some people disdain the query "do you really and truly mean
  2334.         it" when they type Alt-X.  Some feel it mandatory.  COM-AND
  2335.         is distributed with exit query disabled.  You may enable it,
  2336.         if you're so inclined, through this Alt-O selection.
  2337.  
  2338.           . Mark transcript
  2339.  
  2340.         COM-AND will mark every disk transcript taken (beginning and
  2341.         end) with the date and time.  You tell COM-AND not to mark
  2342.         further transcripts through this Alt-O selection.
  2343.  
  2344.         The transcript function also has the capability to add the
  2345.         backscreen (the full backscreen buffer's worth) to the
  2346.         transcript.  Turning transcript marking off means that there
  2347.         will be no delimiter between the backscreen and transcript.
  2348.  
  2349.           . Initial advertisement
  2350.  
  2351.         When COM-AND was distributed, the Information screen (Alt-I)
  2352.         was set to be displayed when the program was run.  You turn
  2353.         the display off through this Alt-O setting.
  2354.  
  2355.           . Use BIOS for screen saves
  2356.  
  2357.         You may set BIOS screen accesses permanently through this
  2358.         option.  COM-AND defaults to direct screen buffer reads and
  2359.         writes.  Some machines (and environments, like Windows)
  2360.         require this option be set.  See also Appendix J on multi-
  2361.         tasking, and "Use DOS for screen writes", below.
  2362.  
  2363.  
  2364. Version 2.8: 910716
  2365.  
  2366. COM-AND: IBM PC Communications and Accessories                 Page  37
  2367.  
  2368.  
  2369. XII.    Program Configuration (continued)
  2370.  
  2371.  
  2372.     C. Options (Alt-O) (continued)
  2373.  
  2374.        2. Settings available only through Alt-O (continued)
  2375.  
  2376.           . Use DOS for screen writes
  2377.  
  2378.         You may set DOS screen writes permanently through this
  2379.         option.  When received text is written through DOS, ANSI.SYS
  2380.         or other console driver is invoked (if you turn all emulation
  2381.         off).  See also Appendix J on multi-tasking, and "Use BIOS
  2382.         for screen saves", above.
  2383.  
  2384.           . Display control characters
  2385.  
  2386.         COM-AND permits displayable control characters to be dis-
  2387.         played (as many BBS's use them).  You may turn this feature
  2388.         off and on through Alt-O according to the system you use.
  2389.  
  2390.           . Software flow control (XON/XOFF)
  2391.  
  2392.         COM-AND supports software flow control using the XON/XOFF
  2393.         discipline for receipt and for ASCII sends.  You may enable
  2394.         and disable this feature according to the system you use.
  2395.  
  2396.           . Unidirectional hardware flow control (OLD style!)
  2397.  
  2398.         COM-AND supports a hardware flow control, raising RTS before
  2399.         transmitting a char, and waiting for CTS.  This function may
  2400.         be permanently established here, according to your needs.
  2401.         This method is rarely used now.
  2402.  
  2403.           . Bidirectional) hardware flow control (modern usage)
  2404.  
  2405.         COM-AND supports a second manner of hardware flow control,
  2406.         raising RTS when able to receive and waiting for CTS before
  2407.         transmitting.  This function may be permanently established
  2408.         here, according to your needs.
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419. Version 2.8: 910716
  2420.  
  2421. COM-AND: IBM PC Communications and Accessories                 Page  38
  2422.  
  2423.  
  2424. XII.    Program Configuration (continued)
  2425.  
  2426.  
  2427.     C. Options (Alt-O) (continued)
  2428.  
  2429.        2. Settings available only through Alt-O (continued)
  2430.  
  2431.           . Drop DTR to hangup
  2432.  
  2433.         COM-AND disconnects either (1) by dropping DTR momentarily or
  2434.         (2) using the hangup escape sequence specified in the Alt-S
  2435.         setup.    Only use the first method if your modem is configured
  2436.         to follow DTR (see Appendix M, Modem Configuration).
  2437.  
  2438.           . Re-initialize modem after HANGUP
  2439.  
  2440.         COM-AND will, or will not retransmit the modem initialization
  2441.         string (Alt-S above) after a HANGUP is performed.  If modem
  2442.         settings are altered for individual hosts, reinitializing
  2443.         after HANGUP ensures that the modem is always in a proper
  2444.         default state.
  2445.  
  2446.           . Call-logging
  2447.  
  2448.         COM-AND logs successful connections, hangup, carrier drop-
  2449.         outs, file transfers and file encrypt/decryptions to a
  2450.         call-log when call-logging is enabled.    The name of the
  2451.         current call-log is declared through Alt-S.
  2452.  
  2453.           . Screen clock
  2454.  
  2455.         COM-AND will display the current time (as "hh:mm:ss" if no
  2456.         connection is known, and as "hh:mm (hh:mm)" showing current
  2457.         time and time since connection) on the status line when the
  2458.         Alt-O screen clock is enabled.
  2459.  
  2460.           . Suppress bells
  2461.  
  2462.         COM-AND will suppress bell characters received if this option
  2463.         is enabled.
  2464.  
  2465.           . Menu mode
  2466.  
  2467.         COM-AND supports a menu mode allowing most all customary
  2468.         functions to be performed with a mouse.  This mode may be
  2469.         set permanently here (interactively toggled with Alt equal).
  2470.  
  2471.  
  2472.  
  2473.  
  2474. Version 2.8: 910716
  2475.  
  2476. COM-AND: IBM PC Communications and Accessories                 Page  39
  2477.  
  2478.  
  2479. XII.    Program Configuration (continued)
  2480.  
  2481.  
  2482.     C. Options (Alt-O) (continued)
  2483.  
  2484.        2. Settings available only through Alt-O (continued)
  2485.  
  2486.           . Respect CD
  2487.  
  2488.         COM-AND monitors carrier detect unless you turn the function
  2489.         off through Alt-O (or the /T run-time switch).    Carrier
  2490.         detect (CD) is monitored during file transfers and after
  2491.         successful connection through the dialing directory.
  2492.  
  2493.           . PCJr (disk I/O suspends comm)
  2494.  
  2495.         PCJr mode suspends the comm line (with an X-OFF) during disk
  2496.         I/O.  You may set/reset PCJr mode through this option.
  2497.  
  2498.           . Capture/Display RLE files
  2499.  
  2500.         COM-AND recognizes RLE files as they are received, and cap-
  2501.         tures them to disk while displaying them (if you have EGA
  2502.         or CGA).  It may be permanently enabled it here.  See also
  2503.         Appendix J on multi-tasking.
  2504.  
  2505.           . Allow MUSIC
  2506.  
  2507.         COM-AND will play music escape sequences when received if
  2508.         this function is enabled.  Music escape sequences are of the
  2509.         form: "ESC,[,M,<BASICA encoded string>,^N".
  2510.  
  2511.           . Allow REMOTE
  2512.  
  2513.         COM-AND implements a REMOTE function performing script
  2514.         commands received over the communications line.  REMOTE
  2515.         sequences are of the form:  "ESC,^,<script command>,<cr>".
  2516.  
  2517.           . Slow output
  2518.  
  2519.         COM-AND performs file transfers at an unusually high speed.
  2520.         The technique is called 'interrupt driven writes'.  Some Net-
  2521.         work modems fail when pressed so hard.    This option may be
  2522.         used to slow COM-AND file transfers down a bit.
  2523.  
  2524.  
  2525.  
  2526.  
  2527.  
  2528.  
  2529. Version 2.8: 910716
  2530.  
  2531. COM-AND: IBM PC Communications and Accessories                 Page  40
  2532.  
  2533.  
  2534. XII.    Program Configuration (continued)
  2535.  
  2536.  
  2537.     C. Options (Alt-O) (continued)
  2538.  
  2539.        2. Settings available only through Alt-O (continued)
  2540.  
  2541.           . ZMODEM auto download
  2542.  
  2543.         COM-AND will start a ZMODEM receive under the host's control
  2544.         when this option is enabled.  It may be disabled to avoid
  2545.         false triggers (for example, by "friends" in CB/chat).
  2546.  
  2547.           . ZMODEM recovery
  2548.  
  2549.         The ZMODEM protocol defines a 'recovery' function for down-
  2550.         loads.    When the file being received already exists, and this
  2551.         option is enabled, the transfer picks up at the end of the
  2552.         file (presumably where a failed transfer ended).  [The prev-
  2553.         ious transfer may have used any protocol (!).] When disabled,
  2554.         ZMODEM downloads go to a unique file name each time.
  2555.  
  2556.  
  2557.        3. Save
  2558.  
  2559.           Values set through this screen are not automatically saved
  2560.           to disk.    Values set through this screen are immediately
  2561.           used by COM-AND.    To configure COM-AND to have the same
  2562.           settings the next time it is loaded, you must save them with
  2563.           the "Save" selection of the Alt-O menu.
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584. Version 2.8: 910716
  2585.  
  2586. COM-AND: IBM PC Communications and Accessories                 Page  41
  2587.  
  2588.  
  2589. XII.    Program Configuration (continued)
  2590.  
  2591.  
  2592.     D. Colors (Alt-J)
  2593.  
  2594.        You may set foreground and background colors for
  2595.  
  2596.           (1) the CRT text area,
  2597.  
  2598.           (2) the status line, and
  2599.  
  2600.           (3) main menus (queries are set to black on white for
  2601.           contrast).
  2602.  
  2603.  
  2604.        The color names are those used in the IBM Technical Reference;
  2605.        if you have different names for some of the color values, I
  2606.        apologize.  My wife and I have argued for years over 'beige'.
  2607.  
  2608.  
  2609.        If the "Use DOS for screen writes" option is set, then the text
  2610.        colors selected above will be ignored.  If this option is set,
  2611.        and the internal ANSI emulator is not turned off, then no color
  2612.        at all (beyond your DOS configuration) is available for text.
  2613.  
  2614.  
  2615.        Like other option menus, you may experiment with settings.
  2616.        Unless you save your settings, they are lost when the program
  2617.        terminates.
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639. Version 2.8: 910716
  2640.  
  2641. COM-AND: IBM PC Communications and Accessories                 Page  42
  2642.  
  2643.  
  2644. XIII.    File Transfer (PgUp, PgDn, Alt-F and F4)
  2645.  
  2646.  
  2647.     COM-AND supports several file transfer methods, to and from your PC.
  2648.     Transfers to your PC are called downloads (down from the host).  File
  2649.     transfers from your PC are called uploads (up to the host).  The file
  2650.     transfer methods currently implemented are:
  2651.  
  2652.     o    XMODEM         (Windowed, CRC and checksum)
  2653.     o    YMODEM         (BBS YMODEM, a.k.a. XMODEM1K)
  2654.     o    Batch YMODEM (True YMODEM (tm), and YMODEM-G)
  2655.     o    ZMODEM         (batch)
  2656.     o    KERMIT         (Windowed or not windowed)
  2657.     o    CIS-B         (classic and Quick (B+), for CompuServe)
  2658.     o    ASCII         (without error checking)
  2659.  
  2660.  
  2661.     To begin a transfer, on the CRT side of COM-AND you must tell the
  2662.     host (system) that it is to begin a transfer.  Each system is diff-
  2663.     erent in this respect.    Once the host is ready to start the transfer,
  2664.     begin the transfer in COM-AND.
  2665.  
  2666.  
  2667.     The transfer is started in COM-AND with the PgUp key (for upload) or
  2668.     PgDn key (for download).  The items on the menu presented are
  2669.     explicit; if you select CRC XMODEM, Windowed XMODEM will not be used,
  2670.     even if the host supports it.  The definition of CRC XMODEM allows a
  2671.     'drop' into checksum XMODEM, on the other hand, if the host doesn't
  2672.     support CRC.
  2673.  
  2674.  
  2675.     Each system you might wish to use has an optimal transfer method.
  2676.     Select the method from the menu.  According to the transfer method
  2677.     selected, you may then be queried for a file name (or wildcard
  2678.     template in the case of KERMIT, ZMODEM and Batch YMODEM uploads).
  2679.  
  2680.  
  2681.     At this point, COM-AND takes over the transfer.  With the exception
  2682.     of ASCII transfers, the sequence is usually:
  2683.  
  2684.     o    Synchronize with the host
  2685.     o    Negotiate parameters for the transfer
  2686.     o    Transfer a file or files
  2687.     o    Report error or completion of transfer
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694. Version 2.8: 910716
  2695.  
  2696. COM-AND: IBM PC Communications and Accessories                 Page  43
  2697.  
  2698.  
  2699. XIII.    File Transfer (continued)
  2700.  
  2701.  
  2702.     COM-AND displays an estimate of the time required for the transfer
  2703.     (for downloads the estimate is for 30K chunks, unless the protocol
  2704.     provides the true file size).  The transfer rate (in terms of bytes
  2705.     per second actually delivered) and efficiency (in terms of percent of
  2706.     maximum linespeed) is computed and displayed every few seconds.
  2707.  
  2708.  
  2709.     The download statistics window displays:
  2710.  
  2711.     . the file name of the file being transferred,
  2712.     . the method
  2713.     . the time so far,
  2714.     . the file size so far,
  2715.     . the number of blocks received,
  2716.     . the number of errors encountered,
  2717.     . a description of the last error encountered.
  2718.     . an estimate for the transfer time (to the nearest 30K interval,
  2719.       unless the protocol supplies the true file size)
  2720.     . and the efficiency of the transfer (percent linespeed)
  2721.  
  2722.  
  2723.     The upload statistics window displays:
  2724.  
  2725.     . the file name of the file being transferred,
  2726.     . its size,
  2727.     . the method
  2728.     . the number of blocks being transferred,
  2729.     . the time so far,
  2730.     . the number of blocks sent,
  2731.     . if windowing the current 'window' size
  2732.     . the number of errors encountered,
  2733.     . a description of the last error encountered.
  2734.     . an estimate for the transfer time
  2735.     . and the efficiency of the transfer (percent linespeed)
  2736.  
  2737.  
  2738.     During file transfers, cursor keys may be used to position the
  2739.     statistics window on the screen.  If the window does not move
  2740.     immediately, wait a moment;  remember that characters are coming
  2741.     in rather quickly.
  2742.  
  2743.     ----------------------------------------------------------------
  2744.     Protocols are not available through accessory programs.
  2745.     ----------------------------------------------------------------
  2746.  
  2747.  
  2748.  
  2749. Version 2.8: 910716
  2750.  
  2751. COM-AND: IBM PC Communications and Accessories                 Page  44
  2752.  
  2753.  
  2754. XIII.    File Transfer (continued)
  2755.  
  2756.  
  2757.     A. XMODEM Up/Download
  2758.  
  2759.  
  2760.        Files may be transferred to/from a system that accepts checksum,
  2761.        CRC, or Windowed XMODEM, using COM-AND.
  2762.  
  2763.        When you request XMODEM upload, you are asked for a file.  Once
  2764.        the file's existence has been assured, COM-AND begins protocol
  2765.        negotiation with the host system.  One of the possible protocols
  2766.        will be negotiated, according to your choice and the host's
  2767.        implementation.  Up to 60 seconds are allowed for the negotiation.
  2768.        If that time is exceeded, the transfer fails.  You may restart it,
  2769.        of course.
  2770.  
  2771.        When you request XMODEM download, you are asked for a file name.
  2772.        Once the file has been created (you will be queried for a purge if
  2773.        it already exists), COM-AND begins protocol negotiation with
  2774.        the host system.  One of the possible protocols will be negotiated
  2775.        according to your choice and to the host's implementation.  COM-
  2776.        AND drops through WXMODEM after 24 seconds.    COM-AND drops through
  2777.        CRC XMODEM after 24 seconds.  If the host does not acknowledge CRC
  2778.        XMODEM, then finally, CHECKSUM is requested.  Up to 100 seconds
  2779.        are allowed for the negotiation.  If that time is exceeded, the
  2780.        transfer fails.  You may restart it, of course.
  2781.  
  2782.        COM-AND is intended primarily for users of networks and services
  2783.        available through the networks.  For this reason, COM-AND
  2784.        implements what is referred to as "relaxed XMODEM".  The networks
  2785.        introduce timing delays into file transfers that the original
  2786.        XMODEM standard did not contemplate.  However, the relaxed XMODEM
  2787.        works quite well with BBS's that expect strict XMODEM.
  2788.  
  2789.  
  2790.        Because COM-AND is intended for a network environment, a new
  2791.        XMODEM variant:  Windowed XMODEM or WXMODEM is implemented.
  2792.        WXMODEM was designed to accommodate network delays and maximize
  2793.        performance.  It also accomodates network flow control (XON/XOFF).
  2794.        WXMODEM gives approximately 35% faster transfer rates in network
  2795.        environments.  For details about WXMODEM refer to Appendix D.
  2796.  
  2797.        COM-AND changes the communications parameters to 8 data bits, no
  2798.        parity, and 1 stop bit when XMODEM begins.  It restores settings
  2799.        to their original state after XMODEM completes.
  2800.  
  2801.  
  2802.  
  2803.  
  2804. Version 2.8: 910716
  2805.  
  2806. COM-AND: IBM PC Communications and Accessories                 Page  45
  2807.  
  2808.  
  2809. XIII.    File Transfer (continued)
  2810.  
  2811.  
  2812.     B. YMODEM Up/Download (BBS YMODEM and Batch YMODEM/YMODEM-G)
  2813.  
  2814.  
  2815.        Files are transmitted/received using one of several YMODEMs:
  2816.  
  2817.        .  simple YMODEM (Bulletin Board YMODEM, also known as XMODEM1K,
  2818.           different from True YMODEM (tm))
  2819.        .  Batch YMODEM (properly named "True YMODEM (tm)")
  2820.        .  Batch YMODEM-G (a streaming version for special connections)
  2821.  
  2822.        When one of the YMODEM uploads is selected, you are asked for a
  2823.        file (or in the case of Batch YMODEM and YMODEM-G, a wildcard
  2824.        template).  Once the file's existence has been assured, COM-AND
  2825.        begins protocol negotiation with the host system.  Up to 60
  2826.        seconds are allowed for the negotiation.  If that time is
  2827.        exceeded, the transfer fails.  You may restart it, of course.
  2828.  
  2829.        When a simple YMODEM/XMODEM1k download is selected, you are asked
  2830.        for a file name.  Once the file has been created (you will be
  2831.        queried for a purge if it already exists), COM-AND begins proto-
  2832.        col negotiation with the host system.  Up to 60 seconds are
  2833.        allowed for the negotiation.  If that time is exceeded, the trans-
  2834.        fer fails.  You may restart it, of course.
  2835.  
  2836.        When a Batch YMODEM or YMODEM-G download is selected, you will NOT
  2837.        be asked for a file name.  The host supplies the name(s).  For
  2838.        this reason, if the supplied name duplicates one on your default
  2839.        download subdirectory, the file name will have its last character
  2840.        (usually the extension) changed to '$'.
  2841.  
  2842.        YMODEM (in all its variants) is more efficient in a networked
  2843.        environment than simple XMODEMs (CRC and checksum) simply because
  2844.        it transfers longer blocks of data at a time.  However, YMODEM is
  2845.        subject to the same problems (lack of flow control, for one) that
  2846.        XMODEM users know well in networked environments.
  2847.  
  2848.        Variations on YMODEM abound.  The various namings of this protocol
  2849.        proliferate; even YMODEM's developer has changed his naming of the
  2850.        protocol; thus COM-AND uses the most common names (and the name
  2851.        given it by the developer in its original specification).
  2852.  
  2853.        COM-AND changes the communications parameters to 8 data bits, no
  2854.        parity, and 1 stop bit when any YMODEM begins.  It restores
  2855.        settings to their original state after YMODEM completes.
  2856.  
  2857.  
  2858.  
  2859. Version 2.8: 910716
  2860.  
  2861. COM-AND: IBM PC Communications and Accessories                 Page  46
  2862.  
  2863.  
  2864. XIII.    File Transfer (continued)
  2865.  
  2866.  
  2867.     C. ZMODEM Up/Download
  2868.  
  2869.  
  2870.        When ZMODEM upload commences, a wildcard template is requested
  2871.        (for example, FILE*.ASM).  Once the (first) file's existence has
  2872.        been assured, COM-AND begins protocol negotiation with the host
  2873.        system.  Up to 60 seconds are allowed for the negotiation.  If
  2874.        that time is exceeded, the transfer fails.
  2875.  
  2876.        COM-AND detects and automatically begins ZMODEM receive when the
  2877.        'auto' option of Alt-O is enabled.  If this option is disabled,
  2878.        the ZMODEM receive must be manually started.
  2879.  
  2880.        When a ZMODEM download begins, you will NOT be asked for a file.
  2881.        The host supplies the name(s).  ZMODEM defines a recovery mode
  2882.        (which is enabled/disabled through Alt-O).  When recovery is
  2883.        disabled, and the supplied name duplicates one on the default
  2884.        download subdirectory, the file name will have its last character
  2885.        (usually the extension) changed to '$'.  When recovery is enabled,
  2886.        and the name supplied duplicates one on the default download sub-
  2887.        directory, the transfer begins at the old end-of-file.  Presum-
  2888.        ably, the file is there as the result of a failed transfer.
  2889.  
  2890.        On download, once the file has been created (or opened if recover-
  2891.        ing) COM-AND begins protocol negotiation with the host system.  Up
  2892.        to 60 seconds are allowed for the negotiation.  If that time is
  2893.        exceeded, the transfer fails.  You may restart it, of course.
  2894.  
  2895.  
  2896.        ZMODEM is more efficient in a networked environment than XMODEM
  2897.        (CRC and checksum) for several reasons.  First, ZMODEM transfers
  2898.        longer blocks of data at a time (up to 1024 byte blocks).  Second,
  2899.        ZMODEM was designed to accomodate software flow control (XON/XOFF)
  2900.        as used by many hosts and networks.    Third, ZMODEM sends contin-
  2901.        uously, until the receiver detects an error (streaming).
  2902.  
  2903.        COM-AND does not implement some of the 'management' and 'trans-
  2904.        port' options intended for batch and automatic operation.  COM-AND
  2905.        does not implement ZMODEM fall-back to YMODEM or XMODEM either.
  2906.  
  2907.        COM-AND changes the communications parameters to 8 data bits, no
  2908.        parity, and 1 stop bit when ZMODEM begins, and enables soft flow
  2909.        control.  It restores settings to their original state after
  2910.        ZMODEM completes.
  2911.  
  2912.  
  2913.  
  2914. Version 2.8: 910716
  2915.  
  2916. COM-AND: IBM PC Communications and Accessories                 Page  47
  2917.  
  2918.  
  2919. XIII.    File Transfer (continued)
  2920.  
  2921.  
  2922.     D. KERMIT Up/Download
  2923.  
  2924.        The KERMIT protocol was developed at Columbia University and has
  2925.        been very popular at many computer sites.  Files may be trans-
  2926.        ferred to and from a system that accepts KERMIT or Super KERMIT,
  2927.        using COM-AND.
  2928.  
  2929.        When you request KERMIT upload, you are asked for a file template
  2930.        (e.g.  *.EXE).  Once the first file's existence has been assured,
  2931.        COM-AND begins protocol negotiation with the host system.  Up to
  2932.        60 seconds are allowed for the negotiation.    If that time is
  2933.        exceeded, the transfer fails.  You may restart it, of course.
  2934.  
  2935.        When you request KERMIT download, you will NOT be asked for a
  2936.        file name.  The host supplies the name.  For this reason, if the
  2937.        supplied name duplicates one on your default download subdir-
  2938.        ectory, the file name will have its last character (usually the
  2939.        extension) changed to '$'.  Once the file has been created,
  2940.        COM-AND begins protocol negotiation with the host system.  Up
  2941.        to 60 seconds are allowed for the negotiation.  If that time is
  2942.        exceeded, the transfer fails.  You may restart it, of course.
  2943.  
  2944.  
  2945.        KERMIT has grown in many directions over the years.    Originally
  2946.        it was a 7-bit protocol.  Extensions were added to accomodate
  2947.        8-bit data, and to negotiate the 'width' (7 or 8 bits) of the
  2948.        transfer.  Extensions have been added to support a simple data
  2949.        compression method (run length encoding).  Extensions have been
  2950.        added to accomodate windowing (called Super KERMIT).
  2951.  
  2952.        COM-AND supports all KERMIT facilities through the windowing
  2953.        extensions.    COM-AND will negotiate window lengths of up to 8.
  2954.        COM-AND does not support the (later) large block size extension.
  2955.  
  2956.        COM-AND will attempt to negotiate an 8 bit data path if you have
  2957.        set your comm parameters 8N1.  COM-AND does not (now) change
  2958.        parity and data bits settings for the transfer.
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.  
  2969. Version 2.8: 910716
  2970.  
  2971. COM-AND: IBM PC Communications and Accessories                 Page  48
  2972.  
  2973.  
  2974. XIII.    File Transfer (continued)
  2975.  
  2976.  
  2977.     E. CIS-B and Quick-B/B+ Up/download
  2978.  
  2979.  
  2980.        The CIS-B protocol was developed at CompuServe and is their
  2981.        protocol 'of choice'.  Files may be transferred to and from
  2982.        CompuServe (CIS) using COM-AND.
  2983.  
  2984.        When you initiate CIS-B on CIS either sending or receiving), you
  2985.        tell CIS the name of the file to be transferred to/from your PC.
  2986.        CIS will then instruct COM-AND to open that file.  Once the file's
  2987.        existence has been assured, COM-AND begins protocol negotiation
  2988.        with CIS.  Up to 60 seconds are allowed for the negotiation.  If
  2989.        that time is exceeded, the transfer fails.  You may restart it,
  2990.        of course.
  2991.  
  2992.        When using VIDTEX emulation in COM-AND, it is not necessary to
  2993.        manually select PgUp/PgDn to send and receive files.  COM-AND
  2994.        recognizes CIS's instructions to begin a protocol transfer once
  2995.        you have instructed CIS as to the transfer under this emulation.
  2996.  
  2997.  
  2998.        A variant of CIS-B known as Quick-B (B+) is also available in
  2999.        COM-AND.  Quick-B supports limited windowing and larger block
  3000.        lengths.  It also changes the quoting mechanism to optimize binary
  3001.        transfer.  Both CIS-B and Quick-B (B+) are available.
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024. Version 2.8: 910716
  3025.  
  3026. COM-AND: IBM PC Communications and Accessories                 Page  49
  3027.  
  3028.  
  3029. XIII.    File Transfer (continued)
  3030.  
  3031.  
  3032.     F. ASCII Upload (PgUp, and F5)
  3033.  
  3034.  
  3035.        Files may be transferred to a system using a simple 'send' (as
  3036.        if entered by hand).  When ASCII upload is requested, you are
  3037.        prompted for a file name.  Once the file has been opened, you
  3038.        are prompted with a small menu with various options:
  3039.  
  3040.        .  Host prompting
  3041.  
  3042.           Transfer may occur in one of two ways:
  3043.  
  3044.           1) with a prompt from the host (some special character) or
  3045.           2) without a host prompt for every line.
  3046.  
  3047.           If 'Host prompting' is set 'On', you will be asked for the
  3048.           prompt character (either an ASCII or a control character).
  3049.           The prompt character is entered as you see it, unless it is
  3050.           a control character (e.g.  enter ^J for a line feed).
  3051.  
  3052.        .  Send linefeeds
  3053.  
  3054.           Line feeds may be suppressed during the transmission.  ASCII
  3055.           text files contain line feeds that you (usually) do not send.
  3056.  
  3057.        .  Expand tabs
  3058.  
  3059.           Similarly, tab characters may or may not be expanded during the
  3060.           transmission.  ASCII text files contain tabs that you (usually)
  3061.           want to expand before transmission.
  3062.  
  3063.        .  Stop at control-z
  3064.  
  3065.           You may specify that the transfer is to terminate when an
  3066.           an end-of-file character (control-Z) is encountered.  This is
  3067.           the case in most ASCII files.
  3068.  
  3069.        .  Respect XON/XOFF
  3070.  
  3071.           ASCII upload uses the default XON/XOFF setting established
  3072.           through Alt-O.  You may change the setting here temporarily for
  3073.           the transfer here.
  3074.  
  3075.  
  3076.  
  3077.  
  3078.  
  3079. Version 2.8: 910716
  3080.  
  3081. COM-AND: IBM PC Communications and Accessories                 Page  50
  3082.  
  3083.  
  3084. XIII.    File Transfer (continued)
  3085.  
  3086.  
  3087.     F. ASCII Upload (continued)
  3088.  
  3089.  
  3090.        .  Expand blank lines
  3091.  
  3092.           You may choose to expand null lines to a blank line.  This is
  3093.           convenient on some BBS's.
  3094.  
  3095.        .  Line pacing
  3096.  
  3097.           You may choose to send lines of text with fixed delays between
  3098.           lines.  This is needed on some systems.  You may set the delay
  3099.           in intervals of 1/10th of a second.
  3100.  
  3101.  
  3102.        Transfer is, in all cases, paced (timed).  Transmission begins at
  3103.        maximum speed.  You may alter the pacing with the Ctl-PgUp and
  3104.        Ctl-PgDn keys during the transmission.  Ctl-Home will increase
  3105.        the speed to its maximum.  Ctl-End decreases the transmission
  3106.        speed to its minimum.  ESC or F1-F10 will terminate the send.
  3107.  
  3108.  
  3109.        The ASCII send function in COM-AND responds to XON/XOFF sequences
  3110.        transmitted by the host (if this feature is enabled).  When an
  3111.        XOFF is received, COM-AND waits up to 30 seconds for a subsequent
  3112.        XON to be received.    Transmission is suspended while COM-AND
  3113.        waits.  Transmission resumes after 30 seconds, or after COM-AND
  3114.        receives an XON.
  3115.  
  3116.  
  3117.  
  3118.        ----------------------------------------------------------------
  3119.        NOTE: When host prompting is specified, the first line is sent and
  3120.        then COM-AND waits for a host prompt.  Should the prompt from the
  3121.        the host be lost (inadvertently, of course), the left arrow key
  3122.        (or function key (F1-F10)) will send the next line.
  3123.        ----------------------------------------------------------------
  3124.        NOTE: When host prompting is specified, COM-AND 'looks ahead' in
  3125.        the file being transmitted.    COM-AND does not wait for a prompt
  3126.        when end-of-file follows after the last carriage return (and
  3127.        linefeed if linefeeds aren't being transmitted).
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134. Version 2.8: 910716
  3135.  
  3136. COM-AND: IBM PC Communications and Accessories                 Page  51
  3137.  
  3138.  
  3139. XIII.    File Transfer (continued)
  3140.  
  3141.  
  3142.     F. ASCII Upload (continued)
  3143.  
  3144.  
  3145.        ----------------------------------------------------------------
  3146.        NOTE: When stop-on-control-z is specified, COM-AND transmits
  3147.        a carriage return on end-of-file (if a carriage return was not
  3148.        the last character transmitted).
  3149.        ----------------------------------------------------------------
  3150.        NOTE: The percent transmitted will be incorrect when the file
  3151.        being transmitted is small (less than 1000 bytes).  Don't be
  3152.        surprised.  I was.  Sorry 'bout that.
  3153.  
  3154.  
  3155.     G. ASCII Download (PgDn, and F6)
  3156.  
  3157.  
  3158.        ASCII downloads differ from transcripting in that no extra
  3159.        characters are added to the file (e.g.  line feeds after received
  3160.        carriage returns, and end-of-file are added when transcripting).
  3161.        Transcripting is intended to result in an ASCII edit file (or a
  3162.        printed log).  ASCII downloads may implement binary transfers.
  3163.  
  3164.  
  3165.        XON/XOFF flow control is performed during an ASCII download
  3166.        according to the current Alt-O setting.
  3167.  
  3168.  
  3169.        Anything you type while the download function is being performed
  3170.        will be sent to the host system also.  ESC or F1-F10 terminates
  3171.        the receive function and closes the capture file.
  3172.  
  3173.  
  3174.        COM-AND special functions (macros, scripts etc) are not available
  3175.        during an ASCII receive.
  3176.  
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.  
  3188.  
  3189. Version 2.8: 910716
  3190.  
  3191. COM-AND: IBM PC Communications and Accessories                 Page  52
  3192.  
  3193.  
  3194. XIII.    File Transfer (continued)
  3195.  
  3196.  
  3197.     H. File directory (Alt-F)
  3198.  
  3199.  
  3200.        A directory of files on any legitimate disk may be requested with
  3201.        the Alt-F command.  A search mask is requested.  Enter one just as
  3202.        you would with the DIR command of DOS.  For example:
  3203.  
  3204.         D:*.TXT
  3205.  
  3206.        specifies all files with the extension "TXT" from the "D" drive.
  3207.        File names and modification dates are displayed, 20 at a time.
  3208.        When the list is exhausted, the amount of free space remaining on
  3209.        the specified drive is displayed.
  3210.  
  3211.  
  3212.        Should you wish a directory search of a subdirectory, you must
  3213.        enter a full file mask.  The mask:
  3214.  
  3215.         C:\TEMP
  3216.  
  3217.        specifies a search on the root directory for a file named TEMP
  3218.        with no extension.  If you wish to search the TEMP subdirectory
  3219.        of the root directory, enter:
  3220.  
  3221.         C:\TEMP\*.*
  3222.  
  3223.  
  3224.     I. Default download path (F4)
  3225.  
  3226.  
  3227.        All file receive functions of COM-AND write to a default path,
  3228.        unless the given file name is qualified (with a drive and/or
  3229.        path).  The default drive:path is set through the F4 function.
  3230.  
  3231.  
  3232.        Please note that this setting is automatically saved for the next
  3233.        use of COM-AND.  No "do you wish to save this setting" prompt is
  3234.        used here; the setting is permanent until next changed.
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.  
  3244. Version 2.8: 910716
  3245.  
  3246. COM-AND: IBM PC Communications and Accessories                 Page  53
  3247.  
  3248.  
  3249. XIV.    Logging and Call-logging
  3250.  
  3251.  
  3252.     COM-AND supports two methods of logging activity for later review.
  3253.     The two methods are transcripting and call-logging.  The transcript
  3254.     records every character of received text... the call-log records
  3255.     calls made through the dialing directory, hangups, carrier dropouts,
  3256.     file transfers, accessory programs, and file encryption/decryption.
  3257.  
  3258.  
  3259.     Generally speaking, the transcript function is invoked when you wish
  3260.     an exact record of everything you've seen (COM-AND even allows you
  3261.     to transcript text seen BEFORE transcripting is turned on).  It is
  3262.     not used all the time.    The call-log is enabled once, and left to
  3263.     record all system activity.
  3264.  
  3265.  
  3266.     A transcript is an ASCII file recording all text you captured.    The
  3267.     only discussion of its contents needed is to point out that COM-AND
  3268.     marks the time of transcript start and end, unless you direct other-
  3269.     wise (through Alt-O, transcript marking).
  3270.  
  3271.  
  3272.     The call-log, however, requires some further discussion.  The call-
  3273.     log is an ASCII file too.  The call-log contents are fixed in format.
  3274.     An example of such a log might be:
  3275.  
  3276.          COM-AND loaded
  3277.          CONNECT: CIS 2400 (chicago)   2400,E,7,1,COM2;ATDT263-5636
  3278.          Dnl BAROQUE.BAS 7552 ( 0:00:32)    98.3% QuickB       0 errs
  3279.          DISCONNECT ( 0:02:33)
  3280.          CONNECT: Source (Chi) C S15   1200,N,8,1,COM2;ATDT938-0600
  3281.          Dnl YES.BAS     2008 ( 0:00:27)    64.3% Super KERMIT 1 errs
  3282.          DISCONNECT ( 0:04:57)
  3283.          CONNECT: Scintillation        2400,N,8,1,COM2;ATDT953-4922
  3284.          Dnl MAZE.ARC    34816 ( 0:02:36)    92.9% YMODEM (chk) 0 errs
  3285.          CARRIER dropped: ( 0:06:02)
  3286.          COM-AND exited ( 0:14:57)
  3287.          COM-AND loaded
  3288.          * Annotation line entered through Alt-U
  3289.          * I'm going to encrypt/decrypt a file for demonstration
  3290.          ENCRYPT:  COM-AND.EXE     to ENCRFILE      154567 ( 0:00:17)
  3291.          DECRYPT:  ENCRFILE     to DECRFILE      154568 ( 0:00:11)
  3292.          COM-AND exited ( 0:02:33)
  3293.          ACCESSORY: PC-VCO Maug mode:        PC-VCO.EXE /2/m/s
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299. Version 2.8: 910716
  3300.  
  3301. COM-AND: IBM PC Communications and Accessories                 Page  54
  3302.  
  3303.  
  3304. XIV.    Logging and Call-logging (continued)
  3305.  
  3306.  
  3307.     In the above example, the timestamp from each line has been removed
  3308.     to make it more easily read in document form.  Each line of the
  3309.     call-log is discussed below.
  3310.  
  3311.     o  COM-AND loaded
  3312.  
  3313.        The "COM-AND loaded" line is issued to timestamp the time COM-AND
  3314.        was invoked from DOS.  This is only logged, of course, when call-
  3315.        logging had been previously enabled.
  3316.  
  3317.     o  CONNECT: <name>            <commparms>    ;<dialing string>
  3318.  
  3319.        The "CONNECT" line is logged when a connection has been made
  3320.        through the dialing directory (Alt-D, Alt-R, and script DIAL and
  3321.        MANUAL commands).  <Name> is taken from the dialing directory.
  3322.        <Commparms> record the current setting and port after connection.
  3323.        <Dialing string> records the dialing sequence passed the modem.
  3324.  
  3325.     o  Dnl <file name>   <size>    <time>     <eff>% <method>  <errs>
  3326.        Upl <file name>   <size>    <time>     <eff>% <method>  <errs>
  3327.  
  3328.        The "Dnl" and "Upl" lines record downloads and uploads (performed
  3329.        through PgDn, PgUp keys, and script GETFILE, SENDFILE commands).
  3330.        <Size>, <time>, <eff>, <errs> and <method> record the file size,
  3331.        transfer time, efficiency of transfer, count of errors, and method
  3332.        used (XMODEM, CISB etc).  Errored transfers are also recorded,
  3333.        with "error = nnn" in place of <size><time><eff%>.  COM-AND error
  3334.        numbers are listed in an appendix of the document CASCRIPT.DOC.
  3335.  
  3336.        Note that ASCII file transfers are not call-logged.
  3337.  
  3338.     o  DISCONNECT (<time>)
  3339.  
  3340.        The "DISCONNECT" line records a manual hangup (Alt-H).  If a
  3341.        connection is known, the time since the connection was made is
  3342.        recorded.
  3343.  
  3344.     o  CARRIER dropped: (<time>)
  3345.  
  3346.        The "CARRIER dropped" line records a loss of carrier when a
  3347.        connection is known.  The time since the connection was made is
  3348.        recorded.
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354. Version 2.8: 910716
  3355.  
  3356. COM-AND: IBM PC Communications and Accessories                 Page  55
  3357.  
  3358.  
  3359. XIV.    Logging and Call-logging (continued)
  3360.  
  3361.  
  3362.     o  * <annotation>
  3363.  
  3364.        Annotation lines (added through Alt-U) are delimited with
  3365.        asterisks (note that lines written to the call-log through the
  3366.        script CLOG statement are not necessarily delimited).
  3367.  
  3368.     o  ENCRYPT:  <fromfile>    to <tofile>        <size> (<time>)
  3369.        DECRYPT:  <fromfile>    to <tofile>        <size> (<time>)
  3370.  
  3371.        The "ENCRYPT" and "DECRYPT" lines record successful file encryp-
  3372.        tion and decryption (Alt-N and script ENCRYPT, DECRYPT commands).
  3373.        <Fromfile>, <tofile>, <Size>, and <time> record the files used,
  3374.        file size, and processing time.  Errored encryption and decryption
  3375.        attempts are not recorded.
  3376.  
  3377.     o  COM-AND exited (<time>)
  3378.  
  3379.        The "COM-AND exited" line is issued to timestamp the time COM-AND
  3380.        terminated.    The total time COM-AND was in use is recorded.
  3381.  
  3382.     o  COM-AND exited (CONNECT=<time>) (<time>)
  3383.  
  3384.        This form of the "COM-AND exited" line is issued to timestamp the
  3385.        time COM-AND terminated, when a connection is known.  The time
  3386.        since the connection was made is recorded as well as the total
  3387.        time COM-AND was in use is recorded.
  3388.  
  3389.     o  ACCESSORY: <F1 menu name> <program invocation>
  3390.  
  3391.        The "ACCESSORY" lines record a program loaded by COM-AND through
  3392.        the F1 Accessory menu (accessory entries which do not load a pro-
  3393.        gram are not recorded).  The entry name and the program invoca-
  3394.        tion are logged.  Accessory terminations and process creation
  3395.        errors are not logged.  Accessories that are simply script files
  3396.        are not logged.
  3397.  
  3398.     Keyboard commands relating to logging and call-logging follow on the
  3399.     next page.
  3400.  
  3401.  
  3402.  
  3403.  
  3404.  
  3405.  
  3406.  
  3407.  
  3408.  
  3409. Version 2.8: 910716
  3410.  
  3411. COM-AND: IBM PC Communications and Accessories                 Page  56
  3412.  
  3413.  
  3414. XIV.    Logging and Call-logging (continued)
  3415.  
  3416.  
  3417.     A. Disk logging [transcripting] (F7)
  3418.  
  3419.        You may transcript what you receive to a disk (or PRN) with the
  3420.        "Disk logging" function.  The transcript will be marked with the
  3421.        date and time it began and ended if transcript marking is set on
  3422.        through the Alt-O screen.
  3423.  
  3424.        COM-AND keeps the last characters received in a buffer for back-
  3425.        screen (or redisplay).  The size of the buffer is adjustable
  3426.        through Alt-S.  When you invoke transcripting, you will be asked
  3427.        if the backscreen is to be saved first.  If you respond "Y", the
  3428.        backscreen will be written to the transcript file before the
  3429.        "BEGIN" mark (if marking is enabled).  F7 is a toggle (press it
  3430.        a second time to terminate logging.
  3431.  
  3432.  
  3433.     B. Log hold [transcripting] (F9)
  3434.  
  3435.        The transcript may be suspended with the F9 toggle.    The logging
  3436.        status is displayed on the status line (if KBD buffer hasn't been
  3437.        enabled).  When the log is held, what is received is not copied to
  3438.        the transcript.  No mark is made to show that the transcript was
  3439.        held.  This key is a toggle (press it again to resume logging).
  3440.  
  3441.  
  3442.     C. Annotate call-log (Alt-U)
  3443.  
  3444.        Notes may be made directly to the call-log (not the transcript).
  3445.        When Alt-U is pressed, COM-AND tests to determine if the call-log
  3446.        if active.  If it is not active you will be asked if you wish to
  3447.        open a call-log.  However, the call-log will be closed when you
  3448.        exit COM-AND and not reopened the next time, unless you save the
  3449.        option through Alt-O.
  3450.  
  3451.        The Alt-U window allows you to enter a line at a time to the call-
  3452.        log.  Each line will be delimited with an asterisk ("*") in the
  3453.        call-log.  When you press <cr>, the line is written to the
  3454.        call-log.  The last three lines so entered are displayed for
  3455.        convenience.
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.  
  3463.  
  3464. Version 2.8: 910716
  3465.  
  3466. COM-AND: IBM PC Communications and Accessories                 Page  57
  3467.  
  3468.  
  3469. XV.    Miscellaneous Functions
  3470.  
  3471.  
  3472.     A. Default Drive:Subdirectory (F3)
  3473.  
  3474.        You may change the default drive:subdirectory at any time through
  3475.        the F3 window.  This affects files uploaded but not files down-
  3476.        loaded (see File Transfers).  When the program terminates, you
  3477.        will be left on the selected drive:path.
  3478.  
  3479.     B. Keyboard display (F8)
  3480.  
  3481.        Some talk systems are more friendly when what you type is not
  3482.        mixed in with what you receive.  Turning echo off (if the system
  3483.        echoes key-entry) may be accomplished in a number of ways (note
  3484.        that this is different from program echo, Alt-E, above).
  3485.  
  3486.        However, all of a sudden there is a new problem: you don't see
  3487.        what you're typing!  Keyboard display in COM-AND is one attempt
  3488.        to solve this problem.  What you type will be displayed on the
  3489.        status line when keyboard display is turned on.
  3490.  
  3491.        Keyboard display may be set on permanently through the Alt-O
  3492.        options window.
  3493.  
  3494.     C. Chat mode (Alt-A)
  3495.  
  3496.        Chat mode is another attempt to make typing more friendly when
  3497.        what you type isn't echoed by the host.  A 'chat window' of 2-10
  3498.        lines may be opened just above the status line.  The last few
  3499.        lines you've typed are displayed there.
  3500.  
  3501.        Chat mode may be set on permanently through the Alt-O options
  3502.        window.
  3503.  
  3504.     D. Redisplay [backscreen] (Alt-B)
  3505.  
  3506.        COM-AND saves lines scrolled 'off' the screen for redisplay (up to
  3507.        the buffer size set through Alt-S).    When you request redisplay,
  3508.        the screen is 'frozen' (as the last page of the backscreen).  You
  3509.        may page backwards and forwards using the 'PgUp', and 'PgDn' keys.
  3510.  
  3511.        The 'Home' key will find the first page of the redisplay.  The
  3512.        'End' key will find the last page of the redisplay.  Exit redis-
  3513.        play with the ESC key.
  3514.  
  3515.  
  3516.  
  3517.  
  3518.  
  3519. Version 2.8: 910716
  3520.  
  3521. COM-AND: IBM PC Communications and Accessories                 Page  58
  3522.  
  3523.  
  3524. XV.    Miscellaneous Functions (continued)
  3525.  
  3526.  
  3527.     E. Clear Screen (Alt-C and received TOF)
  3528.  
  3529.        The command Alt-C entered at the keyboard will clear the screen.
  3530.        Similarly, when the host sends a control-L (^L or decimal 12) the
  3531.        screen is cleared.
  3532.  
  3533.     F. Echo (Alt-E)
  3534.  
  3535.        COM-AND writes keypresses directly through the COM port.  Some
  3536.        services turn around what is sent so that it is visible (full
  3537.        duplex or echoplex) and some don't (half duplex).  You may force
  3538.        COM-AND to display what you enter in the CRT window by toggling
  3539.        echo.  Setting echo on through the Alt-O window will turn echo on
  3540.        now, and the next time you run COM-AND.
  3541.  
  3542.        Echo is set through the dialing directory and permanently through
  3543.        the Alt-O options window.  The dialing directory overrides this,
  3544.        of course.
  3545.  
  3546.     G. Blank line suppression (Alt-G)
  3547.  
  3548.        Blank lines may be suppressed from the display if you wish.    This
  3549.        is especially useful where double spacing is done in a conference
  3550.        area.
  3551.  
  3552.        Blank line suppression may be set permanently through the Alt-O
  3553.        options window.
  3554.  
  3555.     H. 43/25 line toggle (Alt-L)
  3556.  
  3557.        If you have an EGA adapter, you may have 43 line screen displays.
  3558.        If you enter COM-AND from a 43 line screen, COM-AND automatically
  3559.        displays in 43 line mode.  Alt-L may be used to toggle 25 line/43
  3560.        line modes during COM-AND.
  3561.  
  3562.        Do not use Alt-L during VIDTEX sessions on CIS.  CIS will not use
  3563.        the new setting.
  3564.  
  3565.     I. Kermit parameters (Alt-K)
  3566.  
  3567.        The parameters that COM-AND will use during the KERMIT negoti-
  3568.        ation may be changed and saved using the Alt-K menu.  It is not
  3569.        recommended that you change these values unless you understand
  3570.        their meaning completely.  The supplied defaults are suitable for
  3571.        most KERMIT installations.
  3572.  
  3573.  
  3574. Version 2.8: 910716
  3575.  
  3576. COM-AND: IBM PC Communications and Accessories                 Page  59
  3577.  
  3578.  
  3579. XV.    Miscellaneous Functions (continued)
  3580.  
  3581.  
  3582.     J. Time and alarms (Alt-T)
  3583.  
  3584.        The time elapsed since the program was started, and since the
  3585.        last Alt-D dialing command or Alt-R is displayed through the
  3586.        Alt-T window.  The 'last call' time may be reset (if you are
  3587.        actually connected) manually here (or through a script).  An
  3588.        alarm may also be set here, either for the single session or
  3589.        permanently (every time you use COM-AND).  When the alarm is
  3590.        triggered, a pop-up window and noise announce the fact.
  3591.  
  3592.     K. Playback (Alt-W)
  3593.  
  3594.        You may display the contents of a file in the CRT area with the
  3595.        Alt-W Playback command.  You will be asked for a file name.    The
  3596.        contents of the given file will be written to the text area as if
  3597.        the text were being received.
  3598.  
  3599.        Playback is paced (timed).  It begins at minimum speed.  Alter
  3600.        the pacing with the Ctl-PgUp and Ctl-PgDn keys.  Pause the
  3601.        playback with the space bar.  Cancel the display with ESC.
  3602.  
  3603.     L. Program termination (Alt-X)
  3604.  
  3605.        COM-AND is exited (and returns to DOS) through the Alt-X command.
  3606.        The usual query "are you sure" is issued if "Exit query" is
  3607.        turned on with the Alt-O selection.
  3608.  
  3609.        When you exit COM-AND, unless you ran COM-AND with the /P switch
  3610.        (piggyback), you will be queried if a hangup is to be performed if
  3611.        carrier is still reported by the modem.  [If piggyback was set,
  3612.        you will not be queried.]
  3613.  
  3614.        NOTE:  a script may override the Alt-X function.  When a script
  3615.        has done this, after Alt-X is pressed (and after the hangup query
  3616.        if it is needed) a new script may start!
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.  
  3627.  
  3628.  
  3629. Version 2.8: 910716
  3630.  
  3631. COM-AND: IBM PC Communications and Accessories                 Page  60
  3632.  
  3633.  
  3634. XV.    Miscellaneous Functions (continued)
  3635.  
  3636.  
  3637.     M. Parity (hi-bit) mask (Alt-Z)
  3638.  
  3639.        You may mask parity from every received character by setting
  3640.        the parity mask on permanently through the Alt-O window.  I've
  3641.        found this to be useful, mandatory when I've needed it.
  3642.  
  3643.        Some services require you to logon with 8 data bits, no parity, if
  3644.        you intend to download (or upload files).  When there is an X.25
  3645.        network between your PC and the service, certain characters (such
  3646.        as backspace may be transmitted with parity on, regardless of your
  3647.        setting).  In these cases, parity masking is very nice to have.
  3648.  
  3649.        Toggle the current parity mask setting with Alt-Z.
  3650.  
  3651.  
  3652.  
  3653.  
  3654.  
  3655.  
  3656.  
  3657.  
  3658.  
  3659.  
  3660.  
  3661.  
  3662.  
  3663.  
  3664.  
  3665.  
  3666.  
  3667.  
  3668.  
  3669.  
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684. Version 2.8: 910716
  3685.  
  3686. COM-AND: IBM PC Communications and Accessories                 Page  61
  3687.  
  3688.  
  3689. XVI.    DOS Gateway (Alt-F10)
  3690.  
  3691.  
  3692.     COM-AND provides a gateway to a DOS shell through the Alt-F10 key.
  3693.     The DOS gateway requires a few preliminaries, however.
  3694.  
  3695.     .  There must be sufficient memory for the current DOS shell
  3696.        (COMMAND.COM usually), COM-AND, and a second DOS shell.  If there
  3697.        isn't, the Alt-F10 will be rejected for 'insufficient memory'.
  3698.  
  3699.     .  There should be an environment variable 'COMSPEC' that points to
  3700.        the DOS shell to be loaded by Alt-F10.  If this variable is
  3701.        missing (has been deleted), COMMAND.COM on the default drive,
  3702.        root directory will be used (if present).
  3703.  
  3704.  
  3705.     When the DOS gateway is entered, you will be able to execute any
  3706.     DOS function that the shell supports.  Memory available to that
  3707.     shell will be decreased by the presence of COM-AND still running.
  3708.  
  3709.  
  3710.     You return to COM-AND by exiting the DOS shell.  If the shell
  3711.     is COMMAND.COM, type the command 'EXIT' to return to COM-AND.
  3712.  
  3713.  
  3714.     ------------------------------------------------------------------
  3715.     NOTE:  In order to make full use of the DOS gateway, you must
  3716.     provide yourself with the capacity for more open files than the
  3717.     default.  The number of files that may be open at one time is
  3718.     increased by editing the file CONFIG.SYS on the root directory of
  3719.     your boot disk, adding (or changing) a line:  "FILES=n", where n
  3720.     is a number from 1 to 20.  At least 12 is recommended.    Refer to
  3721.     your DOS manual for particulars.
  3722.  
  3723.  
  3724.  
  3725.  
  3726.  
  3727.  
  3728.  
  3729.  
  3730.  
  3731.  
  3732.  
  3733.  
  3734.  
  3735.  
  3736.  
  3737.  
  3738.  
  3739. Version 2.8: 910716
  3740.  
  3741. COM-AND: IBM PC Communications and Accessories                 Page  62
  3742.  
  3743.  
  3744. XVII.    Emulation (Alt-V)
  3745.  
  3746.  
  3747.     COM-AND performs various terminal emulations.  COM-AND defines
  3748.     'terminal emulation' as three individual functions:
  3749.  
  3750.     o    Display emulations
  3751.     o    Translations of received and transmitted characters
  3752.     o    Keyboard remapping
  3753.  
  3754.     All three functions are controlled through the Alt-V menu.  However,
  3755.     translations and remapping require preparation external to COM-AND.
  3756.  
  3757.  
  3758.     A.  Display emulation
  3759.  
  3760.         COM-AND supplies five display emulations:  TTY, ANSI, VidTex,
  3761.         VT100, and VT52 in the current program.  Display emulations are
  3762.         selected through Alt-V.  The setting is enabled as soon is it
  3763.         selected.  Save the setting if COM-AND is to use the setting
  3764.         every time it is loaded.
  3765.  
  3766.         . TTY is appropriate for most BBSes and host systems.  What is
  3767.           received is displayed and what it typed is sent.
  3768.  
  3769.         . ANSI is appropriate for some BBSes and some host systems.
  3770.           The host is given considerable control over cursor positioning
  3771.           and display colors.  [Details of ANSI display sequences are
  3772.           discussed below in Appendix E.]
  3773.  
  3774.         . VidTex is appropriate only for the CompuServe (tm) system.
  3775.           The mode MUST be set before logging onto CompuServe if you
  3776.           wish to use this mode.  CompuServe does not allow you to
  3777.           change 'modes' after logging on.  [See Appendix F.]
  3778.  
  3779.         . VT100 and VT52 emulations are appropriate only for certain
  3780.           host systems and communications applications.  [Details of
  3781.           VT100/VT52 display sequences are discussed in Appendix E.]
  3782.  
  3783.  
  3784.         Display emulation in COM-AND only refers to COM-AND's response
  3785.         to certain control sequences received from the host.  Selection
  3786.         of a display emulation has no effect on character translation
  3787.         or on keyboard remapping.
  3788.  
  3789.         Character translation and keyboard remapping must be specified
  3790.         independently (see the following).
  3791.  
  3792.  
  3793.  
  3794. Version 2.8: 910716
  3795.  
  3796. COM-AND: IBM PC Communications and Accessories                 Page  63
  3797.  
  3798.  
  3799. XVII.    Emulation (continued)
  3800.  
  3801.  
  3802.     B. Translation
  3803.  
  3804.        COM-AND will translate characters both incoming and outgoing
  3805.        if you wish.  Characters are translated immediately upon receipt,
  3806.        and just before transmission, using two tables (one incoming and
  3807.        one for outgoing) supplied in the file COM-AND.XLT.
  3808.  
  3809.  
  3810.        When translation is enabled, the only cases where characters are
  3811.        NOT translated is within the binary protocols (XMODEM, YMODEM,
  3812.        KERMIT, and CIS-B), and when modem commands are issued.
  3813.  
  3814.  
  3815.        The file COM-AND.XLT is a binary file.  It must be supplied by
  3816.        you.  COM-AND.XLT consists of two tables:  each 256 bytes in
  3817.        size.  Within a table, the 'nth' byte contains the translation
  3818.        for the character of value 'n'.  Within the 'incoming' table, you
  3819.        are translating character with value 'n' received, to something
  3820.        else (hopefully ASCII).  Within the 'outgoing' table, you are
  3821.        translating a character (probably ASCII again, e.g. a keypress)
  3822.        of value 'n' into something else.
  3823.  
  3824.  
  3825.        On the incoming side, translating a character to a null
  3826.        effectively causes that character to be ignored by COM-AND.
  3827.  
  3828.  
  3829.        Obviously, the creation and maintenance of such a file is quite
  3830.        an effort.  It requires an ASCII table t'boot!  A script, XLATE.
  3831.        CMD is supplied to serve to format, display and edit the tables.
  3832.        You'll still need the ASCII table, however.  [Within the PC, all
  3833.        characters are treated as ASCII (as defined by IBM of course).]
  3834.  
  3835.  
  3836.        Translation is enabled and disabled through Alt-V (it may also be
  3837.        enabled or disabled through the XLATE.CMD script).  The table(s)
  3838.        may be edited at any time.  The new values are not used by
  3839.        COM-AND until translation is re-enabled (turned ON) after the
  3840.        changes were made.
  3841.  
  3842.  
  3843.  
  3844.  
  3845.  
  3846.  
  3847.  
  3848.  
  3849. Version 2.8: 910716
  3850.  
  3851. COM-AND: IBM PC Communications and Accessories                 Page  64
  3852.  
  3853.  
  3854. XVII.    Emulation (continued)
  3855.  
  3856.  
  3857.     C. Remapping
  3858.  
  3859.        To complete the overall function of 'emulation', COM-AND provides
  3860.        an internal 'keyboard remapping' function.  Remapping makes COM-
  3861.        AND see a keystroke as another keystroke or even a string of
  3862.        keys.  When a remapped key is pressed, COM-AND sees the key(s)
  3863.        that redefine it instead.
  3864.  
  3865.  
  3866.        Remaps allow the COM-AND to provide a keyboard similar to a ter-
  3867.        minal being emulated.  One immediate difficulty presents itself,
  3868.        however...  within COM-AND, certain keys have certain meanings
  3869.        (e.g.  F1 for a help screen, Alt-F10 for shell-to-DOS and so on).
  3870.        When you redefine a key that COM-AND uses, either some other key
  3871.        must be redefined to replace it or the function in COM-AND is
  3872.        lost while the remap is in effect.
  3873.  
  3874.  
  3875.        Remaps only affect actual keystrokes when pressed; they do not
  3876.        have any affect on characters within the binary protocols
  3877.        (XMODEM, YMODEM, KERMIT, and CIS-B), or script TRANSMIT text.
  3878.  
  3879.  
  3880.        Remaps are specified through a binary file, COM-AND.RMP.  It must
  3881.        be created outside of COM-AND.  COM-AND.RMP consists of one
  3882.        table, defining keys that are remapped and their new value(s).
  3883.  
  3884.  
  3885.        Needless to say:  the creation and maintenance of such a file is
  3886.        more effort than dealing with the translation tables!  A script,
  3887.        REMAP.CMD is supplied to create a suitable COM-AND.RMP file.
  3888.  
  3889.  
  3890.        REMAP.CMD compiles a simple language for remapping.    Keys (such
  3891.        as F1) are given 'names' (Function key F1 is 'F1').  A simple
  3892.        syntax is defined to redefine any key COM-AND can detect.
  3893.        REMAP.CMD expects a source file prepared with a text editor (like
  3894.        a script).  It compiles the source file into COM-AND.RMP.  Sample
  3895.        remaps (in source form) are provided in REMAPS.TXT.
  3896.  
  3897.  
  3898.        Remapping is enabled/disabled through Alt-V (also through the
  3899.        REMAP.CMD script and Alt-O).  The table may be reconstructed at
  3900.        any time; the new table is not used by COM-AND until remapping is
  3901.        enabled again (turned ON) after the changes were made.
  3902.  
  3903.  
  3904. Version 2.8: 910716
  3905.  
  3906. COM-AND: IBM PC Communications and Accessories                 Page  65
  3907.  
  3908.  
  3909. XVII.    Emulation (continued)
  3910.  
  3911.  
  3912.     D. Other related settings
  3913.  
  3914.        Two related settings are available through Alt-V.  They are:
  3915.  
  3916.        . Status Line ON/OFF
  3917.  
  3918.          The status line may be disabled through Alt-V, yielding the last
  3919.          line of the display for received text.  When the status line is
  3920.          disabled, the keyboard buffer (F8) is disabled, of course.  How-
  3921.          ever, the special script/statement buffer invoked with Alt-2-5-5
  3922.          is NOT disabled...  just invisible.
  3923.  
  3924.          When COM-AND is used in tandem with DOORWAY (see Appendices) or
  3925.          a Doorway-like utility, disable the status line for the best
  3926.          effect.
  3927.  
  3928.        . Wrap ON/OFF
  3929.  
  3930.          Line wrapping at the last character position may be disabled.
  3931.          For most purposes, this is undesirable... however, again, with
  3932.          DOORWAY and Doorway-like utilities, it may be best to disable
  3933.          line-wrap.
  3934.  
  3935.  
  3936.  
  3937.  
  3938.  
  3939.  
  3940.  
  3941.  
  3942.  
  3943.  
  3944.  
  3945.  
  3946.  
  3947.  
  3948.  
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.  
  3958.  
  3959. Version 2.8: 910716
  3960.  
  3961. COM-AND: IBM PC Communications and Accessories                 Page  66
  3962.  
  3963.  
  3964. XVIII.    Script Language
  3965.  
  3966.  
  3967.     A script automates certain manual tasks, and allows COM-AND to run
  3968.     unattended (in some cases).  Scripting is invoked in several ways:
  3969.  
  3970.     o   when COM-AND is loaded:
  3971.  
  3972.         ..    COM-AND.CMD, is executed immediately if found
  3973.         ..    INSTALL.CMD, is executed if the file COM-AND.DFT was created
  3974.         (not updated) if this script is available
  3975.         ..    the /F switch in the run command specifies a script to be
  3976.         executed immediately (after COM-AND.CMD, and INSTALL.CMD)
  3977.  
  3978.     o   interactively (F2)
  3979.     o   attached to a dialing directory entry
  3980.  
  3981.     Script commands are read by COM-AND from an ASCII file (wordprocessor
  3982.     files are not usually ASCII files (!)).  Programmer's text editors
  3983.     and EDLIN (provided with DOS) may be used to create and modify a
  3984.     script file.  If you use a word processor to update a script ensure
  3985.     that the particular word processor will output an ASCII file (often
  3986.     called non-document format, perhaps even ASCII).
  3987.  
  3988.     Once a script begins, execution of COM-AND is automatic, driven by
  3989.     the script.  However, the ESC key may be used to terminate most
  3990.     scripts at any time.  During dialing, two ESCs are needed...  one to
  3991.     terminate the dial function, and the second to end script.
  3992.  
  3993.     Generally, a script takes the form: <perform some action>
  3994.                         <wait for a response>
  3995.                         <perform some action...
  3996.     and so on.
  3997.  
  3998.     For example, a script might dial a number listed in the dialing
  3999.     directory and wait for the "ID = " prompt from the dialed host.
  4000.     The scripts included with COM-AND provide examples of such scripts.
  4001.     However, the COM-AND script language is not limited to just such
  4002.     tasks...  programs may be loaded and passed parameters, screen
  4003.     windows may be opened and scrolled...  A nontrivial BBS has been
  4004.     written as a COM-AND script, and is provided with the distribution
  4005.     for the interested (and intrepid!).
  4006.  
  4007.     Documentation for the COM-AND script language is presented in the
  4008.     separate document CASCRIPT.DOC.
  4009.  
  4010.  
  4011.  
  4012.  
  4013.  
  4014. Version 2.8: 910716
  4015.  
  4016. COM-AND: IBM PC Communications and Accessories                 Page  67
  4017.  
  4018.  
  4019. XIX.    Program Requirements
  4020.  
  4021.  
  4022.     This program will only function on an IBM PC or DOS compatible
  4023.     machine.  COM-AND does direct-to-screen buffer fetches and stores
  4024.     (unless BIOS screen updates are directed using the /C switch or the
  4025.     Alt-O options menu).
  4026.  
  4027.  
  4028.     Note that COM-AND is TopView aware even without the /C switch or
  4029.     Alt-O option.
  4030.  
  4031.  
  4032.     COM-AND supports MDA, CGA, EGA, VGA and Hercules.  COM-AND supports
  4033.     a Microsoft Mouse if one is available.
  4034.  
  4035.  
  4036.     COM-AND disk I/O is done through the 'Handle' oriented I/O routines
  4037.     added to DOS 2.0.  Therefore DOS 2.0 is a minimum requirement.
  4038.  
  4039.  
  4040.     COM-AND (Version 2.8) requires 256K for itself.  You need 384K
  4041.     minimally to use COM-AND and the DOS Gateway, and more to take
  4042.     advantage of accessories.
  4043.  
  4044.  
  4045.  
  4046.  
  4047.  
  4048.  
  4049.  
  4050.  
  4051.  
  4052.  
  4053.  
  4054.  
  4055.  
  4056.  
  4057.  
  4058.  
  4059.  
  4060.  
  4061.  
  4062.  
  4063.  
  4064.  
  4065.  
  4066.  
  4067.  
  4068.  
  4069. Version 2.8: 910716
  4070.  
  4071. COM-AND: IBM PC Communications and Accessories                 Page  68
  4072.  
  4073.  
  4074. XX.    Program and Author Information
  4075.  
  4076.  
  4077.     This program was written using Microsoft Macro-Assembler.  The
  4078.     author likes assembler.  Assembly language is an entirely
  4079.     appropriate vehicle for some of the program, and a not-inappro-
  4080.     priate vehicle for the rest of it.  Everything, in moderation...
  4081.  
  4082.  
  4083.     COM-AND has been written by, and is supported by R. Scott McGinnis
  4084.     of Chicago (CABER Software), Illinois.    My PLINK and GEnie IDs are:
  4085.     TARTAN.  My CIS ID is 73147,2665.  Comment and suggestions (and
  4086.     criticism in moderation) are welcomed:
  4087.  
  4088.              CABER Software
  4089.              R. (Scott) McGinnis
  4090.              P.O. Box 3607 Mdse Mart
  4091.              Chicago, IL 60654-0607
  4092.  
  4093.  
  4094.     I want to thank the sysops on GEnie, Paul Homchick, David Kozinn
  4095.     and Charles Strom for their support of this program in its early
  4096.     days (known as PC-VCO).  Their opening an RTC just for PC-VCO made
  4097.     it possible to reach a wide audience quickly and to gather comments
  4098.     and criticism from people using the program.
  4099.  
  4100.     I thank my wife, Elizabeth, who supported this effort and doesn't
  4101.     laugh at me (except for the time I tried to squeeze between a grape
  4102.     arbor and a board fence...).  She has been my companion and partner
  4103.     for many years and I am grateful.
  4104.  
  4105.     I also thank Jim Aspinwall, who contributed the Appendix below on
  4106.     modem initializations, and Dr. David Snyder, who contributed the
  4107.     marvelous TARTAN icon for COM-AND under Windows 3.0.
  4108.  
  4109.  
  4110.     This program (Version 2.8) may be distributed freely along with its
  4111.     accessories with the caveat that the Author information displayed at
  4112.     program termination is not removed.  If the program is USED after a
  4113.     reasonable evaluation period, a registration of $50.00 is required.
  4114.  
  4115.  
  4116.     PROCOMM, PCPLus, and ASPECT are trademarks of the DataStorm cor-
  4117.     poration.  DSZ is a trademark of OMEN Technology.  Windows is a
  4118.     trademark of the MicroSoft Corporation.  DesqView is a trademark
  4119.     of the QuarterDeck Corporation.  Smartmodem is a trademark of the
  4120.     Hayes Corporation.
  4121.  
  4122.  
  4123.  
  4124. Version 2.8: 910716
  4125.  
  4126. COM-AND: IBM PC Communications and Accessories                 Page  69
  4127.  
  4128.  
  4129. A.    Switches and parameters
  4130.  
  4131.  
  4132.     Program Switches:
  4133.  
  4134.     /A  'Chat mode':  COM-AND may be set to default to the chat mode
  4135.         split screen through the Alt-O options menu.  However, you may
  4136.         wish to turn chat on for some systems and off for others.  The
  4137.         /A switch allows the decision to be made through a batch file.
  4138.  
  4139.     /B  'Black and White mode':  COM-AND may be set to use or not use
  4140.         colors on-screen with the Alt-J Colors menu.  /B on the command
  4141.         line is an expedient way to turn colors off temporarily.
  4142.  
  4143.     /C  'Compatible': COM-AND normally does direct screen buffer reads
  4144.         and writes for its pop-up menues.  The /C switch forces COM-AND
  4145.         to use BIOS for all such references (e.g.  when under WINDOWS).
  4146.  
  4147.     /E  'no EGA': Turn off EGA support (forcing 25 line mode when COM-AND
  4148.         is entered in 43 or 50 line mode).
  4149.  
  4150.     /F  'Execute script':  The /F switch followed by a legitimate file
  4151.         name (for example /FPLINK.CMD) will cause the designated file to
  4152.         be used as a script after COM-AND is loaded.  The file name given
  4153.         defaults to .CMD (and .ENF) if the name-as-given is not found.
  4154.  
  4155.     /G  'Blank line suppression': Blank lines are used to double space
  4156.         on some systems.  Alt-G toggles a blank line suppression feature
  4157.         interactively.  /G in the run command turns the feature on when
  4158.         COM-AND is loaded.    This feature may also be set through Alt-O.
  4159.  
  4160.     /H  'No mode': inhibit COM-AND from changing screen mode when the
  4161.         screen is initialized.
  4162.  
  4163.     /I  'No Init': inhibit the modem initialization string from being
  4164.         transmitted at run-time.
  4165.  
  4166.     /J  'PCJr': Set PCJr mode for streaming transfers (logging, WXMODEM,
  4167.         CIS Quick-B, and Super KERMIT) if you have a PC-Jr.
  4168.  
  4169.     /K  'KBD Buffer': Turn on KBD buffer (F8).
  4170.  
  4171.     /L  'EGA mode':  Set 43 line mode on upon entry.  This feature is
  4172.         automatic if COM-AND is entered from a 43 line screen.  This
  4173.         feature may be toggled within COM-AND with Alt-L.
  4174.  
  4175.     /M  'No Mouse': Turn off MOUSE support (e.g. when running under
  4176.         WINDOWS or DesqView).
  4177.  
  4178.  
  4179. Version 2.8: 910716                           Appendices
  4180.  
  4181. COM-AND: IBM PC Communications and Accessories                 Page  70
  4182.  
  4183.  
  4184. A.    Switches and Parameters (continued)
  4185.  
  4186.  
  4187.     /P  'Piggyback':  COM-AND will open the COM port in such a manner as
  4188.         to retain another program's already opened line.  When COM-AND
  4189.         is exited, the previous state is restored.
  4190.  
  4191.     /Q  'No COM-AND.CMD':  This switch inhibits the automatic execution
  4192.         of COM-AND.CMD (if one is present).  It is provided for batch
  4193.         invocations, where the automatic script might require action.
  4194.  
  4195.     /R  'Report Receive Errors':  This switch causes all receive errors
  4196.         to be reported.  During testing, certain nodes of certain net-
  4197.         works consistently reported framing errors.  The apparent error
  4198.         did not interfere so report of it was suppressed.
  4199.  
  4200.     /S  'Bidirectional flow control':  This switch sets 'Bidirectional
  4201.         Flow control to be turned ON at load time.    When this switch
  4202.         is set, RTS is turned high when COM-AND is able to read, and
  4203.         (CTS) is awaited before writes.
  4204.  
  4205.         Certain modems will not work with this discipline.    Other modems
  4206.         (especially the new 9600 baud modems) and interconnects require
  4207.         it.  The option may be set permanently through Alt-O.
  4208.  
  4209.     /T  'Carrier override':  This switch forces COM-AND to ignore the
  4210.         carrier detect sense reported by the MODEM.  COM-AND tests the
  4211.         carrier detect sense during all file transfers, and through the
  4212.         script processor.  A few modems apparently cannot (???) report
  4213.         carrier detect.  This switch allows COM-AND to be used on those
  4214.         modems (to perform file transfers).
  4215.  
  4216.     /V  'Menu mode':  This switch forces COM-AND to initialize in menu
  4217.         mode.  The top line menu comes up after initialization.
  4218.  
  4219.     /W  'Slow transfers':  This switch forces COM-AND to slow down its
  4220.         file transfers.  COM-AND uses interrupt driven writes for file
  4221.         transfers...  which is too fast for some network modems (!).
  4222.         This switch allows COM-AND to be used on those modems (to per-
  4223.         form file transfers).
  4224.  
  4225.     /X  'Debug mode': This switch enables certain resident debugging keys
  4226.         (such as Ctl-F2, which writes a dump of memory to disk).  I do
  4227.         not recommend you use it.  I document it only for the curious.
  4228.  
  4229.     /Z  'REMOTE commands':  This switch allows COM-AND to perform script
  4230.         commands received through the sequence:  "ESC ^ <text> <cr>".
  4231.         This switch overrides the Alt-O setting.
  4232.  
  4233.  
  4234. Version 2.8: 910716                           Appendices
  4235.  
  4236. COM-AND: IBM PC Communications and Accessories                 Page  71
  4237.  
  4238.  
  4239. A.    Switches and Parameters (continued)
  4240.  
  4241.  
  4242.     Program parameters:
  4243.  
  4244.        COM1     COM-AND uses the COM1 port
  4245.        COM2     COM-AND uses the COM2 port
  4246.        COM3     COM-AND uses the COM3 port (base addr 3e8h)
  4247.        COM4     COM-AND uses the COM4 port (base addr 2e8h)
  4248.  
  4249.        300        COM-AND uses port at 300 baud
  4250.        1200     COM-AND uses port at 1200 baud
  4251.        2400     COM-AND uses port at 2400 baud
  4252.        4800     COM-AND uses port at 4800 baud
  4253.        9600     COM-AND uses port at 9600 baud
  4254.        19K        COM-AND uses port at 19.2K baud
  4255.        38K        COM-AND uses port at 38.4K baud
  4256.        57K        COM-AND uses port at 57.6K baud
  4257.        115K     COM-AND uses port at 115K baud
  4258.  
  4259.        EVEN     COM-AND uses port with even parity
  4260.        ODD        COM-AND uses port with odd parity
  4261.        NONE     COM-AND uses port with no parity
  4262.  
  4263.        DATA7    COM-AND transmits/receives 7 data bits
  4264.        DATA8    COM-AND transmits/receives 8 data bits
  4265.  
  4266.        STOP1    COM-AND uses and expects 1 stop bit
  4267.        STOP2    COM-AND uses and expects 2 stop bits
  4268.  
  4269.        BIOS     COM-AND uses BIOS for communications services;
  4270.        BIOS (#)    (#) may be optional port # (parentheses required)
  4271.  
  4272.        DIAL <n>    After initialization, COM-AND dials directory entry
  4273.             <n>, using the rate, parity, data and stop bits as
  4274.             specified.
  4275.  
  4276.  
  4277.     Program switches require no delimiters.  Parameters must be
  4278.     preceded by a blank (in succession).  For example:
  4279.  
  4280.     A> COM-AND 1200      Run the program at 1200 baud
  4281.     A> COM-AND /L1200     43 line mode, 1200 baud
  4282.     A> COM-AND /L 1200     43 line mode, 1200 baud
  4283.  
  4284.  
  4285.     Program defaults are: "d"> COM-AND COM2 300 EVEN DATA7 STOP1
  4286.  
  4287.  
  4288.  
  4289. Version 2.8: 910716                           Appendices
  4290.  
  4291. COM-AND: IBM PC Communications and Accessories                 Page  72
  4292.  
  4293.  
  4294. B.    COM-AND Error display.
  4295.  
  4296.  
  4297.     One command not listed in the F10 help display is Alt-Y.  This
  4298.     command displays RS232 and file errors encountered.  RS232 errors
  4299.     list both the last error condition recorded and a count of errors.
  4300.     RS232 errors are:
  4301.  
  4302.     Receive error.    The hex value represents:
  4303.  
  4304.        Bit 0:  Shouldn't occur in display, but what do I know.
  4305.        Bit 1:  Overrun.  Indicates that a character in the 8250
  4306.            Receive buffer was not read before the next character
  4307.            was received.  This program enables interrupts to read
  4308.            the COM port.
  4309.        Bit 2:  Parity error.  Indicates that the parity of the
  4310.            received character does not match that specified.
  4311.            This bit report is normally suppressed, but may be
  4312.            enabled with the /R switch.
  4313.        Bit 3:  Framing error.  Indicates that the character received
  4314.            lacked a valid stop bit.
  4315.        Bit 4:  Break interrupt. Not too many systems send a break.
  4316.  
  4317.        Other bits of the LSR of the 8250 are masked off.
  4318.  
  4319.     Send error.  The hex value represents:
  4320.  
  4321.        Bit 7:  A timeout occurred in one of three places:
  4322.            . Waiting for DSR to go true
  4323.            . Waiting for CTS to go true
  4324.            . Waiting for the transmit holding register to clear
  4325.              The first two conditions are normally suppressed,
  4326.              but may be overridden with the /S switch.
  4327.  
  4328.        Other bits are masked out. There is serious trouble (or my over-
  4329.        sight) if anything but Hex 80 is reported.
  4330.  
  4331.     Buffer overflow.
  4332.  
  4333.        This program uses an interrupt service routine to read the
  4334.        COM port.  The ISR fills a 4096 byte buffer.  The application
  4335.        takes characters out of the circular receive buffer one by
  4336.        one.  Buffer overflow may occur when the application is
  4337.        suspended; for example when a menu is pending attention, and
  4338.        flow control is not enabled.
  4339.  
  4340.  
  4341.  
  4342.  
  4343.  
  4344. Version 2.8: 910716                           Appendices
  4345.  
  4346. COM-AND: IBM PC Communications and Accessories                 Page  73
  4347.  
  4348.  
  4349. C.    Files
  4350.  
  4351.  
  4352.     COM-AND expects the following files on the default drive/subdirectory
  4353.     (or COM-AND= environment variable specified drive/subdirectory):
  4354.  
  4355.     COM-AND.DFT     Parameter save area (Alt-S, Alt-O and Alt-P)
  4356.     COM-AND.DIR     Dialing directory (change name in Alt-S)
  4357.     COM-AND.MAC     Macro definition (change name in Alt-S)
  4358.     COM-AND.ACC     Accessory definitions (F1) (change name in Alt-S)
  4359.  
  4360.     COM-AND will create the .DFT file at load-time if not found.  COM-AND
  4361.     will automatically update the .DFT file if the program version number
  4362.     is different from the .DFT file version number.
  4363.  
  4364.     COM-AND will create if not present (filling with default values):
  4365.     an empty dialing directory, and empty macro definition, and an empty
  4366.     accessory definition.  Different versions of COM-AND will require
  4367.     different structures to the .DFT file...  previous versions (with the
  4368.     exception of 1.0) will be accepted; however when a new major (e.g.
  4369.     1.0, 2.0, ...) is released the previous .DFT file probably should be
  4370.     purged (and recreated by COM-AND).
  4371.  
  4372.     COM-AND also uses:
  4373.  
  4374.     COM-AND.XLT     Translation tables; see XLATE.CMD script
  4375.     COM-AND.RMP     Keyboard remapping table; see REMAP.CMD script
  4376.     COM-AND.LOG     Default call-log file
  4377.     COM-AND.TUN     Tune file (if present; ASCII file, PLAY data)
  4378.     COM-AND.CMD     Automatic script (if present, executed at init)
  4379.     INSTALL.CMD     Automatic script (if present, and if COM-AND.DFT is
  4380.              created (not updated))
  4381.     COM-AND.RLE     Last RLE viewed (used during receipt of RLEs)
  4382.  
  4383.     The ".RLE" and ".LOG" file names may be changed through the Alt-S
  4384.     (Setup) Menu.  COM-AND currently implements the rule for file names:
  4385.     If the given file name carries a drive spec (i.e.  C:) or path
  4386.     (subdirectory), the name is taken 'as is'.  If neither is provided
  4387.     the default drive and subdirectory are added to the file name.
  4388.  
  4389.     COM-AND will share Dialing Directory and Macro Definition files with
  4390.     PROCOMM 2.4.2 and before.  In this case the subdirectory on which
  4391.     these files may be found must be specified through the Alt-S func-
  4392.     tion, and the values saved for subsequent executions.  COM-AND's
  4393.     updates to these files will be acceptable to PROCOMM, and PROCOMM's
  4394.     to COM-AND (true at least through Version 2.4.2 of PROCOMM).
  4395.  
  4396.  
  4397.  
  4398.  
  4399. Version 2.8: 910716                           Appendices
  4400.  
  4401. COM-AND: IBM PC Communications and Accessories                 Page  74
  4402.  
  4403.  
  4404. D.    Windowed XMODEM (WXMODEM)
  4405.  
  4406.  
  4407.     In June, 1986, Peter Boswell of PLINK issued a specification for
  4408.     an XMODEM protocol variant called Windowed XMODEM (WXMODEM to its
  4409.     friends).  WXMODEM was designed primarily to overcome delays that
  4410.     are imposed by the X.25 networks.  X.25 network delays are mostly
  4411.     imperceptible to conversational users of the networks...  however,
  4412.     people performing file transfers might expect to see up to 50% of
  4413.     the transfer time eaten up in these delays!
  4414.  
  4415.     Asynchronous communications lines do not suffer these same delays.
  4416.     When someone accustomed to Bulletin Boards (dialed through a direct
  4417.     phone line) enters the network environment, the 'feel' of file
  4418.     transfers is found to be entirely 'too slow'.  The difference is
  4419.     entirely in the network (and many times intervening satellite hops).
  4420.  
  4421.  
  4422.     Windowed XMODEM also accomodates the requirements of new services
  4423.     such as PC Pursuit...  allowing XON/XOFF flow control to be exer-
  4424.     cised by the network during a binary file transfer (this is not
  4425.     possible with XMODEM, as transparency is required).  Flow control
  4426.     allows higher data rates to be supported while retaining existing
  4427.     network interconnects.
  4428.  
  4429.  
  4430.     Windowed XMODEM was implemented on PLINK in September, 1986.  Many
  4431.     comm programs on many different machines have been modified or
  4432.     written to implement WXMODEM for PLINK communications.    The differ-
  4433.     ence in throughput between CRC XMODEM and WXMODEM is astounding.
  4434.     I measure at least 35% and sometimes as much as 40% improvement in
  4435.     transfer times over CRC XMODEM.  In real terms, this means the dif-
  4436.     ference between 24 minutes and 40 minutes for a download of the same
  4437.     (approximately 120K) file at 1200 baud.
  4438.  
  4439.  
  4440.     Windowed XMODEM is still a new protocol.  Its developers discovered
  4441.     quite a few practicalities not addressed in the original specific-
  4442.     ation during its implementation.  However, WXMODEM is now available
  4443.     on Delphi, and for various BBS's (TCOMM, and RBBS for example).
  4444.  
  4445.  
  4446.     For the technically inclined, the Windowed XMODEM specification will
  4447.     be found on many bulletin boards and most systems as WXMODEM.ARC.  An
  4448.     excellent analysis of XMODEM problems in an X.25 environment was also
  4449.     published (electronically) by Peter Boswell.  In the latter paper,
  4450.     Peter quantifies exactly the delays and their predicted overhead in
  4451.     an X.25 environment.
  4452.  
  4453.  
  4454. Version 2.8: 910716                           Appendices
  4455.  
  4456. COM-AND: IBM PC Communications and Accessories                 Page  75
  4457.  
  4458.  
  4459. E.    ANSI, VT100, and VT52 graphics
  4460.  
  4461.  
  4462.     1. ANSI sequences
  4463.  
  4464.        COM-AND is capable of displaying ANSI graphics on the CRT side.
  4465.        ANSI graphics are used by some services and Bulletin Boards to
  4466.        enrich the display through screen formatting and colors.
  4467.  
  4468.  
  4469.        Beginning with Version 2.0 of this program, ANSI graphic software
  4470.        is entirely contained within COM-AND.  Any errors in implementa-
  4471.        tion must be addressed to this developer.  COM-AND implements the
  4472.        ANSI sequences as follows:
  4473.  
  4474.         ESC,'[#;#H'   CUP: Cursor position; 1st #=row, 2nd=col
  4475.         ESC,'[;#H'    CUP: Alternate cursor position to col
  4476.         ESC,'[#H'     CUP: Alternate cursor position to row
  4477.         ESC,'[H'      CUP: Alternate cursor position to home
  4478.         ESC,'[#;#f'   HVP: Horiz/Vert pos; 1st = row, 2nd = col
  4479.         ESC,'[;#f'    HVP: Alternate horiz/vert pos to col
  4480.         ESC,'[#f'     HVP: Alternate horiz/vert pos to row
  4481.         ESC,'[f'      HVP: Alternate horiz/vert pos to home
  4482.         ESC,'[#A'     CUU: Cursor Up # rows
  4483.         ESC,'[#B'     CUD: Cursor Down # rows
  4484.         ESC,'[#C'     CUF: Cursor Forward # cols
  4485.         ESC,'[#D'     CUB: Cursor Backward # cols
  4486.         ESC,'[6n'     DSR: Device status rpt (rtns CPR)
  4487.         ESC,'[#;#R'   CPR: Cursor position rpt (1st=row, 2nd=col)
  4488.         ESC,'[s'      SCP: Save cursor position
  4489.         ESC,'[u'      RCP: Restore cursor position
  4490.         ESC,'[#J'     ED: Erase display (# = 0,1,2)
  4491.         ESC,'[#K'     EL: Erase line (# = 0,1,2)
  4492.         ESC,'[&m'     SGR: Set graphics rendition (&-> #[;#...])
  4493.         ESC,'[=#h'    SM: Set mode
  4494.         ESC,'[?7h'    SM: Set wrap mode
  4495.         ESC,'[=#l'    RM: Reset mode
  4496.         ESC,'[?7l'    SM: Reset wrap mode
  4497.  
  4498.  
  4499.        The only sequence defined in ANSI.SYS (the device driver that
  4500.        supplies ANSI emulation) that is not implemented in COM-AND is:
  4501.  
  4502.         Esc,'[...p'   KKR: Keyboard key redefinition.
  4503.  
  4504.        I am considering implementing this sequence, with a menu to sup-
  4505.        port it as a 'different' sort of Macro facility.  I'd like to hear
  4506.        comments from people reading this.
  4507.  
  4508.  
  4509. Version 2.8: 910716                           Appendices
  4510.  
  4511. COM-AND: IBM PC Communications and Accessories                 Page  76
  4512.  
  4513.  
  4514. E.    ANSI, VT100 and VT52 graphics (continued)
  4515.  
  4516.  
  4517.     1. ANSI sequences (continued)
  4518.  
  4519.        Under MS-DOS/PC-DOS, ANSI graphics are usually performed by the
  4520.        ANSI.SYS device driver.  Replacements for ANSI.SYS are available
  4521.        on all the systems and boards, offering increased functionality
  4522.        and additional utility.  For example, the FANSI device driver
  4523.        (sold by Hersey Micro Consulting) offers:
  4524.  
  4525.        .  improvements in screen display speed,
  4526.        .  considerably more control sequences than ANSI.SYS,
  4527.        .  DEC VT100 emulation (which therefore is available to you in
  4528.           COM-AND if you use FANSI and turn DOS screen on),
  4529.        .  a backscreen function which pages last-to-first,
  4530.        .  one finger typing,
  4531.        .  increased typeahead buffer size,
  4532.        .  and many many other functional enhancements
  4533.  
  4534.        The implementation of ANSI within COM-AND does not negate any of
  4535.        the above features (except perhaps terminal emulation).
  4536.  
  4537.  
  4538.        In order to use ANSI.SYS or any of its replacements through COM-
  4539.        AND, you must have a device driver installed in your DOS.  All
  4540.        that is required is that the line:
  4541.  
  4542.           DEVICE=ANSI.SYS
  4543.  
  4544.        be added to the file CONFIG.SYS on the root directory of the boot
  4545.        disk, and the PC rebooted (Ctl-Alt-Del).  If there is no file
  4546.        named CONFIG.SYS on the root directory of your boot disk, create
  4547.        one containing the line above (see also the note on DOS gateway),
  4548.        and then reboot.
  4549.  
  4550.  
  4551.        Other device drivers, as FANSI mentioned above, will have their
  4552.        own installation requirements.  Refer to the documentation for the
  4553.        device driver you wish to use for instructions.
  4554.  
  4555.  
  4556.        Once you've installed the ANSI device, you must turn COM-AND's
  4557.        ANSI and VIDTEX emulation off through the Alt-V menu.  You must
  4558.        also turn on 'DOS screen writes' through Alt-O.  With ANSI and
  4559.        VIDTEX off, and DOS on, all received text is routed through the
  4560.        ANSI device.
  4561.  
  4562.  
  4563.  
  4564. Version 2.8: 910716                           Appendices
  4565.  
  4566. COM-AND: IBM PC Communications and Accessories                 Page  77
  4567.  
  4568.  
  4569. E.    ANSI, VT100, and VT52 graphics (continued)
  4570.  
  4571.  
  4572.     2. VT100 sequences
  4573.  
  4574.        COM-AND is accepts a subset of VT100 escape sequences in display
  4575.        emulation.  VT100 emulation is available through the Alt-V option
  4576.        'VT100' (or in a script, 'EMULATE VT100').
  4577.  
  4578.  
  4579.        The VT100 was created to be an ANSI terminal.  The difference
  4580.        between COM-AND's VT100 and ANSI modes is minor.  There are the
  4581.        following differences to the above ANSI sequences:
  4582.  
  4583.        o    Erase display does not position to home in VT100
  4584.        o    Erase line does not position to beginning of line in VT100
  4585.  
  4586.  
  4587.        In addition to the ANSI sequences above, COM-AND VT100 emulation
  4588.        also adds the following sequences:
  4589.  
  4590.         ESC,'[?2l'    Switch to VT52 mode
  4591.         ESC,'<'       VT52: Change to VT100 (redundant)
  4592.         ESC,'>'       Keypad numeric mode
  4593.         ESC,'='       Keypad application mode
  4594.         ESC,'7'       Save cursor and attributes
  4595.         ESC,'8'       Restore cursor and attributes
  4596.         ESC,'#3'      Set cursor line to DH DW top half (literal '#')
  4597.         ESC,'#4'      Set cursor line to DH DW bot half (literal '#')
  4598.         ESC,'#5'      Set cursor line to SH SW          (literal '#')
  4599.         ESC,'#6'      Set cursor line to SH DW          (literal '#')
  4600.         ESC,'#:'      Set cursor line to DH SW top half (literal '#')
  4601.         ESC,'#;'      Set cursor line to DH SW bot half (literal '#')
  4602.         ESC,'[#;#r'   Set scrolling region
  4603.         ESC,'[?#l'    Reset (parameter controls)
  4604.         ESC,'[?#h'    Set (parameter controls)
  4605.         ESC,'[>#l'    Reset (parameter controls)
  4606.         ESC,'[>#h'    Set (parameter controls)
  4607.         ESC,'[20l'    Reset LF to new ln (unused)
  4608.         ESC,'[20h'    Set new line mode (unused)
  4609.         ESC,'[#q'     LED controls (unused)
  4610.  
  4611.  
  4612.  
  4613.  
  4614.  
  4615.  
  4616.  
  4617.  
  4618.  
  4619. Version 2.8: 910716                           Appendices
  4620.  
  4621. COM-AND: IBM PC Communications and Accessories                 Page  78
  4622.  
  4623.  
  4624. E.    ANSI, VT100, and VT52 graphics (continued)
  4625.  
  4626.  
  4627.     2. VT100 sequences (continued)
  4628.  
  4629.        COM-AND's VT100 emulation Displays from one of two character sets,
  4630.        designated G0 and G1 in VT100 nomenclature.    The identity of each
  4631.        set and the current controlling set is determined through the
  4632.        following sequences:
  4633.  
  4634.         ESC,')A'      Designate UK set as G1
  4635.         ESC,')B'      Designate ASCII set as G1
  4636.         ESC,')0'      Designate graphics set as G1
  4637.         ESC,')1'      Designate Alternate char set as G1
  4638.         ESC,')2'      Designate special graphics as G1
  4639.         ESC,'(A'      Designate UK set as G0
  4640.         ESC,'(B'      Designate ASCII set as G0
  4641.         ESC,'(0'      Designate graphics set as G0
  4642.         ESC,'(1'      Designate Alternate char set as G0
  4643.         ESC,'(2'      Designate special graphics as G0
  4644.         ESC,'D'       Move cursor down a line
  4645.         ESC,'E'       Move cursor down a line to col 0
  4646.         ESC,'M'       Move cursor up a line
  4647.         SI (15)       Shift in (use G0 char set)
  4648.         SO (14)       Shift out (use G1 char set)
  4649.  
  4650.        COM-AND implements the UK set identically to ASCII at this time.
  4651.        The graphics set, alternate set and special graphics sets use an
  4652.        approximation from the high order characters (128-255).
  4653.  
  4654.  
  4655.        Finally, COM-AND supports these inquiry sequences:
  4656.  
  4657.         ESC,Z          Report identity
  4658.         ESC,'c'       Report device attributes
  4659.         ESC,'0c'      Report device attributes
  4660.  
  4661.        The response to these three 'report' sequences above is the same
  4662.        in all cases:  VT100 without a printer (which is ESC,'[?1;2c').
  4663.  
  4664.  
  4665.  
  4666.  
  4667.  
  4668.  
  4669.  
  4670.  
  4671.  
  4672.  
  4673.  
  4674. Version 2.8: 910716                           Appendices
  4675.  
  4676. COM-AND: IBM PC Communications and Accessories                 Page  79
  4677.  
  4678.  
  4679. E.    ANSI, VT100, and VT52 graphics (continued)
  4680.  
  4681.  
  4682.     3. VT52 sequences
  4683.  
  4684.        COM-AND is capable of accepting VT52 escape sequences as well.
  4685.        CIS in VIDTEX mode uses a mix of ANSI, and VT52 sequences to
  4686.        format the screen.
  4687.  
  4688.  
  4689.        Beginning with version 2.3 of this program, VT52 cursor control
  4690.        is available if the Alt-V option 'VT52' is enabled (or in a
  4691.        script, 'EMULATE VT52').  COM-AND implements the following VT52
  4692.        sequences:
  4693.  
  4694.         ESC,'A'       CUU: Cursor up
  4695.         ESC,'B'       CUD: Cursor down
  4696.         ESC,'C'       CUF: Cursor forward
  4697.         ESC,'D'       CUB: Cursor backward
  4698.         ESC,'H'       CUH: Cursor home
  4699.         ESC,'J'       ES:  Erase from cursor to end of screen
  4700.         ESC,'K'       EL:  Erase from cursor to end of line
  4701.         ESC,'Yrc'     CUP: Horiz/Vert pos; r= row+32, c= col+32
  4702.         ESC,'j'       CS:  Clear screen and home cursor
  4703.         ESC,'<'       VT100: Switch to VT100 mode
  4704.  
  4705.  
  4706.  
  4707.  
  4708.  
  4709.  
  4710.  
  4711.  
  4712.  
  4713.  
  4714.  
  4715.  
  4716.  
  4717.  
  4718.  
  4719.  
  4720.  
  4721.  
  4722.  
  4723.  
  4724.  
  4725.  
  4726.  
  4727.  
  4728.  
  4729.  
  4730. Version 2.8: 910716                           Appendices
  4731.  
  4732. COM-AND: IBM PC Communications and Accessories                 Page  80
  4733.  
  4734.  
  4735. F.    Vidtex and RLE files
  4736.  
  4737.  
  4738.     1. Vidtex
  4739.  
  4740.        COM-AND emulates a 'VIDTEX' screen mode as an option.  Vidtex
  4741.        is a special service of CompuServe (CIS).  It is enabled:
  4742.  
  4743.        o    Alt-V (set VIDTEX screen mode ON), or
  4744.        o    script "SET ENQ CISB" or "EMULATE VIDTEX" statements
  4745.  
  4746.  
  4747.        Vidtex screen mode provides several features to the CIS user:
  4748.  
  4749.        o    Screen displays are formatted to appear 'full screen'.  If
  4750.         color is available, it is used.  The current screen size is
  4751.         known to CIS as well.
  4752.        o    File transfers are automatic.  CIS asks the name a file is to
  4753.         take on your machine, and then prompts COM-AND for the
  4754.         transfer.  PgDn and PgUp are not needed.
  4755.        o    RLE files are displayed automatically.
  4756.  
  4757.  
  4758.        There are several drawbacks to the VIDTEX screen mode, too:
  4759.  
  4760.        o    CIS assumes you are going to use Quick-B for file transfers.
  4761.         It doesn't ask for alternatives.
  4762.        o    Alt-L screen size may not be toggled during a VIDTEX session.
  4763.         The screen size at the time of logon is reported to CIS, and
  4764.         there is no method (now) to report a change of size.
  4765.        o    Vidtex control sequences are captured (along with text) when
  4766.         transcripting.    These are easy to edit out, but distracting.
  4767.         Again,    VIDTEX can't be turned off easily during a session.
  4768.        o    Other systems may from time-to-time use the ENQ character for
  4769.         special functions.  You should ensure that VIDTEX mode is off
  4770.         when you use such a system.
  4771.  
  4772.  
  4773.        CIS inquires the capability of a communication program with the
  4774.        sequence: ESC,'I'.  COM-AND responds (in VIDTEX mode) with:
  4775.  
  4776.         #IBX,SSyx,AC/CA/CC,GH,GM,PB,DT,+<checksum>
  4777.  
  4778.        The SS parameter specifies screen size.  The AC/CA/CC choice is
  4779.        made according to whether color is set through Alt-J.
  4780.  
  4781.  
  4782.  
  4783.  
  4784.  
  4785. Version 2.8: 910716                           Appendices
  4786.  
  4787. COM-AND: IBM PC Communications and Accessories                 Page  81
  4788.  
  4789.  
  4790. F.    Vidtex and RLE files (continued)
  4791.  
  4792.  
  4793.     2. RLE files
  4794.  
  4795.        Although created on CompuServe, RLE (run length encoded) graphics
  4796.        files have been popular for some time on the services and BBS's.
  4797.        One reason is because the format is not machine specific.  Most
  4798.        any flavor of PC having a graphics display may view and create
  4799.        graphics images in RLE format.
  4800.  
  4801.  
  4802.        The resolution is limited (256 horizontal pixels by 192 lines).
  4803.        RLE images are monochrome (although I know that there are some
  4804.        people who've experimented with color information embedded in RLE
  4805.        files).  But RLE files do provide one medium of graphics exchange
  4806.        between differing personal computers.
  4807.  
  4808.  
  4809.        RLEs are encoded as 7 bit ASCII data.  Normally, an RLE file would
  4810.        be viewed through something like an ASCII download.    [PLINK, for
  4811.        one, has trouble with this.    It backscans text lines, removing
  4812.        blanks.  That is death for an RLE graphics image.]
  4813.  
  4814.  
  4815.        COM-AND recognizes RLE control sequences when they are encountered
  4816.        in the stream of received text.  When COM-AND encounters an RLE
  4817.        sequence, it attempts to switch to graphics mode.  If successful,
  4818.        COM-AND then displays the image as it is received, and buffers the
  4819.        image in a temporary file.  Upon completion of the image, COM-AND
  4820.        prompts for a save file name.  You may ignore the save step, and
  4821.        throw away the picture in good conscience, as you now know what it
  4822.        shows.  Or you may of course opt to save it for later playback.
  4823.  
  4824.        You may disable this feature of COM-AND through the Alt-O options
  4825.        menu.
  4826.  
  4827.        ---------------------------------------------------------------
  4828.        CIS Users NOTE:  CIS 'tests' your terminal program each time you
  4829.        request an RLE viewing.  COM-AND responds to the test only if you
  4830.        have set emulation to 'VIDTEX' or used the equivalent script
  4831.        statement.
  4832.  
  4833.        If the option is not enabled, CIS will tell you "Your terminal
  4834.        program is not equipped ...    do you wish to proceed?" If you
  4835.        answer "Y", CIS will send the RLE file, and COM-AND will display
  4836.        it nicely.
  4837.  
  4838.  
  4839.  
  4840. Version 2.8: 910716                           Appendices
  4841.  
  4842. COM-AND: IBM PC Communications and Accessories                 Page  82
  4843.  
  4844.  
  4845. G.    External protocol drivers
  4846.  
  4847.  
  4848.     COM-AND supports external protocol drivers through its F1 (acces-
  4849.     sories) menu.  You may edit the entries in the F1 menu to load and
  4850.     execute just about any program you might wish (and have memory for).
  4851.     If you limit the F1 entries to simple script invocations, you may
  4852.     also use the script name through F2.
  4853.  
  4854.     For example, you might wish to add ZMODEM or True YMODEM (tm)
  4855.     capability to COM-AND.    You may do this with Chuck Forsberg's
  4856.     DSZ.COM program.  DSZ is a module that may be run from within other
  4857.     comm programs to perform ZMODEM transfers (and X/Ymodem transfers
  4858.     too).  DSZ is revised quite often (to expand its function), and is
  4859.     available on most systems.
  4860.  
  4861.     For downloading purposes, no script is needed to invoke DSZ.  How-
  4862.     ever, as mentioned above, the F1 entry will be coded to use a script
  4863.     to allow the same script to be manually invoked through F2.  The file
  4864.     name used for the downloaded file will be determined by the sender.
  4865.     Revise an F1 entry (with the 'r' subcommand) as follows:
  4866.  
  4867.         Name:        Download using YMODEM
  4868.         Subdirectory:    (whatever subdirectory your DSZ occupies)
  4869.         Program:        (leave this field blank)
  4870.         Script:        DSZDOWN.CMD
  4871.  
  4872.     The script DSZDOWN.CMD might be written:
  4873.     ------------------------------------------------------------------
  4874.     COMPARMS S1        ; read current settings
  4875.     S2 =  "DSZ.COM port " * S1(14:14) * " rb " ; Ask for YMODEM rcv
  4876.     RUN S2            ; Load and run DSZ
  4877.     ------------------------------------------------------------------
  4878.     Note: change " rb " to " rz " for ZMODEM
  4879.     ------------------------------------------------------------------
  4880.  
  4881.     DSZ requires a file name for uploading.  You can accomplish this by
  4882.     editing the F1 menu as follows, and creating a script.
  4883.  
  4884.         Name:        Upload using YMODEM
  4885.         Subdirectory:    (whatever subdirectory DSZ/DSZUP occupies)
  4886.         Program:        (leave this field blank)
  4887.         Script:        DSZUP.CMD
  4888.  
  4889.     An example script DSZUP.CMD follows on the next page.
  4890.  
  4891.  
  4892.  
  4893.  
  4894.  
  4895. Version 2.8: 910716                           Appendices
  4896.  
  4897. COM-AND: IBM PC Communications and Accessories                 Page  83
  4898.  
  4899.  
  4900. G.    External protocol drivers (continued)
  4901.  
  4902.  
  4903.     The script DSZUP.CMD might be written:
  4904.     ------------------------------------------------------------------
  4905.     MESSAGE "^MEnter the upload file name: "
  4906.     GET S0            ; Read keyboard
  4907.     COMPARMS S1        ; read current settings
  4908.     S2 =  "DSZ.COM port " * S1(14:14) * " sb " * S0 ; ask for YMODEM
  4909.     sb" RUN S2                  ; Load and run DSZ
  4910.     ------------------------------------------------------------------
  4911.     Note: change " sb " to " sz " for ZMODEM
  4912.     ------------------------------------------------------------------
  4913.  
  4914.  
  4915.     DSZ defaults to COM1 and your current baud rate.  The above scripts
  4916.     adjust for the comm port you're using.  The above scripts (or better)
  4917.     are included in the scripts archive file released with COM-AND.
  4918.  
  4919.  
  4920.     NOTE: DSZ is user supported.  If you use it, please register it!
  4921.     DSZ may be found on most bulletin boards, and on every major system.
  4922.     Registration information is provided with every release of DSZ.
  4923.  
  4924.  
  4925.  
  4926.  
  4927.  
  4928.  
  4929.  
  4930.  
  4931.  
  4932.  
  4933.  
  4934.  
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.  
  4941.  
  4942.  
  4943.  
  4944.  
  4945.  
  4946.  
  4947.  
  4948.  
  4949.  
  4950. Version 2.8: 910716                           Appendices
  4951.  
  4952. COM-AND: IBM PC Communications and Accessories                 Page  84
  4953.  
  4954.  
  4955. H.    Modem Configuration
  4956.  
  4957.  
  4958.     COM-AND default values do not require your modem to be configured
  4959.     in any particular manner.  However, certain features cannot be used
  4960.     unless you configure your modem before you use COM-AND.
  4961.  
  4962.  
  4963.     1. DTR (Data Terminal Ready)
  4964.  
  4965.        COM-AND, by default, hangs up using the command sequences defined
  4966.        through the Alt-S setup (hangup and modem escape).  However, you
  4967.        may alternately select 'Drop DTR to hangup' through the Alt-O
  4968.        options.  Dropping DTR is the only way to hangup certain modems,
  4969.        and is generally much faster than the command sequences.
  4970.  
  4971.        Most Hayes compatible modems allow configuration of the DTR sense
  4972.        through a switch-block.  If you wish to use DTR to hangup, be sure
  4973.        that your modem follows the DTR signal.  Refer to the documenta-
  4974.        tion provided with your modem to be sure that option switches are
  4975.        set appropriately.
  4976.  
  4977.  
  4978.     2. CD (Carrier Detect)
  4979.  
  4980.        COM-AND (presently) uses the CD sense line for several purposes.
  4981.        The 'CONNECTED' test supported in the script language, test for
  4982.        carrier detect upon exit, and the file transfer protocols all
  4983.        require that the modem report carrier detect.  True carrier detect
  4984.        is the only way to determine if you are 'on-line' or 'off-line'.
  4985.  
  4986.        Many Hayes compatible modems are sold with a carrier detect
  4987.        override (in other words the modem reports carrier detect all the
  4988.        time).  When carrier detect is overridden, COM-AND cannot detect
  4989.        when carrier is lost during a file transfer or whether to ask if
  4990.        you want to hangup when you exit to DOS.
  4991.  
  4992.        Be sure that the modem is reporting true CD (instead of it just
  4993.        saying 'yes').  Most Hayes compatible modems allow configuration
  4994.        of the CD sense through a switch-block.  Refer to the documenta-
  4995.        tion provided with your modem to be sure that option switches are
  4996.        set appropriately.
  4997.  
  4998.  
  4999.  
  5000.  
  5001.  
  5002.  
  5003.  
  5004.  
  5005. Version 2.8: 910716                           Appendices
  5006.  
  5007. COM-AND: IBM PC Communications and Accessories                 Page  85
  5008.  
  5009.  
  5010. I.    Environment variables
  5011.  
  5012.  
  5013.     COM-AND uses environment variables to default files names.  Two
  5014.     environment variables are relevant to COM-AND.    The "COM-AND='
  5015.     environment variable specifies a default path for certain file names,
  5016.     and "COMSPEC=" specifies the shell program name.
  5017.  
  5018.  
  5019.     1. COM-AND=
  5020.  
  5021.        COM-AND searches the current subdirectory and then the subdirec-
  5022.        tory indicated by the environment variable "COM-AND=" (if present)
  5023.        for the following files:
  5024.  
  5025.        . COM-AND.DFT    (Default settings and values)
  5026.        . COM-AND.DIR    (Dialing directory)
  5027.        . COM-AND.MAC    (Macro definitions)
  5028.        . COM-AND.ACC    (Accessory definitions)
  5029.        . COM-AND.RMP    (Remap definition)
  5030.        . COM-AND.XLT    (Translate tables)
  5031.  
  5032.  
  5033.        COM-AND also uses this environment variable searching for script
  5034.        file names.    However, script files are also searched using (a) the
  5035.        supplied extension, (b) the extension ".CMD" and (c) the extension
  5036.        ".ENF" (for encrypted files).  So, the search for script files is
  5037.        a little bit longer than the search for the above files.
  5038.  
  5039.  
  5040.        COM-AND accessories use the "COM-AND=" environment variable to
  5041.        find COM-AND.EXE when they are loaded without COM-AND.  For this
  5042.        reason it is recommended that COM-AND.EXE be in that subdirectory.
  5043.  
  5044.  
  5045.        Refer to your DOS manual (the SET command) for information about
  5046.        environment variables and how to create them.  As an example, you
  5047.        might place COM-AND in the C:\COM-AND subdirectory.    You should
  5048.        then add the following line to your c:\AUTOEXEC.BAT file:
  5049.  
  5050.                  SET COM-AND=C:\COM-AND
  5051.  
  5052.  
  5053.  
  5054.  
  5055.  
  5056.  
  5057.  
  5058.  
  5059.  
  5060. Version 2.8: 910716                           Appendices
  5061.  
  5062. COM-AND: IBM PC Communications and Accessories                 Page  86
  5063.  
  5064.  
  5065. I.    Environment variables (continued)
  5066.  
  5067.  
  5068.     2. COMSPEC=
  5069.  
  5070.  
  5071.        COM-AND uses the environment variable "COMSPEC=" to identify the
  5072.        shell program to be used when Alt-F10'ing or executing the SHELL
  5073.        script command.  This environment variable is already set in most
  5074.        installations.
  5075.  
  5076.  
  5077.     3. Other variables
  5078.  
  5079.  
  5080.        COM-AND's script language allows access to environment variables
  5081.        through the ENVIRON statement.  Scripts written for COM-AND may
  5082.        therefore be sensitive to environment variables.
  5083.  
  5084.        The script statement "EBL" and EBLSET" look for a 'BATINT='
  5085.        environment variable to set the (hex) interrupt number for EBL.
  5086.  
  5087.  
  5088.  
  5089.  
  5090.  
  5091.  
  5092.  
  5093.  
  5094.  
  5095.  
  5096.  
  5097.  
  5098.  
  5099.  
  5100.  
  5101.  
  5102.  
  5103.  
  5104.  
  5105.  
  5106.  
  5107.  
  5108.  
  5109.  
  5110.  
  5111.  
  5112.  
  5113.  
  5114.  
  5115. Version 2.8: 910716                           Appendices
  5116.  
  5117. COM-AND: IBM PC Communications and Accessories                 Page  87
  5118.  
  5119.  
  5120. J.    Background operation
  5121.  
  5122.  
  5123.     COM-AND may be used as a background process with several of the
  5124.     available multi-tasking operating environments.  In particular,
  5125.     file transfers are buffered, and send is interrupt driven to
  5126.     provide maximum efficiency when used as a background processor
  5127.     (which of course means more efficiency in foreground mode, too).
  5128.  
  5129.  
  5130.     COM-AND has been made 'shadow-buffer' aware... if an operating
  5131.     environment such as DesqView or Windows establishes a shadow-buffer
  5132.     for the screen, COM-AND uses it.  Thus, COM-AND does not need to be
  5133.     flagged as "writing directly to the screen" under such environments.
  5134.  
  5135.  
  5136.     The only exception to this is RLE displays in interactive mode (RLE
  5137.     displays are inhibited during the script processor).  RLE displays
  5138.     switch the screen from text to graphics modes; during RLE display
  5139.     all access to the screen is performed using BIOS write-pixel calls
  5140.     However, you should turn RLE displays off (through Alt-O) if you
  5141.     plan on using COM-AND regularly in background mode, and view RLEs.
  5142.  
  5143.  
  5144.     The distribution of COM-AND includes a PIF and ICO (icon) file for
  5145.     Windows and a DVP file for DesqView.
  5146.  
  5147.  
  5148.  
  5149.  
  5150.  
  5151.  
  5152.  
  5153.  
  5154.  
  5155.  
  5156.  
  5157.  
  5158.  
  5159.  
  5160.  
  5161.  
  5162.  
  5163.  
  5164.  
  5165.  
  5166.  
  5167.  
  5168.  
  5169.  
  5170. Version 2.8: 910716                           Appendices
  5171.  
  5172. COM-AND: IBM PC Communications and Accessories                 Page  88
  5173.  
  5174.  
  5175. K.    Encoded music
  5176.  
  5177.  
  5178.     Beginning with version 2.3, COM-AND uses encoded music strings for
  5179.     several different purposes:
  5180.  
  5181.     .  If the file COM-AND.TUN exists on the default drive:subdirectory
  5182.        (or on the COM-AND= drive:subdirectory), and it contains a valid
  5183.        encoded music string (not to exceed 40 notes), COM-AND will use
  5184.        the encoded string for its alarm.
  5185.  
  5186.     .  The alarm tune may be changed with a "SET TUNE" command through
  5187.        a script file.  The new alarm tune holds until it is changed,
  5188.        or until COM-AND is terminated.
  5189.  
  5190.     .  A script may PLAY an encoded music string during its execution
  5191.        (up to 80 notes).
  5192.  
  5193.     .  An escape sequence to play music has been implemented (for some
  5194.        RBBS boards).  The escape sequence is "ESC [M <music string> ^N"
  5195.        allowing up to 255 characters for the <music string>.
  5196.  
  5197.  
  5198.     The script ALARM.CMD is included with this release.  ALARM contains
  5199.     a number of simple melodies that may be substituted for the alarm
  5200.     tune.  The ALARM script allows the tunes to be sampled, and one may
  5201.     be selected permanently (if it doesn't hurt the ear...).  Permanent
  5202.     selection means that the script creates a file, COM-AND.TUN which
  5203.     will be used by COM-AND every time it is loaded.
  5204.  
  5205.  
  5206.     Syntax for music statements will be found in an appendix to the
  5207.     CASCRIPT.DOC document.    The interested reader is referred there.
  5208.  
  5209.  
  5210.  
  5211.  
  5212.  
  5213.  
  5214.  
  5215.  
  5216.  
  5217.  
  5218.  
  5219.  
  5220.  
  5221.  
  5222.  
  5223.  
  5224.  
  5225. Version 2.8: 910716                           Appendices
  5226.  
  5227. COM-AND: IBM PC Communications and Accessories                 Page  89
  5228.  
  5229.  
  5230. L.    BIOS Comm Read/Write
  5231.  
  5232.  
  5233.     Beginning with version 2.3 of COM-AND, BIOS read/write comm port
  5234.     calls are intercepted by COM-AND.  When the port number matches
  5235.     the comm port currently opened by COM-AND, COM-AND makes available
  5236.     its interrupt driven read/write procedures.  Only read/write
  5237.     are supported.    Open (change parameters) and status are stubbed.
  5238.  
  5239.  
  5240.     COM-AND's interception of BIOS comm port calls opens some doors for
  5241.     the wary.  For example, the following script is useful:
  5242.  
  5243.         KFLUSH            ; Clear the keyboard buffer
  5244.         STACK "CTTY COM2:!"     ; Stack a cmd for DOS
  5245.         SHELL            ; Shell-to-DOS
  5246.  
  5247.     After the shell-to-DOS, DOS functions are available through the comm
  5248.     port.  If COM-AND had previously established a connection through the
  5249.     modem (dialed another PC, or used the CONNECT script to answer the
  5250.     phone), then DOS would be available to the caller!  [Note that only
  5251.     very-well-behaved programs may be used through this link.  A program
  5252.     that writes to screen memory or intercepts keyboard interrupts WILL
  5253.     NOT be available, and will make it difficult to terminate remotely.]
  5254.  
  5255.  
  5256.     Programs using no more communications support than that provided by
  5257.     BIOS may use COM-AND's communications, and act as accessories.  Such
  5258.     programs, when loaded through the accessory menu (or DOS Gateway)
  5259.     take advantage of COM-AND's communication support (and XON/XOFF flow
  5260.     control).
  5261.  
  5262.  
  5263.     The author would be interested in hearing of any applications
  5264.     developed to use this feature, and would be interested in discussing
  5265.     its future refinement.
  5266.  
  5267.  
  5268.  
  5269.  
  5270.  
  5271.  
  5272.  
  5273.  
  5274.  
  5275.  
  5276.  
  5277.  
  5278.  
  5279.  
  5280. Version 2.8: 910716                           Appendices
  5281.  
  5282. COM-AND: IBM PC Communications and Accessories                 Page  90
  5283.  
  5284.  
  5285. M.    Modem initialization
  5286.  
  5287.  
  5288.     COMMON MODEM PARAMETER INITIALIZATION VALUES for USE WITH COM-AND
  5289.     and OTHER COMMON COMMUNICATIONS PROGRAMS,     by Jim Aspinwall
  5290.     -----------------------------------------------------------------
  5291.  
  5292.     As a user of computer modems and communications software, you should
  5293.     be aware of several aspects that affect your modem, your software,
  5294.     and successful on-line operation.
  5295.  
  5296.     It seems that the most common problems we have encountered have to
  5297.     do with how or if the modem reports back on the status of the
  5298.     Carrier Detect (DCD or CD) signal.  That is, whether or not you are
  5299.     on-line, connected to another modem.  Also, how the modem responds
  5300.     to the Data Terminal Ready (DTR) signal from the terminal or PC.
  5301.  
  5302.     In many cases the modems we use have default or factory configura-
  5303.     tions that cause DCD to indicate that you are on-line at all times,
  5304.     even if there has been no connection made; and the modem acts like
  5305.     the terminal or software is active all of the time.
  5306.  
  5307.     This situation does not always prohibit proper communications, but
  5308.     it does make some operations inefficient, or causes error messages
  5309.     that are inaccurate.  Setting these and other parameters to the
  5310.     values we have shown below, or equivalent values specific to your
  5311.     modem, have resulted in very successful on-line operations for a
  5312.     great many users.
  5313.  
  5314.     You must also correlate some of the modem values to corresponding
  5315.     values in your communications software.  One value of particular
  5316.     note is the modem's S7 register.  The value in this register sets
  5317.     how long the modem waits for a carrier after dialing a call.  Most
  5318.     modems use 40 seconds as a default.  It is likely that your communi-
  5319.     cations software also provides a Wait-For-Carrier parameter for its
  5320.     operation.
  5321.  
  5322.     If these two values are different, you may get unexpected results in
  5323.     originating calls.  Either the modem hangs-up before the call is
  5324.     established while the software is still waiting, or the software
  5325.     aborts the call origination before enough time has elapsed.  Setting
  5326.     the parameter at the modem S7 register does not set the value in
  5327.     your software, and setting the value in the software does not reset
  5328.     it for the modem.  There are a few other parameters that may exhibit
  5329.     this difference, so you should read the modem and software documen-
  5330.     tation carefully.
  5331.  
  5332.  
  5333.  
  5334.  
  5335. Version 2.8: 910716                           Appendices
  5336.  
  5337. COM-AND: IBM PC Communications and Accessories                 Page  91
  5338.  
  5339.  
  5340. M.    Modem initialization (continued)
  5341.  
  5342.  
  5343.     As annoying as it may seem to issue YET ANOTHER reminder about docu-
  5344.     mentation, it IS very helpful to read through it all, even if you
  5345.     think you will not understand or need it all, at first.  Once you
  5346.     have become familiar with what information is where you will be able
  5347.     to recognize problems and their solutions as they arise.  Many
  5348.     veteran users are pleasantly surprised
  5349.  
  5350.  
  5351.     Product R&D Corp.: (per Charlie)
  5352.     -----------------
  5353.       AT&C1S7=60S11=40V1X1
  5354.  
  5355.  
  5356.     MICROCOM 9624c: (per Mike, modified 891103)
  5357.     --------------
  5358.       Modem Init:    ATE1\C1\G0\J1\K5\N3\Q0&T5\V1V1\X1S0=0^M
  5359.       Dial Command: AT\N3DT
  5360.  
  5361.       Alt-P:    9600,N,8,1,COM1
  5362.       Alt-O:    Keyboard=ON
  5363.             Drop DTR=ON
  5364.       Alt-S:    Break Delay=250 ms
  5365.             Alarm Duration=3 sec
  5366.  
  5367.  
  5368.     Everex 2400 internal (older style?): (per Jim)
  5369.     -----------------------------------
  5370.       Switches 1 and 2;    as appropriate for COM 1,2,3 or 4
  5371.       Switches 3,4,5;    OFF (default)
  5372.       String = AT&D2S7=60^M (the &D2 sets proper DTR, can also be done
  5373.                 with S21=48 or S21=112 (default=96))
  5374.  
  5375.  
  5376.     Leading Edge 2400B half-size internal: (per Jim)
  5377.     -------------------------------------
  5378.       Switches 1 and 2;    COM 1,2,3,4 selection
  5379.       Switches 3,4,5,6;    OFF (default)
  5380.       String = ATS7=60X3^M (there are no &... settings and no S21, DCD
  5381.                    and DTR are set by switches)
  5382.  
  5383.  
  5384.     Practical Peripherals 2400 half-size internal: (per Jim)
  5385.     ---------------------------------------------
  5386.       Switch on rear selects COM 1 or 2
  5387.       String = AT&C1&D2L0X3^M  (S21=117 is another way of doing &C1&D2)
  5388.  
  5389.  
  5390. Version 2.8: 910716                           Appendices
  5391.  
  5392. COM-AND: IBM PC Communications and Accessories                 Page  92
  5393.  
  5394.  
  5395. M.    Modem initialization (continued)
  5396.  
  5397.  
  5398.     Everex, Evercom 24+ (MNP): (per Mike)
  5399.     -------------------------
  5400.       Modem INIT string:  AT\N3\Q1\K5\V1\X1\C1^M
  5401.       Dialing Prefix:     AT\N3DT (\N3 forces the modem to MNP)
  5402.       Break Delay:          250 ms
  5403.       Drop DTR on Hangup: ON
  5404.  
  5405.  
  5406.     Ven-Tel Pathfinder 18k: (per Jim)
  5407.     ----------------------
  5408.       Init String: ATS0=0S7=60S51=5S52=1S53=1S58=2S66=1S95=2&W^M
  5409.  
  5410.       AutoAnswer Off/Wait 60secs for carrier/Serial Port at 19,200
  5411.       DTR active/DCD active/Hardware handshake/Lock Serial Port/Auto MNP
  5412.  
  5413.       With these settings set into the modem and written (&W) once the
  5414.       user can recall them (INIT) using AT&E^M, instead of the entire
  5415.       string. It is handy to place this string in a comm. program macro
  5416.       for later use, should the modem get reset to factory values or
  5417.       other events change the desired settings.
  5418.  
  5419.       FACTORY   Jim's     Function and Notes
  5420.       DEFAULT   Usage     about settings
  5421.       -------   -----     ------------------
  5422.       S0=1        S0=0      This depends on ORIG/ANSWER side
  5423.       S7=40     S7=60     Longer for some calls/systems...
  5424.       S45=0     S45=0     Keep disabled (0) for secure/support operations
  5425.       S50=0     S50=0     Auto-speed (starts high, allows other uses)
  5426.       S51=4     S51=5     19,200 VS. 9600 SERIAL LINE
  5427.       S52=0     S52=1     DTR must be active...
  5428.       S53=0     S53=1     DCD must be active...
  5429.       S58=3     S58=2     Hardware handshake is faster
  5430.       S61=45    S61=0-255 Speaker volume, =<45 is best.
  5431.       S66=0     S66=1     Lock serial speed, flow control
  5432.       S95=0     S95=2     Auto-reliable MNP mode
  5433.       S110=255  S110=255  Compression depends on other side
  5434.             S110=1    To control remote's compression ON
  5435.       S111=255  S111=255  Protocol depends on other side
  5436.             S111=10   KERMIT 8,n,1
  5437.             S111=20   XMODEM
  5438.             S111=30   UUCP
  5439.  
  5440.       Note : Only items with remarks need to be changed and re-written
  5441.       to the EEPROM ( with &W) vs. factory defaults. ATZ recalls all
  5442.       parameters to Factory defaults. AT&E recalls EEPROM values.
  5443.  
  5444.  
  5445. Version 2.8: 910716                           Appendices
  5446.  
  5447. COM-AND: IBM PC Communications and Accessories                 Page  93
  5448.  
  5449.  
  5450. N.    COM-AND's Backscreen
  5451.  
  5452.  
  5453.     Beginning with COM-AND 2.8, the backscreen function performs its task
  5454.     as customers have asked.  This was a major modification to COM-AND's
  5455.     backscreen function, and has several ramifications:
  5456.  
  5457.  
  5458.     o    Previously released accessories no longer perform backscreen
  5459.         functions with COM-AND 2.8.  [New versions of popular acces-
  5460.         sories will be released, supporting the new function.]
  5461.  
  5462.     o    The backscreen-to-transcript function now does not save the
  5463.         exact text received... rather it saves the formatted screen
  5464.         lines to the transcript.
  5465.  
  5466.         If ANSI display is used, or VT100 or VT52, not necessarily
  5467.         all the received display will be written to the transcript.
  5468.         The backscreen no longer captures cursor positioning.
  5469.  
  5470.         Should it be necessary to capture exactly what was sent,
  5471.         ASCII receive (though limiting) is now required.
  5472.  
  5473.  
  5474.     The new backscreen is faster than before.  Considerably.  The author
  5475.     hopes that it meets the approval of those who requested it.
  5476.  
  5477.  
  5478.  
  5479.  
  5480.  
  5481.  
  5482.  
  5483.  
  5484.  
  5485.  
  5486.  
  5487.  
  5488.  
  5489.  
  5490.  
  5491.  
  5492.  
  5493.  
  5494.  
  5495.  
  5496.  
  5497.  
  5498.  
  5499.  
  5500. Version 2.8: 910716                           Appendices
  5501.  
  5502. COM-AND: IBM PC Communications and Accessories                 Page  94
  5503.  
  5504.  
  5505. O.    Customizing COM-AND
  5506.  
  5507.  
  5508.     Several methods are immediately available to customize COM-AND for
  5509.     particular purposes.  Some script authorship is required, but the
  5510.     result a communications program tailored to an exact application.
  5511.     Beyond customization of the existing COM-AND product, other custom-
  5512.     izations are possible and negotiable.
  5513.  
  5514.  
  5515.     1) COM-AND initialization
  5516.  
  5517.        When COM-AND is loaded, it performs an initialization process
  5518.        (opening the comm port, sending an init string, opening files, and
  5519.        so on).  After initialization, a shareware advertisement is dis-
  5520.        played (unless turned off in Alt-O).  After the advert, if a
  5521.        script named COM-AND.CMD is found in the current default subdirec-
  5522.        tory OR the "COM-AND=" environment variable indicated subdirec-
  5523.        tory, that script is executed.
  5524.  
  5525.        A simple COM-AND.CMD script may be created to display an opening
  5526.        screen, set options and values to your preference, and to offer an
  5527.        initial menu.  For example, a menu might be offered making func-
  5528.        tion key F1 dial a certain number, function key F3 enter COM-AND
  5529.        proper and function key F5 exit COM-AND back to DOS.
  5530.  
  5531.  
  5532.     2) COM-AND termination
  5533.  
  5534.        When COM-AND is terminated (either by Alt-X or through the script
  5535.        statement "BYE"), COM-AND tests for carrier (may be turned off by
  5536.        Alt-O or "SET CDRESPECT OFF").  If carrier is found (if tested), a
  5537.        prompt for hangup is issued.  After the carrier test, COM-AND
  5538.        tests to determine if an "exit script" has been established.  If
  5539.        an exit script has been named, COM-AND attempts to execute it.
  5540.  
  5541.        Exit scripts are defined through the script statement "SET EXIT".
  5542.        If the indicated file does not exist, COM-AND terminates.  If the
  5543.        indicated file exists, COM-AND executes it as a script.
  5544.  
  5545.        Upon Alt-X then, COM-AND may be customized to provide a menu of
  5546.        choices (e.g. dial another system, and a list of systems).  When
  5547.        established, the exit script determines if COM-AND is actually to
  5548.        terminate, or to continue.
  5549.  
  5550.  
  5551.  
  5552.  
  5553.  
  5554.  
  5555. Version 2.8: 910716                           Appendices
  5556.  
  5557. COM-AND: IBM PC Communications and Accessories                 Page  95
  5558.  
  5559.  
  5560. O.    Customizing COM-AND (continued)
  5561.  
  5562.  
  5563.     3) DOS after COM-AND
  5564.  
  5565.        An interesting feature of COM-AND's script language is the state-
  5566.        ment "STACK".  STACK places a string into the BIOS keyboard
  5567.        buffer.  An exit script might easily offer selections that invoke
  5568.        other programs through DOS.    For example, the script:
  5569.  
  5570.         SET TTHRU OFF        ; Turn off script typethrough
  5571.         STACK "DIR *.*!"        ; Set-up to execute a DOS DIR cmd
  5572.         BYE            ; Terminate com-and and do a DIR
  5573.  
  5574.        terminates COM-AND (without hanging up... be careful), and
  5575.        executes a DIR *.* through DOS.  More interesting things might
  5576.        be found, I'm sure, to do with DOS.... but the point is made.
  5577.  
  5578.     4) Keyboard remapping
  5579.  
  5580.        COM-AND maps the Alt'd and function keys on the PC keyboard in a
  5581.        manner consistent with (the author's experience of) common usage.
  5582.        Other maps for the PC keyboard may well be imagined.  The keyboard
  5583.        remap function (available through the REMAP.CMD script) makes it
  5584.        very possible to change the assignments.
  5585.  
  5586.        As the simplest example, COM-AND's F10 help window might be con-
  5587.        sidered inadequate (the author thinks it is...).  To change this
  5588.        sad state of affairs, the following remap might be created:
  5589.  
  5590.         F10 = 255 "HELP" CR
  5591.  
  5592.        This remap says in effect:  When the F10 key is pressed, COM-AND
  5593.        will see the character with value 255, the characters "H" "E" "L"
  5594.        and "P", and a CR.  255 as a character is documented above under
  5595.        Alt-M Macros.  The character 255 in COM-AND has the same function
  5596.        as F2 (run a script), but does not pop up a window and search the
  5597.        drive for all files *.CMD and *.ENF.  "HELP" would be interpreted
  5598.        by the 255 function as a script name (either HELP., HELP.CMD or
  5599.        HELP.ENF on the default or COM-AND= subdirectory).  The CR causes
  5600.        the 255 function to execute the script named HELP.
  5601.  
  5602.        So...  one might write one's own help window (see the help screens
  5603.        in FILEMGR or LEARN), call it HELP.CMD, put it in the COM-AND=
  5604.        subdir, and never see the author's idea of a HELP summary again.
  5605.        It might be paginated, indexed, what-have-you.
  5606.  
  5607.  
  5608.  
  5609.  
  5610. Version 2.8: 910716                           Appendices
  5611.  
  5612. COM-AND: IBM PC Communications and Accessories                 Page  96
  5613.  
  5614.  
  5615. O.    Customizing COM-AND (continued)
  5616.  
  5617.  
  5618.     5) Functional customization
  5619.  
  5620.        The author of COM-AND will customize a version of COM-AND for
  5621.        anyone licensing 30 or more copies of COM-AND (site license).
  5622.        This customization is limited to:
  5623.  
  5624.        .    Alt-I Information screen:  10 lines of the program informa-
  5625.         tion screen are devoted to a description of COM-AND and its
  5626.         accessories in the 'standard' edition.  CABER Software will
  5627.         encode any information a licensee (meeting the quantity
  5628.         restriction) requests in this space.  CABER Software will
  5629.         retain the last lines of the window for itself.
  5630.  
  5631.        .    Copyright statement upon termination: CABER software will
  5632.         change the program termination notice from:
  5633.  
  5634.             "Freely redistributable; R. Scott McGinnis <date>"
  5635.  
  5636.         to  "Licensed from CABER Software (all rights reserved),
  5637.              <date>, by: <licensee name>"
  5638.  
  5639.        .    Customization is limited to the current version of COM-AND.
  5640.         The same customization, applied to later releases of COM-AND
  5641.         may be had from CABER Software upon request, for a fee of
  5642.         $15.00 each release.  CABER Software will not automatically
  5643.         update customized versions.
  5644.  
  5645.  
  5646.        Other functional customizations are negotiable.
  5647.  
  5648.  
  5649.  
  5650.  
  5651.  
  5652.  
  5653.  
  5654.  
  5655.  
  5656.  
  5657.  
  5658.  
  5659.  
  5660.  
  5661.  
  5662.  
  5663.  
  5664.  
  5665. Version 2.8: 910716                           Appendices
  5666.  
  5667. COM-AND: IBM PC Communications and Accessories                 Page  97
  5668.  
  5669.  
  5670. P.    BIOS (INT 14h) communications
  5671.  
  5672.  
  5673.     With version 2.7, COM-AND may be directed to invoke BIOS services for
  5674.     communications.  Communications programs, per se, exist in large part
  5675.     BECAUSE of the BIOS comm service routines...  what BIOS provided in
  5676.     the early days of the PC was generally useless; to perform communica-
  5677.     tions work, one wrote one's own.
  5678.  
  5679.  
  5680.     However, at this date, it is becoming common for LAN modem servers
  5681.     and special purpose communications gear to 'take over' the BIOS ser-
  5682.     vice routines, and replace them with special code.  COM-AND now pro-
  5683.     vides the capability to override its own communications driver (in-
  5684.     ternal) and be directed to use the BIOS service routines instead.
  5685.  
  5686.  
  5687.     Due to the nature of the original BIOS service call definitions,
  5688.     certain COM-AND functions are disabled or ignored when COM-AND is
  5689.     directed to invoke BIOS for communications.
  5690.  
  5691.         . When COM-AND is run /p, the Alt-P value (script COMPARM)
  5692.           shown for the 'current setting' only reflects the default
  5693.           set for COM-AND.  BIOS doesn't allow settings to be read.
  5694.  
  5695.         . True break is disabled (Ctl-End).  The original BIOS has no
  5696.           facility to perform true break.
  5697.  
  5698.         . DROP DTR is ignored even if set.  Some versions of BIOS
  5699.           do and some don't allow access to DTR.
  5700.  
  5701.         . RTS Flow control is ignored even if set, for the same
  5702.           reason as DROP DTR is ignored.
  5703.  
  5704.  
  5705.  
  5706.  
  5707.  
  5708.  
  5709.  
  5710.  
  5711.  
  5712.  
  5713.  
  5714.  
  5715.  
  5716.  
  5717.  
  5718.  
  5719.  
  5720. Version 2.8: 910716                           Appendices
  5721.  
  5722. COM-AND: IBM PC Communications and Accessories                 Page  98
  5723.  
  5724.  
  5725. P.    BIOS (INT 14h) communications (continued)
  5726.  
  5727.  
  5728.     This modification is not intended to be used with BIOS proper, al-
  5729.     though it can be (at 300 baud).  BIOS proper does not provide an in-
  5730.     terrupt service routine; therefore, the comm port must be constant-
  5731.     ly 'sampled' to find if a character has been received.  At 300 baud,
  5732.     with a fast CPU, BIOS sampling is possible.  At 1200 baud, even with
  5733.     a 16Mhz machine, characters are dropped.
  5734.  
  5735.  
  5736.     To direct COM-AND to use BIOS communications, run COM-AND thusly:
  5737.  
  5738.         "d>" COM-AND BIOS <other switches and parameters>
  5739.  
  5740.  
  5741.     COM-AND's BIOS redirection is only partially dependant on the current
  5742.     port set in COM-AND.  When BIOS redirection is used, COM-AND places
  5743.     the base address for the current port (declared through Alt-P) in the
  5744.     appropriate BIOS parameter area (it restores the previous value when
  5745.     COM-AND exits).  This overrides default BIOS base addresses, if the
  5746.     INT 14h service routine uses the BIOS parameter area.
  5747.  
  5748.  
  5749.     However, when COM-AND invokes service through the BIOS INT 14h, it
  5750.     does not pass a base address; a port number (0,1,2,3 representing
  5751.     COM1 through COM4) is passed.  The port number passed is the port for
  5752.     the currently selected COM port (e.g.  0 for COM1, 1 for COM2) unless
  5753.     a port number override was specified in the run command.
  5754.  
  5755.  
  5756.     To override the port number passed to the INT 14h service routine
  5757.     (i.e. pass a number larger than 3), run COM-AND thusly:
  5758.  
  5759.         "d>" COM-AND BIOS(5) <other switches and parameters>
  5760.  
  5761.  
  5762.     The port number following the BIOS keyword is then passed to INT 14h
  5763.     on all calls.  The port number MUST be encased in parentheses.
  5764.  
  5765.  
  5766.     When BIOS redirection is used, COM-AND does NOT replace the INT 14h
  5767.     BIOS service routines with its own driver.  COM-AND simply uses the
  5768.     service routines provided.
  5769.  
  5770.  
  5771.  
  5772.  
  5773.  
  5774.  
  5775. Version 2.8: 910716                           Appendices
  5776.  
  5777. COM-AND: IBM PC Communications and Accessories                 Page  99
  5778.  
  5779.  
  5780. P.    16550A(N) UARTs
  5781.  
  5782.  
  5783.     A UART is the 40 pin chip in the serial board.    UART means Universal
  5784.     Asynchronous Receiver Transmitter.  The UART chip converts an 8 bit
  5785.     byte from parallel to serial, sending, and from serial to parallel,
  5786.     receiving.  This is the electronic base for serial communications.
  5787.  
  5788.     The original UART used in PCs was the 8250.  This was (relatively)
  5789.     slow, but adequate for the 4.77 Mhz bus speed of the PC and XT.  With
  5790.     the 8 Mhz bus speed of the AT, a faster chip was needed.  The 16450
  5791.     was used.  The 8250 and 16450 chips are functionally identical, and
  5792.     are pin compatible.  Many AT computers come with an 8250 UART now on
  5793.     their serial port.
  5794.  
  5795.     To gain maximum efficiency from certain modems, the serial port is
  5796.     set fixed to 19,200 baud.  Most computers can keep up with that.
  5797.     However, expansion boards such as (some) disk controllers, and (some)
  5798.     Network Interface cards tie up the machine for (relatively) long
  5799.     intervals of time.  When interrupts are suppressed for more than one
  5800.     character time (1/1920th of a second at 19,200 baud) the character
  5801.     coming in through the serial port is lost.  [With a 2400 baud modem,
  5802.     there is 1/240th of a second between characters.  Much more lee-way!]
  5803.     At 19,200 baud, potential problems became apparent.
  5804.  
  5805.     For these newer modems a new UART was needed to buffer characters
  5806.     that would otherwise be lost, until the computer was able to read
  5807.     them.  National Semiconductor constructed the 16550 UART.  With the
  5808.     UART buffering, the computer can be busy doing something else for up
  5809.     to 16 character times, with no characters lost.
  5810.  
  5811.     The 16550 works on any serial port that now has an 8250 or 16450.
  5812.     The 16550 is pin-for-pin identical to the 16450/8250.  However, no-
  5813.     thing comes for free.  Special software is needed to activate the
  5814.     buffer.  Unactivated, the 16550 acts like a 16450 without the buffer;
  5815.     simply a fast UART.
  5816.  
  5817.     With version 2.7, COM-AND recognizes the 16550 UART and activates it
  5818.     when a communications port is opened.  A script author may even
  5819.     inquire what type of UART is present (through the intrinsic "_UART").
  5820.     COM-AND resets the 16550 to its previous mode when the port is
  5821.     closed.
  5822.  
  5823.     The use of the 16550 UART provides a noticeable improvement in speed
  5824.     of transfers when a 4.77 Mhz CPU is used.
  5825.  
  5826.  
  5827.  
  5828.  
  5829.  
  5830. Version 2.8: 910716                           Appendices
  5831.  
  5832. COM-AND: IBM PC Communications and Accessories                 Page 100
  5833.  
  5834.  
  5835. R.    High-Speed Communication
  5836.  
  5837.  
  5838.     As described above (Appendix J, Background Operation), COM-AND imple-
  5839.     ments interrupt driven sends to maximize speed of file transfers
  5840.     (when COM-AND is sending).  This is particularly useful when COM-AND
  5841.     is used in the background DesqView or Windows 3.0.
  5842.  
  5843.  
  5844.     However, this method has drawbacks, too.  Particularly with the 8250
  5845.     UART (see above, Appendix Q, 16550A(N) UARTs), the maximum send rate
  5846.     can overrun the receiver, especially at high speeds.
  5847.  
  5848.  
  5849.     If you use COM-AND at 115kbaud (or 57.6kbaud sometimes) it is recom-
  5850.     mended that interrupt driven sends be turned OFF.  TO do so, set SLOW
  5851.     Xfer ON in Alt-O (Options).  [The script command is SET SLOW ON.]
  5852.  
  5853.  
  5854.     Setting SLOW ON does not drastically reduce the speed with which
  5855.     sends are performed.  At most, under DOS, a few percent decrease in
  5856.     efficiency will be noticed while uploading (none during downloads).
  5857.     Under multi-tasking environments, a considerably larger decrease in
  5858.     efficiency may be noted when COM-AND is uploading in the background.
  5859.  
  5860.  
  5861.     16550A(N) UARTs may also be used to improve the transfer speed.
  5862.     Experimentation with 16550s and your PC(s) will show whether COM-AND
  5863.     will perform reliable transfers at 115kbaud given the PC speed and
  5864.     UARTS you use with SLOW OFF.
  5865.  
  5866.  
  5867.  
  5868.  
  5869.  
  5870.  
  5871.  
  5872.  
  5873.  
  5874.  
  5875.  
  5876.  
  5877.  
  5878.  
  5879.  
  5880.  
  5881.  
  5882.  
  5883.  
  5884.  
  5885. Version 2.8: 910716                           Appendices
  5886.  
  5887. COM-AND: IBM PC Communications and Accessories                 Page 101
  5888.  
  5889.  
  5890. S.    Doorways
  5891.  
  5892.  
  5893.     A number of 'doorway' utilities are available for the intrepid PC
  5894.     communicator.  With a doorway utility running on a PC, and a connec-
  5895.     tion to another PC through a comm port established,  the display of
  5896.     the host PC (the one running the doorway) is ALSO displayed on the
  5897.     remote PC (the one connected), and keyentry from the remote PC is
  5898.     accepted by the host PC as if entered on the local keyboard.
  5899.  
  5900.  
  5901.     Literally, two people can work together in one program, document,
  5902.     spreadsheet, or what-have-you.    Albeit most 'doorway' type utilities
  5903.     are limited to text-only mode, this is not an overly severe limita-
  5904.     tion at this time.  [Don't try to doorway Windows, or graphics!]
  5905.  
  5906.  
  5907.     COM-AND, of course, provides a vehicle for connecting two PCs through
  5908.     a modem.  The CONNECT script, supplied in the scripts archive of this
  5909.     release allows one PC to go into autoanswer, to accept an incoming
  5910.     call.  The other side of the connection makes a call to the host PC
  5911.     in the usual manner.
  5912.  
  5913.  
  5914.     Once two PCs are connected through the modem, EITHER PC can then exe-
  5915.     cute the doorway function.  The doorway may be loaded ON-TOP of the
  5916.     existing communications program (i.e.  through a shell-to-DOS), or if
  5917.     the communications program permits, IN PLACE of the communications
  5918.     program.
  5919.  
  5920.  
  5921.     With this version of COM-AND, a new script is included in the scripts
  5922.     archive, named DOORWAY.  The DOORWAY script unloads COM-AND without
  5923.     breaking an existing connection, loads a doorway utility... and on
  5924.     exit from the doorway utility reloads COM-AND, again without breaking
  5925.     the connection.  Used this way, almost all of the memory occupied by
  5926.     COM-AND in execution is freed for use by the doorway and DOS.
  5927.  
  5928.  
  5929.     Ths script DOORWAY requires editing;  you must change the first line
  5930.     to invoke the doorway utility you have, and the comm port you use.
  5931.     The script supplied is set for Marshall Dudley's DOORWAY utility.
  5932.     Any similar utility might be invoked in its place.
  5933.  
  5934.  
  5935.  
  5936.  
  5937.  
  5938.  
  5939.  
  5940. Version 2.8: 910716                           Appendices
  5941.  
  5942. COM-AND: IBM PC Communications and Accessories                 Page 102
  5943.  
  5944.  
  5945. S.    Doorways
  5946.  
  5947.  
  5948.     The host PC (the one running the doorway) keeps the display of the
  5949.     remote PC (the one NOT running the doorway) up-to-date using control
  5950.     sequences.  The remote must be set to the appropriate display emula-
  5951.     tion (in the case of Marshall Dudley's DOORWAY, the ANSI display
  5952.     emulation of Alt-V would be selected by the remote PC).
  5953.  
  5954.  
  5955.     The remote PC must have a means of sending not only simple keystrokes
  5956.     but a means to send function keys (if the remote user wants to have
  5957.     function and Alt'd keys available).  The remote PC must therefore
  5958.     distinguish function keystrokes from from simple text in what it
  5959.     sends.    For Marshall Dudley's DOORWAY (and all similar utilities),
  5960.     COM-AND supplies a 'mode', tied to the Alt-Minus key.  In 'Remote'
  5961.     mode, function (and Alt'd) keystrokes do NOT pop-up COM-AND windows;
  5962.     they are instead sent to the host doorway utility.
  5963.  
  5964.  
  5965.     The remote PC user toggles 'Remote mode' with the Alt-Minus key.
  5966.     That means that Alt-Minus itself is recognized by COM-AND in EITHER
  5967.     mode... and therefore Alt-Minus cannot be sent to the host.  A simple
  5968.     macro, or script may be used to send that one keystroke to the host.
  5969.  
  5970.  
  5971.     COM-AND converts mouse motion (and mouse-keyclicks) on the remote PC
  5972.     to cursor keys (keyclicks to PgUp, PgDn, ESC and CR) as discussed in
  5973.     Chapter V above, Menu mode.  Therefore, if the program running on the
  5974.     host accepts cursor keys and PgUp/PgDn, even the mouse on the remote
  5975.     PC is useful!
  5976.  
  5977.     To summarize, the host PC must (minimally):
  5978.  
  5979.     .  make connection with the remote by calling or answering a call
  5980.  
  5981.     .  ensure the remote user's display emulation is set correctly
  5982.  
  5983.     .  load the doorway utility (plus whatever program the doorway will
  5984.        execute;  the supplied DOORWAY script invokes the DOS prompt)
  5985.  
  5986.     .  exit the doorway utility (the remote user may initiate the exit
  5987.        too, in most cases)
  5988.  
  5989.     .  disconnect from the call
  5990.  
  5991.  
  5992.  
  5993.  
  5994.  
  5995. Version 2.8: 910716                           Appendices
  5996.  
  5997. COM-AND: IBM PC Communications and Accessories                 Page 103
  5998.  
  5999.  
  6000. S.    Doorways
  6001.  
  6002.  
  6003.     The remote PC's operation is a bit more complex.  It must:
  6004.  
  6005.     .  make connection with the host by calling or answering a call
  6006.  
  6007.     .  select appropriate display emulation (ANSI is usual) with Alt-V
  6008.  
  6009.     .  select other options according to the host's software:
  6010.  
  6011.        ..  Display control chars (Alt-O) should probably be ON
  6012.            (control characters are commonly used as displayed characters)
  6013.  
  6014.        ..  XON/XOFF software flow control (Alt-O) should probably be OFF
  6015.            (XON/XOFF are control characters commonly used in displays)
  6016.  
  6017.        ..  The status line should probably be turned OFF (in Alt-V)
  6018.            (depending on the doorway and the application)
  6019.  
  6020.        ..  Line wrap should probably be turned OFF (in Alt-V)
  6021.            (depending on the doorway and the application)
  6022.  
  6023.        ..  Menu mode should probably be turned OFF (with Alt =).  [Menu
  6024.            selection is performed with cursor keys.  In 'Remote' mode,
  6025.            these are sent to the host.]
  6026.  
  6027.     .  select 'remote' mode with Alt-Minus to send function keys to host
  6028.  
  6029.     .  return to usual after the doorway session by toggling Alt-Minus
  6030.        again (to exit COM-AND, one presses Alt-X;  in 'Remote mode', the
  6031.        Alt-X is simply sent to the host; turn OFF 'Remote mode' to exit!)
  6032.  
  6033.     .  disconnect from the call
  6034.  
  6035.  
  6036.  
  6037.  
  6038.  
  6039.  
  6040.  
  6041.  
  6042.  
  6043.  
  6044.  
  6045.  
  6046.  
  6047.  
  6048.  
  6049.  
  6050. Version 2.8: 910716                           Appendices
  6051.  
  6052. COM-AND: IBM PC Communications and Accessories                 Page 104
  6053.  
  6054.  
  6055. T.    Command Index
  6056.  
  6057.  
  6058.     -------------------------------------------------------------
  6059.     Key      Meaning                    Page
  6060.     --------- --------------------------------------------- -----
  6061.     F1      Switch between CRT and Accessory.        12,8-9
  6062.     F2      Perform a script                15,66
  6063.     F3      Set current disk/subdirectory         15,57
  6064.     F4      Set default download disk/subdirectory    15,52
  6065.     F5      ASCII upload.                 15,49
  6066.     F6      ASCII download.                15,51
  6067.     F7      Toggle logging (transcripting).        15,56
  6068.     F8      Toggle display of typed characters.        15,57
  6069.     F9      Toggle Log hold.                15,56
  6070.     F10      Help screen.                    12
  6071.     Alt-F10   DOS Gateway.                    12,61
  6072.     Alt-A      Toggle chat mode (on CRT screen)        17,57
  6073.     Alt-B      Redisplay (backscreen).            17,57
  6074.     Alt-C      Clear the screen.                12,58
  6075.     Alt-D      Dialing directory.                12,19-20
  6076.     Alt-E      Toggle echo (full/half duplex).        12,58
  6077.     Alt-F      File directory.                12,52
  6078.     Alt-G      Toggle blank line suppression         12,58
  6079.     Alt-H      Hangup.                    13,21
  6080.     Alt-I      Program information.                13
  6081.     Alt-J      Set screen colors                17,41
  6082.     Alt-K      Set KERMIT parameters             17,58
  6083.     Alt-L      Toggle 25/43 line modes            17,58
  6084.     Alt-M      Define a macro for Alt-0 through Alt-9.    13,22
  6085.     Alt-N      Encrypt/Decrypt a file            13,25
  6086.     Alt-O      Set program options.                13,34-41
  6087.     Alt-P      Comm Parameters.                13,32
  6088.     Alt-R      Redial the last number dialed.        13,21
  6089.     Alt-S      Setup.  Define initial program values.    13,28-31
  6090.     Alt-T      Elapsed time.                 14,59
  6091.     Alt-U      Annotate call-log                14,56
  6092.     Alt-V      Emulation, Translate, and Remap        62
  6093.     Alt-W      Playback                    17,59
  6094.     Alt-X      Exit the program.                14,59
  6095.     Alt-Y      Error information.                72
  6096.     Alt-Z      Toggle parity mask.                14,60
  6097.     Alt-0/9   Send a Macro.                 14,22
  6098.     Alt-Minus Toggle remote function key usage (Doorways)    17,101
  6099.     Alt-Equal Toggle menu mode                17,10
  6100.     PgUp      Begin an upload                16,42-52
  6101.     PgDn      Begin a download                16,42-52
  6102.     Ctl-End   Send a Break.                 12
  6103.     Ctl-PrtSc Toggle printer (LP1)                12
  6104.  
  6105. Version 2.8: 910716                           Appendices
  6106.