home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR10 / ACE181.ZIP / ACE.MAN < prev    next >
Text File  |  1994-01-17  |  240KB  |  8,730 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19. AceComm (tm)
  20.  
  21.  
  22.  
  23.  
  24.  
  25. User's Guide
  26.  
  27.  
  28.  
  29. Copyright (c) 1991-1994 by MGP Software.
  30.  
  31. All rights reserved.  No part of this publication may be reproduced, stored in
  32. a retrieval system, or transmitted by any means, electronic, mechanical,
  33. photocopying, recording, or otherwise, without express written permission from
  34. MGP Software.  The software described in this publication is furnished under a
  35. license agreement and may be used or copied only in accordance with the terms
  36. of that agreement.
  37.  
  38. This publication and its associated software are sold without warranties,
  39. either expressed or implied, regarding their merchantability or fitness for any
  40. particular application or purpose.  The information in this publication is
  41. subject to change without notice and does not represent a commitment on the
  42. part of MGP Software.  In no event shall MGP Software be liable for any loss of
  43. profit or any other commercial damage, including but not limited to special,
  44. incidental, consequential, or other damages resulting from the use of or the
  45. inability to use this product, even if MGP Software has been notified of the
  46. possibility of such damages.
  47.  
  48.  
  49. First Printing, January 1994
  50.  
  51. AceComm version 1.81
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. All brand and product names mentioned in this publication are trademarks or
  64. registered trademarks of their respective holders.
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.                 T a b l e   o f   C o n t e n t s
  72.  
  73.  
  74. Chapter 1  Introduction........................................1
  75.               QUICK START......................................3
  76. Chapter 2  Modem Setup.........................................8
  77. Chapter 3  AceComm Start up/ Terminal Area....................12
  78.               Pop Up Reference................................14
  79. Chapter 4  PRM-data Menus Area................................16
  80.               Area Controls / Options Menus...................17
  81.               Memory Manager..................................19
  82.               Internal Protocol Options.......................21
  83.               Dialing Area Options............................23
  84.               Terminal Area Options...........................25
  85.               Serial Port Setup...............................27
  86.               Port Select/Configure...........................28
  87.               UART Line Control...............................30
  88.               Modem Response Strings..........................34
  89.               Modem Commands..................................36
  90.               Modem Control...................................37
  91.               Default Video Emulation.........................38
  92.               Key Translation Sequence file (.KTS)............39
  93.               Keyboard MACRO Assignments......................40
  94.               Directories in Use Menu.........................44
  95.               External Programs Setup.........................46
  96.               Auto Engage Sequence Triggers...................49
  97.               "Intelligent Auto Log On Technology" (Tm).......52
  98.               Mass Menu Attribute Changes.....................55
  99.               EMSI/IEMSI data.................................58
  100. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS......................63
  101.               Internal, Defined-External Receiving Units......63
  102.               Internal, External Sender Protocols.............68
  103. Chapter 6  Telephone Directory Area...........................72
  104. Chapter 7  File List/Utility Area.............................81
  105. Chapter 8  Point Mail Functions...............................84
  106. Chapter 9  Auto Answer Setups.................................88
  107. Chapter 10 Event Schedules....................................89
  108. Chapter 11 "Mondo Menus" (Tm).................................90
  109. Chapter 12 Mouse Support......................................93
  110. Chapter 13 ACECOMM DATA FILES.................................94
  111.               ACE.PRM / .CTL..................................94
  112.               KTS files.......................................95
  113.               KBD files.......................................96
  114.               REQ/FLO,LST,SCR,FON files.......................97
  115. Chapter 14 AceComm Macro Language.............................99
  116. Chapter 15 Macros list.......................................101
  117.  
  118.  
  119.  
  120.                 T a b l e   o f   C o n t e n t s
  121.  
  122.  
  123.               Local User Input (LUI) Functions...............101
  124.               Character I/O Functions........................107
  125.               Flags..........................................112
  126.               File Functions.................................114
  127.               Data Transfer functions........................116
  128.               Modem/Dialing/Fon.Record.......................120
  129.               Misc Functions.................................124
  130. Chapter 16 MACRO Parameter Macros............................127
  131.               Expandable PRM-data Macros.....................127
  132.               Expandable Macro Functions.....................132
  133. Chapter 17 Scripts...........................................133
  134.               AutoScriptGen (Tm).............................134
  135.               Conditionals, Labels, Gotos, Data Area.........137
  136. Chapter 18 Whats New?........................................140
  137. Chapter 19 WARRANTY..........................................142
  138. Chapter 20 LICENSE...........................................143
  139. Chapter 21 AceComm Registration..............................147
  140. Chapter 22 Order Form........................................148
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174. Chapter 1  Introduction
  175.  
  176.  
  177.  
  178. What is AceComm?
  179.  
  180. AceComm is a communications program especially designed for today's high speed
  181. modems.  AceComm provides a default setup that is ready to run with most Hayes
  182. compatible modems. The AceComm package contains a modem install utility, that
  183. will install most Hayes compatible modems into AceComm.
  184.  
  185. AceComm supports a macro driven keyboard which features complete key
  186. redefinition.  AceComm's macro language provides the user a powerful interface
  187. to the AceComm internal functions, as well as many computer services.
  188.  
  189. AceComm's terminal area provides a key driven and or menu driven interface.
  190. With AceComm's key-redef and macro language, complete control over any complex
  191. task is just a key press away.
  192.  
  193. AceComm supports user definable menus.  Menus that can be made to display and
  194. offer user definable functions.  Menus that are available as popup menus at any
  195. time from the terminal area.
  196.  
  197. AceComm supports an internal point mail system which uses the EMSI handshake
  198. protocol.
  199.  
  200. A time (event) scheduler supports the point mail system and any other automated
  201. process the user wants to define.  The scheduler is capable of beginning and
  202. ending events as they come around on the clock.
  203.  
  204. An automatic script generating function can record complex on line sessions
  205. to script files needing little to know editing.
  206.  
  207. Intelligent Auto Log On Technology (tm) is capable of automating log on.
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214. AceComm Utilities
  215.  
  216. AceComm comes with several utilities for added support.  Utilities for modem
  217. install, backing up the configuration files, creating unique keyboard
  218. emulation, converting BBS lists and many other services that enhance and extend
  219. the overall AceComm services.  Some of these utilities are considered as part
  220. of the default setup, and will be present in the AceComm directory upon
  221. install.  Other utilities will be placed into a sub directory of there own.  We
  222. call these "Extra Utilities".
  223.  
  224.  
  225.  
  226.  
  227.        Page 1              AceComm (tm) v 1.81
  228.  
  229.  
  230. Chapter 1  Introduction
  231.  
  232.  
  233. AceComm Extra Utilities
  234.  
  235. The Acecomm package comes with several support utilities which add to and
  236. enhance the standard installation.  The utilities are located in a compressed
  237. file named ACEUTIL. Here you will find a USBBS list to ACE.FON file converter
  238. capable of converting the whole list or 1 area code. ANSI/AVATAR filter for
  239. removing video control codes from a file outputting to another file. Custom
  240. keyboard video emulation compiler can create keyboard emulation files from
  241. ascii definition files (examples provided). AceComm's point mail system is
  242. supported by several utilities that make interface AceComm to a FIDONET
  243. NodeList. AceComm's NodeList handler is said to be the best and faster of all
  244. programs offering point mail services.
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.        Page 2              AceComm (tm) v 1.81
  284.  
  285.  
  286. Chapter 1  Introduction
  287.  
  288.            QUICK START
  289.  
  290.  
  291. QUICK START INSTRUCTIONS FOR AceComm & Utilities
  292. Last revised 1/16/94
  293.  
  294. Distribution DISK
  295.  
  296. The AceComm package is distributed in a compressed format.  The compression
  297. utility used with AceComm is the current version of LHA (this writing LHA213).
  298. AceComm package and sub-packages are compressed as SelF eXtracting "SFX"
  299. files.  This means the compressed file "ARCHIVE" uses an .EXE file extension.
  300. This SFX format allows you the user to simply type the name of an archive.  The
  301. archive's SFX code will execute, and extract the files to their un-compressed
  302. form.
  303.  
  304. Electronic Distribution
  305.  
  306. Many BBS systems will store the distributed SFX file inside an archive envelope
  307. of their default archive.  The AceComm BBS provides the AceComm package in ARJ
  308. and ZIP format.  SFX files as described above are appropriately renamed and
  309. contained inside the main package, as regular compressed files.
  310.  
  311.  
  312.  
  313.  
  314. INSTALL.BAT
  315.  
  316. The easiest way to AceComm is to just run INSTALL.BAT.  The batch file will run
  317. ACTL.EXE.  ACTL.EXE assembles ACE.CTL into ACE.PRM.  ACE.CTL is an ascii
  318. control file that can be edited with any text editor or created later with the
  319. PRM2CTL.EXE utility (included).  ACTL creates sub directories defined inside
  320. ACE.CTL.  Directories defined in the default setup are CAP, FON, FILES, KTS,
  321. SCR, and MAIL.  INSTALL.BAT copies FON files into FON, KTS files into KTS, DOC
  322. files into a DOC sub directories.  INSTALL.BAT then runs ACE.EXE All setup data
  323. can be configured from inside AceComm.  Install.bat will get you up and
  324. running, you may need to set the com port to match that of your modem.
  325.  
  326.  
  327.  
  328.  
  329. QUICK SETUP STEPS
  330.  
  331. If you down loaded AceComm
  332.      go to    "Step 1 for Electronic distributed files"
  333.  
  334. Step  1  for Distribution DISK
  335.  
  336.  
  337.  
  338.  
  339.        Page 3              AceComm (tm) v 1.81
  340.  
  341.  
  342. Chapter 1  Introduction
  343.  
  344.            QUICK START (continued)
  345.  
  346.    - Un compress the AceComm package into it's own sub directory.
  347.      This example assumes the filename ACE170.EXE
  348.  
  349.      ACE170 means version 1.70
  350.  
  351.      .EXE means AceComm is distributed as a SelF eXtracting
  352.      archive (SFX)
  353.                 Example
  354.  
  355.         At the DOS prompt type:  md \ace
  356.         At the DOS prompt type:  copy ACE170.EXE \ACE
  357.         At the DOS prompt type:  cd \ace
  358.         At the DOS prompt type:  ACE170
  359.  
  360.      The basic setup files will be ready in a sub directory ACE.  Other files
  361.      that include SFX in the filename and end in .EXE file extension, are also
  362.      SelF eXtracting archives.  These files are enhancements to the basic
  363.      setup.
  364.  
  365.  
  366.  
  367. Step 1 for Electronic distributed files
  368.  
  369.      If you down loaded AceComm from a BBS the archive will be in another format
  370.      such as ACE170.ARJ or ACE170.ZIP.  If this is the case you will need to
  371.      use the compression utility that corresponds to the file extension to
  372.      de-compress the AceComm package.
  373.  
  374.                 Example for ACE170.ZIP
  375.  
  376.         At the DOS prompt type:  md \ace
  377.         At the DOS prompt type:  copy ACE170.ZIP \ACE
  378.         At the DOS prompt type:  cd \ace
  379.         At the DOS prompt type:  PKUNZIP ACE170
  380.  
  381.      The basic setup files will be ready in a sub directory ACE.  Other
  382.      archives files that included are enhancements to the basic setup.
  383.  
  384.  
  385.  
  386.  
  387. Step 2
  388.    - Read ACTL.DOC  (1 page)
  389.  
  390.    - Run ACTL.EXE (assemble ACE.CTL into ACE.PRM)
  391.  
  392.  
  393.  
  394.  
  395.        Page 4              AceComm (tm) v 1.81
  396.  
  397.  
  398. Chapter 1  Introduction
  399.  
  400.            QUICK START (continued)
  401.  
  402.                 Example ACTL ace.ctl
  403.  
  404.    ACTL.EXE need only be run when creating a new PRM file is desired.  All
  405.    PRM-data is configurational from within inside AceComm.
  406.  
  407.    Note: AceComm will invoke ACTL.EXE directly when no ACE.PRM file is found in
  408.          the start up directory.
  409.  
  410.  
  411. Step 3
  412.    - Run ACE.EXE
  413.         At the DOS prompt type:  ACE
  414.  
  415.  
  416.  
  417.  
  418.  
  419. OPTIONAL
  420. Not required for QUICK START
  421.  
  422. After having become familiar with AceComm, you may decide to edit ACE.CTL for
  423. some personal defaults.  This will allow future compilations to use your custom
  424. setup instructions.  ACE.CTL can store personal and custom setup data for times
  425. when a new ACE.PRM file is generated.  This will be most used when upgrading
  426. AceComm versions.
  427.  
  428. A utility PRM2CTL.EXE is provided to clone your PRM file into an ascii control
  429. file.  PRM2CTL will save your custom setup to a file that ACTL.EXE can later
  430. use to build the custom PRM file back.  This is also the means used for
  431. upgrading AceComm versions.
  432.  
  433.  
  434.  
  435. The following are enhancements to the AceComm package
  436.  
  437. a) FON_SFX.EXE (distributed)  FON.ZIP/ARJ (BBS)
  438.    FON_SFX contains several sample .BBS, FON, and .NOD files.
  439.  
  440.    It is suggested that FON_SFX be un-compressed inside a sub directory to the
  441.    AceComm directory
  442.  
  443.                 Example: C:\ACE\FON
  444.  
  445.         At the DOS prompt type:  md \ace\fon
  446.         At the DOS prompt type:  copy FON_SFX.EXE \ace\fon
  447.         At the DOS prompt type:  cd \ace\fon
  448.  
  449.  
  450.  
  451.        Page 5              AceComm (tm) v 1.81
  452.  
  453.  
  454. Chapter 1  Introduction
  455.  
  456.            QUICK START (continued)
  457.  
  458.         At the DOS prompt type:  FON_SFX
  459.         At the DOS prompt type:  cd \ace
  460.  
  461.    NOTE: ACTL creates these directories if defined in ACE.CTL and
  462.          not found.
  463.  
  464. b) KTS_SFX.EXE (Distributed)  KTS.ZIP/ARJ (BBS)
  465.    KTS_SFX contains the KTS files included in the default setup, as well as the
  466.    ascii versions.  Ascii version KTS files share the filename with KTS files,
  467.    but use .ASC extension.
  468.  
  469.    It is suggested that KTS_SFX be un-compressed inside a sub directory to the
  470.    AceComm directory
  471.  
  472.                 Example: C:\ACE\KTS
  473.  
  474.         At the DOS prompt type:  md \ace\kts
  475.         At the DOS prompt type:  copy KTS_SFX.EXE \ace\kts
  476.         At the DOS prompt type:  cd \ace\kts
  477.         At the DOS prompt type:  KTS_SFX
  478.         At the DOS prompt type:  cd \ace
  479.  
  480.    (.KTS files are the Key Translation Sequence files for terminals) This file
  481.    contains ascii versions of .KTS files.  ASC files are compiled into KTS
  482.    files using KTS.EXE.
  483.  
  484.  
  485. c) UTIL_SFX.EXE (Distributed)  UTIL.ZIP/ARJ (BBS)
  486.    UTIL_SFX contains several utilities that enhance the AceComm package.  Each
  487.    utility has it's .DOC file.
  488.  
  489.    It is suggested that UTIL_SFX be un-compressed inside a sub directory to the
  490.    AceComm directory
  491.  
  492.                 Example: C:\ACE\UTIL
  493.  
  494.         At the DOS prompt type:  md \ace\util
  495.         At the DOS prompt type:  copy UTIL_SFX.EXE \ace\util
  496.         At the DOS prompt type:  cd \ace\util
  497.         At the DOS prompt type:  UTIL_SFX
  498.         At the DOS prompt type:  cd \ace
  499.  
  500.  
  501.    MDMI.EXE Modem install utility, installs modem setup data directly into
  502.    ACE.PRM
  503.  
  504.  
  505.  
  506.  
  507.        Page 6              AceComm (tm) v 1.81
  508.  
  509.  
  510. Chapter 1  Introduction
  511.  
  512.            QUICK START (continued)
  513.  
  514.  
  515.    CBF.EXE can compile direct FBL output into a FON file.
  516.  
  517.  
  518.    UBF.EXE can compile the USBBS listing into a FON file.  UBF can optionally
  519.    extract any area code from the USBBS listing.
  520.  
  521.  
  522.    IDX.EXE creates a very small index file so that AceComm can use a RAW
  523.    NODELIST file for mailer mode/file requests.
  524.  
  525.  
  526.    FBL.EXE creates a .BBS and .NOD file from the raw nodelist for a given NET
  527.    HOST
  528.  
  529.  
  530.    KTS.EXE compiles a Key Translation Sequence file from ascii to binary
  531.    format.
  532.  
  533.  
  534.    ANSI.EXE filters ANSI and AVATAR video control sequence codes from files.
  535.    ANSI.EXE can also be used to view the files.
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.        Page 7              AceComm (tm) v 1.81
  564.  
  565.  
  566. Chapter 2  Modem Setup
  567.  
  568.  
  569.  
  570. High Speed Modems
  571.  
  572. Modems with connect speeds of 9600 and above and offer data compression and or
  573. error correction are capable of transferring data at much faster rates that the
  574. ordinary 9600 baud modem.
  575.  
  576. Todays modems including v.32 and v.32bis and beyond are all capable of data
  577. compression and offer data rates much faster than the 9600 connect speed.  To
  578. make proper use of these Hi-Speed modems the user needs understand a little
  579. about the modem.  Lets take a v.32bis modem as example.  V.32bis modems are
  580. very common and the price rivals that of 2400 baud modems of a few years ago.
  581. The V.32bis modem offers connect speeds up to 14400 and can transfer compressed
  582. data using various built in compression protocols at rates averaging and beyond
  583. 1650 cps for pre compressed files, and 2000-3000+ with un-compressed files.
  584.  
  585.  
  586. Locking the Port
  587.  
  588. It is necessary to use what is referred to as a "locked port" when operating a
  589. 14400 v32 bis modem.  A "locked port" refers to having the software (AceComm)
  590. set the port at a rate faster than the highest possible connect speed, and then
  591. leave the port speed alone.  Modems setup to use a "locked port" will make the
  592. translation between connect speed and computer speed.  Here we refer to
  593. "connect speed" as the speed at which the modem connects to the other modem,
  594. and computer speed refers to the port setting.
  595.  
  596.  
  597. Locked Ports and Flow Control
  598.  
  599. In order to support connect speeds of 14400, the modem needs be setup to use
  600. flow control.  Flow control enables the modem to be connected to the remote
  601. modem at a different speed than the computer-to-modem speed.  When modems
  602. connect at 14400 we refer to the connect speed as modem-to-modem speed.  14400
  603. is not a speed that the port (UART) can be set to.  Valid port speeds include
  604. 9600, 19200, 38400 and 57600.  To take advantage of 14400 connect speeds, the
  605. port needs be set to at least 19200.  AceComm supports setting the port to
  606. 19200, 38400, 57600, or 115200 and locking it here.  This is referred to as
  607. "Locking the port".  19200 is a preferable starting speed.  The faster you lock
  608. your port, the faster your computer needs to be in combination with a buffered
  609. (16550) UART.  An average 286/(386SX) 16 Mhz computer using a standard 16450
  610. UART chip can run a 14400 modem with the port locked at 19200.  Replace the
  611. 16450 single byte buffer UART chip with a 16550 16 byte buffer chip and the
  612. same computers can run the port at 38400.
  613.  
  614. When the port is set to 19200, the UART is setup to make data available to the
  615. computer software (AceComm) at 19200 bits per second (BPS).  This allows
  616.  
  617.  
  618.  
  619.        Page 8              AceComm (tm) v 1.81
  620.  
  621.  
  622. Chapter 2  Modem Setup
  623.  
  624. AceComm to fetch a character from the port at a faster rate than the modem can
  625. theoretically make the character available.  Theoretically because with todays
  626. data compression technology, Hi-Speed modem are capable of delivering text
  627. files at rates well above the connect speed.
  628.  
  629. The faster you set your port, the more quickly the UART assembles a character
  630. from the modem.  Thus faster port rates require faster computers and or
  631. buffered (16550) UART chips.
  632.  
  633. This is why we recommend 19200 a good starting point.  You may be able to
  634. download compressed files with the port locked at 38400, but an un-compressed
  635. file will be assembled so much faster with the modem's own compression services
  636. that errors may occur.  You may experience errors with un-compressed files, and
  637. normally do fine with compressed (.ARJ,.ZIP etc).  At 19200 you will probably
  638. be fine either way.  At 38400 and 56700 un-compressed data files can arrive
  639. much faster than your computer _may_ be capable of responding to.
  640.  
  641.  
  642.  
  643.  
  644. Modem Setup
  645.  
  646. Modem defaults may not always be ready for use with using a locked port rate.
  647. Most factory defaults are ready to go work with flow control and locked port
  648. rates.  The AceComm voice support line gets plenty of calls from users whose
  649. modems are not configured properly.
  650.  
  651. Lets examine a Supra v32 bis modem.  The AT commands below will work with
  652. almost all Hayes compatible v.32 / v.32bis modems.
  653.  
  654. The Supra modem can be set to a factory default which is suited to locked port
  655. rates by issuing the commands AT&F2 <CR>.  The command "AT&F2" loads a factory
  656. configuration for IBM compatible modems.  The "&F2" configuration is
  657. appropriate for error correction and data compression with Supra modems.
  658. Consult your modem manual for the proper &Fn param for your modem.
  659.  
  660.  
  661.  
  662.  
  663.  
  664. Generic Hayes Compatible Modem Setup
  665.  
  666.  
  667. &C1      DCD indicates carrier from modem
  668. &D2      Modem follows DTR signal
  669. &K3      RTS/CTS hardware flow control
  670. &Q5      Asynchronous reliable (error correction) mode
  671.  
  672.  
  673.  
  674.  
  675.        Page 9              AceComm (tm) v 1.81
  676.  
  677.  
  678. Chapter 2  Modem Setup
  679.  
  680. The above commands will work with most Hayes compatible modems.
  681.  
  682.  
  683.  
  684. Modem INIT Strings
  685.  
  686. Lets begin by making certain the modem is off hook and ready to receive an INIT
  687. string.
  688.  
  689.            ATH0^M
  690.  
  691. The AT command "H0" brings the modem off hook.  Most modems need be off hook to
  692. except AT commands.  "^M" is what AceComm translates into a <CR> character.
  693.  
  694. typing ATH1 <CR> from terminal mode puts the modem on hook. (busy)
  695. typing ATH0 <CR> from terminal mode puts the modem off hook.
  696.  
  697. We may have the modem off hook (busy) for any number reasons.  It is a good
  698. idea to begin our INIT string with ATH0^M and a small delay.  A small delay
  699. gives the modem a chance to respond before we send another INIT string .  We
  700. can create small delays in out INIT strings using ~ characters.  AceComm
  701. creates a 1/4 second delay for each occurrence of ~ character.
  702.  
  703. ATH0^M~~~~ATE0M0&C1&D2&K3&Q6
  704.  
  705. AceComm will append INIT strings with the command terminator.  Normally <CR> or
  706. as AceComm wants to see it ^M is the command terminator.  The above string
  707. includes 1 embedded command terminator but leaves AceComm to append the final
  708. <CR> to the end of the string.  The above modem INIT string is actually 2 init
  709. strings chained together.  The above modem INIT string should make most Hayes
  710. compatible modems ready to operate with FLOW control at a LOCKED port rate of
  711. 19200.
  712.  
  713.  
  714. Saving to NV RAM
  715.  
  716. We do not need to include "&F2" in our init string every time.  It is likely
  717. that other AT commands will be included in your modem init string.  M0 turns
  718. the speaker off, certain tweaking to some of the S registers alters both
  719. performance and connect response strings.  Custom modem configurations can be
  720. saved to the modem using the "&W" command.  When this is done, the modem init
  721. string can become simply ATZ <CR>.  Follows is our INIT string with &W tacked
  722. on.
  723.  
  724. ATH0^M~~~~ATE0M0&C1&D2&K3&Q6&W
  725.  
  726. AceComm supports a SETUP field in the modem commands menu.  The setup field is
  727. designed for modem command lines that are to be used occasionally, and
  728.  
  729.  
  730.  
  731.        Page 10              AceComm (tm) v 1.81
  732.  
  733.  
  734. Chapter 2  Modem Setup
  735.  
  736. preferably to setup the modem with the "&W" AT command.  AT&F&W <CR> recalls
  737. the factory default configuration and saves it to nonvolatile memory.  This
  738. setup can then be recalled using ATZ <CR>.
  739.  
  740. NV RAM is not designed to be written to everyday.  You want to configure your
  741. modem from time to time with &W and then use ATZ and whatever tweaks, as your
  742. normal INIT string.  You can get by just fine by simply using the default INIT
  743. string developed above, leaving off the &W command.  &W is for modem
  744. configurations that require several lines of INIT strings.  &W is an AT command
  745. you should know about, but may very well not ever need to use.
  746.  
  747.  
  748.  
  749. AceComm's Modem Install Utility
  750.  
  751. The AceComm package provides a modem install utility.  MDMI.EXE will display a
  752. menu of modem brands along with the setup strings for each.  You may choose
  753. your modem type from the list.  MDMI.EXE will write directly to the ACE.PRM
  754. file (AceComm's binary configuration file).
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.        Page 11              AceComm (tm) v 1.81
  788.  
  789.  
  790. Chapter 3  AceComm Start up/ Terminal Area
  791.  
  792.  
  793.  
  794. AceComm can be started from the DOS prompt, from a batch file, inside
  795. MS-Windows, DESQView, OS/2 etc.
  796.  
  797. AceComm locates itself on the drive, and locates the ACE.PRM file. Memory is
  798. allocated for ACE.PRM. ACE.PRM is read into memory. the KBD file is overlays
  799. onto ACE.PRM data. Multiple KBD files are supported, one KBD files is loaded
  800. at any one time.
  801.  
  802. The ACE.PRM file may be located in the current directory or the directory that
  803. ACE.EXE resides in.  AceComm is capable of running from a remote directory.
  804. AceComm will find itself and include the path to itself for it's data files.
  805. It is recommended that all of the AceComm files be kept in the same directory
  806. and sub directories.
  807.  
  808. Upon reading the ACE.PRM file into memory, a CRC check is made to validate
  809. certain data, an ID byte is checked for version compatibility.  Finally the size
  810. is checked to make sure all data is available.  AceComm will display an
  811. appropriate error message upon failure in any of these checks.
  812.  
  813. AceComm reads in the current .KBD (keyboard definition) file.  Default
  814. .KBD file is ACE_DEF.KBD. KBD files contain all macro assigns and total
  815. keyboard setup. Not to be confused with KTS files. KTS files store keyboard
  816. translation sequence definitions (keyboard terminal emulation) and are
  817. associated with the current video type.
  818.  
  819. AceComm reads the current associated KTS file at program start.
  820.  
  821. AceComm installs onto the serial port defined inside the aCE.PRM data, and
  822. initializes the modem. The user is now in the terminal area. An optional flag
  823. located inside PRM-data Options(Terminal-Options) menu will have Acecomm
  824. report directly into the Telephone List Area. Default is to remain in the
  825. Terminal Area.
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.        Page 12              AceComm (tm) v 1.81
  845.  
  846.  
  847. Chapter 3  AceComm Start up/ Terminal Area
  848.  
  849.  
  850.  
  851. ----------------------------------------------------------------
  852.  
  853.  
  854.  
  855. OK
  856.  
  857.  
  858. ...
  859.  
  860.  
  861.  AceComm ▒ 2,19200L,7E1 ▒ Av/An ▒ 08:06:48am ▒ ALT-V =Key Ref,
  862. ----------------------------------------------------------------
  863.  
  864. AceComm begins presenting to the user it's TERMINAL Area screen.  TERMINAL is
  865. the area in which all other areas are accessible, and where serial I/O takes
  866. place for the user.  Above is a sample of the AceComm TERMINAL screen upon
  867. start up.  A status line is present, when it's flag is SET(default).  If on
  868. line, the 'AceComm' would be replaced with 'CARRIER, and other information
  869. particular to the current setup, and host.  Note the 'L' after baud(19200)
  870. indicates LOCK BAUD is SET.  'AV/AN' indicates the current active VIDEO
  871. EMULATION.
  872.  
  873. Hold down the ALT key for a Pop Up Reference to key-combos available from the
  874. TERMINAL area.  Releasing the ALT key and the POP-UP REFERENCE disappears.  The
  875. Pop Up Reference menu is called using the <ViewKeyCombos_> MACRO.  ALT-V is
  876. assigned the <ViewKeyCombos_> MACRO in AceComm's default keyboard setup
  877. ACE_DEF.KBD file.  The default Keyboard is completely re definable by
  878. re-defining the KEY-COMBO a different MACRO(S) (see below)
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.        Page 13              AceComm (tm) v 1.81
  901.  
  902.  
  903. Chapter 3  AceComm Start up/ Terminal Area
  904.  
  905.            Pop Up Reference
  906.  
  907.  
  908. (TERMINAL screen below with POP UP REFERENCE)
  909.  
  910.  
  911. ┌─KBD Macro Assignments, current file: ACE_DEF.KBD───────────────
  912. │>ALT-A <AutoScrGen_>
  913. │ ALT-B <BackBuffer_>
  914. │ ALT-C <CaptureFile_>
  915. │ ALT-D <FonListDialer_>
  916. │ ALT-E <SendStr> ATE^M <HostEcho>
  917. │ ALT-F <FileLister_>[DIR_DNLDS]
  918. │ ALT-G <FileRequest_>
  919. │ ALT-H <MdmHangUp_>
  920. │ ALT-I
  921. │ ALT-J <CommandShell_>
  922. │ ALT-K
  923. │ ALT-L <RunProg> list
  924. │ ALT-M <SendStr>ath1^M <ChgDir>mail\ged <RunProg>GOLDED <ChgDir>[DIR_START]
  925. │ ALT-N <ChgDir>c:\mail\qm <RunProg>QM toss <ChgDir>[DIR_START]
  926. │ ALT-O <PrmDataMenus_>
  927. │ ALT-P <PrmDataMenus_>
  928. │ ALT-Q
  929. │ ALT-R <RunScript_>
  930. │ ALT-S <ScrnSnapshot_>
  931. │ ALT-T <ScrnTag_>
  932. └───(PgDn) Display  Template  Quit  Help ┤<>v^├──────────────────
  933.  
  934. o The AceComm keyboard is macro driven
  935.  
  936. o The Popup Reference displays each key press that has been assigned to a
  937.   MACRO, or MACROS.
  938.  
  939. o Current .KBD file is displayed, AceComm supports unlimited .KBD files.
  940.   Current .KBD filename is always displayed at the right side of the Terminal
  941.   Area's status line.
  942.  
  943. AceComm's Keyboard is re definable.  Each key press can be re assigned a
  944. different function, or set of functions.  To accomplish keyboard re definition,
  945. AceComm uses descriptive text symbols called MACROS.  MACROS are enclosed
  946. inside of angled brackets.
  947.  
  948. The Pop Up Reference menu displays the current .KBD file's MACRO(S)
  949. assignments.  A .KBD file contains a copy of all key-press MACRO(S)
  950. assignments.  AceComm supports unlimited .KBD files.  Each key press
  951. combination can be assigned a MACRO(S).  AceComm allows the user to re define
  952. the keyboard functions if so desired.  AceComm provides a rich set of MACRO
  953.  
  954.  
  955.  
  956.        Page 14              AceComm (tm) v 1.81
  957.  
  958.  
  959. Chapter 3  AceComm Start up/ Terminal Area
  960.  
  961.            Pop Up Reference (continued)
  962.  
  963. functions for all of AceComm's internal functions.  A complete MACRO list with
  964. descriptions is contained in the MACRO.DOC file.
  965.  
  966. - PgDn or <CR> will display the next key set at top of screen.
  967.  
  968. - Display toggles the display from a text description and the actual macro
  969.   assignments
  970.  
  971.   The key press is displayed to the left, with it's MACRO assignment to the
  972.   right.  The example below shows the MACRO for AceComm's configurations area
  973.   is assigned to ALT-P.
  974.  
  975.      ALT-P <PrmDataMenus_>              <= MACRO assign
  976.      ALT-P Configuration Area           <= descriptive text
  977.  
  978. - Template allows you to print a list of keys that have MACRO assignments.  The
  979.   default filename is "PRN".  You may find it handy to print to a FILE,
  980.   (key.prn) or similar, this way you can format the TEMPLATE, for a more custom
  981.   print job.
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.        Page 15              AceComm (tm) v 1.81
  1013.  
  1014.  
  1015. Chapter 4  PRM-data Menus Area
  1016.  
  1017.  
  1018. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1019. ░░░░░░░░░░░░░░░░┌─D:\ACE\ACE.PRM─────────────────────┐░░░░░░░░░░
  1020. ░░░░░░░░░░░░░░░░│──PRM-data   Sub-Menu Areas ────────│░░░░░░░░░░
  1021. ░░░░░░░░░░░░░░░░│>Area controls / Options menus      │░░░░░░░░░░
  1022. ░░░░░░░░░░░░░░░░│ Serial Port/Modem Setup            │░░░░░░░░░░
  1023. ░░░░░░░░░░░░░░░░│ KeyBoarD Macro Assignments         │░░░░░░░░░░
  1024. ░░░░░░░░░░░░░░░░│ Directories in Use Menu            │░░░░░░░░░░
  1025. ░░░░░░░░░░░░░░░░│ External Programs Setup            │░░░░░░░░░░
  1026. ░░░░░░░░░░░░░░░░│ Auto Engage Sequence Triggers      │░░░░░░░░░░
  1027. ░░░░░░░░░░░░░░░░│ Intelligent Auto Log On Technology │░░░░░░░░░░
  1028. ░░░░░░░░░░░░░░░░│ Paint Screens - Video Controls     │░░░░░░░░░░
  1029. ░░░░░░░░░░░░░░░░│ EMSI handshake data                │░░░░░░░░░░
  1030. ░░░░░░░░░░░░░░░░│ Point Mail Setup                   │░░░░░░░░░░
  1031. ░░░░░░░░░░░░░░░░│ AutoAnswer Mode Setup              │░░░░░░░░░░
  1032. ░░░░░░░░░░░░░░░░│ Event Schedules                    │░░░░░░░░░░
  1033. ░░░░░░░░░░░░░░░░│ AutoSave is ON                     │░░░░░░░░░░
  1034. ░░░░░░░░░░░░░░░░└─── Select  Quit  Help ┤<>v^├───────┘░░░░░░░░░░
  1035. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1036. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1037.  
  1038. o MACRO for this menu is: <PrmDataMenus_> (default assignment is to both ALT
  1039.   O & ALT P)
  1040.  
  1041. o All PRM-data changes are auto-saved when Auto-Save flag is "ON" (default)
  1042.  
  1043. o Each sub-menu contains context sensitive HELP
  1044.  
  1045. Virtually any data contained inside the ACE.PRM file is accessible and
  1046. configurational from the PRM-data area.  Above is the menu you will see after
  1047. pressing key-combo <PrmDataMenus_> is assigned to from the TERMINAL area.
  1048.  
  1049. Note: If you toggle "AutoSave" to Off, you will select the "Save Changes"
  1050.       option before exiting AceComm, if you want the toggled option to remain
  1051.       toggled.  Otherwise, AceComm will be back to "AutoSave" when re-started.
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.        Page 16              AceComm (tm) v 1.81
  1069.  
  1070.  
  1071. Chapter 4  PRM-data Menus Area
  1072.  
  1073.            Area Controls / Options Menus
  1074.  
  1075.  
  1076. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1077. ░░░░░░░░░░░░░░░░░┌─Area controls / Options menus─────────────────┐░░░░░░░
  1078. ░░░░░░░░░░░░░░░░░│ Telephone book on start up               No   │░░░░░░░
  1079. ░░░░░░░░░░░░░░░░░│ Allow enhanced keyboard detection        Yes  │░░░░░░░
  1080. ░░░░░░░░░░░░░░░░░│ Allow mouse detection                    Yes  │░░░░░░░
  1081. ░░░░░░░░░░░░░░░░░│ Mouse horizontal sensitivity             6    │░░░░░░░
  1082. ░░░░░░░░░░░░░░░░░│ Mouse vertical sensitivity               4    │░░░░░░░
  1083. ░░░░░░░░░░░░░░░░░│ Auto Save Changes                        On   │░░░░░░░
  1084. ░░░░░░░░░░░░░░░░░│ Screen Saver timeout value (minutes)     4    │░░░░░░░
  1085. ░░░░░░░░░░░░░░░░░│ Keep Log file                            On   │░░░░░░░
  1086. ░░░░░░░░░░░░░░░░░│ All Sounds Override Switch <> Sounds are On   │░░░░░░░
  1087. ░░░░░░░░░░░░░░░░░│ Ignore DCD on INIT & Dial                No   │░░░░░░░
  1088. ░░░░░░░░░░░░░░░░░│─Sub Menus─────────────────────────────────────│░░░░░░░
  1089. ░░░░░░░░░░░░░░░░░│ Control Memory Use                            │░░░░░░░
  1090. ░░░░░░░░░░░░░░░░░│>Internal Protocol Options                     │░░░░░░░
  1091. ░░░░░░░░░░░░░░░░░│ Dialing Options                               │░░░░░░░
  1092. ░░░░░░░░░░░░░░░░░│ Terminal Area Options                         │░░░░░░░
  1093. ░░░░░░░░░░░░░░░░░└─── Edit  Quit  Help ┤<>v^├────────────────────┘░░░░░░░
  1094. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1095.  
  1096. o The controls are enable/disable flags, some of which can also contain a value
  1097.   for timers.
  1098.  
  1099. o Sub menus contain more categorized controls
  1100.  
  1101.  
  1102. Most controls are a series of flags which tell AceComm when to use some of the
  1103. features, and when not to.  Flags with the ON/OFF status are toggles, and will
  1104. be toggled here in this menu.
  1105.  
  1106. Notice the "Screen Saver" flag description contains the number 5,
  1107. rather than an ON/OFF.  Selecting Screen Saver mode 0 = OFF.
  1108.  
  1109.  
  1110. Allow enhanced keyboard detection        Yes
  1111.  
  1112.   AceComm will detect and use enhanced BIOS keyboard functions.  Some systems
  1113.   may not fully support this mode properly.  This flag allows locking out
  1114.   AceComm's use of enhanced BIOS keyboard functions.
  1115.  
  1116.  
  1117. Allow mouse detection                    Yes
  1118.  
  1119.   Setting this to "NO" will cause AceComm to act as if a mouse is non existent,
  1120.   the mouse driver is never initialized, no mouse menu is presented in the
  1121.  
  1122.  
  1123.  
  1124.        Page 17              AceComm (tm) v 1.81
  1125.  
  1126.  
  1127. Chapter 4  PRM-data Menus Area
  1128.  
  1129.            Area Controls / Options Menus (continued)
  1130.  
  1131.   Terminal Area.
  1132.  
  1133.  
  1134. Mouse horizontal sensitivity             6
  1135.  
  1136.   Mouse sensitivity is already set in the mouse driver.  This value is internal
  1137.   to AceComm only
  1138.  
  1139.  
  1140. Mouse vertical sensitivity               4
  1141.  
  1142.   Mouse sensitivity is already set in the mouse driver.  This value is internal
  1143.   to AceComm only
  1144.  
  1145.  
  1146. Auto Save Changes                        On
  1147.  
  1148.   When "ON" AceComm will save PRM-data changes to the ACE.PRM file.  When "OFF"
  1149.   the prompt inside the main PRM-data menu must be selected for PRM-data
  1150.   changes to be recorded to file.  This pertains to actual PRM-data below the
  1151.   menu system data.  Menu area attributes are ALWAYS SAVED, with exception to
  1152.   "Mass Menu Area" changes, these must be affected using the appropriate
  1153.   selection from inside "Mass Menu".
  1154.  
  1155.  
  1156. Screen Saver timeout value (minutes)     5
  1157.  
  1158.   Screen Blanking function.  Screen Saver can be set from 0 - 10.  Values above
  1159.   0 are minutes without a key press to AceComm blanking the screen.  Screen is
  1160.   restored with a key press.  Un-blank-key-press is valid.  Use ALT alone for
  1161.   non-destructive key press to un-blank the screen.
  1162.  
  1163.   See also "Screen Saver if Data Carrier Detect" from Terminal Area Options
  1164.   menu.
  1165.  
  1166.  
  1167. Keep Log file                            On
  1168.  
  1169.   Toggle AceComm use logging ON/OFF.
  1170.  
  1171.  
  1172. All Sounds Override Switch <> Sounds are Off
  1173.  
  1174.   Toggle, enable/disable all sounds. Master override.
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.        Page 18              AceComm (tm) v 1.81
  1181.  
  1182.  
  1183. Chapter 4  PRM-data Menus Area
  1184.  
  1185.            Memory Manager
  1186.  
  1187.  
  1188.  
  1189. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1190. ░░░╔═D:\ACE\ACE.PRM══════════════════╗░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1191. ░░░║╔═General Controls/Menus════════════════════════╗░░░░░░░░░░░░
  1192. ░░░║║                                               ║░░░░░░░░░░░░
  1193. ░░░║║                                               ║░░░░░░░░░░░░
  1194. ░░░║║                                               ║░░░░░░░░░░░░
  1195. ░░░║║╔═Control Memory Use═══════════════════════╗   ║░░░░░░░░░░░░
  1196. ░░░║║║>XMS (kb) ok to use           64          ║   ║░░░░░░░░░░░░
  1197. ░░░║║║ Scroll Back (kb) to use      64          ║   ║░░░░░░░░░░░░
  1198. ░░░║║║ Swap for <RunProgram>        On          ║   ║░░░░░░░░░░░░
  1199. ░░░║║║ Swap for <CommandShell_>     On          ║   ║░░░░░░░░░░░░
  1200. ░░░║║║═Current Memory Use═══════════════════════║   ║░░░░░░░░░░░░
  1201. ░░░║║║ XMS allocated                65536       ║═══║░░░░░░░░░░░░
  1202. ░░░║║║ XMS free at load             2424832     ║   ║░░░░░░░░░░░░
  1203. ░░░╚║║ ACE.EXE load                 227040      ║   ║░░░░░░░░░░░░
  1204. ░░░░║║ Scroll Back allocated        65536       ║   ║░░░░░░░░░░░░
  1205. ░░░░║║ PRM file  allocated          36025       ║   ║░░░░░░░░░░░░
  1206. ░░░░╚║ Rx buffer allocated          8192        ║═══╝░░░░░░░░░░░░
  1207. ░░░░░║ Tx buffer allocated          256         ║░░░░░░░░░░░░░░░░
  1208. ░░░░░╚═══ Select  Quit  Help ┤<>v^├═════════════╝░░░░░░░░░░░░░░░░
  1209. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1210.  
  1211.  
  1212. o With version 1.7, AceComm begins managing memory usage.
  1213.  
  1214. o AceComm can swap the scroll back buffer memory to XMS prior to allocating
  1215.   large chunks of memory for other operations.
  1216.  
  1217. o EMS will be supported in the next release.
  1218.  
  1219. o XMS and EMS are supported for the SWAP functions.
  1220.  
  1221.  
  1222. XMS (kb) ok to use
  1223.  
  1224.   AceComm's internal memory manager can save overall memory requirements by
  1225.   swapping some internal data to XMS memory when about to perform another
  1226.   memory hungary task.
  1227.  
  1228.  
  1229. Scroll Back (kb) to use
  1230.  
  1231.   Up to 64 kb (64 x 1024) memory can be used for the back buffer.  Future
  1232.   versions of AceComm will begin allowing multiple 64 kb memory be used for
  1233.  
  1234.  
  1235.  
  1236.        Page 19              AceComm (tm) v 1.81
  1237.  
  1238.  
  1239. Chapter 4  PRM-data Menus Area
  1240.  
  1241.            Memory Manager (continued)
  1242.  
  1243.   scroll back buffer.  The first 64 kb memory is conventional memory.
  1244.  
  1245.  
  1246. Swap for <RunProgram>                    On
  1247.  
  1248.   XMS, EMS, DISK swapping for the AceComm executable will take place when this
  1249.   flag is set "ON".  When SWAPPING is active, AceComm 's SIO is deactivated
  1250.   while <RunProgram> MACRO is active.
  1251.  
  1252.   Notes: AceComm is currently using Ralf Brown's SWAP functions for the SWAP
  1253.          service.  SWAP is the only code inside AceComm executable that is not
  1254.          written entirely by MGP Programming Services.  SWAP has proven to be
  1255.          the most dependable code of this type that has been tested in our
  1256.          executable files.  MGP Software would like to thank Ralf Brown for
  1257.          permission to use his SWAP code in our products.
  1258.  
  1259.  
  1260. Swap for <CommandShell_>              On
  1261.  
  1262.   XMS, EMS, DISK swapping for the AceComm executable will take place when this
  1263.   flag is set "ON".  When SWAPPING is active, AceComm 's SIO is deactivated
  1264.   while <CommandShell_> MACRO is active.
  1265.  
  1266.   Notes: The Notes for <RunProgram> apply to this MACRO
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.        Page 20              AceComm (tm) v 1.81
  1293.  
  1294.  
  1295. Chapter 4  PRM-data Menus Area
  1296.  
  1297.            Internal Protocol Options
  1298.  
  1299.  
  1300.  
  1301. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1302. ░░░░░░░░░░░┌─Internal Protocol Options────────────────┐░░
  1303. ░░░░░░░░░░░│>Auto Engage                       Yes    │░░
  1304. ░░░░░░░░░░░│ File Rename                       Yes    │░░
  1305. ░░░░░░░░░░░│ File Resume                       Yes    │░░
  1306. ░░░░░░░░░░░│ Bell after internal protocol      3      │░░
  1307. ░░░░░░░░░░░│ Time release from protocol        No     │░░
  1308. ░░░░░░░░░░░└─── Select  Quit  Help ┤<>v^├─────────────┘░░
  1309. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1310.  
  1311. Auto Engage                              Yes
  1312.  
  1313.   Activate/deactivate Auto engage sequence triggers & Associated AutoM
  1314.   MACROS.  (enable/disable auto downloads) Does not affect auto log on.
  1315.  
  1316.  
  1317. File Rename                              Yes
  1318.  
  1319.   For internal Zmodem.  Rename "Yes" existing files when last modification
  1320.   time/date don't match.  AceComm will create a new filename.  When file times
  1321.   don't match, we can assume that although the filenames are the same, they
  1322.   were created at different times, and probably contain different data.
  1323.  
  1324.   Example:
  1325.           The file "114-35.QWK" exists in our receive directory.  The incoming
  1326.           filename is "114-35.QWK" also.  AceComm's internal zmodem will then
  1327.           compare file times and if they match, it is safely these files are
  1328.           the same and a file size check is done to see if we can resume the
  1329.           download.
  1330.  
  1331.           If the file times don't match, AceComm's internal zmodem will try and
  1332.           create a filename "114-35.QW0", if this filename exists, "114-35.QW1"
  1333.           etc.  Thus we can have several *same* filenames in our receive
  1334.           directory without overwriting them.
  1335.   Example:
  1336.           You download the "allfiles.lst" from the same BBS every week.  The
  1337.           filename is always the same, the file times differ.  AceComm will
  1338.           name duplicates names as "allfiles.lst", "allfiles.ls0",
  1339.           "allfiles.ls1" etc.
  1340.  
  1341.  
  1342. File Resume                              Yes
  1343.  
  1344.   For internal Zmodem.  Resume "Yes" existing files, data is appended to the
  1345.  
  1346.  
  1347.  
  1348.        Page 21              AceComm (tm) v 1.81
  1349.  
  1350.  
  1351. Chapter 4  PRM-data Menus Area
  1352.  
  1353.            Internal Protocol Options (continued)
  1354.  
  1355.   file, "OFF", the file is created new, any existing file of the same name is
  1356.   over written.  *If* the file modification time matched.  Otherwise with File
  1357.   Rename function would have created it's unique filename.  In the event the
  1358.   file sizes are same, the file is skipped when the resume flag is set to yes.
  1359.  
  1360.   Example:
  1361.           You started down loading a file and were interrupted for some reason
  1362.           aborting the download.  You log back on at a later time, and using
  1363.           Acecomm's internal zmodem begin to download the file once again.
  1364.           AceComm's internal zmodem will see if the file times match, and
  1365.           considers the to be the same file.  Internal zmodem will tell the
  1366.           host zmodem to begin sending from the position where the file was
  1367.           aborted from.  The file can be "Resumed", thus saving the time
  1368.           involved in down loading the entire file all over again.
  1369.  
  1370.  
  1371. Ring bell after internal protocol        3
  1372.  
  1373.   Internal protocols will sound an alarm before returning to Terminal Area.  A
  1374.   value of "0" disables any sound after internal protocols.  A value of "1"
  1375.   plays a Victory tune.  Values from 2-30 become seconds to sound the internal
  1376.   bell.  See also <RingBell> 5 MACRO
  1377.  
  1378.  
  1379. Time release from protocol               No
  1380.  
  1381.   Time slices for Windows/ OS/2, DV, and DOS are supported.  This flag applies
  1382.   to the DV and DOS time releases.  Releasing time to Windows/ OS/2 using the
  1383.   interrupt 2fh function causes so many missed interrupts that AceComm never
  1384.   releases int 2fh time slices during an internal protocol function.  Time
  1385.   slices are otherwise given up generously.
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.        Page 22              AceComm (tm) v 1.81
  1405.  
  1406.  
  1407. Chapter 4  PRM-data Menus Area
  1408.  
  1409.            Dialing Area Options
  1410.  
  1411.  
  1412.  
  1413. ┌─Dialing Options───────────────────────────────┐00
  1414. │>Inter byte delay                         1    │
  1415. │ Modem Response Timeout when dialing      60   │
  1416. │ Seconds between re-dial                  1    │
  1417. │ DTR state between re-dial                Off  │
  1418. │ Ring BELL on Dial/Connect                1    │
  1419. │ Re-dials in mail mode                    64   │
  1420. └─── Select  Quit  Help ┤<>v^├──────────────────┘
  1421.  
  1422.  
  1423. Inter Byte Delay                         1
  1424.  
  1425.   Add (value x 55 millisecond) delay between modem command characters.  With a
  1426.   value of '0' modem command strings are sent just as fast as the UART's
  1427.   Transmit Hold Register is Empty (THRE).  (I've observed Supra modems behave
  1428.   much better using a value of 1 for inter byte delay when in continuous
  1429.   re-dial)
  1430.  
  1431.  
  1432. Modem Response Timeout when dialing      60
  1433.  
  1434.   Master timeout when dialing.  Overrides your modem's own S7 register.
  1435.  
  1436.   Notes: It may be best to set this value several seconds above your modem's S7
  1437.          register.
  1438.  
  1439.  
  1440. Seconds between re dials                 1
  1441.  
  1442.   AceComm will pause this many seconds between receiving a modem response
  1443.   string, or timing out, and sending the next dial string to the modem.  The
  1444.   variable can be toggled from 0 seconds to 90 seconds.
  1445.  
  1446.  
  1447. Ring BELL on Dial/Connect                1
  1448.  
  1449.   Seconds to ring BELL on successful detection of either DCD or a connect
  1450.   message response from the modem.
  1451.  
  1452.  
  1453. Re-dials in mail mode                    64
  1454.  
  1455.    Number of re-dials before giving up to terminal mode.  A mail schedule will
  1456.    go back into the dialer every few minutes anyway.  If the scheduled mail
  1457.  
  1458.  
  1459.  
  1460.        Page 23              AceComm (tm) v 1.81
  1461.  
  1462.  
  1463. Chapter 4  PRM-data Menus Area
  1464.  
  1465.            Dialing Area Options (continued)
  1466.  
  1467.    event ends, re-dial continues for this setting times.
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.        Page 24              AceComm (tm) v 1.81
  1517.  
  1518.  
  1519. Chapter 4  PRM-data Menus Area
  1520.  
  1521.            Terminal Area Options
  1522.  
  1523.  
  1524.  
  1525.       ╔═Terminal Area Options═══════════════════════════╗
  1526.       ║>Status line                              On     ║
  1527.       ║ Mouse menu                               Yes    ║
  1528.       ║ Screen Saver if Data Carrier Detect      No     ║
  1529.       ║ Terminal Area screen color (TTY mode)    7      ║
  1530.       ║ Drop DTR when quitting ACECOMM           No     ║
  1531.       ║ Log modem response while off line        Yes    ║
  1532.       ║ Strip high bit from incoming             Off    ║
  1533.       ║ Default Video Emulation                  Av/An  ║
  1534.       ╚═══ Edit  Quit  Help ┤<>v^├══════════════════════╝
  1535.  
  1536. Status line                              On
  1537.  
  1538.   Toggle AceComm 's STATUS LINE On/Off
  1539.  
  1540.   Notes: AutoScrGen (Tm) will assert the STATUS LINE, and restore it on when
  1541.          through.  The RunScript function will do the same.
  1542.  
  1543.  
  1544. Mouse Menu                              Yes
  1545.  
  1546.   Display 1 line mouse menu on Terminal Area screen
  1547.  
  1548.  
  1549. Screen Saver if Data Carrier Detect      No
  1550.  
  1551.   Screen Blanking service disabled during modem status DCD bit detected to be
  1552.   ASSERTED.
  1553.  
  1554.  
  1555. Terminal Area screen color (TTY mode)    7
  1556.  
  1557.   This setting allows changing the Terminal Screen color that is initially
  1558.   active when AceComm is started.  The color will remain constant through TTY
  1559.   video emulation.
  1560.  
  1561.  
  1562. Drop DTR when quitting AceComm            No
  1563.   AceComm will or will not drop DTR when the <EndACECOMM> [n] MACRO is run.
  1564.   Most modems will by default, drop carrier along with a drop in DTR.  DTR is a
  1565.   bit in the modem control register of the UART.  Setting this to "YES" will
  1566.   cause AceComm to drop DTR when ever <EndACECOMM> [n] MACRO is executed.
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.        Page 25              AceComm (tm) v 1.81
  1573.  
  1574.  
  1575. Chapter 4  PRM-data Menus Area
  1576.  
  1577.            Terminal Area Options (continued)
  1578.  
  1579. Log modem response while off line        No
  1580.  
  1581.   AceComm can log modem response strings that come in.  This flag will tells
  1582.   AceComm if it should log the responses.  This is for off line only.  This
  1583.   flag is most use full when you want to know when your phone rings, AceComm
  1584.   will TIME STAMP PRM-data Area MDM_RESPONSE_RING responses strings.  Many
  1585.   modem ROMS are now featuring caller ID.  Modems that have caller ID ability
  1586.   will be able to present to the terminal screen the caller ID info, if
  1587.   available.  This information will also be logged along with the TIME STAMPED
  1588.   "RING".
  1589.  
  1590.  
  1591. Strip high bit from incoming             Off
  1592.  
  1593.   "Off" data received from the modem is un altered.  "ON" data is stripped of
  1594.   any bits above the decimal value 128.
  1595.  
  1596.  
  1597. Default Video Emulation                  Av/An
  1598.  
  1599.   This selection brings up another menu.  The menu displays the available video
  1600.   terminal emulation modes.  Along with their associated KTS files.  This
  1601.   setting affects the default video terminal setting for AceComm.  Individual
  1602.   FON RECORDS contain their own video terminal settings.
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.        Page 26              AceComm (tm) v 1.81
  1629.  
  1630.  
  1631. Chapter 4  PRM-data Menus Area
  1632.  
  1633.            Serial Port Setup
  1634.  
  1635.  
  1636.  
  1637. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1638. ░░░░░┌───Serial Port/Modem Setup────────────┐░░
  1639. ░░░░░│ Port Number Select      2            │░░
  1640. ░░░░░│ Line Control Setup      19200L,8N1   │░░
  1641. ░░░░░│ Modem Response Strings               │░░
  1642. ░░░░░│>Modem Command Strings                │░░
  1643. ░░░░░│ Modem Control Setup                  │░░
  1644. ░░░░░└─ Select  Quit ┤<>v^├─────────────────┘░░
  1645. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1646.  
  1647.  
  1648. o The "Serial Port Setup Menu" contains sub-menus for all of AceComm's serial
  1649.   port and serial port related configurations.
  1650.  
  1651. o Information presented to the right of menu selections are current settings.
  1652.   The 'L' appended to BAUD indicates LOCK BAUD is SET "ON".  If you run a
  1653.   Hi-Speed modem, then you will be leaving LOCKBAUD set "ON".
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.        Page 27              AceComm (tm) v 1.81
  1685.  
  1686.  
  1687. Chapter 4  PRM-data Menus Area
  1688.  
  1689.            Port Select/Configure
  1690.  
  1691.  
  1692. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1693. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1694. ░░░░░░░░░░░░░░░░░░░░░┌──────────────────────────────────────┐░░░░░░░░░░░░░░░░░
  1695. ░░░░░░░░░░░░░░░░░░░░░│─ PRM-data   Sub-Menu Areas ──────────│░░░░░░░░░░░░░░░░░
  1696. ░░░░░░░░░░░░░░░░░░░░░│ ┌─Port          Address IRQ   Detected ───────┐░░░░░░░░
  1697. ░░░░░░░░░░░░░░░░░░░░░│┌│>1             03F8h    4      Yes           │░░░░░░░░
  1698. ░░░░░░░░░░░░░░░░░░░░░│││ 2             02F8h    3   In use           │░░░░░░░░
  1699. ░░░░░░░░░░░░░░░░░░░░░│││ 3             03E8h    4       No           │░░░░░░░░
  1700. ░░░░░░░░░░░░░░░░░░░░░│││ 4             02E8h    3       No           │░░░░░░░░
  1701. ░░░░░░░░░░░░░░░░░░░░░│││ 5             0230h    4       No           │░░░░░░░░
  1702. ░░░░░░░░░░░░░░░░░░░░░│││ 6             0238h    4       No           │░░░░░░░░
  1703. ░░░░░░░░░░░░░░░░░░░░░│└│ 7             0240h    4       No           │░░░░░░░░
  1704. ░░░░░░░░░░░░░░░░░░░░░│ │ 8             0248h    4       No           │░░░░░░░░
  1705. ░░░░░░░░░░░░░░░░░░░░░│ │─ Other stuff ───────────────────────────────│░░░░░░░░
  1706. ░░░░░░░░░░░░░░░░░░░░░│ │ RBuf          8192                          │░░░░░░░░
  1707. ░░░░░░░░░░░░░░░░░░░░░│ │ TBuf          256                           │░░░░░░░░
  1708. ░░░░░░░░░░░░░░░░░░░░░│ │ FIFO trigger  8                             │░░░░░░░░
  1709. ░░░░░░░░░░░░░░░░░░░░░└─│ TX            Off                           │░░░░░░░░
  1710. ░░░░░░░░░░░░░░░░░░░░░░░│ CTS/RTS       On                            │░░░░░░░░
  1711. ░░░░░░░░░░░░░░░░░░░░░░░│ XON/XOFF      On                            │░░░░░░░░
  1712. ░░░░░░░░░░░░░░░░░░░░░░░└─ Install  Edit  Quit  Help ┤<>v^├───────────┘░░░░░░░░
  1713. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1714.  
  1715. Port numbers are merely symbolic for identification.  Port addresses and the
  1716. Interrupt ReQuest line for the address is configurational.
  1717.  
  1718.       Install option, AceComm will close the active port and install it's SIO
  1719.   on the port selected.  MDM_INIT string is sent to modem.
  1720.  
  1721.       Edit option, you will be prompted for port address and IRQ.  Address is a
  1722.   HEX number.  Entering a decimal value will fail.
  1723.  
  1724.       Rbuf/Tbuf are the buffer size used for serial I/O.  Normally there won't
  1725.   be any advantage to raising the TBuf size.  RBuf size will be adequate at
  1726.   about 1024 bytes for all normal use.  The larger value (default) will allow
  1727.   storage of incoming during Back buffer, Tagger etc.  RBuf range is from 1k to
  1728.   32k, TBuf 128 bytes to 32k.  The Zmodem sending unit's window size is equal
  1729.   to TBuf size.  Window size is not data-frame size.  Window size means "how
  1730.   much data do we let build up into the TX buffer at any one time.  RBuf/TBuf
  1731.   can be changed at any time, on line or not.  It is recommended that the HOST
  1732.   be still when re-sizing RBuf/TBuf.  RBuf/TBuf changes take immediate affect.
  1733.  
  1734.       FIFO trigger is the number of bytes buffered before a First In First Out
  1735.   UART chip will alert the CPU by way of interrupt.  FIFO UART operation is
  1736.   automatically enabled when a FIFO UART is detected.  AceComm always checks
  1737.   for FIFO UART presence whenever installing onto a PORT.  FIFO trigger level
  1738.  
  1739.  
  1740.  
  1741.        Page 28              AceComm (tm) v 1.81
  1742.  
  1743.  
  1744. Chapter 4  PRM-data Menus Area
  1745.  
  1746.            Port Select/Configure (continued)
  1747.  
  1748.   changes take immediate affect.  Trigger level of "1" affectively disables the
  1749.   FIFO affect.  The setting for "8" will give the best performance under
  1750.   multi taskers.
  1751.  
  1752.       TX is a flag that tells AceComm to use interrupt driven output.
  1753.   Interrupt driven input is always on.  The TX toggle takes immediate affect.
  1754.   If you FAST computer/modem setup is capable of overwhelming the other end
  1755.   when sending data, toggling TX "OFF" may improve the situation.
  1756.  
  1757.       CTS/RTS hardware handshaking / FLOW control Hardware handshaking may
  1758.   normally be left ON (default).  High speed modems using fast data rates and
  1759.   typically locked port rates will require software to use FLOW control.
  1760.  
  1761.       XON/XOFF software handshaking / FLOW control Many HOST software will
  1762.   recognize XON/XOFF FLOW control.  You may need software handshaking enabled
  1763.   for proper FLOW control while performing ascii uploads.
  1764.  
  1765.       Notes: AceComm uses FLOW control flags (above) primarily to detect when
  1766.              not to send data to the modem.
  1767.  
  1768.              AceComm will automatically use both forms of FLOW control when it
  1769.              detects the receive buffer getting full.
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.        Page 29              AceComm (tm) v 1.81
  1798.  
  1799.  
  1800. Chapter 4  PRM-data Menus Area
  1801.  
  1802.            UART Line Control
  1803.  
  1804.  
  1805.     ╔═══ Serial Port Setup Menu ═══════════╗
  1806.     ║ Port Number Select      1            ║
  1807.     ║╔═ UART Line Control ═══════════════╗ ║
  1808.     ║║>Data Bits          8              ║ ║
  1809.     ║║ Parity             None           ║ ║
  1810.     ║║ Stop Bits          1              ║ ║
  1811.     ║║ Max/Lock Baud Rate 19200          ║ ║
  1812.     ║║ Lockbaud           On             ║ ║
  1813.     ╚╚═ Select  Quit  Help ══════════════╝═╝
  1814.  
  1815.  
  1816. The UART's line control register can be set for several different data
  1817. arrangements.  Most common being 8 data bits, no parity bit, 1 stop bit.  Most
  1818. BBS systems will use the 8N1 configuration.  The UART uses the line control
  1819. information when assembling incoming bits into a byte.  Setting this
  1820. information from the PRM-data area, the format is stored in the default
  1821. settings for AceComm to use.  When you look at the FON directory records you
  1822. will see that each record stores it's personal line control setting to be used
  1823. when dialing the record.  Data format is saved with each individual record in
  1824. the record's .FON file.  When using AceComm in HOST mode the default setting
  1825. will be used.  AceComm retains the default line control register setting in the
  1826. ACE.PRM file.  FON record line control settings are stored in their respective
  1827. .FON files.
  1828.  
  1829. BAUD rate is also something that will normally be attached to a FON record and
  1830. used when dialing the record.  This is of more concern to users of modems that
  1831. do not allow LOCKING the port.
  1832.  
  1833. LOCK BAUD is almost always available as an option when using a modem that can
  1834. support CONNECT rates above 2400 baud.  When using the LOCK BAUD option,
  1835. AceComm will leave the port speed alone when dialing.  The modem handles speed
  1836. translation between 'connect' and 'computer'.  LOCK BAUD ON is generally
  1837. preferable with modems that support it.  The status displays will reflect 'L'
  1838. appended to the baud rate when LOCK BAUD is set ON.  NOTE: the 'L' is not
  1839. appended in the Line Control Window's display above.
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.        Page 30              AceComm (tm) v 1.81
  1854.  
  1855.  
  1856. Chapter 4  PRM-data Menus Area
  1857.  
  1858.            UART Line Control (continued)
  1859.  
  1860.  
  1861.  
  1862.     ╔═══ Serial Port Setup Menu ═══════════╗
  1863.     ║ Port Number Select      1            ║
  1864.     ║╔═ UART Line Control ═══════════════╗ ║
  1865.     ║║╔═ Data Bits ═══════════════════════╗║
  1866.     ║║║>5                                 ║║
  1867.     ║║║ 6                                 ║║
  1868.     ║║║ 7                                 ║║
  1869.     ║║║ 8                                 ║║
  1870.     ╚╚╚═ Select  Quit ════════════════════╝╝
  1871.     ╔═══ Serial Port Setup Menu ═══════════╗
  1872.     ║ Port Number Select      1            ║
  1873.     ║╔═ UART Line Control ═══════════════╗ ║
  1874.     ║║ Data Bits          8              ║ ║
  1875.     ║║╔═ Parity ══════════════════════════╗║
  1876.     ║║║>None                              ║║
  1877.     ║║║ Odd                               ║║
  1878.     ║║║ Even                              ║║
  1879.     ╚╚║ Mark                              ║╝
  1880.       ║ Space                             ║
  1881.       ╚═ Select  Quit ════════════════════╝
  1882.     ╔═══ Serial Port Setup Menu ═══════════╗
  1883.     ║ Port Number Select      1            ║
  1884.     ║╔═ UART Line Control ═══════════════╗ ║
  1885.     ║║ Data Bits          8              ║ ║
  1886.     ║║ Parity             None           ║ ║
  1887.     ║║╔═ Stop Bits ═══════════════════════╗║
  1888.     ║║║>1                                 ║║
  1889.     ║║║ 2                                 ║║
  1890.     ╚╚╚═ Select  Quit ════════════════════╝╝
  1891.  
  1892. Data Format
  1893.  
  1894.   Stop bits, Parity, Data bits.  Each character that comes in the serial port
  1895.   arrives as a series of BITS.  The BITS are assembled in your serial port's
  1896.   UART's SERIAL DATA UNIT SDU).
  1897.  
  1898.   AceComm's default setting of 8 data bits, no parity, and 1 stop bit is the
  1899.   most popular arrangement, and that which most BBS systems use.  You will
  1900.   change the Data Format when necessary for connecting with systems that don't
  1901.   use the standard 8N1.
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.        Page 31              AceComm (tm) v 1.81
  1910.  
  1911.  
  1912. Chapter 4  PRM-data Menus Area
  1913.  
  1914.            UART Line Control (continued)
  1915.  
  1916.  
  1917. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1918. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1919. ░░░░░░░░░░░░░░░░░░░░░┌──────────────────────────────────────┐░░░░░░░░░░░░░░░░░
  1920. ░░░░░░░░░░░░░░░░░░░░░│─ PRM-data   Sub-Menu Areas ──────────│░░░░░░░░░░░░░░░░░
  1921. ░░░░░░░░░░░░░░░░░░░░░│ Area controls / Options menus        │░░░░░░░░░░░░░░░░░
  1922. ░░░░░░░░░░░░░░░░░░░░░│┌───Serial Port/Modem Setup────────────┐░░░░░░░░░░░░░░░░
  1923. ░░░░░░░░░░░░░░░░░░░░░││ Port Number Select      2            │░░░░░░░░░░░░░░░░
  1924. ░░░░░░░░░░░░░░░░░░░░░││┌─UART Line Control─────────────────┐ │░░░░░░░░░░░░░░░░
  1925. ░░░░░░░░░░░░░░░░░░░░░│││ Data Bits          8              │ │░░░░░░░░░░░░░░░░
  1926. ░░░░░░░░░░░░░░░░░░░░░│││ Parity             None           │ │░░░░░░░░░░░░░░░░
  1927. ░░░░░░░░░░░░░░░░░░░░░│││┌─Baud Select───────────┐          │ │░░░░░░░░░░░░░░░░
  1928. ░░░░░░░░░░░░░░░░░░░░░│└││>300                   │          │─┘░░░░░░░░░░░░░░░░
  1929. ░░░░░░░░░░░░░░░░░░░░░│ ││ 1200                  │          ││░░░░░░░░░░░░░░░░░
  1930. ░░░░░░░░░░░░░░░░░░░░░│ └│ 2400                  │^├────────┘│░░░░░░░░░░░░░░░░░
  1931. ░░░░░░░░░░░░░░░░░░░░░│ A│ 4800                  │           │░░░░░░░░░░░░░░░░░
  1932. ░░░░░░░░░░░░░░░░░░░░░│ E│ 9600                  │           │░░░░░░░░░░░░░░░░░
  1933. ░░░░░░░░░░░░░░░░░░░░░│ A│ 19200                 │           │░░░░░░░░░░░░░░░░░
  1934. ░░░░░░░░░░░░░░░░░░░░░└──│ 38400                 │^├─────────┘░░░░░░░░░░░░░░░░░
  1935. ░░░░░░░░░░░░░░░░░░░░░░░░│ 57600                 │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1936. ░░░░░░░░░░░░░░░░░░░░░░░░│ 115200                │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1937. ░░░░░░░░░░░░░░░░░░░░░░░░└─ Select  Quit  Help ──┘░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1938. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1939.  
  1940.  
  1941. o Connect speeds such as 12000, 14400 etc.  are not actual data rates that the
  1942.   UART (serial port) can be set to.
  1943.  
  1944. o Modems capable of connecting at 9600 and above can usually be used with a
  1945.   "Locked port"
  1946.  
  1947. o Setting the Baud rate to 19200 for a 9600 baud modem will allow better
  1948.   performance when down loading data.
  1949.  
  1950. o Locking the port means selecting a baud rate higher than the highest connect
  1951.   speed the modem is capable of, and telling the communications software to
  1952.   lock it there.
  1953.  
  1954. o Using a locked port requires your modem be in full handshake mode.
  1955.  
  1956.  
  1957.    "14.4k, 16.8k modems"
  1958.  
  1959.   Q.) Why doesn't AceComm support my 14.4k modems connect speed of 14400 in
  1960.       the "Baud Select" menu?
  1961.  
  1962.  
  1963.  
  1964.  
  1965.        Page 32              AceComm (tm) v 1.81
  1966.  
  1967.  
  1968. Chapter 4  PRM-data Menus Area
  1969.  
  1970.            UART Line Control (continued)
  1971.  
  1972.   A.) 14400 is a data rate your modem is capable of.  The serial port in your
  1973.       computer cannot be set to 14400 baud.  In order to operate at 14400
  1974.       connect speeds, the serial port must be set to 19200, 38400, or 57600
  1975.       baud.
  1976.  
  1977.       o 14400 is your modems "Connection Rate" "Line Speed", "Modem-to-Modem
  1978.          Speed", "DCE Speed" are other synonyms for "Connection Rate"
  1979.  
  1980.       o 19200 is the closest "Computer Rate"
  1981.  
  1982.       o Selecting the closest "Computer Rate" is called using a "Locked" port
  1983.  
  1984.         When using a "Locked" port your modem makes the translation between
  1985.         "Connection Rate" and "Computer Rate" by using FLOW control (RTS/CTS
  1986.         hardware handshaking) Your serial port can be set to 19200, or 38400
  1987.         and left there (See LOCKBAUD)
  1988.  
  1989.  
  1990.  
  1991. "Selecting your highest port speed when LOCKing the port"
  1992.  
  1993.   Locking the port at 57600 with a high speed modem causes the UART to assemble
  1994.   a character off the bit stream VERY quickly.
  1995.  
  1996.   If you experience serial input errors with HIGH locked rates, drop down to
  1997.   38400 or even 19200.  The lower rate will cause the UART to make characters
  1998.   available at a reduced speed.  For instance a 12 MHZ AT will probably
  1999.   experience data overruns using a locked port above 19200 when down loading
  2000.   TEXT files with ZMODEM.
  2001.  
  2002.   A common miss-conception is when CRC errors occur with HIGH LOCKED PORT
  2003.   rates, that it is the UART unable to keep up.  This is simply not true.  The
  2004.   UART/modem combo is capable of out running the computer/software combo.  When
  2005.   using a TASK switcher such as WINDOWS or DESQVIEW, a lower PORT RATE such as
  2006.   19200 may very well be needed for efficient data transfers.
  2007.  
  2008.   The idea is to set the port to a speed that the computer/software combo is
  2009.   capable of responding to quickly enough.
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.        Page 33              AceComm (tm) v 1.81
  2022.  
  2023.  
  2024. Chapter 4  PRM-data Menus Area
  2025.  
  2026.            Modem Response Strings
  2027.  
  2028.  
  2029. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2030. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2031. ░░░░░░░░░░░░░░░░░░░░░┌──────────────────────────────────────┐░░░░░░░░░░░░░░░░░
  2032. ░░░░░░░░░░░░░░░░░░░░░│─ PRM-data   Sub-Menu Areas ──────────│░░░░░░░░░░░░░░░░░
  2033. ░░░░░░░░░░░░░░░░░░░░░│ Area controls / Options menus        │░░░░░░░░░░░░░░░░░
  2034. ░░░░░░░░░░░░░░░░░░░░░│┌───Serial Port/Modem Setup────────────┐░░░░░░░░░░░░░░░░
  2035. ░░░░░░░░░░░░░░░░░░░░░││ Port Number Select      2            │░░░░░░░░░░░░░░░░
  2036. ░░░░░░░░░░░░░░░░░░░░░││┌─Modem Response Strings──────────────┐░░░░░░░░░░░░░░░░
  2037. ░░░░░░░░░░░░░░░░░░░░░│││ OK              OK^M                │░░░░░░░░░░░░░░░░
  2038. ░░░░░░░░░░░░░░░░░░░░░│││ RING            RING^M              │░░░░░░░░░░░░░░░░
  2039. ░░░░░░░░░░░░░░░░░░░░░│││ NO_CARRIER      NO CARRIER          │░░░░░░░░░░░░░░░░
  2040. ░░░░░░░░░░░░░░░░░░░░░│└│ ERROR           ERROR               │░░░░░░░░░░░░░░░░
  2041. ░░░░░░░░░░░░░░░░░░░░░│ │ NO_DIAL_TONE    NO DIAL TONE        │░░░░░░░░░░░░░░░░
  2042. ░░░░░░░░░░░░░░░░░░░░░│ │ BUSY            BUSY                │░░░░░░░░░░░░░░░░
  2043. ░░░░░░░░░░░░░░░░░░░░░│ │ NO_ANSWER       NO ANSWER           │░░░░░░░░░░░░░░░░
  2044. ░░░░░░░░░░░░░░░░░░░░░│ │ RINGING         RINGING^M           │░░░░░░░░░░░░░░░░
  2045. ░░░░░░░░░░░░░░░░░░░░░│ │ VOICE           VOICE               │░░░░░░░░░░░░░░░░
  2046. ░░░░░░░░░░░░░░░░░░░░░└─│ Connect 1       CONNECT             │░░░░░░░░░░░░░░░░
  2047. ░░░░░░░░░░░░░░░░░░░░░░░│>Connect 2       CARRIER             │░░░░░░░░░░░░░░░░
  2048. ░░░░░░░░░░░░░░░░░░░░░░░│ Connect 3       FAX                 │░░░░░░░░░░░░░░░░
  2049. ░░░░░░░░░░░░░░░░░░░░░░░└─ Edit  Quit  Help ┤<>v^├────────────┘░░░░░░░░░░░░░░░░
  2050. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2051.  
  2052.  
  2053. o AceComm uses text response strings only
  2054.  
  2055. o Connect strings will allow non-locked ports "auto adjust" AceComm leaves
  2056.    locked ports set to the selected LOCKBAUD rate.
  2057.  
  2058. Modem response strings are normally UPPER CASE.  Response strings are used by
  2059. AceComm when dialing to more quickly respond to BUSY, NO CARRIER etc.  HOSTMODE
  2060. will be waiting for a RING code.(1) The Response strings that can be matched
  2061. while dialing are displayed in the DIAL WINDOW as they come in.
  2062.  
  2063. AceComm will detect a connection after dialing, a few seconds quicker when able
  2064. to match a connect string with the modem's connect message.
  2065.  
  2066. High Speed modem users may configure the modem for more than 1 connect message
  2067. to be returned from the modem.  AceComm need only detect 1.  The connect string
  2068. fields are freely configurational, and follow no specific order.  Leave them,
  2069. or edit them as needed any way you see fit.
  2070.  
  2071. AceComm will fall out of re-dial on detection of carrier anyway.  For the LOCK
  2072. BAUD users, this detection is right away.  For those who use modems that don't
  2073. allow port LOCKING, and want auto baud rate adjustment to match the connect,
  2074.  
  2075.  
  2076.  
  2077.        Page 34              AceComm (tm) v 1.81
  2078.  
  2079.  
  2080. Chapter 4  PRM-data Menus Area
  2081.  
  2082.            Modem Response Strings (continued)
  2083.  
  2084. carrier is checked only after the dialing has timed out.  AceComm will be
  2085. trying it's best to get a CONNECT string so that the connect speed can be
  2086. checked.
  2087.  
  2088.  
  2089. (1) HOSTMODE also uses the UART's modem status register RI bit when detecting
  2090.      "RING".
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.        Page 35              AceComm (tm) v 1.81
  2134.  
  2135.  
  2136. Chapter 4  PRM-data Menus Area
  2137.  
  2138.            Modem Commands
  2139.  
  2140.  
  2141. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2142. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2143. ░░░░░░░░░░░░░░░░░░░░░┌──────────────────────────────────────┐░░░░░░░░░░░░░░░░░
  2144. ░░░░░░░░░░░░░░░░░░░░░│─ PRM-data   Sub-Menu Areas ──────────│░░░░░░░░░░░░░░░░░
  2145. ░░░░░░░░░░░░░░░░░░░░░│ Area controls / Options menus        │░░░░░░░░░░░░░░░░░
  2146. ░░░░░░░░░░░░░░░░░░░░░│┌───Serial Port/Modem Setup────────────┐░░░░░░░░░░░░░░░░
  2147. ░░░░░░░░░░░░░░░░░░░░░││ Port Number Select      2            │░░░░░░░░░░░░░░░░
  2148. ░┌───Modem Command Strings────────────────────────────────────┐░░░░░░░░░░░░░░░
  2149. ░│>Setup              ATH0^M~~~~AT&F2^M~~~~ATE0&W0            │░░░░░░░░░░░░░░░
  2150. ░│ Init               ATZ^M~~~~ATE0&C1&D2                     │░░░░░░░░░░░░░░░
  2151. ░│ Dial Prefix        ATEQ0X4DT                               │░░░░░░░░░░░░░░░
  2152. ░│ Dial Suffix                                                 │░░░░░░░░░░░░░░░
  2153. ░│ Answer             ATA                                     │░░░░░░░░░░░░░░░
  2154. ░│ Hangup             +++~~~~~ATH0                            │░░░░░░░░░░░░░░░
  2155. ░│ Offhook            ATH1                                    │░░░░░░░░░░░░░░░
  2156. ░│ Abort              ^M                                      │░░░░░░░░░░░░░░░
  2157. ░│ Reset              ATZ                                     │░░░░░░░░░░░░░░░
  2158. ░│ Command Echo       ATE1                                    │░░░░░░░░░░░░░░░
  2159. ░│ Host Init          ATE                                     │░░░░░░░░░░░░░░░
  2160. ░│ Cmd Enter          ^M                                      │░░░░░░░░░░░░░░░
  2161. ░└─── Edit  Select  Quit  Help ┤<>v^├─────────────────────────┘░░░░░░░░░░░░░░░
  2162. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2163.  
  2164.  
  2165. o Cmd Terminator is automatically appended to modem command strings.
  2166.  
  2167. Here we have the modem commands AceComm uses to interact with your modem.
  2168. Please note the bottom of the menu contains the "Cmd Terminator".  AceComm
  2169. appends this to all modem commands automatically.  Notice that "Init" has a ^M
  2170. followed by ~~~~ and another command.  This is an example of command stacking.
  2171.  
  2172. '^' is an escape character AceComm recognizes and translates byte following
  2173. into control characters.  ^M translates into a carriage return, <CR>, (13d).  A
  2174. character following '^' is either upper case or made upper case by AceComm,
  2175. then subtracted by 64 converting 'A' to 1 etc.
  2176.  
  2177. '~' translate into 1/4 second delays.
  2178.  
  2179. AceComm modem command lines are limited to 40 characters in length, including
  2180. the Cmd Terminator.  This is a standard maximum command length used by modem
  2181. manufacturers.
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.        Page 36              AceComm (tm) v 1.81
  2190.  
  2191.  
  2192. Chapter 4  PRM-data Menus Area
  2193.  
  2194.            Modem Control
  2195.  
  2196.  
  2197.    ╔═════════ACE.PRM Data  Edit-Menus═══════╗
  2198.    ║ General Controls                       ║
  2199.    ║╔═══ Serial Port Setup Menu ═══════════╗║
  2200.    ║║ Port Number Select      1            ║║
  2201.    ║║ Line Control Setup      19200L,8N1   ║║
  2202.    ║║ Modem Connect Strings                ║║
  2203.    ║║ Modem Response Strings               ║║
  2204.    ║║ Modem Command Strings                ║║
  2205.    ║║╔═ Modem Control════════════════════╗ ║║
  2206.    ║║║>DTR      On                       ║ ║║
  2207.    ╚╚║ RTS      On                       ║═╝╝
  2208.      ║ GPO1     Off                      ║
  2209.      ║ GPO2     On                       ║
  2210.      ║ Loopback Off                      ║
  2211.      ║═Modem Status══════════════════════║
  2212.      ║ CTS      On                       ║
  2213.      ║ DSR      On                       ║
  2214.      ║ RI       Off                      ║
  2215.      ║ DCD      Off                      ║
  2216.      ╚═ Select  Quit ════════════════════╝
  2217.  
  2218. Modem Control
  2219.  
  2220. o GPO2 must be set "ON" for interrupt to seen by the computer
  2221.  
  2222. o Normal operation requires LOOPBACK be left "OFF"
  2223.  
  2224. These controls are available for experienced users.  The "Modem Control" menu
  2225. will allow setting or re-setting each of the bits listed.  If you want
  2226. interrupts to continue to be recognized you shall make sure and leave GPO2
  2227. "ON".  GPO2 "OFF" will disable interrupts for the port, and AceComm will not
  2228. function properly.  Same with Loop back.  If in doubt, you can use the above
  2229. snapshot as a reference to correct bit setting of the modem control register.
  2230.  
  2231.  
  2232. Modem Status
  2233.  
  2234. o DSR will normally be SET when a modem is powered up.  AceComm will alert the
  2235.    user on DSR not SET when installing on a port.
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.        Page 37              AceComm (tm) v 1.81
  2246.  
  2247.  
  2248. Chapter 4  PRM-data Menus Area
  2249.  
  2250.            Default Video Emulation
  2251.  
  2252.  
  2253.    ╔═════════ACE.PRM Data  Edit-Menus═══════╗
  2254.    ║ General Controls                       ║
  2255.    ║╔═══ Serial Port Setup Menu ═══════════╗║
  2256.    ║║ Port Number Select      1            ║║
  2257.    ║║ Line Control Setup      19200L,8N1   ║║
  2258.    ║║ Modem Connect Strings                ║║
  2259.    ║║ Modem Response Strings               ║║
  2260.    ║║ Modem Command Strings                ║║
  2261.    ║║ Modem Control Setup                  ║║
  2262.    ║║╔═Default Video Emulation════════════════════════════╗
  2263.    ╚╚║═Video Emulation  <>  Associated KTS file═══════════║
  2264.      ║ TTY                   TTY.KTS                      ║
  2265.      ║ Ansi                  ANSI.KTS                     ║
  2266.      ║>Avatar                AVATAR.KTS                   ║
  2267.      ║ VT102                 VT102.KTS                    ║
  2268.      ╚═ New_Vid  Asso_KTS  Quit  View_Cur_KTS ════════════╝
  2269.  
  2270. o Video Terminal emulation is built into AceComm
  2271.  
  2272. o Associated KTS file is the Keyboard Translation Sequence file that will be
  2273.   loaded for the given Video Type.
  2274.  
  2275. o Keyboard Terminal emulation is defined inside of *.KTS files AceComm includes
  2276.   a separate utility KTS.EXE which allows the user to define KTS files for any
  2277.   Keyboard Terminal emulation desired.
  2278.  
  2279. AceComm emulates the selected VIDEO type.  "Associated KTS file" is the .KTS
  2280. file you want to use with the VIDEO selection.  Each time AceComm activates a
  2281. VIDEO type, the associated KTS file is loaded and becomes active on the
  2282. keyboard.  KTS keyboard definitions override MACRO assignments.
  2283.  
  2284. KTS (Key Translation Sequence) files contain assignments for a sequence of
  2285. characters to a key press.  When a key is pressed from inside TERMINAL area,
  2286. AceComm first checks to see if the key press has been defined in the current
  2287. KTS data.  If so, AceComm sends the assigned sequence of characters to the
  2288. modem.  The utility KTS.EXE (included) can be used to create new and or custom
  2289. KTS files.  See the included .ASC examples for defining and creating KTS
  2290. files.  Using KTS.EXE, the keyboard can be deigned to emulate any possible
  2291. combination of characters available to the system.  Key press assignments
  2292. defined in the KTS data area are given top priority, and thus take presides
  2293. over MACROS assigned to the same key.
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.        Page 38              AceComm (tm) v 1.81
  2302.  
  2303.  
  2304. Chapter 4  PRM-data Menus Area
  2305.  
  2306.            Key Translation Sequence file (.KTS)
  2307.  
  2308.  
  2309.  
  2310. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2311. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░┌─VT102.KTS─────────────────────────┐
  2312. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│>TAB          ^I                   │
  2313. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ Del/.                            │
  2314. ░░░░░░░░░░░░░░░░░░░░░┌───────────────────│ Home/7       ^[[H                 │
  2315. ░░░░░░░░░░░░░░░░░░░░░│─ PRM-data   Sub-Me│ Up/8         ^[[A                 │
  2316. ░░░░░░░░░░░░░░░░░░░░░│┌─Area controls / O│ Left/4       ^[[D                 │
  2317. ░░░░░░░░░░░░░░░░░░░░░││ Telephone book on│ Right/6      ^[[C                 │
  2318. ░░░░░░░░░░░░░░░░░░░░░││ Allow enhanced ke│ End/1        ^[[K                 │
  2319. ░░░░░░░░░░░░░░░░░░░░░││ Allow mouse detec│ Down/2       ^[[B                 │
  2320. ░░░░░░░░░░░░░░░░░░░░░││ Mouse horizontal │ Keypad-0     ^[Op                 │
  2321. ░░░░░░░░░░░░░░░░░░░░░││ Mouse vertical se│ Keypad-1     ^[Oq                 │
  2322. ░░░░░░░░░░░░░░░░░░░░░││ Auto Save Changes│ Keypad-2     ^[Or                 │
  2323. ░░░░░░░░░░░░░░░░░░░░░││ Screen Saver time│ Keypad-3     ^[Os                 │
  2324. ░░░░░░░░░░░░░░░░░░░░░││┌─Terminal Area Op│ Keypad-4     ^[Ot                 │
  2325. ░░░░░░░░░░░░░░░░░░░░░│││┌─Default Video E│ Keypad-5     ^[Ou                 │
  2326. ░░░░░░░░░░░░░░░░░░░░░││││─Video Emulation│ Keypad-6     ^[Ov                 │
  2327. ░░░░░░░░░░░░░░░░░░░░░││││ TTY            │ Keypad-7     ^[Ow                 │
  2328. ░░░░░░░░░░░░░░░░░░░░░││││ Ansi           │ Keypad-8     ^[Ox                 │
  2329. ░░░░░░░░░░░░░░░░░░░░░└│││ Avatar         │ Keypad-9     ^[Oy                 │
  2330. ░░░░░░░░░░░░░░░░░░░░░░│││ Av/An          │ Keypad--     ^[Om                 │
  2331. ░░░░░░░░░░░░░░░░░░░░░░│││>VT102          │ Keypad-*     ^[Ol                 │
  2332. ░░░░░░░░░░░░░░░░░░░░░░└└└─ New_Vid  Asso_└─ Select  More  Quit  Help ┤<>v^├──┘
  2333. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2334.  
  2335. KTS files contain a sequence of bytes to be sent to the modem when a particular
  2336. key press is made.  AceComm emulates a video type independently from the
  2337. keyboard emulation.  KTS files may be edited to emulate any combination
  2338. imaginable.  KTS files may be created and assigned to a video type using the
  2339. "Associate" option above.
  2340.  
  2341. AceComm comes with ready made KTS files.
  2342.  
  2343.    Notes: .KTS files are compiled from .ASC files.  .ASC files may be created,
  2344.           maintained, customized with a TEXT EDITOR in ASCII TEXT mode.  The
  2345.           utility KTS.EXE is provided for compiling .ASC files into .BIN
  2346.           files.  Rename the .BIN file with .KTS and copy the .KTS file into
  2347.           the directory pointed to in PRM-data for ".KTS".
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.        Page 39              AceComm (tm) v 1.81
  2358.  
  2359.  
  2360. Chapter 4  PRM-data Menus Area
  2361.  
  2362.            Keyboard MACRO Assignments
  2363.  
  2364.  
  2365.  
  2366.     ╓─KeyBoard MACRO Assignments───╖
  2367.     ║─Current Keyboard:ACE_DEF.KBD─║
  2368.     ║>      F1 - F12               ║
  2369.     ║   ALT-F1 - F12               ║
  2370.     ║  CTRL-F1 - F12               ║
  2371.     ║ SHIFT-F1 - F12               ║
  2372.     ║  ALT+KEY Combo               ║
  2373.     ║ CTRL+KEY Combo               ║
  2374.     ║  Extended Keys               ║
  2375.     ╙─── Select  Write  Quit───────╜
  2376. o Each of the above key sets is available for assignment to a MACRO or MACRO
  2377.   stack.  The MACROS provide a wide range of services.  All of AceComm's
  2378.   functionality is available with MACROS.
  2379.  
  2380. o The "SHIFT-Fn" key-set is used by TAGGER to store TAGGED ITEMS
  2381.  
  2382. Menu options here allow each key press be re-assigned.  The keyboard can be
  2383. arranged thru the use of MACROS to resemble software you are more accustomed
  2384. to.  AceComm`s keyboard is totally MACRO driven.  Keyboard definitions are
  2385. stored in .KBD files.  ACE.CTL can be edited so future upgrades of AceComm will
  2386. automatically configure with your keyboard preference.
  2387.  
  2388.  
  2389. Write
  2390.   Prompts for a filename, and writes the current keyboard to a new KBD file, or
  2391.   updates an existing KBD file of the same name.
  2392.  
  2393.   When you choose "Write" the following occurs:
  2394.  
  2395.     AceComm  prompts  for  "filename"
  2396.     "filename"  is  forced a ".KBD"  extension
  2397.     "filename" is written in the same directory as ACE.PRM
  2398.     resides
  2399.     AceComm writes the contents of "Key MACRO Assignments" menu
  2400.     to the file
  2401.     AceComm re-reads the original KBD file.
  2402.  
  2403.   In short:
  2404.   - All changes, once written to a KBD file with "Write", pertain to the KBD
  2405.     file written to.
  2406.   - Making changes and not "Writing" them, will be saved to the current KBD
  2407.     file at program end.
  2408.  
  2409. To further explain, all changes made in this menu area to the keyboard
  2410. definitions, apply to the current KBD file.  If you exit the menu area, without
  2411.  
  2412.  
  2413.  
  2414.        Page 40              AceComm (tm) v 1.81
  2415.  
  2416.  
  2417. Chapter 4  PRM-data Menus Area
  2418.  
  2419.            Keyboard MACRO Assignments (continued)
  2420.  
  2421. choosing "Write", and say "ACE_DEF.KBD" is active, the changes will be stored
  2422. to "ACE_DEF.KBD" when you leave the PRM-data area.  If you choose "Write" from
  2423. the above menu, then the changes are stored to a new or existing KBD file, and
  2424. do not affect the current keyboard, as AceComm re-loads the current KBD file
  2425. after a "Write".  Unless you "Write" to the current KBD file, which is un
  2426. necessary, because AceComm will update it automatically anyway.
  2427.  
  2428. "SHIFT-Fn" is the key-set the TAGGER function assigns TAGGED ITEMS to.  When
  2429. you tag a word or line from the screen, the tagged item becomes associated with
  2430. the first available SHIFT-Fn key by way of the <SEND_SendStr> MACRO.
  2431.  
  2432. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2433. ░░░░░░░░░░░░░░░░░░░░░┌──────────────────────────────────────┐░░░░░░░░░░░░░░░░░
  2434. ┌─ F# Keys ───────────────────────────────────────────────────────────────────
  2435. │> 1<SendStr>[USER_NAME]^M
  2436. │  2<SendStr>[FON_REC_PWD]^M
  2437. │  3<SendStr>[LOCATION]^M
  2438. │  4<SendStr>[VOICE_PNUM]^M
  2439. │  5<SendStr>[PASSWORD]^M
  2440. │  6<SetDTR> ON
  2441. │  7<SendAscii> %PF
  2442. │  8<Mondos>
  2443. │  9<HelpMenu>
  2444. │ 10<TopBar>
  2445. │ 11<Mondo1>
  2446. │ 12<SendStr>75120,3306^M
  2447. └─── Edit  Zap  Quit ┤<>v^├───────────────────────────────────────────────────
  2448. ░░░░░░░░░░░░░░░░░░░░░└─── Select  Quit  Help ┤<>v^├─────────┘░░░░░░░░░░░░░░░░░
  2449. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2450.  
  2451. Edit
  2452.  
  2453.   Allows editing the MACRO assignment.
  2454.  
  2455.  
  2456. Zap
  2457.  
  2458.   Clears field (Zaps) the MACRO assignment.
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.  
  2468.  
  2469.  
  2470.        Page 41              AceComm (tm) v 1.81
  2471.  
  2472.  
  2473. Chapter 4  PRM-data Menus Area
  2474.  
  2475.            Keyboard MACRO Assignments (continued)
  2476.  
  2477.  
  2478.  
  2479.    ╔═════════ACE.PRM Data  Edit-Menus═══════╗
  2480.    ║ General Controls                       ║
  2481.    ║ Serial Port Setup                      ║
  2482.    ║╔═KeyBoard MACRO Assignments═══╗        ║
  2483. ╔═ SHIFT F# Keys ═══════════════════════════════════════════════
  2484. ║  1<SENDSTR>80XXX_92.ARJ
  2485. ║  2
  2486. ║  3
  2487. ║  4
  2488. ║> 5
  2489. ║  6
  2490. ║  7
  2491. ║  8
  2492. ║  9
  2493. ║ 10
  2494. ║ 11
  2495. ║ 12
  2496. ╚═══ Edit  Zap  Quit ═══════════════════════════════════════════
  2497.  
  2498. "SHIFT-Fn" key-set the TAGGER function assigns TAGGED ITEMS to.
  2499.  
  2500. When you tag a word or line from the screen, the tagged item becomes associated
  2501. with the first available SHIFT-Fn key by way of the <SEND_SendStr> MACRO.
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526.        Page 42              AceComm (tm) v 1.81
  2527.  
  2528.  
  2529. Chapter 4  PRM-data Menus Area
  2530.  
  2531.            Keyboard MACRO Assignments (continued)
  2532.  
  2533.  
  2534. ┌─ALT+KEY Combo───────────────────────────────────────────────────────────────
  2535. │>ALT-A <AutoScrGen_>
  2536. │ ALT-B <BackBuffer_>
  2537. │ ALT-C <CaptureFile_>
  2538. │ ALT-D <FonListDialer_>
  2539. │ ALT-E <SendStr> ATE^M <HostEcho>
  2540. │ ALT-F <FileLister_>[DIR_DNLDS]
  2541. │ ALT-G <FileRequest_>
  2542. │ ALT-H <MdmHangUp_>
  2543. │ ALT-I
  2544. │ ALT-J <CommandShell_>
  2545. │ ALT-K
  2546. │ ALT-L <RunProg> list
  2547. │ ALT-M <SendStr>ath1^M <ChgDir>mail\ged <RunProg>GOLDED <ChgDir>[DIR_START]
  2548. │ ALT-N <ChgDir>c:\mail\qm <RunProg>QM toss <ChgDir>[DIR_START]
  2549. │ ALT-O <PrmDataMenus_>
  2550. │ ALT-P <PrmDataMenus_>
  2551. │ ALT-Q
  2552. │ ALT-R <RunScript_>
  2553. │ ALT-S <ScrnSnapshot_>
  2554. │ ALT-T <ScrnTag_>
  2555. └─── Edit  More  Quit ┤<>v^├──────────────────────────────────────────────────
  2556.  
  2557. PgDn/PgUp toggles display between above and below
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.        Page 43              AceComm (tm) v 1.81
  2583.  
  2584.  
  2585. Chapter 4  PRM-data Menus Area
  2586.  
  2587.            Directories in Use Menu
  2588.  
  2589.  
  2590.  
  2591.     ╓─Directories in Use Menu─────────────────────────────────
  2592.     ║>.FON files: D:\ACE
  2593.     ║ .CAP files: D:\ACE
  2594.     ║ .SCR files: D:\ACE
  2595.     ║ .KTS files: D:\ACE
  2596.     ║  Downloads: D:\ACE
  2597.     ║   Nodelist: D:\ACE
  2598.     ║  .REQ/.FLO: D:\AC
  2599.     ╙─── Edit  Quit ──────────────────────────────────────────
  2600.  
  2601. .FON
  2602.  
  2603.   Where AceComm expects .FON files to be.
  2604.  
  2605.  
  2606. .CAP
  2607.  
  2608.   Where AceComm will create and or re-open CAPTURE files.  A CAPTURE file is a
  2609.   means for "capturing" all port I/O to DISK.  When you open a capture file,
  2610.   AceComm records everything that comes into the serial port, exactly as it
  2611.   comes in.  Capture mode can be set to "Text" or "Raw".  "Raw" mode, no
  2612.   filtering, no translation of any kind takes place.(1) Video codes are
  2613.   recorded as they come in.  This allows capture of ANSI, AVATAR, RIP etc.
  2614.   screens.  "Text" mode, video control codes are filtered from the captured
  2615.   text.  AceComm does not overwrite CAPTURE files.  You have the option of
  2616.   renaming the file, or AceComm will append new data to the end of the
  2617.   file(2).  Time/Date stamps are always placed at the beginning of a capture
  2618.   file when opened.
  2619.  
  2620.  
  2621. .SCR
  2622.  
  2623.   Where AceComm will create and or look for .SCR files.  The MACRO <RunScript_>
  2624.   lists this directory.
  2625.  
  2626.  
  2627. .KTS
  2628.   Where AceComm expects to find it's KTS files.  It's ok to store
  2629.   your .ASC files in this directory.
  2630.  
  2631. Downloads
  2632.  
  2633.   This is the directory that AceComm 's internal protocols will receive into.
  2634.   AceComm will also list this directory when building upload LISTFILES.
  2635.  
  2636.  
  2637.  
  2638.        Page 44              AceComm (tm) v 1.81
  2639.  
  2640.  
  2641. Chapter 4  PRM-data Menus Area
  2642.  
  2643.            Directories in Use Menu (continued)
  2644.  
  2645.  
  2646.  
  2647. Nodelist
  2648.  
  2649.   When you select the FileRequest option, AceComm expects to find either (a) a
  2650.   valid RAW FIDO NODELIST and NLIST.IDX file(3).  or (b) a .NOD file(4)
  2651.  
  2652.  
  2653. .REQ/.FLO
  2654.  
  2655.   .REQ files are used when doing File Requests.  When you ask AceComm to make a
  2656.   File Request, the filename is created using the NET/NODE number in ascii hex,
  2657.   and the file extensions is ".REQ".
  2658.  
  2659.   .FLO files (Mail List File) are used when you want to Fil Attach to a
  2660.   NET/NODE.  File Attach may be any file(s), and will
  2661.   for point mail operators to send their mail bundle to the HOST.
  2662.  
  2663. (1) ANSI.EXE is a provided utility that can filter VIDEO CONTROL SEQUENCES from
  2664.      DISK files.
  2665.  
  2666. (2) If you have edited a CAPTURE file, or by other means used any utility that
  2667.      added the 26d character to the file, AceComm will not overwrite the END OF
  2668.      FILE character.  This may result in some editors not recognizing new data
  2669.      that follows the 26d character.  There exists utilities that can filter
  2670.      this and other characters from TEXT files.
  2671.  
  2672. (3) NLIST.IDX is a file created using the AceComm utility IDX.EXE.  IDX.EXE
  2673.      will create a small index into the RAW FIDO NODELIST file, for all
  2674.      ZONE:NET pairs.
  2675.  
  2676. (4) .NOD files are FBL output for a NET.  FBL.EXE is another AceComm utility.
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.        Page 45              AceComm (tm) v 1.81
  2695.  
  2696.  
  2697. Chapter 4  PRM-data Menus Area
  2698.  
  2699.            External Programs Setup
  2700.  
  2701.  
  2702.  
  2703. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2704. ░░░░░░░░░░░░░░░░░░░░░┌──────────────────────────────────────┐░░░░░░░░░░░░░░░░░
  2705. ░░░░░░░░░░░░░░░░░░░░░│─ PRM-data   Sub-Menu Areas ──────────│░░░░░░░░░░░░░░░░░
  2706. ░░░░░░░░░░░░░░░░░░░░░│ Area controls / Options menus        │░░░░░░░░░░░░░░░░░
  2707. ░░░░░░░░░░░░░░░░░░░░░│ Serial Port/Modem Setup              │░░░░░░░░░░░░░░░░░
  2708. ░░░░░░░░░░░░░░░░░░░░░│ KeyBoarD Macro Assignments           │░░░░░░░░░░░░░░░░░
  2709. ░░░░░░░░░░░░░░░░░░░░░│┌─External Programs Setup──────┐      │░░░░░░░░░░░░░░░░░
  2710. ░░░░░░░░░░░░░░░░░░░░░││>*.ARJ                        │      │░░░░░░░░░░░░░░░░░
  2711. ░░░░░░░░░░░░░░░░░░░░░││ *.ARC                        │      │░░░░░░░░░░░░░░░░░
  2712. ░░░░░░░░░░░░░░░░░░░░░││ *.LZH                        │logy" │░░░░░░░░░░░░░░░░░
  2713. ░░░░░░░░░░░░░░░░░░░░░││ *.SDN                        │      │░░░░░░░░░░░░░░░░░
  2714. ░░░░░░░░░░░░░░░░░░░░░││ *.ZIP                        │      │░░░░░░░░░░░░░░░░░
  2715. ░░░░░░░░░░░░░░░░░░░░░││ *.ZOO                        │      │░░░░░░░░░░░░░░░░░
  2716. ░░░░░░░░░░░░░░░░░░░░░││ *.EXE                        │      │░░░░░░░░░░░░░░░░░
  2717. ░░░░░░░░░░░░░░░░░░░░░││ *.COM                        │      │░░░░░░░░░░░░░░░░░
  2718. ░░░░░░░░░░░░░░░░░░░░░││ *.DOC                        │      │░░░░░░░░░░░░░░░░░
  2719. ░░░░░░░░░░░░░░░░░░░░░└│ All others                   │──────┘░░░░░░░░░░░░░░░░░
  2720. ░░░░░░░░░░░░░░░░░░░░░░│ External Upload Protocols    │░░░░░░░░░░░░░░░░░░░░░░░░
  2721. ░░░░░░░░░░░░░░░░░░░░░░│ External Download Protocols  │░░░░░░░░░░░░░░░░░░░░░░░░
  2722. ░░░░░░░░░░░░░░░░░░░░░░└─── Select  Quit ┤<>v^ ───────┘░░░░░░░░░░░░░░░░░░░░░░░░
  2723. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2724.  
  2725. The extensions are used with the following menus, and are called when a
  2726. filename has been selected that contains the .EXT as listed.  Selections are
  2727. made while in <FileLister_> menu area.
  2728.  
  2729. Executable files are then handed over to AceComm's SPAWN function.
  2730. (<RunProgram> equivalent) SPAWN can find files along the DOS PATH.  SPAWN can
  2731. also determine a files extension (.COM,
  2732. .EXE) SPAWN will use XMS,EMS,DISK swapping if the option is selected.  SWAP for
  2733. SPWAN is selected from inside PRM-data "General Controls" menu.
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.        Page 46              AceComm (tm) v 1.81
  2751.  
  2752.  
  2753. Chapter 4  PRM-data Menus Area
  2754.  
  2755.            External Programs Setup (continued)
  2756.  
  2757.  
  2758.    ╔═════════ACE.PRM Data  Edit-Menus═══════╗
  2759.    ║ General Controls                       ║
  2760.    ║ Serial Port Setup                      ║
  2761.    ║ KeyBoard Text Macros                   ║
  2762.    ║ Directories in use                     ║
  2763.    ║╔═ Executable files Menus ═════╗        ║
  2764.    ║║╔═%Fn = *.ARJ══════════════════════════════════════════════
  2765.    ║║║><RUNPROGRAM> ARJ a -s %FN %WK
  2766.    ║║║ <RUNPROGRAM> ARJ x %FN %WK
  2767.    ║║║ <RUNPROGRAM> ARJ v %FN %WK
  2768.    ╚║║
  2769.     ║║
  2770.     ║╚═ Select  Edit  Quit ═════════════════════════════════════
  2771.     ║ *.COM                        ║
  2772.     ║ *.DOC                        ║
  2773.     ║ All others                   ║
  2774.     ║ External Upload Protocols    ║
  2775.     ║ External Download Protocols  ║
  2776.     ╚═══ Select  Quit ═════════════╝
  2777.  
  2778. Sample menu when a "Highlighted" file's extension of ".ARJ".  AceComm changes
  2779. to the directory being listed, so that any WORK done by the utility is done in
  2780. the LISTED directory.  AceComm will use the SWAP functions if allowed.  (see
  2781. SWAP enable flags located inside "General Controls" Menu Area.
  2782.  
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.  
  2790.  
  2791.  
  2792.  
  2793.  
  2794.  
  2795.  
  2796.  
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.        Page 47              AceComm (tm) v 1.81
  2807.  
  2808.  
  2809. Chapter 4  PRM-data Menus Area
  2810.  
  2811.            External Programs Setup (continued)
  2812.  
  2813.  
  2814.    ╔═════════ACE.PRM Data  Edit-Menus═══════╗
  2815.    ║ General Controls                       ║
  2816.    ║ Serial Port Setup                      ║
  2817.    ║ KeyBoard Text Macros                   ║
  2818.    ║ Directories in use                     ║
  2819.    ║╔═ Executable files Menus ═════╗        ║
  2820.    ║║ *.ARJ                        ║        ║
  2821.    ║║ *.ARC                        ║        ║
  2822.    ║║ *.LZH                        ║        ║
  2823.    ║║ *.SDN                        ║        ║
  2824.    ╚║ *.ZIP                        ║════════╝
  2825.     ║ *.ZOO                        ║
  2826.     ║╔═%FN = *.EXE══════════════════════════════════════════════
  2827.     ║║><RUNPROGRAM> %FN %WK
  2828.     ║║ <RUNPROGRAM> LIST %FN
  2829.     ║║
  2830.     ║║
  2831.     ║║
  2832.     ╚╚═ Select  Edit  Quit ═════════════════════════════════════
  2833.  
  2834. Sample menu for executable files.  Notice that the <RunProgram> MACRO will be
  2835. handed the current "Highlighted" filename with the %FN MACRO.  In the above
  2836. example the %WK argument will cause AceComm to wait for a key press afterward.
  2837. This allows the user to view any finishing screens generated from the
  2838. executable file argument to <RunProgram>.
  2839.  
  2840. This type of MACRO programming allows the user to fire up that QWK Mail Reader
  2841. (and what have you) on the fly without exiting AceComm.
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.        Page 48              AceComm (tm) v 1.81
  2863.  
  2864.  
  2865. Chapter 4  PRM-data Menus Area
  2866.  
  2867.            Auto Engage Sequence Triggers
  2868.  
  2869.  
  2870.  
  2871. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2872. ░░░░░░░░░░░░░░░░░░░░░┌──────────────────────────────────────┐░░░░░░░░░░░░░░░░░
  2873. ┌─Auto Engage Sequence Triggers───────────────────────────────────────────────
  2874. │─Trigger Sequence -- Responding Macro Stack──────────────────────────────────
  2875. │>rz^M**^X            <RecvZmo>
  2876. │ HS*^B               <RunProg>HSLINK -P%P -U[DIR_DNLDS] @UPLDS.LST
  2877. │ ^H ^H ^H ^H ^H ^H   <RunProg>BIMODEM \L%P \R[DIR_DNLDS] Bimodem.Pth
  2878. │ MPt ^V^H            <RunProg>MPT P%P N+ F+ R+ R [DIR_DNLDS]
  2879. │
  2880. │
  2881. │
  2882. │
  2883. │ **EMSI_REQA77E      <SendEMSI_CLI>
  2884. │ **EMSI_IRQ8E08      <SendEMSI_ICI>
  2885. │─Pre/Post AutoM Macros───────────────────────────────────────────────────────
  2886. │
  2887. │
  2888. └─── Edit  Quit  Help ┤<>v^├──────────────────────────────────────────────────
  2889. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2890.  
  2891. o The last byte in a Sequence Trigger is the sequence scan trigger byte
  2892.  
  2893. o The last byte in a Sequence Trigger should end in an un common character (as
  2894.   designed above)
  2895.  
  2896. o EMSI_REQ detection can allow swift access to a BBS when mailer software
  2897.   answers the phone
  2898.  
  2899. o EMSI_IRQ is sent by BBS software to tell the caller it can do Interactive
  2900.   EMSI data handshaking
  2901.  
  2902.   The above defaults have been working very well for the protocols associated.
  2903.  
  2904.  
  2905. Sequence Trigger
  2906.  
  2907.   A sequence trigger is a character string that is used by a remote HOST,
  2908.   protocol etc.  as an attempt to engage some action from the other end.
  2909.  
  2910.  
  2911. Trigger Character
  2912.  
  2913.   AceComm scans back thru it's receive buffer for a trigger sequence with each
  2914.   occurrence of the "last byte of the sequence".  This means that AceComm will
  2915.  
  2916.  
  2917.  
  2918.        Page 49              AceComm (tm) v 1.81
  2919.  
  2920.  
  2921. Chapter 4  PRM-data Menus Area
  2922.  
  2923.            Auto Engage Sequence Triggers (continued)
  2924.  
  2925.   scan for the string each time it sees the trigger byte arrive from the
  2926.   modem.  For this reason a sequence trigger will end in a non-common byte.
  2927.   While 'rz^M' (^M being <CR>, 13 decimal) would be a valid sequence trigger,
  2928.   we don't want AceComm to search on every carriage return character that comes
  2929.   in.  Look at Bimodem's sequence trigger, we don't want to end the sequence
  2930.   with a <SP> character (^' is the control code for SPACE CHARACTER 32
  2931.   decimal).
  2932.  
  2933.   Characters 32(Space) and below need be escape encoded with the '^' ^A becomes
  2934.   1, ^B 2, ^C 3, ^M <CR>, ^` 32 <SP> etc.  When entering sequence text, you may
  2935.   simply type the <SP> character, AceComm will do the conversion for you.
  2936.  
  2937.  
  2938. **EMSI_REQA77E
  2939.  
  2940.   Most FIDONET mailer software will send an EMSI_REQ string to a caller.  This
  2941.   string is an attempt to determine the caller type.  AceComm's <SendEMSI_CLI>
  2942.   MACRO tells the mailer this is a human caller, bypassing the common "Press
  2943.   ESC to enter BBS" prompt.  DBridge mailer software is in complete and won't
  2944.   recognize this advanced EMSI handshaking.  All other mailer software does.
  2945.  
  2946.  
  2947. **EMSI_IRQ8E08
  2948.  
  2949.   IEMSI capable BBS systems will send an EMSI_IRQ string to a caller.
  2950.   Detection of EMSI_IRQ is responded to with IEMSI data handshaking.
  2951.   AceComm's <SendEMSI_ICI> MACRO handles IEMSI log on.  (see PRM-data IEMSI
  2952.   Setup menu)
  2953.  
  2954.  
  2955. Responding MACRO Stack
  2956.  
  2957.   The MACRO defined to the right of each sequence trigger will be used when a
  2958.   sequence has been detected.  This allows AceComm to be configured with auto
  2959.   download detection for up to 10 protocols.  MACRO STACKING is valid with
  2960.   AutoM MACROS.
  2961.  
  2962.   The sending of a carriage return as the last macro is use full for moving the
  2963.   BBS display upon return from the external protocol.  AceComm completely
  2964.   disables the serial port before calling any external programs.
  2965.  
  2966.  
  2967. PreAutoM MACRO
  2968.  
  2969.   The "PreAutoM" MACRO, if defined, will be processed prior to the AutoM MACRO
  2970.   about to be processed.  This allows for some extra maneuvering to be done
  2971.  
  2972.  
  2973.  
  2974.        Page 50              AceComm (tm) v 1.81
  2975.  
  2976.  
  2977. Chapter 4  PRM-data Menus Area
  2978.  
  2979.            Auto Engage Sequence Triggers (continued)
  2980.  
  2981.   which might otherwise be common to all AutoM MACROS anyway.  For instance the
  2982.   practice of changing to your "FILES" directory will insure that downloads are
  2983.   received into the "FILES" directory, even with protocols that do not allow
  2984.   file redirection.
  2985.  
  2986.   Notes: If you use PreAutoM MACRO for changing directories, remember that
  2987.          protocols such as BIMODEM which you may be up loading with at the same
  2988.          time, will need full path names to files they are to send.  Also
  2989.          protocols or what have you that use PRM, CFG etc.  files need know
  2990.          where to find these control files.
  2991.  
  2992.  
  2993. PostAutoM MACRO
  2994.  
  2995.   The "PostAutoM" MACRO, if defined will be processed immediately following the
  2996.   AutoM MACRO.  Again this is some extra MACRO processing power for those
  2997.   common to all AutoM MACRO jobs.
  2998.  
  2999.  
  3000. To Disable Auto Engage Sequence Triggers
  3001.  
  3002.   Located in the "Terminal Area Options" is a over ride flag with which Auto
  3003.   downloads may be completely disabled.  This flag affects all Sequence
  3004.   Trigger / AutoM MACROS pairs defined.
  3005.  
  3006.   Auto Engage                            On    <=-ENABLE
  3007.   Auto Engage                            Off   <=-DISABLE
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.        Page 51              AceComm (tm) v 1.81
  3031.  
  3032.  
  3033. Chapter 4  PRM-data Menus Area
  3034.  
  3035.            "Intelligent Auto Log On Technology" (Tm)
  3036.  
  3037.  
  3038.  
  3039. ┌─"Intelligent Auto Log On Technology" (Tm)───────────────────────────────────
  3040. │─Trigger Sequence -- Responding Macro Stack──────────────────────────────────
  3041. │>is your name:       <SendStr>[USER_NAME]^M~Y^M~[FON_PWD]^M
  3042. │ Your FIRST name:    <SendStr>[USER_NAME]^MY^M~[FON_PWD]^M
  3043. │ Host Name:          <SendStr>CIS^M~~~~[FON_ID]^M~~~~~~[FON_PWD]^M
  3044. │ first name ?        <SendStr>[USER_NAME]^MY^M[FON_PWD]^M
  3045. │ and LAST name:      <SendStr>[USER_NAME]^M~^M~[FON_PWD]^M
  3046. │ last name?          <SendStr>[USER_NAME]^M~~[FON_PWD]^M
  3047. │ first name?         <SendStr>[USER_NAME]^M~~[FON_PWD]^M
  3048. │ (First and Last)    <SendStr>[USER_NAME]^M~~[FON_PWD]^M
  3049. ...
  3050. │
  3051. │─Case  Off───────────────────────────────────────────────────────────────────
  3052. └─── Edit  Toggle_Case  Quit  Help ┤<>v^├─────────────────────────────────────
  3053.  
  3054. o Each Fon.Record FLAGS can be toggled to perform auto log on by either use of
  3055.   a script file, or character sequence trigger and associated macro stack.
  3056.  
  3057. o AceComm responds to a sequence trigger by processing the macro stack.
  3058.  
  3059. o Log on sequence trigger scanning is available immediately after connect, and
  3060.   until the sequence has been found, or 2 minutes of on line time has passed.
  3061.  
  3062. o When a log on sequence has been processed, or 2 minutes of on line time has
  3063.   passed AceComm stops scanning for log on sequences for the remainder of the
  3064.   on line session.
  3065.  
  3066. o Sequence triggers are optionally CASE or nO cASE sensitive
  3067.  
  3068. On Dial/Connect Acecomm will, if the AutoL flag for the current Fon.Record is
  3069. SET, begin scanning incoming data for Auto Log On Sequence Triggers.  When any
  3070. of the 10 possible sequences is found, the sequence's associated macro stack is
  3071. processed.  Once a sequence has been found, scanning stops until the next
  3072. Dial/Connect.  If a sequence has not been found after the first 2 minutes of on
  3073. line time has passed, Intelligent Auto Log On (Tm) is disabled until the next
  3074. Dial/Connect.
  3075.  
  3076.  
  3077. Toggle_Case
  3078.  
  3079.   The setup menu contains an option where sequence trigger scanning can be made
  3080.   case sensitive.  AceComm's default setup is for scanning to be not case
  3081.   sensitive.
  3082.  
  3083.  
  3084.  
  3085.  
  3086.        Page 52              AceComm (tm) v 1.81
  3087.  
  3088.  
  3089. Chapter 4  PRM-data Menus Area
  3090.  
  3091.            "Intelligent Auto Log On Technology" (Tm) (continued)
  3092.  
  3093.  
  3094. Sequence Trigger
  3095.  
  3096.   A sequence trigger is a character string that is used by a remote HOST,
  3097.   protocol etc.  as an attempt to engage some action from the other end.
  3098.  
  3099.  
  3100. Trigger Character
  3101.  
  3102.   AceComm scans back thru it's receive buffer for a trigger sequence with each
  3103.   occurrence of the "last byte of the sequence".  This means that AceComm will
  3104.   scan for the string each time it sees the trigger byte arrive from the
  3105.   modem.  For this reason a sequence trigger will end in a non-common byte.
  3106.   While 'rz^M' (^M being <CR>, 13 decimal) would be a valid sequence trigger,
  3107.   we don't want AceComm to search on every carriage return character that comes
  3108.   in.  Look at Bimodem's sequence trigger, we don't want to end the sequence
  3109.   with a <SP> character (^' is the control code for SPACE CHARACTER 32
  3110.   decimal).
  3111.  
  3112.   Characters 32(Space) and below need be escape encoded with the '^' ^A becomes
  3113.   1, ^B 2, ^C 3, ^M <CR>, ^` 32 <SP> etc.  When entering sequence text, you may
  3114.   simply type the <SP> character, AceComm will do the conversion for you.
  3115.  
  3116.  
  3117. To Disable Auto Log On Sequence Triggers Located in the
  3118.  
  3119.   "Fon.Record Edit" FLAGS menu is a over ride flag with which Auto Log On for
  3120.   the record may be completely disabled.  This flag only affects the currently
  3121.   selected record.
  3122.  
  3123.  Closer Look
  3124.  
  3125.  is your name:       <SendStr>[USER_NAME]^M~Y^M~[FON_REC_PWD]^M
  3126.   |                   |        |                 |
  3127.   |                   |        |                 Fon.Record
  3128.   Sequence Trigger    |        |                 password field
  3129.                       |        |
  3130.                       |        IEMSI data field
  3131.                       |
  3132.                       Associated macro stack
  3133.  
  3134.  AceComm provides two different data macros for passwords
  3135.  
  3136.    [PASSWORD]  represents the IEMSI password field
  3137.  
  3138. [FON_REC_PWD]  represents the current Fon.Record
  3139.  
  3140.  
  3141.  
  3142.        Page 53              AceComm (tm) v 1.81
  3143.  
  3144.  
  3145. Chapter 4  PRM-data Menus Area
  3146.  
  3147.            "Intelligent Auto Log On Technology" (Tm) (continued)
  3148.  
  3149.                password field
  3150.  
  3151. Fon.Record password fields can be cloned for the entire FON file using the
  3152. "Mass_change" menu selection from inside the Telephone directory list area.
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.  
  3188.  
  3189.  
  3190.  
  3191.  
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.        Page 54              AceComm (tm) v 1.81
  3199.  
  3200.  
  3201. Chapter 4  PRM-data Menus Area
  3202.  
  3203.            Mass Menu Attribute Changes
  3204.  
  3205.  
  3206.  
  3207. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3208. ░░░░░░┌─Paint Screens - Video Controls────────────┐░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3209. ░░░░░░│ Status line color                         │░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3210. ░░░░░░│ Curtain color                             │░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3211. ░░░░░░│ Help screen color                         │─────────┐░░░░░░░░░░░░░░░░░
  3212. ░░░░░░│>Paint Menus                               │─────────│░░░░░░░░░░░░░░░░░
  3213. ░░░░░░│ Update All Menus                          │s        │░░░░░░░░░░░░░░░░░
  3214. ░░░░░░│ Video snow checking   Off                 │         │░░░░░░░░░░░░░░░░░
  3215. ░░░░░░│ Video Rows (VGA)      Detect              │         │░░░░░░░░░░░░░░░░░
  3216. ░░░░░░│─"Update" uses values below────────────────│         │░░░░░░░░░░░░░░░░░
  3217. ░░░░░░│       Border Attr     7                   │         │░░░░░░░░░░░░░░░░░
  3218. ░░░░░░│       Border Type     0                   │s        │░░░░░░░░░░░░░░░░░
  3219. ░░░░░░│       Title Color     120                 │hnology" │░░░░░░░░░░░░░░░░░
  3220. ░░░░░░│      ITitle Color     10                  │ls       │░░░░░░░░░░░░░░░░░
  3221. ░░░░░░│    Selector Color     2                   │         │░░░░░░░░░░░░░░░░░
  3222. ░░░░░░│  Left Field Color     3                   │         │░░░░░░░░░░░░░░░░░
  3223. ░░░░░░│ Right Field Color     7                   │         │░░░░░░░░░░░░░░░░░
  3224. ░░░░░░│        Burst Mode     Off                 │         │░░░░░░░░░░░░░░░░░
  3225. ░░░░░░│      Menu Chatter     Off                 │         │░░░░░░░░░░░░░░░░░
  3226. ░░░░░░│      Menu Whistle     Off                 │─────────┘░░░░░░░░░░░░░░░░░
  3227. ░░░░░░└─── Select  Quit ┤<>v^├────────────────────┘░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3228. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3229. ┌─  Customizer        <ENTER>-Select ─────────────────────────────────────────
  3230. │    Paint_Border  Type_Border  Left_Field  Right_Field  Title  ITitle
  3231. └─── Selector  Display  Burst Off Chatter Off Whistle Off Quit ┤<>v^├─────────
  3232. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3233.  
  3234. o Here you can play with the colors for this menu only, unless you choose the
  3235.   "Update All Menus" option
  3236.  
  3237.  
  3238. Status Line Color
  3239.  
  3240.   Toggle the AceComm status line back ground color (1 - 7)
  3241.  
  3242.  
  3243. Curtain Color
  3244.  
  3245.   Toggle color of back drops for various Areas
  3246.  
  3247.  
  3248. Customize
  3249.  
  3250.   All changes are limited to the current active menu "Mass Box".  Just as
  3251.  
  3252.  
  3253.  
  3254.        Page 55              AceComm (tm) v 1.81
  3255.  
  3256.  
  3257. Chapter 4  PRM-data Menus Area
  3258.  
  3259.            Mass Menu Attribute Changes (continued)
  3260.  
  3261.   selecting the "Customize" option from any other menu, changes are reflected
  3262.   and remain permanent.
  3263.  
  3264.  
  3265. Help Screen Colors
  3266.  
  3267.   AceComm's on line help uses 4 separate colors.  Certain error conditions can
  3268.   trigger a help screen to be displayed.  When this occurs, the error message
  3269.   is displayed at the top of the help screen, followed by the help screen's
  3270.   Title, help text, and bottom selector bar.
  3271.  
  3272.  
  3273. Update All Menus
  3274.  
  3275.   Selecting this option write a clone of the active menu "Mass Box" to *all*
  3276.   AceComm menus except the Fon List menu, and Dial/Edit Record menus.  The Fon
  3277.   List area menus have their own Paint options.
  3278.  
  3279.  
  3280. Snow (vertical retrace) checking     Off
  3281.  
  3282.   AceComm uses direct video buffer writes for all it display areas.  Most areas
  3283.   will be able to handle SNOW CHECKING properly before making screen updates.
  3284.  
  3285.  
  3286. Video Rows (VGA)                     Detect
  3287.  
  3288.    ┌─Video Rows (VGA)──────────────────────────┐
  3289.    │>Detect                                    │
  3290.    │ 25 rows                                   │
  3291.    │ 28 rows                                   │
  3292.    │ 43 rows                                   │
  3293.    │ 50 rows                                   │
  3294.    └─── Select  Quit ┤<>v^├────────────────────┘
  3295.  
  3296.  
  3297. The values on the right side of the menu are in decimal.  They may be copied
  3298. and used in the .CTL file as defaults.  (See ACE.CTL(1) "Menu Attributes")
  3299.  
  3300. ╔═  Customizer        <ENTER>-Select ═══════════════════════════
  3301. ╚═══ Color_Border  Type_Border  Left_Field  Right_Field   More
  3302. ................................................................
  3303. ╔═  Customizer        <ENTER>-Select ═══════════════════════════
  3304. ╚═══ Title  ITitle  Selector  Burst On Chatter Off Whistle On
  3305.  
  3306.  
  3307.  
  3308.  
  3309.  
  3310.  
  3311.        Page 56              AceComm (tm) v 1.81
  3312.  
  3313.  
  3314. Chapter 4  PRM-data Menus Area
  3315.  
  3316.            Mass Menu Attribute Changes (continued)
  3317.  
  3318. (1) ACE.CTL may be renamed.  AceComm package contains the default ,CTL file
  3319.      ACE.CTL, but it may be renamed to another filename.
  3320.  
  3321.  
  3322.  
  3323.  
  3324.  
  3325.  
  3326.  
  3327.  
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.  
  3335.  
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.  
  3364.  
  3365.  
  3366.  
  3367.        Page 57              AceComm (tm) v 1.81
  3368.  
  3369.  
  3370. Chapter 4  PRM-data Menus Area
  3371.  
  3372.            EMSI/IEMSI data
  3373.  
  3374.  
  3375. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3376. ░░░░░░░░░░░┌──────────────────────────────────────────────────────┐░░░░░░░░░░░
  3377. ░░░░░░░░░░░│─EMSI data────────────────────────────────────────────│░░░░░░░░░░░
  3378. ░░░░░░░░░░░│    Address  1:114/35                                 │░░░░░░░░░░░
  3379. ░░░░░░░░░░░│   Sys Name  AceComm Software Support                 │░░░░░░░░░░░
  3380. ░░░░░░░░░░░│       City  Phoenix, AZ                              │░░░░░░░░░░░
  3381. ░░░░░░░░░░░│   Operator  Michael Phelps                           │░░░░░░░░░░░
  3382. ░░░░░░░░░░░│  Sys Phone  (602) 846-2940                           │░░░░░░░░░░░
  3383. ░░░░░░░░░░░│       Baud  19200                                    │░░░░░░░░░░░
  3384. ░░░░░░░░░░░│      Flags  v32                                      │░░░░░░░░░░░
  3385. ░░░░░░░░░░░│─IEMSI data───────────────────────────────────────────│░░░░░░░░░░░
  3386. ░░░░░░░░░░░│> User Name  Michael Phelps                           │░░░░░░░░░░░
  3387. ░░░░░░░░░░░│      Alias  Michael Phelps/(AceComm)                 │░░░░░░░░░░░
  3388. ░░░░░░░░░░░│   Location  Phoenix, AZ  USA                         │░░░░░░░░░░░
  3389. ░░░░░░░░░░░│     Data #  (602) 846-2940                           │░░░░░░░░░░░
  3390. ░░░░░░░░░░░│    Voice #                                           │░░░░░░░░░░░
  3391. ░░░░░░░░░░░│   Password  AceComm                                  │░░░░░░░░░░░
  3392. ░░░░░░░░░░░│─Sub Menus────────────────────────────────────────────│░░░░░░░░░░░
  3393. ░░░░░░░░░░░│    CRT def  ANSI,24,80,0                             │░░░░░░░░░░░
  3394. ░░░░░░░░░░░│  Protocols  Zap,ZMO                                  │░░░░░░░░░░░
  3395. ░░░░░░░░░░░│ Capability  CHT,TAB,ASCII8                           │░░░░░░░░░░░
  3396. ░░░░░░░░░░░│   Requests  NEWS,MAIL,FILE,HOT,CLR,HUSH,MORE,FSED    │░░░░░░░░░░░
  3397. ░░░░░░░░░░░└─── Edit  Quit  Help ┤<>v^├───────────────────────────┘░░░░░░░░░░░
  3398. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3399.  
  3400.  
  3401. o Electronic Mail Standard Identification (EMSI)
  3402.  
  3403. o EMSI is a widely used handshake protocol used with FIDONET mailer software
  3404.  
  3405. o Interactive Electronic Mail Standard Identification (IEMSI)
  3406.  
  3407. o IEMSI is an auto log on interface designed to present caller information to
  3408.   the HOST quickly and automatically.  Few BBS systems currently support
  3409.   IEMSI.  RA supports IEMSI log on.
  3410.  
  3411. o Interactive EMSI log on function is called with the <SendEMSI_ICI> MACRO
  3412.   function
  3413.  
  3414. o Data defined here will be used by the <SendEMSI_ICI> MACRO function
  3415.  
  3416. o All IEMSI data need not be defined.  The BBS system will prompt the user for
  3417. any invalid or missing information.
  3418.  
  3419. EMSI handshake data
  3420.  
  3421.  
  3422.  
  3423.        Page 58              AceComm (tm) v 1.81
  3424.  
  3425.  
  3426. Chapter 4  PRM-data Menus Area
  3427.  
  3428.            EMSI/IEMSI data (continued)
  3429.  
  3430.  
  3431.    The following data is presented to the remote mail system during EMSI
  3432.    handshaking.
  3433.  
  3434.    Address
  3435.  
  3436.    Sys Name AceComm Support
  3437.  
  3438.    City Phoenix, AZ
  3439.  
  3440.    Operator Michael Phelps
  3441.  
  3442.    Sys Phone (602) 846-2940
  3443.  
  3444.    Baud 14.4
  3445.  
  3446.    Flags v32b
  3447.  
  3448.    Password  --  Pre arranged between two systems.
  3449.  
  3450.    The following example will cause AceComm to fill in the EMSI data field for
  3451.    "password" with 'mailman' when the target system's address is 1:114/12.
  3452.  
  3453.                   Password 1:114/12 mailman
  3454.  
  3455.  
  3456. IEMSI handshake data
  3457.  
  3458. User Name and Alias
  3459.  
  3460.   Enter your name as you want it to appear to a BBS system.  There is also a
  3461.   PRM-data MACRO [USER_NAME] that uses this field.
  3462.  
  3463.   There is also a PRM-data MACRO [ALIAS] that uses this field.
  3464.  
  3465.  
  3466. Location
  3467.  
  3468.   City, State, Country
  3469.  
  3470.   There is also a PRM-data MACRO [LOCATION] that uses this field.
  3471.  
  3472.  
  3473. Data # and Voice #
  3474.  
  3475.   If you have no Data #, leave the field blank.  There is also a PRM-data
  3476.  
  3477.  
  3478.  
  3479.        Page 59              AceComm (tm) v 1.81
  3480.  
  3481.  
  3482. Chapter 4  PRM-data Menus Area
  3483.  
  3484.            EMSI/IEMSI data (continued)
  3485.  
  3486.   MACRO [DATA_PNUM] that uses this field.
  3487.  
  3488.   There is also a PRM-data MACRO [DATA_PNUM] that uses this field.
  3489.  
  3490.  
  3491. Password
  3492.  
  3493.   This is a default password, any FON.RECORD.PASSWORD always will override this
  3494.   IEMSI PASSWORD.
  3495.  
  3496.   There is also a PRM-data MACRO [PASSWORD] that uses this field.
  3497.  
  3498.  
  3499. Birthdate (currently unused)
  3500.  
  3501.  
  3502. CRT def    (current session only)
  3503.  
  3504.       ╔═CRT Def═════════════════╗
  3505.       ║>AVATAR/0+ / ANSI        ║
  3506.       ║ ANSI X3.64              ║
  3507.       ║ TTY (raw mode)          ║
  3508.       ╚═══ Select  Quit ┤<>v^├══╝
  3509.  
  3510.   Consists of four sub-fields separated by commas, from left to right:TERMINAL
  3511.   EMULATION,ROWS,COLUMNS,NULS
  3512.  
  3513.   AceComm fills in the ROWS,COLUMNS,NULS fields automatically when building
  3514.   IEMSI data packets.
  3515.  
  3516.                        Example CRTDEF: AVT0,24,80,0
  3517.  
  3518.   TERMINAL EMULATION
  3519.   Video type
  3520.                               AVT0        (AVATAR/ANSI)
  3521.                               ANSI
  3522.                               TTY
  3523.   ROWS
  3524.          Video rows for current session only
  3525.   COLUMNS
  3526.          Video columns for current session only
  3527.   NULS
  3528.          00h character required after line feeds.
  3529.  
  3530.  
  3531. Protocols
  3532.  
  3533.  
  3534.  
  3535.        Page 60              AceComm (tm) v 1.81
  3536.  
  3537.  
  3538. Chapter 4  PRM-data Menus Area
  3539.  
  3540.            EMSI/IEMSI data (continued)
  3541.  
  3542.  
  3543.   ╔═Protocols═════════════════════════╗
  3544.   ║>ZedZap (Zmodem to 8k)        Yes  ║
  3545.   ║ Zmodem                       Yes  ║
  3546.   ╚═══ Select  Quit ┤<>v^├════════════╝
  3547.  
  3548.   AceComm internal protocols support ZMO,ZAP fields.
  3549.  
  3550.   ZMO is normal zmodem
  3551.  
  3552.   ZAP is zmodem with up to 8k data frames.
  3553.  
  3554.  
  3555. Capability    (current session only)
  3556.  
  3557.   ╔═Capabilities══════════════════════╗
  3558.   ║>Can do full screen chat      Yes  ║
  3559.   ║ Can handle TAB characters    Yes  ║
  3560.   ║ Can handle 8-bit characters  Yes  ║
  3561.   ╚═══ Select  Quit ┤<>v^├════════════╝
  3562.  
  3563.   CHT       Can do full screen on line conversation (CHAT)
  3564.  
  3565.   TAB Can handle TAB (ASCII 09h) characters AceComm supports TAB
  3566.  
  3567.   ASCII8    Can handle 8-bit IBM PC ASCII characters
  3568.  
  3569.  
  3570. Requests      (current session only)
  3571.  
  3572.   ╔═Requests══════════════════════════╗
  3573.   ║>Show bulletins,announcements Yes  ║
  3574.   ║ Check for new mail           Yes  ║
  3575.   ║ Check for new files          Yes  ║
  3576.   ║ Hot-keys                     Yes  ║
  3577.   ║ Screen clearing              Yes  ║
  3578.   ║ Do not disturb               Yes  ║
  3579.   ║ Page pausing, `More`         Yes  ║
  3580.   ║ Full-screen editor           Yes  ║
  3581.   ╚═══ Select  Quit ┤<>v^├════════════╝
  3582.  
  3583.   NEWS      Show bulletins, announcements, etc.
  3584.  
  3585.   MAIL      Check for new mail
  3586.  
  3587.   FILE      Check for new files
  3588.  
  3589.  
  3590.  
  3591.        Page 61              AceComm (tm) v 1.81
  3592.  
  3593.  
  3594. Chapter 4  PRM-data Menus Area
  3595.  
  3596.            EMSI/IEMSI data (continued)
  3597.  
  3598.  
  3599.   HOT       Hot keys "ON"
  3600.  
  3601.   CLR       Screen clearing
  3602.  
  3603.   HUSH      Do not disturb
  3604.  
  3605.   MORE      Page pausing, often referred to as "More"
  3606.  
  3607.   FSED      Full screen editor
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.  
  3627.  
  3628.  
  3629.  
  3630.  
  3631.  
  3632.  
  3633.  
  3634.  
  3635.  
  3636.  
  3637.  
  3638.  
  3639.  
  3640.  
  3641.  
  3642.  
  3643.  
  3644.  
  3645.  
  3646.  
  3647.        Page 62              AceComm (tm) v 1.81
  3648.  
  3649.  
  3650. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  3651.  
  3652.            Internal, Defined-External Receiving Units
  3653.  
  3654.  
  3655. ┌─Receiver Protocols──────────────────────────────────────────
  3656. │─Internal────────────────────────────────────────────────────
  3657. │>Zmodem   1K/8K adoptive
  3658. │ Ymodem   128/1K adoptive
  3659. │ YmodemG
  3660. │ Xmodem   128/1K adoptive
  3661. │ Ascii file      XON/CTS
  3662. │─External (user defined)─────────────────────────────────────
  3663. │ <RunProg>BIMODEM /L%P /R[DIR_DNLDS] Bimodem.Pth
  3664. │ <RunProg>HSLINK -P%P -U[DIR_DNLDS] @UPLDS.LST
  3665. │ <RunProg>MPT P%P N+ F+ R+ R [DIR_DNLDS]
  3666. │ <RunProg>JMODEM %PF %WK
  3667. │ <RunProg>DSZ port %P speed %B rz -mrr [DIR_DNLDS]
  3668. │
  3669. │
  3670. │
  3671. │
  3672. │
  3673. │ Setup Menu (Externals)
  3674. │─Auto Engage Menu────────────────────────────────────────────
  3675. │ Setup Menu (Auto Engage)
  3676. │─EMSI Protocol───────────────────────────────────────────────
  3677. │ Recv Mail / File Request
  3678. └─ Select  Options  Quit  Help ┤<>v^├─────────────────────────
  3679.  
  3680.  
  3681. AceComm contains internal Xmodem, Xmodem 1k, Ymodem, Ymodem 1k, Ymodem G,
  3682. Zmodem, and a Zmodem variant ZedZap (8k).
  3683.  
  3684.  
  3685. Internal Batch Capable
  3686.  
  3687.   Batch protocols receive the incoming filenames as part of the file data sent
  3688.   from the sender.  AceComm will append filenames received from the remote
  3689.   sender to the directory path contained in the PRM-data area under "FILES".
  3690.  
  3691.  
  3692. Internal Single File
  3693.  
  3694.   Single file protocols require a filename be given locally, by the user.  The
  3695.   user is prompted for a filename between the menu selection and calling the
  3696.   internal protocol function.
  3697.  
  3698.  
  3699. External Menu
  3700.  
  3701.  
  3702.  
  3703.        Page 63              AceComm (tm) v 1.81
  3704.  
  3705.  
  3706. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  3707.  
  3708.            Internal, Defined-External Receiving Units (continued)
  3709.  
  3710.  
  3711.   "Externals" are defined as menu selectable executable that will become
  3712.    arguments to the <RunProgram> MACRO.
  3713.  
  3714.    You may find it handy to assign some external protocols to a "Hot Key" from
  3715.    inside PRM-data Key Definition menu.
  3716.  
  3717. ┌─ External Protocols (DnLd) ────────────────────────────────
  3718. │ <RunProg>BIMODEM /L%P /R[DIR_DNLDS] Bimodem.Pth
  3719. │ <RunProg>HSLINK -P%P -U[DIR_DNLDS] @UPLDS.LST
  3720. │ <RunProg>MPT P%P N+ F+ R+ R [DIR_DNLDS]
  3721. │ <RunProg>JMODEM %PF %WK
  3722. │ <RunProg>DSZ port %P speed %B rz -mrr [DIR_DNLDS]
  3723. │
  3724. │
  3725. │>
  3726. │
  3727. │
  3728. └─ Edit  Select  Quit ┤<>v^├─────────────────────────────────
  3729.  
  3730.  
  3731. Auto Engaging Menu
  3732.  
  3733.   Auto engaging protocols have sending units that begin by sending a documented
  3734.   sequence of characters.  AceComm allows up to 10 separate sequences be
  3735.   defined, and associates each sequence with a MACRO STACK.  the MACRO STACK
  3736.   can be setup to call the external protocol associated with the sequence.
  3737.   "AutoDnLds" is documented in more detail above.  Shown below is a snippet
  3738.   reminder display.
  3739.  
  3740. ┌─Auto Engage Sequence Triggers─────────────────────────────────
  3741. │─Trigger Sequence -- Responding Macro Stack────────────────────
  3742. │>rz^M**^X            <RecvZmo>
  3743. │ HS*^B               <RunProg>HSLINK -P%P -U[DIR_DNLDS] @UP.LST
  3744. │ ^H ^H ^H ^H ^H ^H   <RunProg>BIMODEM \L%P \R[DIR_DNLDS] Bi.Pth
  3745. │ MPt ^V^H            <RunProg>MPT P%P N+ F+ R+ R [DIR_DNLDS]
  3746. │ **EMSI_REQA77E      <SendEMSI_CLI>
  3747. │ **EMSI_IRQ8E08      <SendEMSI_ICI>
  3748.  
  3749.  
  3750. Recv Mail / File Request
  3751.  
  3752.   "FileRequest" is a point mail function.
  3753.  
  3754.   Selecting File Request function will bring up the menu below if the PRM-data
  3755.   directory field for NODELIST points to either
  3756.  
  3757.  
  3758.  
  3759.        Page 64              AceComm (tm) v 1.81
  3760.  
  3761.  
  3762. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  3763.  
  3764.            Internal, Defined-External Receiving Units (continued)
  3765.  
  3766.     - FIDONET NODELIST and compiled NLIST.IDX file
  3767.     - FBL.EXE output .NOD file
  3768.   FBL output .NOD file is used in the example below.
  3769.  
  3770.  ╔═══════════════════════════════════════╗
  3771.  ║>           1:114/12                   ║
  3772.  ║ Format =>  ZONE:NET/NODE              ║
  3773.  ╚═══════════════════════════════════════╝
  3774.  This menu prompts the user for a ZONE:NET/NODE number of the system we want to
  3775.  call.  Having entered the above "1:114/12" the menu below is presented.
  3776.  
  3777.  ╔═1:114/12══════════════════════════════╗
  3778.  ╔═D:\ACE\fon\══════════════════════════╗║
  3779.  ║  1_105.NOD    19595   05/12/93 10:09 ║║
  3780.  ║> 1_114.NOD    11220   05/12/93 10:09 ║╝
  3781.  ║  1_125.NOD    7886    05/12/93 10:09 ║
  3782.  ║  1_282.NOD    7623    05/12/93 10:09 ║
  3783.  ║  1_382.NOD    10291   05/12/93 10:09 ║
  3784.  ╚═│Grab│ Quit ┤<>v^├═══════════════════╝
  3785.  This menu lists FBL output .NOD files found in the directory field NODELIST.
  3786.  FBL produces these files and names them according to their ZONE_NET number.
  3787.  We want to select the file 1_114.NOD because 1_114.NOD is an extracted listing
  3788.  of all NET 114 zone 1, from the FIDONET NODELIST.  Selecting the 1_114.NOD
  3789.  file produces the following menu.
  3790.  
  3791.  ╔═1:114/12══════════════════════════════╗
  3792.  ║╔═1:114/12═══════════════════════════════════════════╗
  3793.  ║║    System Name ORAC/2                              ║
  3794.  ╚║           City Phoenix_AZ                          ║
  3795.   ║  Operator Name Eugene_Glover                       ║
  3796.   ║   Phone Number 1-602-277-1334                      ║
  3797.   ║      Baud Rate 9600                                ║
  3798.   ║          Flags H16,CM,XA                           ║
  3799.   ║ .CFG  Password mailman                             ║
  3800.   ╚═│File_Request│ Human call  Poll_for_Mail  Quit ════╝
  3801.  
  3802.  Here AceComm has found the desired node information from the file 1_114.NOD.
  3803.  
  3804.  Notice the "Phone Number" field contains a long distance number.  The
  3805.  following "Dial Filter" statement" contained in "Point Mail Setup" menu is
  3806.  used to convert the phone number to a local number.
  3807.       1-602-
  3808.        (A)        (B)
  3809.  Explanation: Field (A) defines what to look for in phone numbers Field (B)
  3810.               defines what to replace field (A) with.  Here we left field (B)
  3811.               blank.  AceComm then replaces "1-602-" with nothing.
  3812.  
  3813.  
  3814.  
  3815.        Page 65              AceComm (tm) v 1.81
  3816.  
  3817.  
  3818. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  3819.  
  3820.            Internal, Defined-External Receiving Units (continued)
  3821.  
  3822.  
  3823.  Notice the "Password field.  The following "Password" definition was made in
  3824.  "Point Mail Setup" menu.
  3825.       1:114/12 mailman
  3826.  
  3827.  The selector bar at the bottom of the above menu contains several choices.
  3828.  The first being "File Request".  Selecting "File Request" produces the
  3829.  following screen.
  3830.  
  3831.  ╔═Input Window═════════════════════
  3832.  ║══════════════════════════════════
  3833.  ║>FileName:  files
  3834.  ╚══════════════════════════════════
  3835.  
  3836.  AceComm is prompting for file names.  The example uses the file name "files".
  3837.  Many systems will recognize "files" as a MAGIC file name, and send an "all
  3838.  files listing" for the system in response.  Pressing <ENTER> alone when
  3839.  finished entering file names causes AceComm to begin dialing the target
  3840.  system.
  3841.  
  3842.      ╔══Record Number 1:114/12══════════════════════════════════
  3843.      ║>     System Name   ORAC/2
  3844.      ║     Phone Number   1-602-277-1334
  3845.      ║     Line Control   9600L,8N1
  3846.      ║       Video Type
  3847.      ║ Control Flags      AutoMACRO,
  3848.      ║      Dial Prefix
  3849.      ║     Log on Script
  3850.      ║     Capture File
  3851.      ║         Password   mailman
  3852.      ║    Load KBD File
  3853.      ║  Log on triggers
  3854.      ║═Last Connect  --   Total Connects ═══════════════════════
  3855.      ║ 0
  3856.      ║═Cycles     --      Dial String                       Last
  3857.      ║   0                ATEQ0X4DT277-1334
  3858.      ║ 00:03    00:03     58
  3859.      ╚═│Quit│ <SpaceBar>-ReCycle ┤<>v^├═════════════════════════
  3860. ----------------------------------------------------------------
  3861. CONNECT 9600/ARQ
  3862.  Address 1:114/12 Using BinkleyTerm-OS/2 Ver. 2.56
  3863.  
  3864. Welcome to ORAC/2 - Home of Log/2 (Log for OS/2)
  3865. Press <escape> to enter BBS!
  3866. ORAC/2
  3867. Eugene Glover, Phoenix, AZ USA1-602-277-1334
  3868.  
  3869.  
  3870.  
  3871.        Page 66              AceComm (tm) v 1.81
  3872.  
  3873.  
  3874. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  3875.  
  3876.            Internal, Defined-External Receiving Units (continued)
  3877.  
  3878. BinkleyTerm, 9600, CM,XA,V32B,HST
  3879.  
  3880.   Outgoing  D:\ACE\mail\0072000C.REQ
  3881.  File Info  7 06/26/1993 11:55
  3882. 0        7        0 CPS        00:00        ZEOF
  3883.                  CPS                ZDATA
  3884.   Incoming  c:\fil\orac.lzh
  3885.  File Info  90401 06/24/1993 20:00
  3886. 90401        289        1089 CPS        01:23        ZSendHexHdr
  3887. TIMEOUT
  3888.  
  3889. NO CARRIER
  3890.  
  3891. OK
  3892. ----------------------------------------------------------------
  3893. AceComm uses it's text based display for the Point Mail protocol displays.
  3894.  
  3895.  
  3896.  
  3897.  
  3898.  
  3899.  
  3900.  
  3901.  
  3902.  
  3903.  
  3904.  
  3905.  
  3906.  
  3907.  
  3908.  
  3909.  
  3910.  
  3911.  
  3912.  
  3913.  
  3914.  
  3915.  
  3916.  
  3917.  
  3918.  
  3919.  
  3920.  
  3921.  
  3922.  
  3923.  
  3924.  
  3925.  
  3926.  
  3927.        Page 67              AceComm (tm) v 1.81
  3928.  
  3929.  
  3930. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  3931.  
  3932.            Internal, External Sender Protocols
  3933.  
  3934.  
  3935.  
  3936. ┌─Sender Protocols────────────────────────────────────────────
  3937. │─Internal────────────────────────────────────────────────────
  3938. │>Zmodem 1K
  3939. │ Zmodem 8K
  3940. │ Ymodem
  3941. │ Ymodem 1K
  3942. │ YmodemG
  3943. │ Xmodem
  3944. │ Xmodem 1K
  3945. │ Ascii file      XON/CTS
  3946. │─External (user defined)─────────────────────────────────────
  3947. │ <RunProg>BIMODEM /L%P /R[DIR_DNLDS] bimodem.pth
  3948. │ <RunProg>HSLINK -P%P -U[DIR_DNLDS] @UPLDS.LST
  3949. │ <RunProg>MPT P%P N+ F+ S @UPLDS.LST %WK
  3950. │ <RunProg>JMODEM S %PF %WK
  3951. │ <RunProg>DSZ port %P speed %B sz @[DIR_START]\UPLDS.LST
  3952. │
  3953. │
  3954. │
  3955. │
  3956. │
  3957. │ Setup Menu (Externals)
  3958. │ Send Mail / File Attach
  3959. └─ Select  Options  Quit  Help ┤<>v^├─────────────────────────
  3960.  
  3961.  
  3962. AceComm contains internal Xmodem, Xmodem 1k, Ymodem, Ymodem 1k, Ymodem G,
  3963. Zmodem, and a Zmodem variant ZedZap (8k).
  3964.  
  3965. Internal Batch Capable
  3966.  
  3967.   AceComm's internal "Batch" capable protocols are capable of sending from a
  3968.   LISTFILE.  A LISTFILE is an ascii text file containing <CR> <LF> terminated
  3969.   filenames.  One filename per line.  Filenames may contain a full DRIVE:\PATH
  3970.   specifier.  AceComm looks in the current directory for a filename
  3971.   "UPLDS.LST".  When selecting any of the "Batch" capable internal sending
  3972.   units, AceComm will always look for "UPLDS.LST", if the file exists, AceComm
  3973.   displays the following screen.
  3974.  
  3975.  ╓─────────────────╖      AceComm always prompts to send the
  3976.  ║ Found UPLDS.LST ║   from the LISTFILE "UPLDS.LST", when the
  3977.  ║ Send contents?  ║   "UPLDS.LST" file exists in the directory.
  3978.  ║>(Y)es/(n)o?:    ║   Pressing <CR> defaults to (Y)es, (n)o
  3979.  ╙─────────────────╜   brings up the regular file selection
  3980.  
  3981.  
  3982.  
  3983.        Page 68              AceComm (tm) v 1.81
  3984.  
  3985.  
  3986. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  3987.  
  3988.            Internal, External Sender Protocols (continued)
  3989.  
  3990.                        menu.
  3991.  
  3992.  
  3993.  ╓───────────────────╖      If the (Y)es selection was selected,
  3994.  ║ UPLDS.LST         ║   AceComm will, after the transfer,
  3995.  ║ Delete this file? ║   present the menu at left, prompting to
  3996.  ║>(Y)es/(n)o?:      ║   delete the LISTFILE, or leave it exist.
  3997.  ╙───────────────────╜
  3998.  
  3999.  
  4000.  
  4001. The "Regular file selection" menu (below) allows "on the fly" LISTFILE
  4002. creation.  The "on the fly" LISTFILE is not named "UPLDS.LST", but a temporary
  4003. unique filename is selected.  "On the fly" LISTFILE is deleted after transfer
  4004. without any prompt.
  4005.  
  4006.      ╓─Make Uploads List────────────────╖
  4007.      ║>Batch Tag                        ║
  4008.      ║ Manual entry                     ║
  4009.      ║ Finished  /  ESC-key             ║
  4010.      ╙─ Select  Quit ───────────────────╜
  4011.  
  4012.         Batch Tag
  4013.  
  4014.         This selection brings up the "FileLister" menu.  This menu allows
  4015.         tagging filenames to the LISTFILE.  PRM-data DIR "DNLDS" is the default
  4016.         directory displayed by "FileLister" when called by the "Sender
  4017.         Protocols" menu.
  4018.  
  4019.  
  4020.         Manual entry
  4021.  
  4022.         The menu below is presented with the "Manual entry" selection.
  4023.  
  4024.   ╓─Make Uploads List─────────────────╖
  4025.   ║ Batch Tag                         ║
  4026.   ║╓─Input Window───────────────────────────────────────────────
  4027.   ║║>FileName:  c:\fil\
  4028.   ╙║─Input Window<ENTER> alone when done────────────────────────
  4029.    ╙────────────────────────────────────────────────────────────
  4030.   The "Manual entry" filename prompt pre pends the prompt space with any PATH
  4031.   found in PRM-data DNLDS field.
  4032.  
  4033.  
  4034.   "Batch Tag/ Manual entry" are recorded to a temporary unique LISTFILE as
  4035.   explained above.  Temporary unique LISTFILE is automatically deleted after
  4036.  
  4037.  
  4038.  
  4039.        Page 69              AceComm (tm) v 1.81
  4040.  
  4041.  
  4042. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  4043.  
  4044.            Internal, External Sender Protocols (continued)
  4045.  
  4046.   use.
  4047.  
  4048.  
  4049. Single File
  4050.  
  4051.     AceComm's internal protocols that send 1 filename per invocation use the
  4052.     "Manual entry" window shown below.
  4053.  
  4054.   ╓─Input Window───────────────────────────────────────────────
  4055.   ║>FileName:  c:\fil\
  4056.   ║─Input Window<ENTER> alone when done────────────────────────
  4057.   ╙────────────────────────────────────────────────────────────
  4058.  
  4059.  
  4060. Externals
  4061.  
  4062.   This selection brings up a menu listing up to five configurations for
  4063.   external protocol setup/selection.  This menu allows storing configurations
  4064.   for external protocols to be used.  The menu storage below functions the same
  4065.   as any MACRO stack assigned to a key press.  Here you have a menu where you
  4066.   may find it easier to to store specific upload protocol definitions.
  4067.  
  4068.  ╓─ External Protocols (UpLd) ──────────────────────────────────
  4069.  ║><RunProgram>BIMODEM %WK
  4070.  ║ <RunProgram>HSLINK %PF %WK
  4071.  ║ <RunProgram>MPT S @UPLDS.LST %WK
  4072.  ║ <RunProgram>JMODEM S %PF %WK
  4073.  ║ <RunProgram>DSZ sz %PF
  4074.  ╙─ Select  Edit  Quit ─────────────────────────────────────────
  4075.  
  4076.  
  4077. Send Mail / File Attach
  4078.  
  4079.   This selection allows the user to send files to EMSI capable mailer
  4080.   software.  The menu shown below prompts the user for a FIDONET style
  4081.   ZONE:NET/NODE number.
  4082.  
  4083.  ╓───────────────────────────────────────╖
  4084.  ║>                                      ║
  4085.  ║ Format =>  ZONE:NET/NODE              ║
  4086.  ╙───────────────────────────────────────╜
  4087.  
  4088.   The number is required for naming a LISTFILE.  LISTFILE in this mode uses
  4089.   "FLO" file extension.  AceComm allows normal Tag or manual entry when adding
  4090.   filenames to LISTFILE.  Those who want to "File Attach" or are running under
  4091.   a HOST as a point mail system will use this option.  Point mail operators may
  4092.  
  4093.  
  4094.  
  4095.        Page 70              AceComm (tm) v 1.81
  4096.  
  4097.  
  4098. Chapter 5  INTERNAL / EXTERNAL PROTOCOLS
  4099.  
  4100.            Internal, External Sender Protocols (continued)
  4101.  
  4102.   upload their mail bundles with this "Send Mail" selection.  AceComm requires
  4103.   a NODELIST or FBL output .NOD file when using "Send Mail/Attach".  AceComm
  4104.   uses the ZONE:NET/NODE number entered above for looking up system information
  4105.   about the HOST to be called.  AceComm is able to retrieve the phone number
  4106.   and system name from NODELIST/.NOD files.
  4107.  
  4108.   
  4109.  
  4110.  
  4111.  
  4112.  
  4113.  
  4114.  
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.  
  4122.  
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.  
  4129.  
  4130.  
  4131.  
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.  
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.  
  4148.  
  4149.  
  4150.  
  4151.        Page 71              AceComm (tm) v 1.81
  4152.  
  4153.  
  4154. Chapter 6  Telephone Directory Area
  4155.  
  4156.  
  4157. ┌─ Telephone_directory D:\ACE\fon\ACE.FON, 19 Records─────────────────────────
  4158. │─      System Name              Phone Number     Line Control Video  Last On
  4159. │>1    AceComm Support          1-602-846-2940     19200,8N1   Av/An  25 Dec
  4160. │ 2    Albuquerque ROS <ASP>    1-505-299-5974     19200,8N1   Av/An  00
  4161. │ 3    Animal House             1-601-329-4217     19200,8N1   Av/An  00
  4162. │ 4  * CIS (local phoenix 9600) 468-0285           19200,7E1   Av/An  21 Dec
  4163. │ 5    CIS (phones)             1-800-346-3247     19200,7E1   Av/An  03 May
  4164. │ 6    Comput Connections (PCB) 1-202-547-2008     19200,8N1   Av/An  00
  4165. │ 7    Eagan On-line            1-612-686-8806     19200,8N1   Av/An  00
  4166. │ 8    Exec-PC <ASP>            1-414-789-4210     19200,8N1   Av/An  00
  4167. │ 9    Leprechan Castle (SPIT)  1-601-799-2299     19200,8N1   Av/An  00
  4168. │ 10   PC-Ohio <ASP>            1-216-381-3320     19200,8N1   Av/An  00
  4169. │ 11   Supra Modem BBS          1-503-967-2444     19200,8N1   Av/An  00
  4170. │ 12   Technoids Anonymous      1-602-899-4876     19200,8N1   Av/An  00
  4171. │ 13   The Flying Dutchman      1-406-452-4210     19200,8N1   Av/An  00
  4172. │ 14   The GaRBaGe DuMP <ASP>   1-505-294-5675     19200,8N1   Av/An  00
  4173. │ 15   The Hot Tub Chat Lounge  1-201-617-8054     19200,8N1   Av/An  00
  4174. │ 16   Tool Shop,langs          1-818-891-6780     19200,8N1   Av/An  00
  4175. │ 17   Wizard's Gate <ASP>      1-614-224-1635     19200,8N1   Av/An  00
  4176. │ 18   Xanathar's Castle (TAG)  1-601-728-8023     19200,8N1   Av/An  00
  4177. │ 19   James Roberts (TRIBBS)   1-214-339-4495     19200,8N1   Av/An  24 Dec
  4178. │  Dial  Edit  <SP>-Que  Circling_dial_queue  Fon_files  Sort  Options
  4179. └─ Add_record  Remove_record  Mass_Change  Import  Paint  Quit  Help ┤<>v^├───
  4180.  
  4181.  
  4182. The Telephone Directory Area lists binary .FON files in their full ASCII
  4183. representation.  The current loaded .FON file is identified at the top of the
  4184. menu.  Notice that the number of records contained in the '1_114.FON' file is
  4185. presented at the top right.  .FON files are not fixed to any certain record
  4186. size, and can have records added or deleted, from here, in the Directory list
  4187. area.  Maximum record count for a FON file is 1000 records per FON file.
  4188. AceComm supports unlimited FON files, and provides easy directory List/Grab
  4189. function for changing FON files.
  4190.  
  4191. Dial
  4192.  
  4193.   Dial the "highlighted" record.  The function continues dialing until:
  4194.  
  4195.      (a) a connection has been established
  4196.  
  4197.      (b)  USER ABORT.
  4198.  
  4199.  
  4200. Edit
  4201.  
  4202.   Another menu contains the "highlighted" record's data is presented for
  4203.   editing, or just a closer view.  All changes are automatically save to disk.
  4204.  
  4205.  
  4206.  
  4207.        Page 72              AceComm (tm) v 1.81
  4208.  
  4209.  
  4210. Chapter 6  Telephone Directory Area
  4211.  
  4212.  
  4213.  
  4214. <SP>-Que
  4215.  
  4216.   Mark the "highlighted" record for 'RedialQue'.
  4217.  
  4218.  
  4219. Circular_dial_Queue
  4220.  
  4221.   Switch into The 'Que' Menu.  At least 1 record needs be marked "Queued" for
  4222.   AceComm to present this area.  From the 'Que' Menu, 'Dial' goes into single
  4223.   dial mode, and each record is dialed 1 time, followed by the next record
  4224.   until all records in the 'Que' have been dialed.  The 'Que' then revolves
  4225.   around to the first record and begins again.  When a connection has been
  4226.   established, the record is removed from the 'Que'.
  4227.  
  4228. ╔═ Circular_Redial_Que D:\ACE\1_114.FON, 6 Records══════════════
  4229. ║═      System Name            Phone Number     Line Control Vid
  4230. ║>14 - Artemis Lair bbs         1-602-841-4474     9600,8N1    A
  4231. ║ 15 - Astroland                1-602-381-8708     9600,8N1    A
  4232. ║ 16 - Bob's Place BBS Node 1   1-602-497-2173     2400,8N1    A
  4233. ║ 17 - Bob's Place BBS Node 2   1-602-545-8745     9600,8N1    A
  4234. ║ 18 - Broadcaster's BBS        1-602-872-9148     9600,8N1    A
  4235. ║ 19 - CADE BBS                 1-602-931-3468     2400,8N1    A
  4236. ║  Dial  Edit  <SPACEBAR>-Zap  Telephone_Directory
  4237. ╚═ Add_record  Remove_record  UnMark_All  Import  Paint  Quit ┤<
  4238.  
  4239.  
  4240. Fon_files
  4241.  
  4242.   List PRM-data directory .FON, allow selection of new .FON file
  4243.  
  4244.  
  4245. Sort
  4246.  
  4247.   ┌─Sort FON file by ?─┐
  4248.   │>Number of calls    │
  4249.   │ Last date called   │
  4250.   │ System name field  │
  4251.   │ System number      │
  4252.   └─── Select  Quit ───┘
  4253.  
  4254.  
  4255. Options
  4256.  
  4257.   ┌─Dialing Options───────────────────────────────┐
  4258.   │>Inter byte delay                         1    │
  4259.   │ Modem Response Timeout when dialing      60   │
  4260.  
  4261.  
  4262.  
  4263.        Page 73              AceComm (tm) v 1.81
  4264.  
  4265.  
  4266. Chapter 6  Telephone Directory Area
  4267.  
  4268.   │ Seconds between re-dial                  1    │
  4269.   │ DTR state between re-dial                Off  │
  4270.   │ Ring BELL on Dial/Connect                1    │
  4271.   └─── Select  Quit  Help ┤<>v^├──────────────────┘
  4272.  
  4273.  
  4274. Add_record
  4275.  
  4276.   Function appends a new record to the current loaded .FON file, and
  4277.   immediately brings up the 'Edit' Menu.  The new record is automatically
  4278.   saved.
  4279.  
  4280.  
  4281. Remove_record
  4282.  
  4283.   The "highlighted" record is removed from the current loaded .FON file.  No
  4284.   hole is left, the .FON file is reduced a 'record size' in bytes.
  4285.  
  4286.  
  4287. Mass_Change
  4288.  
  4289.   ┌─Mass Change FON Records─┐
  4290.   │>     Dial Prefix        │
  4291.   │         Password        │
  4292.   │    Load KBD File        │
  4293.   │     Line Control        │
  4294.   │       Video Type        │
  4295.   │    Flags Control        │
  4296.   │       UnMark All        │
  4297.   └─── Select  Quit ┤<>v^├──┘
  4298.  
  4299.   All records in a FON file can be updated at one time, with individual record
  4300.   member updates.
  4301.  
  4302.  
  4303. Import
  4304.  
  4305.   o Convert another software's FON type file to AceComm FON file.
  4306.  
  4307.   o Merge two AceComm format FON files into one file.
  4308.  
  4309.   o Initialize a new FON file of video rows number of blank records.
  4310.  
  4311.   "Import" selection brings up the FON file conversion menu displayed below.
  4312.    The menu provides the following functions.
  4313.  
  4314.   ┌─Covert to AceComm FON──────┐
  4315.   │                            │
  4316.   │> BOYAN    5                │
  4317.  
  4318.  
  4319.  
  4320.        Page 74              AceComm (tm) v 1.81
  4321.  
  4322.  
  4323. Chapter 6  Telephone Directory Area
  4324.  
  4325.   │  Qmodem   4                │
  4326.   │  Qmodem   5                │
  4327.   │  Procomm  2.43             │
  4328.   │  PcPlus   1                │
  4329.   │  PcPlus   2                │
  4330.   │  Telemate 3.01 - 4.12      │
  4331.   │  TELIX    3.15 - 3.21      │
  4332.   │  Combine 2 Ace FON         │
  4333.   │  Create blank FON          │
  4334.   └─── Select  Quit ┤<>v^├─────┘
  4335.  
  4336.  
  4337. Paint
  4338.  
  4339.   Customize the current menu only.  All changes are save automatically.
  4340.  
  4341.  
  4342.  
  4343.  
  4344.  
  4345.  
  4346.  
  4347.  
  4348.  
  4349.  
  4350.  
  4351.  
  4352.  
  4353.  
  4354.  
  4355.  
  4356.  
  4357.  
  4358.  
  4359.  
  4360.  
  4361.  
  4362.  
  4363.  
  4364.  
  4365.  
  4366.  
  4367.  
  4368.  
  4369.  
  4370.  
  4371.  
  4372.  
  4373.  
  4374.  
  4375.  
  4376.        Page 75              AceComm (tm) v 1.81
  4377.  
  4378.  
  4379. Chapter 6  Telephone Directory Area
  4380.  
  4381.  
  4382. Fon.Record Edit Menu
  4383.  
  4384. ┌─ Telephone_directory D:\ACE\fon\ACE.FON, 19 Records─────────────────────────
  4385. │─      System Name              Phone Number     Line Control Video  Last On
  4386. │>1    AceComm Support          1-602-846-2940     19200,8N1   Av/An  25 Dec
  4387. │ 2  ╓──Record Number 1────────────────────────────────────────────────────╖
  4388. │ 3  ║>     System Name  AceComm Support                                   ║
  4389. │ 4  ║     Phone Number  1-602-846-2940                                    ║
  4390. │ 5  ║     Line Control  19200L,8N1                                        ║
  4391. │ 6  ║       Video Type  Av/An                                             ║
  4392. │ 7  ║    Control Flags  Macro,DTag,IEMSI,AutoL                            ║
  4393. │ 8  ║      Dial Prefix                                                    ║
  4394. │ 9  ║     LogOn Script                                                    ║
  4395. │ 10 ║     Capture File                                                    ║
  4396. │ 11 ║         Password  pwd                                               ║
  4397. │ 12 ║            Alias  Michael Phelps/AceComm                            ║
  4398. │ 13 ║               ID                                                    ║
  4399. │ 14 ║    Load KBD File                                                    ║
  4400. │ 15 ║  Log on triggers  Case  Off                                         ║
  4401. │ 16 ║─Last Connect  --   Total Connects ──────────────────────────────────║
  4402. │ 17 ║ 25 Dec 11:24:50am      38                                           ║
  4403. │ 18 ║─Cycles     --      Dial String                       Last Response ─║
  4404. │ 19 ║   0               ATEQ0X4DT846-2940                                 ║
  4405. │  Di║   1723            00:00:00                                          ║
  4406. └─ Ad╙─ Edit  Paint  Quit  Help ┤<>v^├─────────────────────────────────────╜──
  4407.  
  4408.  
  4409. System Name            AceComm Software Support
  4410.  
  4411.   The name defined here, is presented onto the revolving status line (right
  4412.   side of status line) when "on line".
  4413.  
  4414.  
  4415. Phone Number           1-602-846-2940
  4416.  
  4417.   This phone number, although long distance, can be modified by AceComm when
  4418.   dialing, with use of "Dial" statements in the Point Mail Menu.
  4419.  
  4420.   Example: lets say we are local Phoenix, where our area code is 602, we have
  4421.            an entire phone directory of long distance numbers.  The following
  4422.            dial statement defined inside "Point Mail Setup" will cause AceComm
  4423.            to translate all of the long distance numbers to local numbers.
  4424.  
  4425.            Dial 1-602-
  4426.  
  4427.            AceComm will see this definition and translate it into anything
  4428.            following the definition.  In this case, we did not put anything
  4429.  
  4430.  
  4431.  
  4432.        Page 76              AceComm (tm) v 1.81
  4433.  
  4434.  
  4435. Chapter 6  Telephone Directory Area
  4436.  
  4437.            after the "1-602-", so AceComm will strip "1-602-" from all phone
  4438.            numbers that contain "1-602-" as part of the number.  This is valid
  4439.            for all phone numbers that are processed thru the AceComm Dialer
  4440.            Menu.  Mailer mode, File Requests which get their phone numbers from
  4441.            either a FIDO NODELIST, of FBL output .NOD file do use the Dialer
  4442.            Menu and do receive number translation from "Dial" statements.
  4443.  
  4444.  
  4445. Line Control           2400L,8N1
  4446.  
  4447.   Most remote HOSTS will be set up using 8 data bits, No parity, and 1 stop
  4448.   bit.  Compuserve uses 7 data bits, Even parity, and 1 stop bit.  AceComm will
  4449.   configure the UART to assemble the in coming bit stream into characters,
  4450.   based on the configuration defined here.  Baud rate means nothing when
  4451.   LOCKBAUD is set, as is with the "L" appended to baud in this example.  Other
  4452.   wise, when LOCKBAUD is not set, AceComm will set the UART up to the
  4453.   Fon.Record baud rate.
  4454.  
  4455.   Note: When LOCKBAUD is not set, AceComm is also capable of resetting the baud
  4456.         rate to a connect string.  If you dial out at 2400, and connect at
  4457.         9600, and 9600 is detected in the the connect string, AceComm will
  4458.         automatically set the baud to 9600.  If LOCKBAUD is set, AceComm leaves
  4459.         baud alone.
  4460.  
  4461.  
  4462. Terminal Emulation     Av/An
  4463.  
  4464.   This option will present the Terminal emulations menu, you may select the
  4465.   video ,type you want associated with this record.  "Av/An means AVATAR and
  4466.   ANSI video emulation.
  4467.  
  4468.  
  4469. Control Flags  Macro,DTag,Capture,Text,IEMSI,AutoL
  4470.  
  4471.        ╔═   Control Flags═════════════════╗
  4472.        ║ Tag dial attempts    On          ║
  4473.        ║ Auto log on method   Macro,      ║
  4474.        ║ Open Capture file on On          ║
  4475.        ║ Capture mode         Text,       ║
  4476.        ║>Allow IEMSI log on   On          ║
  4477.        ║ Allow auto log on    On          ║
  4478.        ╚═══ Edit  Quit ┤<>v^├═════════════╝
  4479.  
  4480.   "Script"  when  set,
  4481.  
  4482.   AceComm will attempt to load and run the filename defined next to "AutoLogOn
  4483.   Script".  If a script file is not found, AceComm ignores the error and
  4484.   continues normal operation.  Notes: .SCR files are looked for in the
  4485.  
  4486.  
  4487.  
  4488.        Page 77              AceComm (tm) v 1.81
  4489.  
  4490.  
  4491. Chapter 6  Telephone Directory Area
  4492.  
  4493.   directory defined inside PRM-data Area "Directories"
  4494.  
  4495.  
  4496.   "Macro"  when  set,
  4497.  
  4498.   AceComm will enable the defined Auto Log on Sequence Triggers and
  4499.   corresponding MACRO stacks.
  4500.  
  4501.  
  4502.   "DTag"  when  set,
  4503.  
  4504.   AceComm will tag un-successful dial attempts (busy, etc.) to the Que Dialer.
  4505.   An "*" character appears to the left of a Fon.Record's display line, when it
  4506.   is either Q tagged or, D tagged.  When this flag is not set, the only other
  4507.   way to Q tag a record is by manually selecting the menu option
  4508.   "<SPACEBAR>-Que" from the fon list display.
  4509.  
  4510.  
  4511.  "Capture"
  4512.  
  4513.  When this flag is selected, a capture file is opened upon Dial/Connect.  Any
  4514.  previously open capture file is first closed.
  4515.  
  4516.  
  4517.  "Raw"  when set,
  4518.  
  4519.  Data to capture file is as it comes in from the modem
  4520.  
  4521.  
  4522.  "Text"  when set,
  4523.  
  4524.  Data to capture file is filtered of video control codes as applicable to the
  4525.  current Video type
  4526.  
  4527.  
  4528.  "IEMSI"
  4529.  
  4530.  Allow Interactive EMSI log on
  4531.  
  4532.  
  4533.  "AutoL"
  4534.  
  4535.  Allow auto log on methods (script/macro)
  4536.  
  4537.  
  4538. Dialing Prefix
  4539.  
  4540.   The Fon.Record dial prefix overrides The PRM-data default prefix.  If this
  4541.  
  4542.  
  4543.  
  4544.        Page 78              AceComm (tm) v 1.81
  4545.  
  4546.  
  4547. Chapter 6  Telephone Directory Area
  4548.  
  4549.   field is null (blank), AceComm uses the PRM-data default dial prefix.
  4550.  
  4551.  
  4552. AutoLogOn Script       ACE_S.SCR
  4553.  
  4554.   When SCRIPT flag is set, for the current Fon.Record, AceComm will use this
  4555.   filename, opening it as a SCRIPT file, and run the contents.  This action
  4556.   takes place upon successful Dial/Connect.  If the filename does not exist,
  4557.   AceComm simply goes about it's business, and you will log on normally.
  4558.   AceComm will look for the SCRIPT filename in PRM-data DIR .SCR path.
  4559.  
  4560.   See also: Expandable Macro Parameters <SendStr> [FON_SCR]
  4561.  
  4562.  
  4563. Capture File           ACE_S.CAP
  4564.  
  4565.   Default filename presented to user when opening a "capture data to file"
  4566.   file.
  4567.  
  4568.   See also: Expandable MACRO Parameters <SendStr> [FON_CAP]
  4569.  
  4570.  
  4571. Password               my/password
  4572.  
  4573.   You may define the Fon.Record PASSWORD field to any character combination,
  4574.   the field maximum length is 19 characters.
  4575.  
  4576.   See also: Expandable MACRO Parameters
  4577.  
  4578.   <SendStr> [FON_PWD]
  4579.  
  4580.   would replace "[FON_PWD]" with "my/password" for this example.
  4581.  
  4582.  
  4583. Alias               Michael Phelps/AceComm
  4584.  
  4585.   See also: Expandable MACRO Parameters
  4586.  
  4587.   <SendStr> [FON_ALIAS]
  4588.  
  4589.  
  4590. ID                 75120,3306
  4591.  
  4592.   See also: Expandable MACRO Parameters
  4593.  
  4594.   <SendStr> [FON_ID]
  4595.  
  4596.  
  4597.  
  4598.  
  4599.  
  4600.        Page 79              AceComm (tm) v 1.81
  4601.  
  4602.  
  4603. Chapter 6  Telephone Directory Area
  4604.  
  4605. Custom .KBD File       MY.KBD
  4606.  
  4607.   KeyBoard File, AceComm will first remember what the current KBD filename is,
  4608.   load the Fon.Record's custom KBD file, if defined, and finally restore the
  4609.   original KBD file after session disconnect.  Say What?
  4610.  
  4611.   You are about to log onto Compuserve.  You have CIS.KBD file defined for the
  4612.   Fon.Record.  When dial/connect is detected, AceComm will load the contents of
  4613.   CIS.KBD, overlaying your current keyboard MACRO assignments.  When you log
  4614.   off of Compuserve, and AceComm detects the carrier drop (no DCD), AceComm
  4615.   will load back the original keyboard file, overlaying your custom CIS.KBD.
  4616.  
  4617.   You will need to distinguish KBD files from KTS files.  Where a KBD file
  4618.   overlays the keyboard MACRO assignments.  The KTS file defines the ultimate
  4619.   sequence that will be sent to the modem for a given key-press.  Keys assigned
  4620.   a MACRO, are processed as MACRO functions.
  4621.  
  4622.   Keys not assigned a MACRO(s) will be sent to the modem, and are candidates
  4623.   for KTS.
  4624.  
  4625.   Keys with extended codes, are sent as they would be seen in DoorWay mode.
  4626.   Normal keys (a-z,A-Z,1-0,CTRL A-CTRL Z, etc.) are sent in their normal lower
  4627.   ascii representation (as you would expect).  Now, any of these key-presses
  4628.   that have been defined inside the KTS file, are translated into their defined
  4629.   sequence.  AceComm & Utilities provides ASCII examples for compiling KTS
  4630.   files, as well as KTS.EXE the custom Keyboard Sequence Translation (Tm)
  4631.   compiler.
  4632.  
  4633.  
  4634. Log on Triggers
  4635.  
  4636.   AceComm will respond to a sequence trigger by processing the MACRO stack.
  4637.   Log on sequence trigger scanning is available immediately after connect, and
  4638.   until the sequence has been found.  When a log on sequence has been
  4639.   processed, AceComm stops scanning for the log on sequence.  Auto logon method
  4640.   can be set in the flags menu.
  4641.  
  4642.  
  4643.  
  4644.  
  4645.  
  4646.  
  4647.  
  4648.  
  4649.  
  4650.  
  4651.  
  4652.  
  4653.  
  4654.  
  4655.  
  4656.        Page 80              AceComm (tm) v 1.81
  4657.  
  4658.  
  4659. Chapter 7  File List/Utility Area
  4660.  
  4661.  
  4662.  
  4663.  ╔═D:\ACE═══════════════════════════════╗
  4664.  ║> 1_114.FON    26368   06/27/93 07:25 ║
  4665.  ║  ACE.ASM      8269    06/26/93 18:00 ║
  4666.  ║  ACE.CTL      13589   06/25/93 08:04 ║
  4667.  ║  ACE.EXE      196102  06/27/93 07:24 ║
  4668.  ║  ACE.FON      1600    06/27/93 04:13 ║
  4669.  ║  ACE.HLP      44572   06/27/93 07:09 ║
  4670.  ║  ACE.LOG      3694    06/27/93 07:29 ║
  4671.  ...
  4672.  ║  ACTL.ASM     101998  06/25/93 14:22 ║
  4673.  ║  Utility  New_Dir  Change_Drive      ║
  4674.  ╚═ Tag  Delete  Quit  Help ┤<>v^├══════╝
  4675.  
  4676. Utility
  4677.  
  4678.   This selection brings up a sub-menu of pre-defined executable.  AceComm
  4679.   contains several sub-menus for this purpose.  Sub-menu selected is determined
  4680.   by the "highlighted" files's extension.  The %FN symbol is documented in
  4681.   MACRO.DOC.  %FN is an Expandable MACRO Function.  %FN argument to a MACRO
  4682.   from anywhere inside the "File Lister" menus is replaced with FULL PATH NAME
  4683.   for the current high lighted filename.
  4684.  
  4685.  ╔═C:\DOC═══════════════════════════════╗
  4686.  ║  A.SNA        1242    06/27/93 07:53 ║
  4687.  ║  ACE.BAK      117893  06/26/93 12:25 ║
  4688.  ║  ACE.CHA      2706    06/27/93 07:46 ║
  4689.  ║>╔═%FN = C:\DOC\ACE.DOC══════════════════════════════════
  4690.  ║ ║ <RunProgram> BB %FN
  4691.  ║ ║><RunProgram> LIST %FN
  4692.  ║ ║ <RunProgram> QEDIT %FN
  4693.  ║ ║ <RunProgram> GREP %PF %FN %PF
  4694.  ║ ║ <RunProgram> PATCH %FN
  4695.  ║ ╚═ Select  Edit  Quit ┤<>v^├════════════════════════════
  4696.  ║  COVER        213     06/25/93 16:22 ║
  4697.  ║  CREDIT.CRD   2918    06/25/93 15:30 ║
  4698.  ...
  4699.  ║  FILE_ID.DIZ  392     06/26/93 13:14 ║
  4700.  ║  Utility  New_Dir  Change_Drive      ║
  4701.  ╚═ Tag  Delete  Quit  Help ┤<>v^├══════╝
  4702.  
  4703.  
  4704. New_Dir
  4705.  
  4706.   Allows changing directories.  AceComm changes directories right along with
  4707.   the display.  When you use AceComm's "Utils" Menu, work is done in the
  4708.   currently listed directory unless otherwise redirected via MACRO arguments or
  4709.  
  4710.  
  4711.  
  4712.        Page 81              AceComm (tm) v 1.81
  4713.  
  4714.  
  4715. Chapter 7  File List/Utility Area
  4716.  
  4717.   overriding external executable configurations.
  4718.  
  4719.   Notes: AceComm always returns to the starting directory after leaving the
  4720.          FileLister Area.
  4721.                     ╔═D:\ACE═══════════════╗
  4722.  ╔═D:\ACE═══════════║>>D:\ACE              ║
  4723.  ║> 1_114.FON    263║ >..                  ║
  4724.  ║  ACE.ASM      826║ >CAP                 ║
  4725.  ║  ACE.CTL      135║ >CVTFON              ║
  4726.  ║  ACE.EXE      196║ >FILES               ║
  4727.  ║  ACE.FON      160║ >FON                 ║
  4728.  ║  ACE.HLP      445║ >KTS                 ║
  4729.  ║  ACE.LOG      369║ >MAIL                ║
  4730.  ║  ACE.MAP      920║ >SCR                 ║
  4731.  ║  ACE.OBJ      271║ >SND                 ║
  4732.  ║  ACE.PRM      378║ >XTRA                ║
  4733.  ║  ACEBOX.INC   345║ >ZEN                 ║
  4734.  ║  ACEM         253║ >F                   ║
  4735.  ║  ACEORDER.FRM 588╚═ Select  Quit ┤<>v^├═╝
  4736.  ║  ACET.SCR     809     05/17/93 21:33 ║
  4737.  ...
  4738.  ║  ACTL.ASM     101998  06/25/93 14:22 ║
  4739.  ║  Utility  New_Dir  Change_Drive      ║
  4740.  ╚═ Tag  Delete  Quit   Help ┤<>v^├═════╝
  4741.  
  4742.  
  4743. Change Drive
  4744.  
  4745.   Allows listing another drive.
  4746.  ╔═D:\ACE═══════════╔══════════════════════╗
  4747.  ║> 1_114.FON    263║>A                    ║
  4748.  ║  ACE.ASM      826║ B                    ║
  4749.  ║  ACE.CTL      135║ C                    ║
  4750.  ║  ACE.EXE      196║ D                    ║
  4751.  ║  ACE.FON      160║ E                    ║
  4752.  ║  ACE.HLP      445╚═ Select  Quit ┤<>v^├═╝
  4753.  ║  ACE.LOG      3694    06/27/93 07:29 ║
  4754.  ...
  4755.  ║  ACTL.ASM     101998  06/25/93 14:22 ║
  4756.  ║  Utility  New_Dir  Change_Drive      ║
  4757.  ╚═ Tag  Delete  Quit  Help ┤<>v^├══════╝
  4758.  
  4759.  
  4760. Tagged files
  4761.  
  4762.   Tagged files are stored in the file "UPLDS.LST" when tagged from inside the
  4763.   <FileLister_> MACRO.  When tagged from any of AceComm's internal protocol
  4764.   sending units, tagged filenames are stored into a temporary file.  The
  4765.  
  4766.  
  4767.  
  4768.        Page 82              AceComm (tm) v 1.81
  4769.  
  4770.  
  4771. Chapter 7  File List/Utility Area
  4772.  
  4773.   temporary file is deleted after each use.  UPLDS.LST files are not deleted,
  4774.   but instead stored ready.
  4775.  
  4776.   AceComm will look for UPLDS.LST when any internal batch capable protocols are
  4777.   selected.  If found, AceComm will ask the user is sending the contents of
  4778.   UPLDS.LST is desired, if (Y)es, AceComm will attempt to send all filenames
  4779.   listed in the UPLDS.LST file, if (n)o, AceComm will present the the File
  4780.   Input' menu.
  4781.  
  4782.  ╔═D:\ACE═══════════════════════════════╗╔═UPLDS.LST════════════
  4783.  ║  1_114.FON    26368   06/27/93 07:25 ║║>D:\ACE\1_114.FON
  4784.  ║> ACE.ASM      8269    06/26/93 18:00 ║║
  4785.  ║  ACE.CTL      13589   06/25/93 08:04 ║║
  4786.  ║  ACE.EXE      196102  06/27/93 07:24 ║║
  4787.  ║  ACE.FON      1600    06/27/93 04:13 ║║
  4788.  ║  ACE.HLP      44572   06/27/93 07:09 ║║
  4789.  ║  ACE_MAIL.CFG 430     06/22/93 14:23 ║║
  4790.  ...
  4791.  ║  ACTL         591     06/22/93 14:08 ║║
  4792.  ║  ACTL.ASM     101998  06/25/93 14:22 ║║
  4793.  ║  Utility  New_Dir  Change_Drive      ║╚══════════════════════
  4794.  ╚═│Tag│ Delete  Quit  Help ┤<>v^├══════╝
  4795.  
  4796.  
  4797. Delete
  4798.  
  4799.   Delete option presents a full path spec for the high lighted filename,
  4800.   prompting confirmation before deletion.
  4801.  ╔═D:\ACE═══════════════════════════════╗
  4802.  ║  1_114.FON    26368   06/27/93 07:25 ║
  4803.  ║>╔═══════════════════╗ 06/27/93 07:31 ║
  4804.  ║ ║ D:\ACE\A.SNA      ║ 06/26/93 18:00 ║
  4805.  ║ ║ Delete this file? ║ 06/27/93 07:31 ║
  4806.  ║ ║>(Y)es/(n)o?:      ║ 06/25/93 08:04 ║
  4807.  ║ ╚═══════════════════╝ 06/27/93 07:24 ║
  4808.  ║  ACE.FON      1600    06/27/93 04:13 ║
  4809.  ║  ACE.HLP      44572   06/27/93 07:09 ║
  4810.  ║  ACE_DEF.KBD  11120   06/27/93 07:29 ║
  4811.  ...
  4812.  ║  ACE_MAIL.CFG 430     06/22/93 14:23 ║
  4813.  ║  Utility  New_Dir  Change_Drive      ║
  4814.  ╚═ Tag  Delete  Quit  Help ┤<>v^├══════╝
  4815.  
  4816.  
  4817.  
  4818.  
  4819.  
  4820.  
  4821.  
  4822.  
  4823.  
  4824.        Page 83              AceComm (tm) v 1.81
  4825.  
  4826.  
  4827. Chapter 8  Point Mail Functions
  4828.  
  4829.  
  4830. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  4831. ░░░░░░░░░░░░░░░░░░░░░┌──────────────────────────────────────┐░░░░░░░░░░░░░░░░░
  4832. ░░░░░░░░░░░░░░░░░░░░░│─ PRM-data   Sub-Menu Areas ──────────│░░░░░░░░░░░░░░░░░
  4833. ░░░░░░░░░░░░░░░░░░░░░│┌─Point Mail Setup─────────────────────────────────────┐
  4834. ░░░░░░░░░░░░░░░░░░░░░││─Boss Data────────────────────────────────────────────│
  4835. ░░░░░░░░░░░░░░░░░░░░░││> Boss Name  Acecomm Software Support BBS             │
  4836. ░░░░░░░░░░░░░░░░░░░░░││  Boss Addr  1:114/35                                 │
  4837. ░░░░░░░░░░░░░░░░░░░░░││ Boss Phone  1-602-846-2940                           │
  4838. ░░░░░░░░░░░░░░░░░░░░░││   Boss Pwd  mailman                                  │
  4839. ░░░░░░░░░░░░░░░░░░░░░││  Boss Baud  19200                                    │
  4840. ░░░░░░░░░░░░░░░░░░░░░││  Nodelist   C:\FIL                                   │
  4841. ░░░░░░░░░░░░░░░░░░░░░││   Mail In   D:\ACE\mail                              │
  4842. ░░░░░░░░░░░░░░░░░░░░░││  Mail Out   D:\ACE\mail                              │
  4843. ░░░░░░░░░░░░░░░░░░░░░└│─Sub Menus────────────────────────────────────────────│
  4844. ░░░░░░░░░░░░░░░░░░░░░░│ Dial Trans                                           │
  4845. ░░░░░░░░░░░░░░░░░░░░░░│ Passwords                                            │
  4846. ░░░░░░░░░░░░░░░░░░░░░░└─── Edit  Quit  Help ┤<>v^├───────────────────────────┘
  4847. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  4848.  
  4849.  
  4850. o Boss data is used for mail Poll, Send, Request functions from inside the menu
  4851.    system (manual).  Automated mail functions require a NODELIST file and
  4852.    NLIST.IDX file.
  4853.  
  4854.  
  4855. Boss Setup
  4856.  
  4857.    Define a system that you point mail from AceComm will allow selection of
  4858.    "Boss" from inside the Zone:Net/Node prompt menu.
  4859.  
  4860.    See also <PollBoss> macro
  4861.  
  4862.  
  4863. Dial filter  --  AceComm will use Dial statements to modify phone numbers.
  4864.  
  4865.    Dial filter statements are used when dialing from inside of AceComm's phone
  4866.    directory, and or with mail functions.  A long distance BBS directory list
  4867.    can be used without editing phone numbers.
  4868.  
  4869.    ┌─Example: 1-602-454- 1-454───────────────────────────
  4870.    │>Dial filter 1-602-
  4871.    │ Dial filter
  4872.    │ Dial filter
  4873.    │ Dial filter
  4874.    │ Dial filter
  4875.    └─── Edit  Quit  Help ┤<>v^├──────────────────────────
  4876.  
  4877.  
  4878.  
  4879.  
  4880.        Page 84              AceComm (tm) v 1.81
  4881.  
  4882.  
  4883. Chapter 8  Point Mail Functions
  4884.  
  4885.  
  4886.    The following dial statement filter "1-602-" from all phone numbers the
  4887.    string is found in.
  4888.  
  4889.                   Dial filter 1-602-
  4890.  
  4891.  
  4892.    The following dial statement converts "1-602-451" found in phone numbers to
  4893.    "1-451".
  4894.  
  4895.                   Dial filter 1-602-451 1-451
  4896.  
  4897.  
  4898.    Dial statements are required when using point mail functions, because
  4899.    NODELIST phone numbers contain area codes.  AceComm uses dial statements to
  4900.    know how to modify phone numbers.
  4901.  
  4902. Password -- When an address is pass worded, the EMSI password field will be
  4903.  used to relay the password to a remote system during mail sessions.
  4904.  
  4905.    ┌─Example: 1:114/12 mailman───────────────────────────
  4906.    │>   Password
  4907.    │    Password
  4908.    │    Password
  4909.    │    Password
  4910.    │    Password
  4911.    └─── Edit  Quit  Help ┤<>v^├──────────────────────────
  4912.  
  4913.  
  4914.  
  4915. NODELIST DIRECTORY
  4916.  
  4917.  
  4918. Point mail functions look in the PRM-data directory "NODELIST" for systems
  4919.   directories.  Point mail functions require either of two types systems
  4920.   directories.
  4921.  
  4922. Systems directory type (FIDO  NODELIST)
  4923.  
  4924.   FIDO NODELIST is a systems directory that most EMSI capable HOST systems
  4925.   use.  AceComm can use a FIDO NODELIST.  To use the FIDO NODELIST, you must
  4926.   first compile an INDEX file.  AceComm uses NLIST.IDX.  NLIST.IDX contains a
  4927.   quick look up table for Zone:Net/Nodes in the FIDO NODELIST.  The AceComm
  4928.   package provides IDX.EXE as a utility to create the NLIST.IDX file.
  4929.   NLIST.IDX and the NODELIST are to be found inside of the PRM-data directory
  4930.   "NODELIST".
  4931.  
  4932.  
  4933.  
  4934.  
  4935.  
  4936.        Page 85              AceComm (tm) v 1.81
  4937.  
  4938.  
  4939. Chapter 8  Point Mail Functions
  4940.  
  4941. Systems directory type (FBL.EXE output .NOD file)
  4942.  
  4943.   NOD file is a NET extraction from the FIDO NODELIST.  FBL.EXE (provided) is
  4944.   capable of creating this file.  .NOD files contain a listing for a single
  4945.   NET.  .NOD files are very small and may be preferable for point mail use
  4946.   where calling 1 or a few pre know NETS is intended.  .NOD files are to be
  4947.   found inside of the PRM-data directory "NODELIST".
  4948.  
  4949.  
  4950. Automated Mail Services
  4951.  
  4952.   Automated (event driven) mail services require a NLIST.IDX,NODELIST.nnn pair
  4953.   be present in the NODELIST directory.  FBL output NOD files are not used for
  4954.   event drive mail activities.
  4955.  
  4956.   When an Event Schedule declares "Mail" as part of the event, AceComm will
  4957.   scan the MAIL_OUT directory for *.FLO files.  FLO type files supported are:
  4958.  
  4959.     FLO  ; file attach
  4960.     CLO  ; continuous
  4961.     DLO  ; direct
  4962.     OUT
  4963.     CUT
  4964.     DUT
  4965.     REQ  ; request
  4966.  
  4967.   AceComm will begin looking in the Nodelist directory for a NLIST.IDX file and
  4968.   associated NODELIST.nnn files.  If found, AceComm will look up the target
  4969.   systems record, build a Fon.Record with the information, and begin dialing
  4970.   with intent to send mail, file requests etc.  Any local systems will require
  4971.   a Dial filter statement be defined so that AceComm can translate the long
  4972.   distance number (as contained in the Nodelist) into a local one.
  4973.  
  4974.    The following dial statement filter "1-602-" from all phone numbers the
  4975.    string is found in.
  4976.                          Dial filter 1-602-
  4977.  
  4978.    If a connection is established, and the mail file is properly processed
  4979.    (sent), upon success AceComm deletes the file.  If the session for some
  4980.    reason is not successful (modems don't connect properly) and the file is not
  4981.    sent, AceComm will again scan the MAIL_OUT directory and process any mail
  4982.    files.  AceComm scans the MAIL_OUT directory about every 30 minutes during
  4983.    a "Mail" event.
  4984.  
  4985.    File Requests .REQ files are considered mail files, and processed in the
  4986.    same way.  During a "Mail" event.  Files received during a file request are
  4987.    placed into the MAIL_IN directory.
  4988.  
  4989.  
  4990.  
  4991.  
  4992.        Page 86              AceComm (tm) v 1.81
  4993.  
  4994.  
  4995. Chapter 8  Point Mail Functions
  4996.  
  4997.    Filenames contained inside of FLO files, with exception to REQ files are to
  4998.    be sent out to the target system.  Filenames that are prefixed with a '#'
  4999.    character are made ZERO length after sending.  Filenames prefixed with '^'
  5000.    character are deleted upon successful send.
  5001.  
  5002.  
  5003. The following has been taken from the "Protocols" menus section.  Receive/Send
  5004. Protocols sections present step by step through File Request and File Attach.
  5005.  
  5006.  
  5007. Recv Mail / File Request
  5008.  
  5009.   "FileRequest" is a point mail function.
  5010.  
  5011.   Selecting File Request function will bring up the menu below if the PRM-data
  5012.   directory field for NODELIST points to either
  5013.  
  5014.     - FIDONET NODELIST and compiled NLIST.IDX file
  5015.     - FBL.EXE output .NOD file
  5016.  
  5017.   FBL output .NOD file is used in the example below.
  5018.  
  5019.  ╔═══════════════════════════════════════╗
  5020.  ║>           1:114/12                   ║
  5021.  ║ Format =>  ZONE:NET/NODE              ║
  5022.  ╚═══════════════════════════════════════╝
  5023.  This menu prompts the user for a ZONE:NET/NODE number of the system we want to
  5024.  call.  Having entered the above "1:114/12" the menu below is presented.
  5025.  
  5026. Send Mail / File Attach
  5027.  
  5028.   This selection allows the user to send files to EMSI capable mailer
  5029.   software.  The menu shown below prompts the user for a FIDONET style
  5030.   ZONE:NET/NODE number.
  5031.  
  5032.  
  5033.  
  5034.  
  5035.  
  5036.  
  5037.  
  5038.  
  5039.  
  5040.  
  5041.  
  5042.  
  5043.  
  5044.  
  5045.  
  5046.  
  5047.  
  5048.        Page 87              AceComm (tm) v 1.81
  5049.  
  5050.  
  5051. Chapter 9  Auto Answer Setups
  5052.  
  5053.  
  5054. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  5055. ┌─Auto Answer Setups──────────────────────────────────────────────────────────
  5056. │─Answer/Connect - Associated macro stack─────────────────────────────────────
  5057. │>CONNECT
  5058. │ <HostEcho> <SendStr>^M^L[ACE_ID]^M^JSysop [USER_NAME], [LOCATION]^M^J^J^J^J
  5059. │─Answer/Connect - Associated macro stack─────────────────────────────────────
  5060. │ FAX
  5061. │ <RunProg>BGFAX /FAX %P Z
  5062. │─Answer/Connect - Associated macro stack─────────────────────────────────────
  5063. │
  5064. │
  5065. │─Default macro stack─────────────────────────────────────────────────────────
  5066. │ <RunProg>BGFAX /FAX %P Z
  5067. └─── Edit  Quit  Help ┤<>V^├──────────────────────────────────────────────────
  5068. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  5069.  
  5070.  
  5071. o AceComm will process a macro stack based on the Answer/Connect string
  5072.  
  5073. o Auto Answer mode can be toggled "On/Off" using a key press assigned the
  5074. <AutoAnswer> macro (ALT-E default)
  5075.  
  5076. o Auto Answer can be an EVENT, see "Event Scheduler" menu
  5077.  
  5078.  
  5079. Answer/Connect
  5080.  
  5081.    The sub-string will be looked for in the actual modem response string upon
  5082.    Answer/Connect Strings are currently case sensitive.
  5083.  
  5084.  
  5085. Associated macro stack
  5086.  
  5087.    Macro stack will be processed on "sub-string" found
  5088.  
  5089.  
  5090. Default macro stack
  5091.  
  5092.    Macro stack to process when sub-string search fails
  5093.  
  5094.  
  5095.  
  5096.  
  5097.  
  5098.  
  5099.  
  5100.  
  5101.  
  5102.  
  5103.  
  5104.  
  5105.        Page 88              AceComm (tm) v 1.81
  5106.  
  5107.  
  5108. Chapter 10  Event Schedules
  5109.  
  5110.  
  5111. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  5112. ░░░░░░░░░░░░░░░░░░░░░┌──────────────────────────────────────┐░░░
  5113. ░░░░░░░░░░░░░░░░░░░░░│─ PRM-data   Sub-Menu Areas ──────────│░░░
  5114. ┌─Event Schedules─────────────────────────────────────────────────────────────
  5115. │ Event 00:00-00:05,Mail
  5116. │>Macro <ChgDir>c:\mail\qm <RunProg>QM scan <ChgDir>[DIR_START]
  5117. │ Event 01:00-02:00,Mail
  5118. │ Macro <PollBoss>
  5119. │ Event
  5120. │ Macro
  5121. │ Event 08:00-09:00,Mail
  5122. │ Macro <PollBoss>
  5123. │ Event 11:30-12:00,Mail,Host
  5124. │ Macro <ChgDir>c:\mail\qm <RunProg>QM toss <ChgDir>[DIR_START]
  5125. │─Active = Yes────────────────────────────────────────────────────────────────
  5126. └─── Edit  Enabled  Quit  Help ┤<>v^├─────────────────────────────────────────
  5127. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  5128.  
  5129.  
  5130. AceComm will watch the clock for any event start times.  When an event rolls
  5131. around the associated macro stack, if any will be processed.
  5132.  
  5133. "Mail" events tell AceComm that it is ok to process any *.FLO files contained
  5134. inside the "MAIL_OUT" directory.
  5135.  
  5136. "Host" events tell AceComm it is ok to Auto Answer the line when RING is
  5137. detected.  AceComm uses the UART RING bit and modem status change for detecting
  5138. RING.
  5139.  
  5140. see Auto Answer Setups for more information about Auto Answer
  5141.  
  5142.  
  5143.  
  5144.  
  5145.  
  5146.  
  5147.  
  5148.  
  5149.  
  5150.  
  5151.  
  5152.  
  5153.  
  5154.  
  5155.  
  5156.  
  5157.  
  5158.  
  5159.  
  5160.  
  5161.        Page 89              AceComm (tm) v 1.81
  5162.  
  5163.  
  5164. Chapter 11  "Mondo Menus" (Tm)
  5165.  
  5166.  
  5167.  
  5168. o  "Mondo Menus" are user definable menus
  5169.  
  5170. o  "Mondo Menus" can be used to group similar macro stacks
  5171.    together into one menu
  5172.  
  5173. o  "Mondo Menus" can be assigned to a hot key
  5174.  
  5175. Master "Mondo"
  5176.    Below is the "Mondo Menu" Master menu.  (macro is <Mondos>) A
  5177.    key-press may be assigned the <Mondos> macro as a hot key for
  5178.    this menu.  It lists five "Mondo" style menus available.
  5179.  
  5180.    Each "Mondo Menu" can be assigned a hot key.
  5181.  
  5182. F10 =  │ File │ Setup │ Phone │ Transfer │ Mondos │ Help │
  5183.                                          ┌──────────────────────┐
  5184.                                          │>1  CIS Functions     │
  5185.                                          │ 2  OffLine Reader    │
  5186.                                          │ 3  Mondo Menu #3     │
  5187.                                          │ 4  Mondo Menu #4     │
  5188.                                          │ 5  Mondo Menu #5     │
  5189.                                          └── Select  Quit  Help ┘
  5190.    Here the first two menus have been given titles.  The titles were entered
  5191.    from the setup menu discussed later on.
  5192.  
  5193.    The following macros can be used for the five "Mondo Menus".
  5194.       <Mondo1>
  5195.       <Mondo2>
  5196.       <Mondo3>
  5197.       <Mondo4>
  5198.       <Mondo5>
  5199.  
  5200.    If I want to assign a hot key to the "Mondo Menu" labeled "CIS Functions" I
  5201.    can go into the PRM-data area "Key Setup" menus and assign a key press to
  5202.    the <Mondo1> macro.
  5203.  
  5204.    Example:  F11 <Mondo1>
  5205.  
  5206.  
  5207.  
  5208. A "Mondo Menu"
  5209.  
  5210.    Below is a "Mondo Menu".  This one was created by the author of AceComm as
  5211.    an example.  I came up with the idea for "Mondo Menus" a week before the
  5212.    1.75 release, and so hadn't had time to document many tried-true Mondo
  5213.    setups.  The menus were designed to offer a means for grouping common macro
  5214.  
  5215.  
  5216.  
  5217.        Page 90              AceComm (tm) v 1.81
  5218.  
  5219.  
  5220. Chapter 11  "Mondo Menus" (Tm)
  5221.  
  5222.    stacks into menus.  I wanted to be able to create, change menus and menu
  5223.    items at will, as my on line needs changed.  "Mondo Menus" allow this sort
  5224.    of configuration flexibility.
  5225.  
  5226.    Each "Mondo Menu" has a title and seven function slots.
  5227.  
  5228. F10 =  │ File │ Setup │ Phone │ Transfer │ Mondos │ Help │
  5229.                                         ┌─CIS Functions─────────┐
  5230.                                         │>CIS Forums Script     │
  5231.                                         │ CIS Bill Script       │
  5232.                                         │ Compose Message       │
  5233.                                         │ IBMPRO Forum 2 File   │
  5234.                                         │ IBMCOM Forum 2 File   │
  5235.                                         │                       │
  5236.                                         │ CIS Msg Reference     │
  5237.                                         └─(Select) Edit  Quit ──┘
  5238.  
  5239.  
  5240.  
  5241. Setup "Mondo"
  5242.  
  5243.    Below is the Setup menu for creating "Mondo Menus".
  5244.  
  5245. ┌─"Mondo Menus" (Tm)────────────────────────────────────────────
  5246. │─Title field───────────────────────────────────────────────────
  5247. │>- CIS Functions
  5248. │─Description / Associated macro stack pairs────────────────────
  5249. │ / CIS Forums Script
  5250. │ \ <RunScript>cisforum.scr
  5251. │ / CIS Bill Script
  5252. │ \ <RunScript>cisbill.scr
  5253. │ / Compose Message
  5254. │ \ <SendAscii>%P
  5255. │ / IBMPRO Forum 2 File
  5256. │ \ <SendStr>go IbmPro^M <OpenCapture>ibmpro <SendStr>Read New^M
  5257. │ / IBMCOM Forum 2 File
  5258. │ \ <SendStr>go IbmCom^M <OpenCapture>ibmcom <SendStr>Read New^M
  5259. │ /
  5260. │ \
  5261. │ / CIS Msg Reference
  5262. │ \ <RunProg>List cis_msg.ref
  5263. └───(Edit) Quit  Help ┤<>v^├────────────────────────────────────
  5264.  
  5265. Title field
  5266.  
  5267.    The Title field is 15 characters long, this will be the title that appears
  5268.    in you "Mondo Menu".
  5269.  
  5270.  
  5271.  
  5272.  
  5273.        Page 91              AceComm (tm) v 1.81
  5274.  
  5275.  
  5276. Chapter 11  "Mondo Menus" (Tm)
  5277.  
  5278. Description / Associated macro stack pairs
  5279.  
  5280.    "Description" fields are 20 characters, these will become the menu choices
  5281.    displayed from your "Mondo Menu".
  5282.  
  5283.    "Associated macro stack" fields are 80 characters, these are the actions
  5284.    that take place when you select a "Description" choice.
  5285.  
  5286.  
  5287.  
  5288.  
  5289.  
  5290.  
  5291.  
  5292.  
  5293.  
  5294.  
  5295.  
  5296.  
  5297.  
  5298.  
  5299.  
  5300.  
  5301.  
  5302.  
  5303.  
  5304.  
  5305.  
  5306.  
  5307.  
  5308.  
  5309.  
  5310.  
  5311.  
  5312.  
  5313.  
  5314.  
  5315.  
  5316.  
  5317.  
  5318.  
  5319.  
  5320.  
  5321.  
  5322.  
  5323.  
  5324.  
  5325.  
  5326.  
  5327.  
  5328.  
  5329.        Page 92              AceComm (tm) v 1.81
  5330.  
  5331.  
  5332. Chapter 12  Mouse Support
  5333.  
  5334.  
  5335.  
  5336. Support for a pointer device has been implemented into AceComm using the
  5337. Microsoft Mouse Driver functions.  Your Microsoft compatible mouse should work
  5338. with AceComm.
  5339.  
  5340. Mouse in Terminal Area
  5341.  
  5342. o Pressing the left mouse button with the cursor over blank space sends <CR>.
  5343.  
  5344. o Pressing the left mouse button with the cursor over a character sends the
  5345.   character.
  5346.  
  5347. o Double clicking brings up the TopBar menu.
  5348.  
  5349. Mouse with Menus
  5350.  
  5351.    To move the vertical highlight bar in the menus, press the left mouse button
  5352.    and drag it along, the cursor will follow.  Selections can then be made from
  5353.    the lateral selector bar by highlighting the first character and pressing
  5354.    the left mouse button.
  5355.  
  5356.  
  5357.  
  5358.  
  5359.  
  5360.  
  5361.  
  5362.  
  5363.  
  5364.  
  5365.  
  5366.  
  5367.  
  5368.  
  5369.  
  5370.  
  5371.  
  5372.  
  5373.  
  5374.  
  5375.  
  5376.  
  5377.  
  5378.  
  5379.  
  5380.  
  5381.  
  5382.  
  5383.  
  5384.  
  5385.        Page 93              AceComm (tm) v 1.81
  5386.  
  5387.  
  5388. Chapter 13  ACECOMM DATA FILES
  5389.  
  5390.            ACE.PRM / .CTL
  5391.  
  5392.  
  5393. ACE.PRM
  5394.  
  5395.   ACE.PRM is a binary file which contains all of AceComm's memory, so to
  5396.   speak.  When AceComm is started it reads the ACE.PRM file.  All your serial
  5397.   data, modem data, the keyboard assignments, menu-usage, customizing and so on
  5398.   is stored in ACE.PRM.  PRM-data Area edits the ACE.PRM data, and when
  5399.   AutoSave is "ON", all data is saved each time you leave PRM-data Area.  When
  5400.   AceComm is terminated, the PRM-data is saved to ACE.PRM.
  5401.  
  5402.  
  5403. ACE.CTL
  5404.  
  5405.   ACE.PRM can be rebuilt using the ACTL.EXE utility.  ACTL.EXE reads and
  5406.   formats a .CTL file into ACE.PRM.  A default .CTL file comes with the AceComm
  5407.   package.  The default filename is ACE.CTL.  Any filename is valid with the
  5408.   .CTL extension.  PRM2CTL.EXE produces "PRM2CTL.CTL" filename.
  5409.  
  5410.  
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.  
  5420.  
  5421.  
  5422.  
  5423.  
  5424.  
  5425.  
  5426.  
  5427.  
  5428.  
  5429.  
  5430.  
  5431.  
  5432.  
  5433.  
  5434.  
  5435.  
  5436.  
  5437.  
  5438.  
  5439.  
  5440.  
  5441.        Page 94              AceComm (tm) v 1.81
  5442.  
  5443.  
  5444. Chapter 13  ACECOMM DATA FILES
  5445.  
  5446.            KTS files
  5447.  
  5448.  
  5449. .KTS/.ASC/.BIN files
  5450.  
  5451.   Key Translation Sequence files are used when you want a key press to be
  5452.   translated into a sequence of characters.  A good example of KTS is in the
  5453.   ANSI.KTS file.  Here, keys such as Up Arrow are defined to send an ansi
  5454.   escape sequence that the HOST'S video can read, and bounce back, decrementing
  5455.   the cursor position by 1.
  5456.  
  5457.   A utility KTS.EXE is provided with the AceComm package, which allows you the
  5458.   user to compile .ASC files into .KTS file.
  5459.  
  5460.   You can look at the included .ASC files, that come inside KTS_SFX.EXE, as an
  5461.   example to work from.  The ANSI.ASC file was compiled by KTS.EXE into
  5462.   ANSI.BIN.  ANSI.BIN is exactly the same as ANSI.KTS.  The .BIN extensions is
  5463.   used so that a working .KTS file is not overwritten.  You need to rename .BIN
  5464.   files to .KTS when ready for use.
  5465.  
  5466.   Notes: Keys assigned KTS are processed only if not defined in KBD.  When a
  5467.          key is assigned to a MACRO(s), the MACRO(s) take priority and are
  5468.          processed.  Do not assign MACRO(s) to key-presses you want to KTS.
  5469.  
  5470.   .KTS has it's directory definition optionally defined inside PRM-data area.
  5471.  
  5472.  
  5473.  
  5474.  
  5475.  
  5476.  
  5477.  
  5478.  
  5479.  
  5480.  
  5481.  
  5482.  
  5483.  
  5484.  
  5485.  
  5486.  
  5487.  
  5488.  
  5489.  
  5490.  
  5491.  
  5492.  
  5493.  
  5494.  
  5495.  
  5496.  
  5497.        Page 95              AceComm (tm) v 1.81
  5498.  
  5499.  
  5500. Chapter 13  ACECOMM DATA FILES
  5501.  
  5502.            KBD files
  5503.  
  5504.  
  5505. .KBD
  5506.  
  5507.   KBD files give the user ability to keep more than one keyboard layout for
  5508.   AceComm operations.
  5509.  
  5510.   KBD KeyBoarD files contain the MACRO assignments for the keyboard.  When
  5511.   AceComm is first installed, the file "ACE_DEF.KBD" is used as a default
  5512.   keyboard (KBD).  When AceComm is started, it reads the "current" KBD file.
  5513.   Current KBD file is the default ("ACE_DEF.KBD" or the last KBD Loaded from
  5514.   inside the PRM-data menu area.
  5515.  
  5516.   When you "Load" a KBD file from inside PRM-data area, The KBD file becomes
  5517.   "current".  This means that any changes you make to the key definitions are
  5518.   saved to the "current" KBD file.  Updating the "current" KBD file is done
  5519.   automatically when leaving PRM-data area when "AutoSave" is "ON" (default).
  5520.   When "AutoSave" is "OFF" you need to manually select the "Save" option from
  5521.   the main PRM-data menu.  Do not confuse "Save" with "Write".  "Write" is an
  5522.   option found inside the "KeyBoarD MACRO Assignments" menu.  "Write does not
  5523.   save changes to the "current" KBD file, but prompts the user for a filename,
  5524.   and creates or overwrites a new or existing KBD file.  Then "Write" re-loads
  5525.   the "current" KBD file.
  5526.  
  5527.   KBD files are also used with Fon.Records.  The AceComm package comes with a
  5528.   "CIS.KBD" file example.  The ACE.FON file, also provided with the AceComm
  5529.   package, contains a record for CIS (local Phoenix).  This Fon.Record (CIS)
  5530.   has defined as a KBD file, "CIS.KBD".  When dialing a Fon.Record that
  5531.   contains a KBD file definition, AceComm will upon successful Dial/Connect,
  5532.   load the KBD file associated with the Fon.Record.  This custom KBD file is
  5533.   valid for the time that AceComm detects CARRIER (DCD), or the user loads
  5534.   another KBD file from inside the PRM-data area.  When AceComm detects that
  5535.   the Dial/Connect call is over, (DCD drops),
  5536.  
  5537.   AceComm will:
  5538.  
  5539.                Write the Fon.Record's KBD file, saving any changes that may
  5540.                have been made to it while on line.
  5541.  
  5542.                Re-load the KBD file that was in affect before the connection
  5543.                was established to system that had a KBD file associated with
  5544.                it's Fon.Record.
  5545.  
  5546.   KBD files may be associated to a Fon.Record from inside the telephone
  5547.   directory area, "Edit" option.
  5548.  
  5549.  
  5550.  
  5551.  
  5552.  
  5553.        Page 96              AceComm (tm) v 1.81
  5554.  
  5555.  
  5556. Chapter 13  ACECOMM DATA FILES
  5557.  
  5558.            REQ/FLO,LST,SCR,FON files
  5559.  
  5560.  
  5561. .REQ/FLO
  5562.  
  5563.   Filenames created with ".REQ" extensions are used when making File Requests
  5564.   on EMSI FIDONET style systems.  REQ files are a list of <CR> <LF> terminated
  5565.   filenames.  This REQ file is sent to the system the File Request is being
  5566.   made on, the system will send from the list.
  5567.  
  5568.   Filenames created with ".FLO" extensions are used for Attaching (sending)
  5569.   files to EMSI FIDONET style systems.  FLO files are a list of <CR> <LF>
  5570.   terminated filenames.  AceComm sends from the list (LISTFILE).
  5571.  
  5572.   .REQ/FLO has it's directory definition optionally defined inside PRM-data
  5573.   area.
  5574.  
  5575.  
  5576. .LST
  5577.  
  5578.   AceComm creates LISTFILES with .LST extensions.  A .LST extended LISTFILE is
  5579.   created from inside the "FileLister" (<FileLister_> macro) area.  Filenames
  5580.   "Tagged" from inside "FileLister" are stored inside a file "UPLDS.LST".
  5581.   AceComm's internal batch protocols will send from "UPLDS.LST" by default, you
  5582.   do have the option of creating another LISTFILE, or entering filenames
  5583.   manually.
  5584.  
  5585.  
  5586. .SCR
  5587.  
  5588.   AceComm forces ".SCR" file extensions onto script files.  Script files may be
  5589.   generated automatically using AceComm's AutoScriptGen (Tm).  Script files may
  5590.   be loaded from the terminal area, or used as AceComm's only argument when
  5591.   starting AceComm.  Script files may be associated with
  5592.  
  5593.   Fon.Records from inside "Edit" option.  Script files associated with a
  5594.   Fon.Record are:
  5595.  
  5596.   Upon successful Dial/Connect AceComm creates an "Event" just prior to exiting
  5597.   back to terminal Area.  The "Event" is to run the Script file associated with
  5598.   the Fon.Record.  Typically, this Script file will contain some auto log on
  5599.   MACROS.  The Script plays out, end of "Event"
  5600.  
  5601.   .SCR has it's directory definition optionally defined inside PRM-data area.
  5602.  
  5603.  
  5604. .FON
  5605.  
  5606.  
  5607.  
  5608.  
  5609.        Page 97              AceComm (tm) v 1.81
  5610.  
  5611.  
  5612. Chapter 13  ACECOMM DATA FILES
  5613.  
  5614.            REQ/FLO,LST,SCR,FON files (continued)
  5615.  
  5616.   AceComm uses a binary .FON file for storing it's telephone directory
  5617.   records.  Each record contains data specific to the system.  FON files must
  5618.   be edited inside AceComm, using The Edit menu.
  5619.  
  5620.   Telephone directory files are forced the ".FON" file extensions.  All
  5621.   Fon.Records are stored inside of FON files.  AceComm FON files can hold up to
  5622.   1000 records each.  AceComm allows unlimited FON files.  Selection of FON
  5623.   files is made available from inside the Fon.List area using "Fon_Files"
  5624.   option.
  5625.  
  5626.   .FON has it's directory definition optionally defined inside PRM-data area.
  5627.  
  5628.  
  5629.  
  5630.  
  5631.  
  5632.  
  5633.  
  5634.  
  5635.  
  5636.  
  5637.  
  5638.  
  5639.  
  5640.  
  5641.  
  5642.  
  5643.  
  5644.  
  5645.  
  5646.  
  5647.  
  5648.  
  5649.  
  5650.  
  5651.  
  5652.  
  5653.  
  5654.  
  5655.  
  5656.  
  5657.  
  5658.  
  5659.  
  5660.  
  5661.  
  5662.  
  5663.  
  5664.  
  5665.        Page 98              AceComm (tm) v 1.81
  5666.  
  5667.  
  5668. Chapter 14  AceComm Macro Language
  5669.  
  5670.  
  5671.  
  5672. Reference to characters such as carriage return, space, escape, etc.  are made
  5673. in this document.  Reference to a character is made in the following manner.
  5674. <CR> <SP> where <CR> refers to a carriage return, and <SP> refers to a space
  5675. character.  Macro are bounded by the same <> brackets as character reference.
  5676. Character references are not macros.  A complete macro listing follows this
  5677. chapter.
  5678.  
  5679.  
  5680.  
  5681. o Macros are directives bounded inside of angle brackets < >
  5682.  
  5683. o Macros must have a SPACE character in front of the '<' left bracket when
  5684.     stacking.
  5685.  
  5686.  <ChgDir>[DIR_MAIL] <RunProg>BWAVE <ChgDir>[DIR_START]
  5687.                    |                 |
  5688.                    |_________________|
  5689.                    |
  5690.                    Leading space
  5691.  
  5692. o Macros may be any combination of CaSe
  5693.  
  5694.  <RunProg> jmodem
  5695.  <runprog> jmodem
  5696.  
  5697.  
  5698. o The MACRO PROCESSOR supports MACRO STACKING MACRO STACKING means multiple
  5699.     MACROS per line
  5700.  
  5701.  <SendStr>u z ACE0601.ARJ^M <SendZmo>files\ace0601.arj
  5702.  
  5703.  <SendStr>u z ACE0601.ARJ^M <RunProg>DSZ sz -m files\ace0601.arj
  5704.  
  5705.  <SetDTR> ON <SendStr>ATDT846-2940^M <WaitStr>CONNECT <SendStr>^[^[
  5706.  
  5707.  
  5708. o MACRO DATA PARAMETERS are bounded inside of square brackets [ ]
  5709.  
  5710. o MACRO DATA PARAMETERS need not have a <SP> character in front of them
  5711.  
  5712. o MACRO DATA PARAMETERS must be upper CASE
  5713.  
  5714.  <SendStr>[USER_NAME]^MY^M[FON_PWD]
  5715.           |          |    |
  5716.           |          |    Data Param (Fon.Record password field)
  5717.           |          |
  5718.  
  5719.  
  5720.  
  5721.        Page 99              AceComm (tm) v 1.81
  5722.  
  5723.  
  5724. Chapter 14  AceComm Macro Language
  5725.  
  5726.           |          ^M translates into a <CR> (carriage return)
  5727.           |
  5728.           Data Param (IEMSI user name field)
  5729.  
  5730.  <SendStr>[USER_NAME]^M~~~~[PASSWORD]^M
  5731.  |        |          |  |  |
  5732.  |        |          |  |  IEMSI password field
  5733.  |        |          |  |
  5734.  |        |          |  One second delay (~ = 1/4 second delay)
  5735.  MACRO    |          |
  5736.           |          Control character representation for <CR>
  5737.           |
  5738.           MACRO DATA PARAMETER (IEMSI data)
  5739.  
  5740.  
  5741. o MACRO FUNCTION PARAMETERS are prefixed with a % character
  5742.  
  5743.  <SendZmo> %PF
  5744.   |        |
  5745.   |        MACRO FUNCTION PARAMETER (prompt for filename)
  5746.   |
  5747.   Internal Zmodem sending unit
  5748.  
  5749.  <RunProg>dsz port %P speed %B sz %PF %WK <SendStr>^M
  5750.                       |        |     |   |
  5751.                       |        |     |   |
  5752.                       |        |     |   MACRO FUNCTION PARAM
  5753.                       |        |     |   (wait for key press)
  5754.                       |        |     |
  5755.                       |        |     MACRO FUNCTION PARAM
  5756.                       |        |     (prompt for filename)
  5757.                       |        |
  5758.                       |        MACRO FUNCTION PARAM
  5759.                       |        (insert ascii baud)
  5760.                       |
  5761.                       MACRO FUNCTION PARAM
  5762.                       (insert ascii port)
  5763.  
  5764.  
  5765.  
  5766. Please submit all macro suggestions to:
  5767. a)  MSG to Michael Phelps on the AceComm Support BBS
  5768. b)  MSG to Michael Phelps on Compuserve UID 75120,3306
  5769.  
  5770.  
  5771.  
  5772.  
  5773.  
  5774.  
  5775.  
  5776.  
  5777.        Page 100              AceComm (tm) v 1.81
  5778.  
  5779.  
  5780. Chapter 15  Macros list
  5781.  
  5782.            Local User Input (LUI) Functions
  5783.  
  5784.  
  5785.  
  5786.  
  5787.  
  5788. LUI MACROS require local keyboard input, and so are not suited to un-attended
  5789. scripts.  LUI MACROS contain a '_' underscore as the last character inside the
  5790. brackets.
  5791.  
  5792. <AutoScrGen_>
  5793.  
  5794.    Toggle AutoScrGen(tm) mode
  5795.  
  5796.    Toggle AutoScript Generation mode On/Off.  When "On" an extended status line
  5797.    will appear at the bottom of the TERMINAL screen.  At the far left of the
  5798.    extended status line will be the phrase "AutoScriptGen"
  5799.  
  5800.  
  5801. <BackBuffer_>
  5802.  
  5803.    Menu Area
  5804.    Enter Back Buffer Screen Area
  5805.  
  5806.    BackBuffer contains the last n lines of display that scrolled off the
  5807.    TERMINAL screen.  BackBuffer has a status line of it's own.  The status line
  5808.    contains such information as current line position into the buffer, total
  5809.    lines buffered, and some of the navigational keys are displayed.  Hold the
  5810.    ALT key down for the POP UP REFERENCE available for the BackBuffer area.
  5811.  
  5812.  
  5813. <CaptureFile_>
  5814.  
  5815.    Toggle Capture File
  5816.    Prompts for filename
  5817.  
  5818.    Capture will also prompt for append or overwrite.  Capture does absolutely
  5819.    NO filtering of any kind.  All data is recorded to file "as it comes in the
  5820.    port".  The AceComm package comes with separate utilities which can strip
  5821.    video control codes from files.  See also <OpenCapture> filename,
  5822.    <CloseCapture>
  5823.  
  5824.  
  5825. <CommandShell_>
  5826.  
  5827.    Enter Shell to Command Processor/ Operating System
  5828.  
  5829.    In most cases "Drop to DOS", if your DOS compatible operating system places
  5830.  
  5831.  
  5832.  
  5833.        Page 101              AceComm (tm) v 1.81
  5834.  
  5835.  
  5836. Chapter 15  Macros list
  5837.  
  5838.            Local User Input (LUI) Functions (continued)
  5839.  
  5840.    it's name in the environment where AceComm can find it.  "Shell" is not hard
  5841.    wired to COMMAND.COM but the COMMAND PROCESSOR as found in the environmental
  5842.    data area.
  5843.  
  5844.  
  5845.    Notes: When SWAP is "ON", the serial port is effectively disabled during the
  5846.           shell.  When SWAP is "OFF" the serial port remains active and any
  5847.           incoming data is handled properly, unless the receive buffer wraps
  5848.           around.
  5849.  
  5850. <FileRequest_>
  5851.    Menu driven EMSI file request function.
  5852.  
  5853.  
  5854. <FonListDialer_>
  5855.  
  5856.    Menu Area
  5857.    Enter .FON List / Dialer
  5858.  
  5859.    Dial/.FON directory area.  While AceComm allows manual dialing from inside
  5860.    the TERMINAL area, it most convenient to dial from a record contained in one
  5861.    of the .FON files available for use from the DIAL area.
  5862.  
  5863.  
  5864. <FileLister_>
  5865.  
  5866.    Menu Area
  5867.    Enter File Lister
  5868.  
  5869.    Files lister inside AceComm provides a basic directory list function capable
  5870.    of changing directories and drives.  File-marking, deletion, selection for
  5871.    appropriate file-utility, etc.  LISTFILES may be created.  UPLDS.LST is a
  5872.    file created by the Tag feature inside the File Lister Area.  files tagged
  5873.    will be listed inside UPLDS.LST as CR LF terminated strings.  When selecting
  5874.    any of AceComm's internal batch capable sending protocols, AceComm will
  5875.    check for the existent of the file UPLDS.LST and allow sending from the
  5876.    LISTFILE if desired.
  5877.  
  5878.  
  5879. <MdmHangUp_>
  5880.  
  5881.    Prompts Yes/no before,
  5882.    Sends PRM-data MDM_HANGUP string to modem.  Waits 1/2 second, then drops DTR
  5883.    for 1 second.
  5884.  
  5885. See also    <MdmHangUp> (non LUI)
  5886.  
  5887.  
  5888.  
  5889.        Page 102              AceComm (tm) v 1.81
  5890.  
  5891.  
  5892. Chapter 15  Macros list
  5893.  
  5894.            Local User Input (LUI) Functions (continued)
  5895.  
  5896.  
  5897.  
  5898. <PrmDataMenus_>
  5899.  
  5900.    Menu Area
  5901.    Enter PRM-data Menu Area
  5902.  
  5903.    Notes: When AutoSave is "ON", all data changed is automatically saved when
  5904.           exiting the PRM-data area.
  5905.  
  5906.  
  5907. <RProtocols_>
  5908.  
  5909.    Menu Area
  5910.    Enter Receive Unit Protocols Area menu
  5911.  
  5912.  
  5913. <RunScript_>
  5914.  
  5915.    List .SCR directory, Allow selection, Run selected .SCR file
  5916.  
  5917.    Lists the PRM-data .SCR directory Allows selection of a .SCR file for
  5918.    immediate execution.
  5919.  
  5920.    Notes: AceComm allows .SCR file as an argument when started which
  5921.           immediately executes the script.
  5922.  
  5923.  
  5924. <ScrnSnapShot_>
  5925.  
  5926.    Menu Area
  5927.    Take Screen Snapshot
  5928.  
  5929.    Create a "SnapShot" of the current screen minus any status lines active.
  5930.    Prompts for a filename.  Filenames always will have the .SNA extension.
  5931.    AceComm can detect and will strip away filename extensions provided by the
  5932.    user when they do not match that of the function.  This command is available
  5933.    from most ALT POP UP REFERENCE areas.
  5934.  
  5935.  
  5936. <ScrnTag_>
  5937.  
  5938.    Menu Area
  5939.    Enter Screen Tagger Screen Area
  5940.  
  5941.    Tagger will allow tagging to the first SPACE_CHAR or press RIGHT-ARROW
  5942.  
  5943.  
  5944.  
  5945.        Page 103              AceComm (tm) v 1.81
  5946.  
  5947.  
  5948. Chapter 15  Macros list
  5949.  
  5950.            Local User Input (LUI) Functions (continued)
  5951.  
  5952.    Tagger tags the entire line of text.  Tagger has it's own status line, and a
  5953.    block cursor will appear inside of the Tagger mode.  Tagged items will be
  5954.    assigned to the next available SHIFT-Fn key.
  5955.  
  5956.    Tagger pops up the SHIFT-Fn key window and displays each tagged item, as
  5957.    they are tagged.  Tagger is most handy for grabbing filenames for download
  5958.    off a BBS screen.  SHIFT-Fn key fires the tagged item back when ready.  This
  5959.    command is available from most ALT POP UP REFERENCE areas.
  5960.  
  5961.  
  5962. <SProtocols_>
  5963.  
  5964.    Menu Area
  5965.    Enter Sending Unit Protocols Area
  5966.  
  5967.  
  5968. <ViewKeyCombos>
  5969.  
  5970.    Bring up Pop up Reference The key press assigned this macro is always
  5971.    displayed on the right side of the status line.
  5972.  
  5973.    Notes: <ViewKeyCombos> macro does not have the trailing '_' in the text
  5974.  
  5975.  
  5976. <TopBar>
  5977.  
  5978.    Activate the menu bar at top of screen
  5979.  
  5980.    The key press assigned this macro is always displayed on the right side of
  5981.    the status line.
  5982.  
  5983.    This menu can be brought up inside the terminal area by double clicking the
  5984.    left mouse button.
  5985.  
  5986.  
  5987.  
  5988.  
  5989. The following macros can be used to call individual menus otherwise choices
  5990. from the TopBar single line menu
  5991.  
  5992.  
  5993. <FileMenu>
  5994.  
  5995.    The TopBar File menu
  5996.  
  5997.  
  5998.  
  5999.  
  6000.  
  6001.        Page 104              AceComm (tm) v 1.81
  6002.  
  6003.  
  6004. Chapter 15  Macros list
  6005.  
  6006.            Local User Input (LUI) Functions (continued)
  6007.  
  6008. <HelpMenu>
  6009.  
  6010.    The TopBar Help menu
  6011.  
  6012.    The key press assigned this macro is always displayed on the right side of
  6013.    the status line.
  6014.  
  6015.  
  6016. <Mondos>
  6017.  
  6018.    The TopBar Mondos menu
  6019.  
  6020.    This is a menu that lists and allows menu selection for the Mondo menus.
  6021.    (Mondo1 - Mondo5)
  6022.  
  6023.  
  6024. <PhoneMenu>
  6025.  
  6026.    Calls the <FonListDialer_> macro
  6027.  
  6028.  
  6029. <SetupMenu>
  6030.  
  6031.    Calls the <PrmDataMenus_> macro
  6032.  
  6033.  
  6034. <XfrMenu>
  6035.  
  6036.    The TopBar Transfer menu
  6037.  
  6038.  
  6039. The following individual Mondo menus can be brought up by themselves.
  6040. Otherwise they are selectable from inside the <Mondos> memu.
  6041.  
  6042. <Mondo1>
  6043.  
  6044.    This macro brings up Mondo menu # 1.
  6045.  
  6046. <Mondo2>
  6047.  
  6048.    This macro brings up Mondo menu # 2.
  6049.  
  6050. <Mondo3>
  6051.  
  6052.    This macro brings up Mondo menu # 3.
  6053.  
  6054.  
  6055.  
  6056.  
  6057.        Page 105              AceComm (tm) v 1.81
  6058.  
  6059.  
  6060. Chapter 15  Macros list
  6061.  
  6062.            Local User Input (LUI) Functions (continued)
  6063.  
  6064. <Mondo4>
  6065.  
  6066.    This macro brings up Mondo menu # 4.
  6067.  
  6068. <Mondo5>
  6069.  
  6070.    This macro brings up Mondo menu # 5.
  6071.  
  6072.  
  6073.  
  6074.  
  6075.  
  6076.  
  6077.  
  6078.  
  6079.  
  6080.  
  6081.  
  6082.  
  6083.  
  6084.  
  6085.  
  6086.  
  6087.  
  6088.  
  6089.  
  6090.  
  6091.  
  6092.  
  6093.  
  6094.  
  6095.  
  6096.  
  6097.  
  6098.  
  6099.  
  6100.  
  6101.  
  6102.  
  6103.  
  6104.  
  6105.  
  6106.  
  6107.  
  6108.  
  6109.  
  6110.  
  6111.  
  6112.  
  6113.        Page 106              AceComm (tm) v 1.81
  6114.  
  6115.  
  6116. Chapter 15  Macros list
  6117.  
  6118.            Character I/O Functions
  6119.  
  6120.  
  6121.  
  6122. I/O Function Toggles
  6123.  
  6124. <AutoAnswer>
  6125.  
  6126.    PRM-data MDM_HOST_INIT is sent to the modem when hostmode flag is toggle
  6127.    "ON".  PRM-data MDM_INIT is sent to the modem when hostmode flag is toggled
  6128.    "OFF".  AceComm begins responding to the RI bit SET, and will send the
  6129.    MDM_ANSWER string to the modem when RI BIT becomes asserted.  <HostEcho>
  6130.    becomes active.  Upon Answer/Connect an attempt to match modem response
  6131.    string those defined in the Auto Answer Setup menu.
  6132.  
  6133.    Notes: Auto Answer is also terminated whenever the user dials out from the
  6134.           FON LIST MENU AREA.
  6135.  
  6136.    See your modems S7 register as an alternative.
  6137.  
  6138. See also   Auto Answer Setup menu
  6139.  
  6140.  
  6141. <DoorWayMode>
  6142.  
  6143.    Toggle doorway mode.  Saves the key press combo on entry, whatever key-combo
  6144.    you assign <DoorWayMode> to, is the only way out.  Doorway sends all key
  6145.    presses to the modem in their RAW 'un-cooked' form.  Non extended key
  6146.    presses are send LOW BYTE ONLY.  Extended key presses are sent LOW BYTE,
  6147.    HIGH BYTE.
  6148.  
  6149.    Notes: Pressing CONTROL BREAK will always end AceComm.  CONTROL BREAK is a
  6150.          back door to the <EndAceComm> macro.  When you exit the program by
  6151.          pressing CONTROL BREAK, all data is saved as usual, and program
  6152.          cleanup is as it would be using the <EndAceComm> macro.
  6153.  
  6154.  
  6155. <HostEcho>
  6156.  
  6157.    Toggle Host echo mode.  This macro emulates HostMode's ECHO capability.  It
  6158.    does not answer the phone.  However modems set up for auto answer function
  6159.    normally.
  6160.  
  6161.    Host echo means that characters type locally will be displayed both local
  6162.    and sent to the modem.
  6163.  
  6164.    Host echo will also translate <CR> into <CR><LF> pairs and <BS> into
  6165.    <BS><SP><BS>.
  6166.  
  6167.  
  6168.  
  6169.        Page 107              AceComm (tm) v 1.81
  6170.  
  6171.  
  6172. Chapter 15  Macros list
  6173.  
  6174.            Character I/O Functions (continued)
  6175.  
  6176.  
  6177.  
  6178. <LocalEcho>
  6179.  
  6180.    Toggle local character echo.  Local key-presses will be echoed to the
  6181.    screen.  (same effect as sending "ATE1^M" to the modem)
  6182.  
  6183.  
  6184.  
  6185. I/O Flags
  6186.  
  6187. Flags can be turned "On" or "OFF" with an argument to the macro
  6188.  
  6189. <Scheds>ON     ; enable schedules
  6190.  
  6191. <Scheds>OFF    ; disable schedules
  6192.  
  6193. <Scheds>       ; disable schedules (no arg defaults to "OFF")
  6194.  
  6195.  
  6196. <CTS> on/off
  6197.  
  6198.    CTS/RTS hardware handshaking.
  6199.  
  6200.  
  6201. <XON> on/off
  6202.  
  6203.    XON/XOFF software handshaking
  6204.  
  6205.  
  6206. <BitStrip> on/off
  6207.  
  6208.    Is AceComm going to turn high ascii characters (above 127d)
  6209.  
  6210.  
  6211. I/O Scripts Oriented
  6212.  
  6213. <DispText> LABEL_NAME
  6214.  
  6215.    Display text defined in a data area of a script file LABEL_NAME is
  6216.    descriptive text following {-TEXT_START-} Text is displayed at current
  6217.    cursor position Text display is local
  6218.  
  6219. ------------snip here -------------
  6220. <ClearWindow>
  6221. <DispText>Intro
  6222. <DispText>Ask_Continue
  6223.  
  6224.  
  6225.  
  6226.        Page 108              AceComm (tm) v 1.81
  6227.  
  6228.  
  6229. Chapter 15  Macros list
  6230.  
  6231.            Character I/O Functions (continued)
  6232.  
  6233. :GetKey
  6234. <GetKey>
  6235.    <if>Y
  6236.    <goto>Dial
  6237.    <if>N
  6238.    <goto>End
  6239.    <goto>GetKey
  6240. :Dial
  6241. <INITFONREC>ACECOMM Support BBS      ; Initialize a FON RECORD
  6242. <FON_NUM>1-602-846-2940            ;
  6243. <FON_BAUD>19200                    ;
  6244. <FON_TERM>Av/An                    ;
  6245. <FON_REDIAL>                       ; Go into re dial mode
  6246. <DispText>Connect
  6247. <WAITSTR> your name:
  6248. <GetDCD>                           ; <WaitStr> may have timed
  6249.    <if>1                           ; out
  6250.    <goto>Connect
  6251.    <goto>Dial
  6252. :Connect
  6253. <SENDSTR>Michael Phelps^M
  6254. <SENDSTR>Y^M
  6255. <SENDSTR>password^M
  6256. <WAITSTR>Select:
  6257. <SENDSTR>ff
  6258. :End
  6259. <ENDS>
  6260.  
  6261.  
  6262. {-DATA_AREA-}
  6263. {-TEXT_START-}Intro
  6264. -- Generic Log On Script --
  6265. {-TEXT_END-}
  6266. {-TEXT_START-}Ask_Continue
  6267. Continue (Y/n) {-TEXT_END-}
  6268.  
  6269. {-TEXT_START-}Connect
  6270. -- Connect --
  6271. {-TEXT_END-}
  6272. ------------snip here -------------
  6273.  
  6274.  
  6275. <LocalKeys> on/off
  6276.  
  6277.    Enable/disable local LUI key press during script (host mode)
  6278.  
  6279.  
  6280.  
  6281.  
  6282.        Page 109              AceComm (tm) v 1.81
  6283.  
  6284.  
  6285. Chapter 15  Macros list
  6286.  
  6287.            Character I/O Functions (continued)
  6288.  
  6289.  
  6290. <SendStr> STRING
  6291.  
  6292.    Sends a string to the modem.
  6293.  
  6294.        <SendStr>^M
  6295.  
  6296.        Send a single CR_CHAR
  6297.  
  6298.  
  6299.        <SendStr> Michael Phelps^M
  6300.  
  6301.        Notes: the leading SPACE_CHAR part of STRING
  6302.  
  6303.  
  6304.       <SendStr>[USER_NAME]^M~~~~Y^M~~~~[FON_PWD]
  6305.  
  6306.        Send IEMSI data user name field, a <CR> char, 1 second pause, Y, <CR>
  6307.        char, 1 second pause, current Fon.Record.Password.
  6308.  
  6309.  
  6310.       <SendStr>[USER_NAME]^M^M[PASSWORD]^M
  6311.  
  6312.        Send IEMSI data user name field, 2 <CR> chars, IEMSI data password
  6313.        field.
  6314.  
  6315.  
  6316.  
  6317. <WaitStr> STRING
  6318.  
  6319.    Waits for a CASE sensitive string (sequence of characters) to come in the
  6320.    from the modem.  Can TIMEOUT.
  6321.  
  6322.    Notes: The example below contains a SPACE_CHAR as the first character of
  6323.           STRING.
  6324.  
  6325.           <WaitStr> name:
  6326.  
  6327.  
  6328.    Arguments to MACROS are taken as is, up until the first <CR> on the line of
  6329.    text.
  6330.  
  6331.    A normal text editor in ASCII TEXT mode will have placed the CR_CHAR as the
  6332.    byte following the ':' character in the example STRING below ' name:'.  File
  6333.    Functions internal to AceComm will filter the leading SPACE_CHAR from the
  6334.    MACRO ARG.
  6335.  
  6336.  
  6337.  
  6338.        Page 110              AceComm (tm) v 1.81
  6339.  
  6340.  
  6341. Chapter 15  Macros list
  6342.  
  6343.            Character I/O Functions (continued)
  6344.  
  6345.  
  6346.  
  6347. <WaitTime> n
  6348.  
  6349.    Where n is in seconds Set the timeout value for <WaitStr> (default is 40
  6350.    seconds)
  6351.  
  6352.  
  6353.  
  6354.  
  6355.  
  6356.  
  6357.  
  6358.  
  6359.  
  6360.  
  6361.  
  6362.  
  6363.  
  6364.  
  6365.  
  6366.  
  6367.  
  6368.  
  6369.  
  6370.  
  6371.  
  6372.  
  6373.  
  6374.  
  6375.  
  6376.  
  6377.  
  6378.  
  6379.  
  6380.  
  6381.  
  6382.  
  6383.  
  6384.  
  6385.  
  6386.  
  6387.  
  6388.  
  6389.  
  6390.  
  6391.  
  6392.  
  6393.  
  6394.        Page 111              AceComm (tm) v 1.81
  6395.  
  6396.  
  6397. Chapter 15  Macros list
  6398.  
  6399.            Flags
  6400.  
  6401.  
  6402.  
  6403. Protocols Flags
  6404.  
  6405.  
  6406. <AutoD> on/off
  6407.  
  6408.    Enable/disable auto engage sequence scanning for protocols
  6409.  
  6410.    Does not affect auto logons
  6411.  
  6412.  
  6413. <Resume> on/off
  6414.  
  6415.    Enable/disable file resume (internal zmodem receive)
  6416.  
  6417.  
  6418. <Rename> on/off
  6419.  
  6420.    Enable/disable file rename (internal zmodem receive)
  6421.  
  6422.  
  6423.  
  6424. General Flags
  6425.  
  6426.  
  6427. <SwapSpawn> on/off
  6428.  
  6429.    Enable/disable swap to EMS/XMS/DISK for <RunProg> macro
  6430.  
  6431.  
  6432. <SwapShell> on/off
  6433.  
  6434.    Enable/disable swap to EMS/XMS/DISK for <CommandShell_> macro
  6435.  
  6436.  
  6437. <DTRExit> on/off
  6438.  
  6439.    DTR state for <EndAceComm> macro
  6440.  
  6441.  
  6442. <Scheds> on/off
  6443.  
  6444.    Enable/disable scheduler
  6445.  
  6446.  
  6447.  
  6448.  
  6449.  
  6450.        Page 112              AceComm (tm) v 1.81
  6451.  
  6452.  
  6453. Chapter 15  Macros list
  6454.  
  6455.            Flags (continued)
  6456.  
  6457.  
  6458.  
  6459.  
  6460.  
  6461.  
  6462.  
  6463.  
  6464. <CapMode> Text/Raw
  6465.  
  6466.    <CapMode>Raw <OpenCapture>xmas.ans
  6467.  
  6468.    Captured data will be stored with or without video control characters.  The
  6469.    current video emulation must mach that of the host.
  6470.  
  6471.  
  6472. <ChgDir> FILENAME
  6473.  
  6474.    Make FILENAME current directory
  6475.    This macro can change drives
  6476.  
  6477.    <ChgDir>C:\WORK\TXT <ToPrn>melissa.01 <ChgDir>[DIR_START]
  6478.  
  6479.    Notes: [DIR_START] is the directory Acecomm is started in.
  6480.  
  6481.  
  6482. <CloseCapture>
  6483.  
  6484.    Close the current open capture file, or just returns if none is open.
  6485.  
  6486.    Capture files a re stamped with date/time when closed.
  6487.  
  6488.    Capture files are automatically closed on detection of a loss in carrier.
  6489.  
  6490.  
  6491. <FileDel> FILENAME
  6492.  
  6493.    If the file exists, it will be deleted without prompt.  Use full path name
  6494.    if not in current directory.
  6495.  
  6496.  
  6497. <OpenCapture> filename
  6498.  
  6499.    Calling this function opens a capture file in the directory path defined
  6500.    inside PRM-data Area "Directories" menu, .CAP files.
  6501.  
  6502.    Existing capture files are appended to.  DOS eof character may end up just
  6503.  
  6504.  
  6505.  
  6506.        Page 113              AceComm (tm) v 1.81
  6507.  
  6508.  
  6509. Chapter 15  Macros list
  6510.  
  6511.            File Functions
  6512.  
  6513.    ahead of the time stamp.
  6514.  
  6515.    This function will first close an open capture file, properly saving it to
  6516.    disk.
  6517.  
  6518.    Capture files are stamped with date/time when opened.
  6519.  
  6520.  
  6521.    See <CapMode> macro in I/O Flags
  6522.  
  6523.  
  6524. <RunScript> FILENAME
  6525.  
  6526.    Open and run FILENAME
  6527.  
  6528.    Notes: Just FILENAME no PATH.  PATH found in PRM-data for SCR directory is
  6529.            used.
  6530.  
  6531.  
  6532. <RunProg> FILENAME
  6533.  
  6534.    Spawn an executable file.
  6535.  
  6536.    Can search the DOS PATH.
  6537.  
  6538.    Can determine files's extension (.COM, .EXE).
  6539.  
  6540.    All system ISRS are restored before the spawn takes place.  The serial port
  6541.    is un-hooked.  The state of DCD, and LINE CONTROL are left in tact.
  6542.  
  6543.    After the spawn the system ISRs AceComm uses are taken back, the serial port
  6544.    is re-assumed.
  6545.  
  6546.    SWAP FLAG "ON" and XMS,EMS, or DISK swapping takes place.  SWAP FLAG "OFF"
  6547.    and AceComm is left in memory, with exception to first restoring the serial
  6548.    port and interrupts.
  6549.  
  6550.  
  6551. <SetFonFile> FILENAME
  6552.  
  6553.    Tacks FILENAME onto the PATH defined in PRM DATA for .FON files.  AceComm
  6554.    keeps track of the current(last accessed) .FON file.  FILENAME becomes the
  6555.    current .FON file.  <SetFonFile> 1_114.fon <DialRecord> 1
  6556.  
  6557.  
  6558. <ToPrn> FILENAME
  6559.  
  6560.  
  6561.  
  6562.        Page 114              AceComm (tm) v 1.81
  6563.  
  6564.  
  6565. Chapter 15  Macros list
  6566.  
  6567.            File Functions (continued)
  6568.  
  6569.  
  6570.    Send FILENAME tom the printer.
  6571.  
  6572.    Notes: This macro opens the filename PRN using DOS file handle function, and
  6573.           writes the file.  Any character translation DOS may do will depend
  6574.           upon the IOCTL functions of DOS.  (eof etc.)
  6575.  
  6576.  
  6577.  
  6578.  
  6579.  
  6580.  
  6581.  
  6582.  
  6583.  
  6584.  
  6585.  
  6586.  
  6587.  
  6588.  
  6589.  
  6590.  
  6591.  
  6592.  
  6593.  
  6594.  
  6595.  
  6596.  
  6597.  
  6598.  
  6599.  
  6600.  
  6601.  
  6602.  
  6603.  
  6604.  
  6605.  
  6606.  
  6607.  
  6608.  
  6609.  
  6610.  
  6611.  
  6612.  
  6613.  
  6614.  
  6615.  
  6616.  
  6617.  
  6618.        Page 115              AceComm (tm) v 1.81
  6619.  
  6620.  
  6621. Chapter 15  Macros list
  6622.  
  6623.            Data Transfer functions
  6624.  
  6625.  
  6626.  
  6627.  
  6628. <SendASCII> C:\MSG\COMM\ASCII.TX1
  6629.  
  6630.    Outputs from a file to the modem.  Sends the complete file.  Does *NO*
  6631.    CONTROL CHARACTER TRANSLATION.  Data sent to the modem is paced for buffer
  6632.    FULL, and all handshaking is valid.
  6633.  
  6634.    ESC-key press aborts the function.
  6635.  
  6636.  
  6637. <SendZmo> FILENAME
  6638.  
  6639.    Call internal zmodem sending unit with 1k data frame size.
  6640.  
  6641.    ESC-key press aborts the function.
  6642.  
  6643.  
  6644. <RecvZmo>
  6645.  
  6646.    Call internal zmodem recv unit.  AceComm's internal zmodem receiver is
  6647.    capable of up to 8k data frame size.  The receive unit will continue in
  6648.    batch mode until the sender stops sending files, or the user terminates the
  6649.    transfer.  Files are placed into the directory pointed to in the PRM-data
  6650.    area for Downloads.
  6651.  
  6652.    ESC-key press aborts the function.
  6653.  
  6654.  
  6655. <SendYmo> FILENAME
  6656.  
  6657.    Call internal ymodem sending unit with 128 byte data frame size.
  6658.  
  6659.    ESC-key press aborts the function.
  6660.  
  6661.  
  6662. <SendYmo1k> FILENAME
  6663.  
  6664.    Call internal ymodem sending unit with 1k data frame size.
  6665.  
  6666.    ESC-key press aborts the function.
  6667.  
  6668.  
  6669. <SendYmoG> FILENAME
  6670.  
  6671.  
  6672.  
  6673.  
  6674.        Page 116              AceComm (tm) v 1.81
  6675.  
  6676.  
  6677. Chapter 15  Macros list
  6678.  
  6679.            Data Transfer functions (continued)
  6680.  
  6681.    Call internal ymodemG sending unit with 1k data frame size.
  6682.  
  6683.    ESC-key press aborts the function.
  6684.  
  6685.  
  6686. <SendXmo> FILENAME
  6687.  
  6688.    Call internal xmodem sending unit with 128 byte data frame size.
  6689.  
  6690.    ESC-key press aborts the function.
  6691.  
  6692.  
  6693. <SendXmo1k> FILENAME
  6694.  
  6695.    Call internal xmodem sending unit with 1k data frame size.
  6696.  
  6697.    ESC-key press aborts the function.
  6698.  
  6699.  
  6700. <RecvYmo>
  6701.  
  6702.    Call internal ymodem.  The receive unit will continue in batch mode until
  6703.    the sender stops sending files, or the user terminates the transfer.  Files
  6704.    are placed into the directory pointed to in the PRM-data area for Downloads.
  6705.  
  6706.    ESC-key press aborts the function.
  6707.  
  6708.  
  6709. <RecvYmo1K>
  6710.  
  6711.    Call internal ymodem1K.  The receive unit will continue in batch mode until
  6712.    the sender stops sending files, or the user terminates the transfer.  Files
  6713.    are placed into the directory pointed to in the PRM-data area for Downloads.
  6714.  
  6715.    ESC-key press aborts the function.
  6716.  
  6717.  
  6718. <RecvYmoG>
  6719.  
  6720.    Call internal ymodemG.  The receive unit will continue in batch mode until
  6721.    the sender stops sending files, or the user terminates the transfer.  Files
  6722.    are placed into the directory pointed to in the PRM-data area for Downloads.
  6723.  
  6724.    ESC-key press aborts the function.
  6725.  
  6726.  
  6727.  
  6728.  
  6729.  
  6730.        Page 117              AceComm (tm) v 1.81
  6731.  
  6732.  
  6733. Chapter 15  Macros list
  6734.  
  6735.            Data Transfer functions (continued)
  6736.  
  6737. <RecvXmo> FILENAME
  6738.  
  6739.    Call internal xmodem.  Files are placed into the directory pointed to in the
  6740.    PRM-data area for Downloads.
  6741.  
  6742.    ESC-key press aborts the function.
  6743.  
  6744.  
  6745. <RecvXmo1K> FILENAME
  6746.  
  6747.    Call internal xmodem1k.  Files are placed into the directory pointed to in
  6748.    the PRM-data area for Downloads.
  6749.  
  6750.    ESC-key press aborts the function.
  6751.  
  6752.  
  6753. <SendEMSI_CLI>
  6754.  
  6755.    Send an EMSI_CLI HDR sequence to modem
  6756.  
  6757.    BBS mailer front ends that use EMSI handshake protocol will, if EMSI is
  6758.    implemented properly, interpret an "EMSI_CLI" HDR sequence, as "this is a
  6759.    human caller" and drop to the BBS without any delay.  Note: At this writing
  6760.    Front Door, and Binkley recognize EMSI_CLI HDR.  DBridge does not.  See
  6761.    default AutoD trigger assignments (ACE.CTL)
  6762.  
  6763.  
  6764. <SendEMSI_ICI>
  6765.  
  6766.    Send an EMSI_ICI data packet to modem
  6767.  
  6768.    EMSI_ICI is a response made by the caller (CLIENT) to a BBS system (HOST)
  6769.    which supports Interactive EMSI handshake protocol.  IEMSI data is contained
  6770.    inside the PRM-data area.  This data can be used for automating log on when
  6771.    call a BBS that supports IEMSI.  See default AutoD trigger assignments
  6772.    (ACE.CTL)
  6773.  
  6774.  
  6775.  
  6776. Notes: Xmodem/Ymodem Receive units are capable of adopting to frame size.
  6777.        128 / 1024 data frames are determined by the sender and can be sent in
  6778.        any combination.
  6779.  
  6780.        The Internal Zmodem in AceComm is capable of up to 8k data frames.  For
  6781.        compatibility, AceComm only uses larger than 1k data frames with it's
  6782.        sending unit in mailer modes.  AceComm's zmodem receive unit can handle
  6783.  
  6784.  
  6785.  
  6786.        Page 118              AceComm (tm) v 1.81
  6787.  
  6788.  
  6789. Chapter 15  Macros list
  6790.  
  6791.            Data Transfer functions (continued)
  6792.  
  6793.        up to 8k data frames at any time.
  6794.        The internal zmodem can make filename management decisions based on the
  6795.        status of option flags for "resume" and "rename".
  6796.  
  6797.  
  6798.  
  6799.  
  6800.  
  6801.  
  6802.  
  6803.  
  6804.  
  6805.  
  6806.  
  6807.  
  6808.  
  6809.  
  6810.  
  6811.  
  6812.  
  6813.  
  6814.  
  6815.  
  6816.  
  6817.  
  6818.  
  6819.  
  6820.  
  6821.  
  6822.  
  6823.  
  6824.  
  6825.  
  6826.  
  6827.  
  6828.  
  6829.  
  6830.  
  6831.  
  6832.  
  6833.  
  6834.  
  6835.  
  6836.  
  6837.  
  6838.  
  6839.  
  6840.  
  6841.  
  6842.        Page 119              AceComm (tm) v 1.81
  6843.  
  6844.  
  6845. Chapter 15  Macros list
  6846.  
  6847.            Modem/Dialing/Fon.Record
  6848.  
  6849.  
  6850.  
  6851. Modem/Dialing
  6852.  
  6853.  
  6854. <DialNum> PHONE_NUMBER
  6855.  
  6856.    Builds a dial string.  Uses PRM-data MDM_DIAL_PREFIX and PHONE_NUMBER Sends
  6857.    the dial string to the modem.  One time.  No re dials as this will typically
  6858.    take place from terminal area.
  6859.  
  6860.  
  6861. <DialRecord> n
  6862.  
  6863.    Retrieves the n record found in current .FON file
  6864.  
  6865.    Re dials number until CONNECT or USER ABORT
  6866.  
  6867.        <SetFonFile> 1_114.FON <DialRecord> 1
  6868.  
  6869.  
  6870. <GetDCD>
  6871.  
  6872.    Returns 0 or 1 current carrier detect signal
  6873. :DIAL
  6874.    ...
  6875.    <GetDCD>
  6876.    <if>1 <goto>CONNECT
  6877.          <goto>DIAL
  6878.    ...
  6879. :CONNECT
  6880.  
  6881.  
  6882. <Fon_Redial>
  6883.  
  6884.    Presents the FON record to the AceComm re dial function.  See "Fon.Record"
  6885.    macros below
  6886.  
  6887.  
  6888. <MdmHangUp>
  6889.  
  6890.    Sends PRM-data MDM_HANGUP string to modem.  Waits 1/2 second, then drops DTR
  6891.    for 1 second.
  6892.  
  6893.  
  6894. <PollBoss>
  6895.  
  6896.  
  6897.  
  6898.        Page 120              AceComm (tm) v 1.81
  6899.  
  6900.  
  6901. Chapter 15  Macros list
  6902.  
  6903.            Modem/Dialing/Fon.Record (continued)
  6904.  
  6905.  
  6906.    This macros take BOSS data and builds a FLO file.  The macro then creates a
  6907.    Fon.Record with the BOSS info and goes into mailer mode.  If the connect is
  6908.    un-successful or aborted, the FLO file still exits in the MAIL OUT
  6909.    directory.  Any schedule that allows mail will see the FLO file and cause
  6910.    the system to be polled again.
  6911.  
  6912.  
  6913. <SetDTR> on/off
  6914.  
  6915.    SET or RESET UART BIT
  6916.  
  6917.         <SetDtr> OFF
  6918.  
  6919.  
  6920.  
  6921.  
  6922. Fon.Record
  6923.  
  6924.  
  6925. <InitFonRec> RECORD NAME
  6926.  
  6927.    This MACRO must be called first.  The MACRO initializes a FON RECORD with
  6928.    AceComm defaults.  RECORD NAME is copied into the system name for this
  6929.    record.
  6930.  
  6931.       <InitFonRec> Compuserve
  6932.  
  6933.  
  6934. <Fon_Num> PHONE_NUMBER
  6935.  
  6936.    Set the phone number field.  Any dial statements in ACE.CFG will be applied
  6937.    to this number when AceComm builds the dial string.
  6938.  
  6939.       <Fon_Num>468-0285
  6940.  
  6941.  
  6942. <Fon_Baud>BAUD
  6943.  
  6944.    If using a locked port, AceComm will ignore this value when getting ready to
  6945.    dial.
  6946.  
  6947.       <Fon_Baud>19200
  6948.  
  6949.  
  6950. <Fon_LineCtrl> DATA_PARITY_STOPBIT
  6951.  
  6952.  
  6953.  
  6954.        Page 121              AceComm (tm) v 1.81
  6955.  
  6956.  
  6957. Chapter 15  Macros list
  6958.  
  6959.            Modem/Dialing/Fon.Record (continued)
  6960.  
  6961.  
  6962.    Valid parameters are as follows
  6963.          8n1
  6964.          7e1
  6965.          7n1
  6966.  
  6967.       <Fon_LineCtrl>8n1
  6968.  
  6969.  
  6970. <Fon_Flags> FLAG, FLAG
  6971.  
  6972.    Possible Control Flags
  6973.  
  6974.    "Script" when set,
  6975.  
  6976.    AceComm will attempt to load and run the filename defined next to "AutoLogOn
  6977.    Script".  If a script file is not found, AceComm ignores the error and
  6978.    continues normal operation.
  6979.  
  6980.    Notes: .SCR files are looked for in the directory defined inside PRM-data
  6981.            Area "Directories"
  6982.  
  6983.  
  6984.    "Macro"  when  set,
  6985.  
  6986.    AceComm will enable the defined Auto Log on Sequence Triggers and
  6987.    corresponding MACRO stacks.
  6988.  
  6989.  
  6990.    "DTag"  when  set,
  6991.  
  6992.    AceComm will tag un-successful dial attempts (busy, etc.) to the Que
  6993.    Dialer.  An "*" character appears to the left of a Fon.Record's display
  6994.    line, when it is either Q tagged or, D tagged.  When this flag is not set,
  6995.    the only other way to Q tag a record is by manually selecting the menu
  6996.    option "<SPACEBAR>-Que" from the fon list display.
  6997.  
  6998.  
  6999.    "Capture" when  set,
  7000.  
  7001.    When this flag is selected, a capture file is opened upon
  7002.    Dial/Connect.  Any previously open capture file is first
  7003.    closed.
  7004.  
  7005.  
  7006.    "Raw"  when set,
  7007.  
  7008.  
  7009.  
  7010.        Page 122              AceComm (tm) v 1.81
  7011.  
  7012.  
  7013. Chapter 15  Macros list
  7014.  
  7015.            Modem/Dialing/Fon.Record (continued)
  7016.  
  7017.  
  7018.    Data to capture file is as it comes in from the modem
  7019.  
  7020.  
  7021.    "Text"  when set,
  7022.  
  7023.    Data to capture file is filtered of video control codes
  7024.    as applicable to the current Video type
  7025.  
  7026.  
  7027.    "IEMSI"  when  set,
  7028.  
  7029.    Allow Interactive EMSI log on
  7030.  
  7031.   "AutoL"
  7032.  
  7033.   Allow auto log on methods (script/macro)
  7034.  
  7035.  
  7036. <Fon_Term> VIDEO_TYPE
  7037.  
  7038.       - Valid parameters are as follows
  7039.  
  7040.         TTY
  7041.         Ansi
  7042.         Avatar
  7043.         Av/An
  7044.         VT102
  7045.  
  7046.       <Fon_Term>Av/An
  7047.  
  7048.  
  7049. <Fon_CapFile> FILENAME
  7050.  
  7051.  
  7052. <Fon_Redial>
  7053.  
  7054.    Presents the FON record to the AceComm re dial function.
  7055.  
  7056.  
  7057.  
  7058.  
  7059.  
  7060.  
  7061.  
  7062.  
  7063.  
  7064.  
  7065.  
  7066.        Page 123              AceComm (tm) v 1.81
  7067.  
  7068.  
  7069. Chapter 15  Macros list
  7070.  
  7071.            Misc Functions
  7072.  
  7073.  
  7074.  
  7075.  
  7076. <Alarm> SECONDS
  7077.  
  7078.    Sound alarm for SECONDS
  7079.  
  7080.  
  7081. <BbsEndAceComm>
  7082.  
  7083.    This macro will Exit AceComm with an errorlevel based on the current baud
  7084.    setting.  Baud is taken from the UART, and if the port is locked, will vary
  7085.    from the connect speed.
  7086.  
  7087.    Errorlevel is decimal of the first 2 ascii decimal digits of the current
  7088.    UART baud setting.
  7089.  
  7090.    DTR state is left as is.
  7091.  
  7092.    Errorlevels returned are:
  7093.                              57 - 57600
  7094.                              38 - 38400
  7095.                              19 - 19200
  7096.                              96 -  9600
  7097.                              48 -  4800
  7098.                              24 -  2400
  7099.                              12 -  1200
  7100.                              30 -   300
  7101.    Sample use:
  7102. :Start
  7103.    echo off
  7104.    ace
  7105.    if errorlevel 96 goto error96
  7106.    if errorlevel 57 goto error57
  7107.    if errorlevel 48 goto error48
  7108.    if errorlevel 38 goto error38
  7109.    if errorlevel 24 goto error24
  7110.    if errorlevel 19 goto error19
  7111.    goto start
  7112. :error57
  7113.    BBS.EXE 57600
  7114.    goto Start
  7115. :error38
  7116.    BBS.EXE 38400
  7117.    goto Start
  7118. :error19
  7119.  
  7120.  
  7121.  
  7122.        Page 124              AceComm (tm) v 1.81
  7123.  
  7124.  
  7125. Chapter 15  Macros list
  7126.  
  7127.            Misc Functions (continued)
  7128.  
  7129.    BBS.EXE 19200
  7130.    goto Start
  7131. :error96
  7132.    BBS.EXE 9600
  7133.    goto Start
  7134. :error48
  7135.    BBS.EXE 4800
  7136.    goto Start
  7137. :error24
  7138.    BBS.EXE 2400
  7139.    goto Start
  7140. :error12
  7141.    BBS.EXE 1200
  7142.    goto Start
  7143. :End
  7144.  
  7145.  
  7146. <ClearWindow>
  7147.  
  7148.    Clear screen. Clears screen above status line
  7149.  
  7150.  
  7151. <Delay> SECONDS
  7152.  
  7153.    Create program function delay.
  7154.  
  7155.  
  7156. <EndAceComm> ERRORLEVEL
  7157.  
  7158.    <EndAceComm> 0
  7159.    AceComm session end with errorlevel
  7160.  
  7161.    Exit AceComm back to the operating system.  End AceComm session.  A QUICK
  7162.    snap, no prompt "Are you sure?".  If your on line, your still on line when
  7163.    you come back unless "drop DTR on exit is SET"
  7164.  
  7165.    See Drop DTR on EXIT flag inside Terminal Area Options
  7166.  
  7167.    Notes: Pressing CONTROL BREAK will always end AceComm.  CONTROL BREAK is a
  7168.          back door to the <EndAceComm> macro.  When you exit the program by
  7169.          pressing CONTROL BREAK, all data is saved as usual, and program
  7170.          cleanup is as it would be using the <EndAceComm> macro.
  7171.  
  7172.  
  7173. <RingBell> SECONDS
  7174.  
  7175.  
  7176.  
  7177.  
  7178.        Page 125              AceComm (tm) v 1.81
  7179.  
  7180.  
  7181. Chapter 15  Macros list
  7182.  
  7183.            Misc Functions (continued)
  7184.  
  7185.    A value of 0 does not ring bell, a value of 1 plays a victory tune, values
  7186.    from 2 - 30 ring the internal bell for the number of seconds.  This is the
  7187.    same bell sound heard in the Dial/Connect window.
  7188.  
  7189.  
  7190.  
  7191. <Wait_To_HHMM> hh:mm
  7192.  
  7193.    Wait until hour:minute 24 hour format leading zeros not needed
  7194.  
  7195.            <Wait_To_HHMM>4:10    is valid
  7196.  
  7197.    Sample use:
  7198.  
  7199.     <Wait_To_HHMM>15:45                ; wait till 3:45 pm
  7200.     <INITFONREC>A.C.E. Software Support; call Init FON function
  7201.     <FON_NUM>1-602-846-2940            ; set phone number
  7202.     <FON_BAUD>2400
  7203.     <FON_TERM>Av/An                    ; video type for script
  7204.     <FON_REDIAL>                       ; call redial function
  7205.     <WAITSTR>it a few moments.
  7206.     <SENDSTR>^M
  7207.     <WAITSTR>s your name:
  7208.     <SENDSTR>Michael Phelps^M
  7209.     <WAITSTR>ael Phelps [Y,n]?
  7210.     <SENDSTR>^M
  7211.     <WAITSTR>Password:
  7212.     <SENDSTR>melissa_jean^M
  7213.     <WAITSTR>Select:
  7214.     <SENDSTR>f^M
  7215.     <SENDSTR>d^Mz^Mace170.arj^M
  7216.     <RecvZmo>
  7217.     <WAITSTR>Select:
  7218.     <SENDSTR>gyn^M
  7219.     <ENDS>
  7220.     <ENDS>
  7221.  
  7222.    Mark the end of a script.
  7223.  
  7224.  
  7225.  
  7226.  
  7227.  
  7228.  
  7229.  
  7230.  
  7231.  
  7232.  
  7233.  
  7234.        Page 126              AceComm (tm) v 1.81
  7235.  
  7236.  
  7237. Chapter 16  MACRO Parameter Macros
  7238.  
  7239.            Expandable PRM-data Macros
  7240.  
  7241.  
  7242.  
  7243. o MACRO parameters are UPPER case only
  7244.  
  7245. Fon.Records
  7246.  
  7247.  
  7248. [FON_PWD]
  7249.  
  7250.    Replaced with the current Fon.Record "password"
  7251.  
  7252.  
  7253. [FON_ALIAS]
  7254.  
  7255.    Replaced with the current Fon.Record "alias"
  7256.  
  7257.  
  7258. [FON_ID]
  7259.  
  7260.    Replaced with the current Fon.Record "ID"
  7261.  
  7262.  
  7263. [FON_CAP]
  7264.  
  7265.    Replaced with the current Fon.Record CAPTURE "filename"
  7266.  
  7267.  
  7268. [FON_SCR]
  7269.  
  7270.    Replaced with the current Fon.Record SCRIPT "filename"
  7271.  
  7272.  
  7273.  
  7274.  
  7275.  
  7276. PRM-data IEMSI
  7277.  
  7278.  
  7279. [USER_NAME]
  7280.  
  7281.    Replaced with the current PRM-data/IEMSI "User Name"
  7282.  
  7283.       <SendStr> [USER_NAME]
  7284.  
  7285.  
  7286. [ALIAS]
  7287.  
  7288.  
  7289.  
  7290.        Page 127              AceComm (tm) v 1.81
  7291.  
  7292.  
  7293. Chapter 16  MACRO Parameter Macros
  7294.  
  7295.            Expandable PRM-data Macros (continued)
  7296.  
  7297.  
  7298.    Replaced with the current PRM-data/IEMSI "alias"
  7299.  
  7300.  
  7301. [LOCATION]
  7302.  
  7303.    Replaced with the current PRM-data/IEMSI "location"
  7304.  
  7305.  
  7306. [DATA_PNUM]
  7307.  
  7308.    Replaced with the current PRM-data/IEMSI "data #"
  7309.  
  7310.  
  7311. [VOICE_PNUM]
  7312.  
  7313.    Replaced with the current PRM-data/IEMSI "voice #"
  7314.  
  7315.  
  7316. [PASSWORD]
  7317.  
  7318.    Replaced with the current PRM-data/IEMSI "password"
  7319.  
  7320.  
  7321. The following are data from PRM-data DIRECTORY section
  7322.  
  7323.  
  7324.  
  7325.  
  7326.  
  7327. PRM-data Directories
  7328.  
  7329.  
  7330. [DIR_START]
  7331.  
  7332.    Replaced with the current PRM-data/DIR "start up"
  7333.    This is the directory AceComm is started in.
  7334.  
  7335.  
  7336. [DIR_FON]
  7337.  
  7338.    Replaced with the current PRM-data/DIR ".FON"
  7339.  
  7340.  
  7341. [DIR_CAP]
  7342.  
  7343.  
  7344.  
  7345.  
  7346.        Page 128              AceComm (tm) v 1.81
  7347.  
  7348.  
  7349. Chapter 16  MACRO Parameter Macros
  7350.  
  7351.            Expandable PRM-data Macros (continued)
  7352.  
  7353.    Replaced with the current PRM-data/DIR ".CAP"
  7354.  
  7355.  
  7356. [DIR_SCR]
  7357.  
  7358.    Replaced with the current PRM-data/DIR ".SCR"
  7359.  
  7360.  
  7361. [DIR_KTS]
  7362.  
  7363.    Replaced with the current PRM-data/DIR ".KTS"
  7364.  
  7365.  
  7366. [DIR_DNLDS]
  7367.  
  7368.    Replaced with the current PRM-data/DIR "dnlds"
  7369.  
  7370. <ChgDir> [DIR_DNLDS] <RunProgram>DSZ rz -mr <ChgDir> [DIR_START]
  7371.  
  7372.  
  7373. [DIR_NODELIST]
  7374.  
  7375.    Replaced with the current PRM-data/DIR "nodelist"
  7376.  
  7377.  
  7378. [DIR_MAILIN]
  7379.  
  7380.    Replaced with the current PRM-data/DIR "mail_in"
  7381.  
  7382. [DIR_MAILOUT]
  7383.  
  7384.    Replaced with the current PRM-data/DIR "mail_out"
  7385.  
  7386.  
  7387.  
  7388.  
  7389.  
  7390. PRM-data Modem
  7391.  
  7392.  
  7393. [MDM_INIT]
  7394.  
  7395.    Replaced with the current PRM-data/MDM "init"
  7396.  
  7397.  
  7398. [DIAL_PREFIX]
  7399.  
  7400.  
  7401.  
  7402.        Page 129              AceComm (tm) v 1.81
  7403.  
  7404.  
  7405. Chapter 16  MACRO Parameter Macros
  7406.  
  7407.            Expandable PRM-data Macros (continued)
  7408.  
  7409.  
  7410.    Replaced with the current PRM-data/MDM "dial prefix"
  7411.  
  7412.  
  7413. [DIAL_SUFFIX]
  7414.  
  7415.    Replaced with the current PRM-data/MDM "dial suffix"
  7416.  
  7417.  
  7418. [ANSWER]
  7419.  
  7420.    Replaced with the current PRM-data/MDM "answer"
  7421.  
  7422.  
  7423. [HANGUP]
  7424.  
  7425.    Replaced with the current PRM-data/MDM "hangup"
  7426.  
  7427.  
  7428. [OFFHOOK]
  7429.  
  7430.    Replaced with the current PRM-data/MDM "off hook"
  7431.  
  7432.  
  7433. [ABORT]
  7434.  
  7435.    Replaced with the current PRM-data/MDM "abort"
  7436.  
  7437.  
  7438. [RESET]
  7439.  
  7440.    Replaced with the current PRM-data/MDM "reset"
  7441.  
  7442.  
  7443. [ECHO]
  7444.  
  7445.    Replaced with the current PRM-data/MDM "echo"
  7446.  
  7447.  
  7448. [HOST_INIT]
  7449.  
  7450.    Replaced with the current PRM-data/MDM "host init"
  7451.  
  7452.  
  7453. [CMD_LINE_TERMINATOR]
  7454.  
  7455.  
  7456.  
  7457.  
  7458.        Page 130              AceComm (tm) v 1.81
  7459.  
  7460.  
  7461. Chapter 16  MACRO Parameter Macros
  7462.  
  7463.            Expandable PRM-data Macros (continued)
  7464.  
  7465.    Replaced   with   the   current   PRM-data/MDM  "command  line
  7466.    terminator"
  7467.  
  7468.  
  7469.  
  7470.  
  7471.  
  7472.  
  7473.  
  7474.  
  7475.  
  7476.  
  7477.  
  7478.  
  7479.  
  7480.  
  7481.  
  7482.  
  7483.  
  7484.  
  7485.  
  7486.  
  7487.  
  7488.  
  7489.  
  7490.  
  7491.  
  7492.  
  7493.  
  7494.  
  7495.  
  7496.  
  7497.  
  7498.  
  7499.  
  7500.  
  7501.  
  7502.  
  7503.  
  7504.  
  7505.  
  7506.  
  7507.  
  7508.  
  7509.  
  7510.  
  7511.  
  7512.  
  7513.  
  7514.        Page 131              AceComm (tm) v 1.81
  7515.  
  7516.  
  7517. Chapter 16  MACRO Parameter Macros
  7518.  
  7519.            Expandable Macro Functions
  7520.  
  7521.  
  7522.  
  7523.  
  7524. o  Expandable MACRO Functions are UPPER case only
  7525.  
  7526. %B
  7527.    Insert ascii baud, %B is replaced with current baud setting in ascii
  7528.    format.  Current baud setting is UART line speed, if the port is locked,
  7529.    this will differ from the modem connect speed.
  7530.  
  7531. %P
  7532.    Insert ascii port, %P is replaced with current port number is ascii format.
  7533.    Port number is 1 based (com1 =1, com2 =2)
  7534.  
  7535. %FN   (Valid when used from <FileLister_>)
  7536.  
  7537.    Use from File Lister Area, %FN is replaced with currently "highlighted"
  7538.    filename.
  7539.  
  7540. %PF
  7541.    Prompt for filename, %PF is replaced with what you type into the prompt box.
  7542.  
  7543. %WK
  7544.  
  7545.    Wait for Key press, stops MACRO execution and waits for a key press.
  7546.  
  7547.  
  7548.  
  7549.  
  7550.  
  7551.  
  7552.  
  7553.  
  7554.  
  7555.  
  7556.  
  7557.  
  7558.  
  7559.  
  7560.  
  7561.  
  7562.  
  7563.  
  7564.  
  7565.  
  7566.  
  7567.  
  7568.  
  7569.  
  7570.        Page 132              AceComm (tm) v 1.81
  7571.  
  7572.  
  7573. Chapter 17  Scripts
  7574.  
  7575.  
  7576.  
  7577.  
  7578.  
  7579.  
  7580.  
  7581. AceComm generates script files automatically when running in AutoScriptGen
  7582. mode.  The macro <AutoScrGen_> puts AceComm into AutoScriptGen mode.  AceComm
  7583. default keyboard file ACE_DEF.KBD assigns ALT-A to <AutoScrGen_>.
  7584.  
  7585.  
  7586. AutoScriptGen first prompts for a filename to use for the script file.  The
  7587. extension .SCR will automatically be appended.
  7588.  
  7589. ╔═Input Window══════════════════════════════════════════════════
  7590. ║═Enter filename, <ENTER> alone when done, ESC-abort════════════
  7591. ║>=> D:\ACE\CSERVE░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  7592. ╚═══════════════════════════════════════════════════════════════
  7593.  
  7594. Having a filename, AutoScriptGen creates the file and waits for activity.  We
  7595. want to call out.  Lets bring up the FON directory and select Compuserve.
  7596.  
  7597. ╔═ Telephone_directory fon\ACE.FON, 9 Records═══════════════════
  7598. ║═      System Name              Phone Number     Line Control V
  7599. ║ 1    AceComm Support BBS      1-602-846-2940     19200,8N1   A
  7600. ║>2    CIS (local phoenix 9600) 468-0285           19200,7E1   A
  7601. ║ 3    CIS (phones)             1-800-346-3247     2400,7E1    A
  7602. ║ 4    Comp USA #2              1-214-620-7993     19200,8N1   A
  7603. ║ 5    Supra Modem BBS          1-503-967-2444     19200,8N1   A
  7604. ║ 6  - Comput Connections (PCB) 1-202-547-2008     19200,8N1   A
  7605. ║ 7  - Comp USE (Dallas TX)     1-214-620-2255     19200,8N1   A
  7606. ║  Dial  Edit  <SPACEBAR>-Que  Circling_dial_queue  Fon_files  S
  7607. ╚═ Add_record  Remove_record  UnMark_All  Import  Paint  Quit  H
  7608.  
  7609. AutoScripGen will write Fon.Record information to the script file in the form
  7610. of macro commands.
  7611.  
  7612. Below is a simple script file produced by AutoScriptGen.  The first 5 lines are
  7613. a result of having selected a Fon.Record to dial from inside the dialing area.
  7614. AutoScriptGen has used 4 macro commands to initialize a Fon.Record and a 5'th
  7615. macro to call the continuous dialer function.
  7616.  
  7617. FILE: CSERVE.SCR
  7618.  
  7619. ------------snip here -------------
  7620. <INITFONREC>CIS (local phoenix 9600)
  7621. <FON_NUM>468-0285
  7622. <FON_BAUD>19200
  7623.  
  7624.  
  7625.  
  7626.        Page 133              AceComm (tm) v 1.81
  7627.  
  7628.  
  7629. Chapter 17  Scripts
  7630.  
  7631.            AutoScriptGen (Tm)
  7632.  
  7633. <FON_TERM>Av/An
  7634. <FON_REDIAL>
  7635. <SENDSTR>^M
  7636. <WAITSTR>Host Name:
  7637. <SENDSTR>cis^M
  7638. <WAITSTR>User ID:
  7639. <SENDSTR>75120,3306^M
  7640. <WAITSTR>Password:
  7641. <SENDSTR>cis/pwd^M
  7642. <WAITSTR>er choice number !
  7643. <SENDSTR>go ibmpro^M
  7644. <WAITSTR>Press <CR> !
  7645. <SENDSTR>^M
  7646. <OPENCAPTURE>ibmpro
  7647. <WAITSTR>Enter choice !
  7648. <SENDSTR>READ NEW^M
  7649. <WAITSTR>ress <CR> !
  7650. <SENDSTR>^M
  7651. <CLOSECAPTURE>
  7652. <WAITSTR>Enter choice !
  7653. <SENDSTR>off^M
  7654. <WAITSTR>Host Name:
  7655. <SENDSTR>off^M
  7656. <ENDS>
  7657. ------------snip here -------------
  7658.  
  7659. The following example has been used by the author successfully (remember to
  7660. insert your password)
  7661.  
  7662. Example CIS Billing
  7663. ------------snip here -------------
  7664. <ClearWindow>
  7665. <DispText>Intro
  7666. <INITFONREC>CIS (local phoenix 9600)
  7667. <FON_NUM>468-0285
  7668. <FON_LINECTRL>7E1
  7669. <FON_BAUD>19200
  7670. <FON_TERM>Av/An
  7671. <FON_FLAGS>Macro,IEMSI,
  7672. <FON_REDIAL>
  7673. <LocalKeys>On
  7674. <WaitTime>10
  7675. <SENDSTR>^M
  7676. <SENDSTR>^M
  7677. <WAITSTR>Host Name: <SENDSTR>cis^M
  7678. <WAITSTR>User ID: <SENDSTR>75120,3306^M
  7679.  
  7680.  
  7681.  
  7682.        Page 134              AceComm (tm) v 1.81
  7683.  
  7684.  
  7685. Chapter 17  Scripts
  7686.  
  7687.            AutoScriptGen (Tm) (continued)
  7688.  
  7689. <WAITSTR>Password: <SENDSTR>password/here^M
  7690. <WaitTime>20
  7691. <WAITSTR>choice number ! <SENDSTR>2^M
  7692. <WAITSTR><CR> for more ! <SENDSTR>8^M
  7693. <WAITSTR>Enter choice ! <SENDSTR>2^M
  7694. <WAITSTR>Enter Choice ! <SENDSTR>2^M <OPENCAPTURE>CISBILL.CAP
  7695. <WAITSTR><CR> for more ! <SENDSTR>^M
  7696. <WAITSTR>Last page ! <SENDSTR>^M
  7697. <WAITSTR>Enter Choice ! <SENDSTR>3^M
  7698. <WAITSTR><CR> for More ! <SENDSTR>^M
  7699. <WAITSTR>Last Page ! <SENDSTR>^M
  7700. <WAITSTR>Enter Choice ! <SENDSTR>4^M
  7701. <WAITSTR>Last Page ! <SENDSTR>^M
  7702. <WAITSTR>Enter Choice ! <CLOSECAPTURE> <SENDSTR>off^M
  7703. <WAITSTR>Host Name: <SENDSTR>off^M
  7704. <ENDS>
  7705. {-DATA_AREA-}
  7706. {-TEXT_START-}Intro
  7707. -- Compuserve Billing Information --
  7708.  
  7709.    This script captures the current months charges, and a review of the last
  7710.    svereal months billing to a capture file "CISBILL.CAP" The script then logs
  7711.    off.  The script could be interupted if you have CIS configured to display
  7712.    mail and other anouncements on login.
  7713.  
  7714. {-TEXT_END-}
  7715. ------------snip here -------------
  7716.  
  7717.  
  7718. The following example has been used by the author successfully (remember to
  7719. insert your password)
  7720.  
  7721. Example CIS Forums
  7722. ------------snip here -------------
  7723. <ClearWindow>
  7724. <DispText>Intro
  7725. <INITFONREC>CIS (local phoenix 9600)
  7726. <FON_NUM>468-0285
  7727. <FON_LINECTRL>7E1
  7728. <FON_BAUD>19200
  7729. <FON_TERM>Av/An
  7730. <FON_REDIAL>
  7731. <SENDSTR>~~~~~~~~~^M
  7732. <WAITSTR>Host Name: <SENDSTR>cis^M
  7733. <WAITSTR>User ID: <SENDSTR>75120,3306^M
  7734. <WAITSTR>Password: <SENDSTR>password/here^M
  7735.  
  7736.  
  7737.  
  7738.  
  7739.        Page 135              AceComm (tm) v 1.81
  7740.  
  7741.  
  7742. Chapter 17  Scripts
  7743.  
  7744.            AutoScriptGen (Tm) (continued)
  7745.  
  7746. <WAITSTR>er choice number ! <SENDSTR>go share^M
  7747. <WAITSTR>Press <CR> ! <SENDSTR>^M
  7748. <WAITSTR>Enter choice ! <OPENCAPTURE>share <SENDSTR>READ NEW^M
  7749. <WaitTime>500 <WAITSTR>ress <CR> ! <SENDSTR>^M
  7750. <WAITSTR>Enter choice ! <CLOSECAPTURE>
  7751.  
  7752. <SENDSTR>go ibmcom^M
  7753. <WAITSTR>Press <CR> ! <SENDSTR>^M
  7754. <WAITSTR>Enter choice ! <OPENCAPTURE>ibmcom <SENDSTR>READ NEW^M
  7755. <WaitTime>500 <WAITSTR>ress <CR> ! <SENDSTR>^M
  7756. <WAITSTR>Enter choice ! <CLOSECAPTURE>
  7757.  
  7758. <SENDSTR>go ibmpro^M
  7759. <WAITSTR>Press <CR> ! <SENDSTR>^M
  7760. <WAITSTR>Enter choice ! <OPENCAPTURE>ibmpro <SENDSTR>READ NEW^M
  7761. <WaitTime>500 <WAITSTR>ress <CR> ! <SENDSTR>^M
  7762. <WAITSTR>Enter choice ! <CLOSECAPTURE>
  7763.  
  7764. <SENDSTR>off^M
  7765. <WAITSTR>Host Name:
  7766. <SENDSTR>off^M
  7767. <ENDS>
  7768. {-DATA_AREA-}
  7769. {-TEXT_START-}Intro
  7770. -- Compuserve Forums --
  7771.  
  7772.    This script captures the new messages for 3 forums.  SHARE, IBMCOM, and
  7773.    IBMPRO.  The forums are captured to 3 separate files.  SHARE.CAP,
  7774.    IBMCOM.CAP, and IBMPRO.CAP.  The script then logs off.  The script could be
  7775.    interupted if you have CIS configured to display mail and other anouncements
  7776.    on login.
  7777.  
  7778. {-TEXT_END-}
  7779. ------------snip here -------------
  7780.  
  7781.  
  7782.  
  7783.  
  7784.  
  7785.  
  7786.  
  7787.  
  7788.  
  7789.  
  7790.  
  7791.  
  7792.  
  7793.  
  7794.  
  7795.        Page 136              AceComm (tm) v 1.81
  7796.  
  7797.  
  7798. Chapter 17  Scripts
  7799.  
  7800.            Conditionals, Labels, Gotos, Data Area
  7801.  
  7802.  
  7803.  
  7804.          :Label
  7805.             Labels begin with ':' character
  7806.             Labels are used as arguments to the <goto> macro
  7807.  
  7808.          <goto> label
  7809.             "Label"  can be defined any where in the script file, either
  7810.             before or after a <goto> macro.
  7811.  
  7812.          <if> condition
  7813.             AceComm supports a set of conditional macros. Conditional
  7814.             macros return either 1 or 0.
  7815.  
  7816.          {-DATA_AREA-}
  7817.             Defines a data area
  7818.  
  7819.          {-TEXT_START-}
  7820.           see examples
  7821.          {-TEXT_END-}
  7822.  
  7823.  
  7824.             {-Data_ Area-} will be covered extensively next month with
  7825.             many complex scripts as well as complete documentation.
  7826.  
  7827.             The following script introduces some un-documented script
  7828.             language features.
  7829.  
  7830.  
  7831.             Follows is a basic script which includes a data area.
  7832.  
  7833.          ------------snip here -------------
  7834.          <ClearWindow>
  7835.          <DispText>Intro
  7836.          <DispText>Ask_Continue
  7837.          :GetKey
  7838.          <GetKey>
  7839.             <if>Y
  7840.             <goto>Dial
  7841.             <if>N
  7842.             <goto>End
  7843.             <goto>GetKey
  7844.          :Dial
  7845.          <INITFONREC>ACECOMM Support BBS      ; Initialize a FON RECORD
  7846.          <FON_NUM>1-602-846-2940            ;
  7847.          <FON_BAUD>19200                    ;
  7848.  
  7849.  
  7850.  
  7851.        Page 137              AceComm (tm) v 1.81
  7852.  
  7853.  
  7854. Chapter 17  Scripts
  7855.  
  7856.            Conditionals, Labels, Gotos, Data Area (continued)
  7857.  
  7858.          <FON_TERM>Av/An                    ;
  7859.          <FON_REDIAL>                       ; Go into re dial mode
  7860.          <DispText>Connect
  7861.          <WAITSTR> your name:
  7862.          <GetDCD>                           ; <WaitStr> may have timed
  7863.             <if>1                           ; out
  7864.             <goto>Connect
  7865.             <goto>Dial
  7866.          :Connect
  7867.          <SENDSTR>Michael Phelps^M
  7868.          <SENDSTR>Y^M
  7869.          <SENDSTR>password^M
  7870.          <WAITSTR>Select:
  7871.          <SENDSTR>ff
  7872.          :End
  7873.          <ENDS>
  7874.  
  7875.  
  7876.          {-DATA_AREA-}
  7877.          {-TEXT_START-}Intro
  7878.          -- Generic Log On Script --
  7879.          {-TEXT_END-}
  7880.          {-TEXT_START-}Ask_Continue
  7881.          Continue (Y/n) {-TEXT_END-}
  7882.  
  7883.          {-TEXT_START-}Connect
  7884.          -- Connect --
  7885.          {-TEXT_END-}
  7886.          ------------snip here -------------
  7887.  
  7888.  
  7889.  
  7890. ------------snip here -------------
  7891.     <Wait_To_HHMM>15:45                ; wait till 3:45 pm
  7892.     <INITFONREC>A.C.E. Software Support; call Init FON function
  7893.     <FON_NUM>1-602-846-2940            ; set phone number
  7894.     <FON_BAUD>2400
  7895.     <FON_TERM>Av/An                    ; video type for script
  7896.     <FON_REDIAL>                       ; call redial function
  7897.     <WAITSTR>it a few moments.
  7898.     <SENDSTR>^M
  7899.     <WAITSTR>s your name:
  7900.     <SENDSTR>Michael Phelps^M
  7901.     <WAITSTR>ael Phelps [Y,n]?
  7902.     <SENDSTR>^M
  7903.     <WAITSTR>Password:
  7904.  
  7905.  
  7906.  
  7907.        Page 138              AceComm (tm) v 1.81
  7908.  
  7909.  
  7910. Chapter 17  Scripts
  7911.  
  7912.            Conditionals, Labels, Gotos, Data Area (continued)
  7913.  
  7914.     <SENDSTR>melissa_jean^M
  7915.     <WAITSTR>Select:
  7916.     <SENDSTR>f^M
  7917.     <SENDSTR>d^Mz^Mace170.arj^M
  7918.     <RecvZmo>
  7919.     <WAITSTR>Select:
  7920.     <SENDSTR>gyn^M
  7921.     <ENDS>
  7922.     <ENDS>
  7923. ------------snip here -------------
  7924.  
  7925.  
  7926.  
  7927.  
  7928.  
  7929.  
  7930.  
  7931.  
  7932.  
  7933.  
  7934.  
  7935.  
  7936.  
  7937.  
  7938.  
  7939.  
  7940.  
  7941.  
  7942.  
  7943.  
  7944.  
  7945.  
  7946.  
  7947.  
  7948.  
  7949.  
  7950.  
  7951.  
  7952.  
  7953.  
  7954.  
  7955.  
  7956.  
  7957.  
  7958.  
  7959.  
  7960.  
  7961.  
  7962.  
  7963.        Page 139              AceComm (tm) v 1.81
  7964.  
  7965.  
  7966. Chapter 18  Whats New?
  7967.  
  7968.  
  7969.  
  7970. =============================================================
  7971. 1/16/94 * Release version 1.81
  7972. =============================================================
  7973.    Some of the setup files have been changed to make the
  7974.    default installation easier to use.
  7975.  
  7976. - Point mail functions using BOSS info were needlessly aborting
  7977.   when NODELIST or NLIST.IDX files were not available.
  7978. - Auto Logon was scanning the first 10 fields and ignoring the last
  7979.   six.
  7980. =============================================================
  7981. 12/26/93 * Release version 1.8
  7982. =============================================================
  7983.  
  7984. Update made for 1.8 include:
  7985.  
  7986.   AceComm is written in 100% assembly language.  This is how the EXE file
  7987.   remains so small.  The movement for menu data to a separate binary file is in
  7988.   the workings, this will allow for memory savings, multiple language support,
  7989.   and to a limited degree, user customizing.  AceComm for MS-Windows is coming
  7990.   along nicely, and like the DOS version, written in assembly language.  The
  7991.   GUI version featuring RIPscrip video will be available to registered users
  7992.   by March of 94. Those wishing to see pre-release copies can get them.
  7993.   Int 14h and FOSSIL support will be seen in a 1.86 release very soon. I have
  7994.   them implemented, haven't enabled them yet. I may tie an interrupt handler
  7995.   to buffer int 14h, as it's dog gone slow using BIOS the way they are.
  7996.  
  7997. - Fixed dialer timeout to recycle where values 60 seconds and greater would not
  7998.   timeout, but require a modem response in order to recycle.
  7999.  
  8000. - Zmodem receiver file management functions in a more expected manor.  User
  8001.   aborts would end with the file time not being updated to the file time sent by
  8002.   the remote.  This caused a later resume to be renamed instead.  ACE.DOC
  8003.   covers the logic behind file management used with Acecomm's internal zmodem.
  8004.  
  8005. - Script/macro processor gets attention every release, this area is very robust
  8006.   now.  The scrip language continues to inch along, what is here is very solid.
  8007.  
  8008. - AutoScrGen does a better overall job and can handle systems using HOT keys.
  8009.  
  8010. - Macro language evolves with each release.  The macro language and scripts
  8011.   capability will see the most attention from version to version.
  8012.  
  8013. - Terminal emulations saw some minor additions. These always get added to and
  8014.   tweaked every version.
  8015.  
  8016.  
  8017.  
  8018.  
  8019.        Page 140              AceComm (tm) v 1.81
  8020.  
  8021.  
  8022. Chapter 18  Whats New?
  8023.  
  8024. - Event schedules are more on line aware, and there is an enable flag where the
  8025.   schedules can be turned off completely.
  8026.  
  8027. - ACTL (assemble CTL) and PRM2CTL (dis-assemble PRM) utilities are more data
  8028.   aware.  The PRM file can be almost 100% cloned across versions.
  8029.  
  8030. - LISTFILE prompting for batch uploads will now search the directory for all
  8031.   LISTFILES and prompt the user "Send from this file Y/n)" before defaulting to
  8032.   the menu.  This allows multiple LISTFILES be ready to go, and used on the
  8033.   fly, greatly improving the fast up load selection process.
  8034.  
  8035. - Point mail services saw a lot of work and those using pre-release versions
  8036.   are getting good results with the scheduler and <PollBoss> macros.
  8037.  
  8038. - MDMI.EXE is included for the first time with this release.  MoDeM Install
  8039.   will read from an ascii format file of modem definitions.  The file can grow,
  8040.   MDMI.EXE will be able to use it as it grows.
  8041.  
  8042. - Mouse handler was re-written. Mouse support is much more flexible. Double
  8043.   click in terminal mode brings up the TopBar menu.
  8044.  
  8045. - KTS key definitions somehow got behind KBD definitions. KTS are back to
  8046.   getting first crack at a key press.
  8047.  
  8048. - Xmodem was not opening file for 1.75, but dumping to the screen. 1.76 fixed
  8049.   this.
  8050.   Both Xmodem and Ymodem (G) saw a lot of attention. Mostly YmodemG. This
  8051.   protocol is not using file management that the Zmodem uses.
  8052.  
  8053. - Fixed a problem where writing the AceComm prompt to the DOS prompt when
  8054.   shelling to command processor, AceComm would overwrite any environment
  8055.   variables that were defined after the prompt. This will be a noticeable fix
  8056.   for many. This caused AceComm to lose it's ability to run programs if any
  8057.   PATH statement followed the prompt string.
  8058.  
  8059. - A trend for menus to become user definable is in the works. It just seems
  8060.   to evolve this way since I wanted to move all the text out to an edit able
  8061.   area anyway.
  8062.  
  8063.  
  8064.  
  8065.  
  8066.  
  8067.  
  8068.  
  8069.  
  8070.  
  8071.  
  8072.  
  8073.  
  8074.  
  8075.        Page 141              AceComm (tm) v 1.81
  8076.  
  8077.  
  8078. Chapter 19  WARRANTY
  8079.  
  8080.  
  8081.  
  8082.  
  8083.  
  8084.  
  8085.                     DISCLAIMER - AGREEMENT
  8086.  
  8087.  
  8088.  
  8089.  
  8090. Users of AceComm must accept this disclaimer of warranty:
  8091.  
  8092. AceComm is supplied as is.  The author disclaims all warranties,
  8093. expressed or implied, including, without limitation, the
  8094. warranties of merchantability and of fitness for any purpose.
  8095. The author assumes no liability for damages, direct or conse-
  8096. quential, which may result from the use of AceComm.
  8097.  
  8098.  
  8099.  
  8100.  
  8101.  
  8102.  
  8103.  
  8104.  
  8105.  
  8106.  
  8107.  
  8108.  
  8109.  
  8110.  
  8111.  
  8112.  
  8113.  
  8114.  
  8115.  
  8116.  
  8117.  
  8118.  
  8119.  
  8120.  
  8121.  
  8122.  
  8123.  
  8124.  
  8125.  
  8126.  
  8127.  
  8128.  
  8129.  
  8130.  
  8131.        Page 142              AceComm (tm) v 1.81
  8132.  
  8133.  
  8134. Chapter 20  LICENSE
  8135.  
  8136.  
  8137. AceComm is not a Public Domain program and is not free.  AceComm is copyright
  8138. (C) 1990-1993 by MGP Programming Services.
  8139.  
  8140. Non-registered users of this program are granted a limited 30 day license to
  8141. evaluate the programs suitability for their requirements.  Any usage of AceComm
  8142. beyond the evaluation time period requires registration of each copy of the
  8143. program used.  Use of non- registered copies of AceComm beyond the original
  8144. evaluation period is prohibited.
  8145.  
  8146. AceComm may NOT be modified in any respect, for any reason, including but not
  8147. limited to, de-compiling, disassembling, or reverse engineering of the
  8148. program.  The opening title screen, help screens, and all other proprietary
  8149. program output must never be altered, removed, bypassed or modified by any
  8150. means.
  8151.  
  8152. You are free to distribute the PUBLICLY AVAILABLE evaluation version of AceComm
  8153. to others subject to the above restrictions and also the following:
  8154.  
  8155.    A.   No fee is charged for its use.
  8156.  
  8157.    B.  No re numeration may be accepted for AceComm.  This does not apply to
  8158.         computer access charges the system operators (Sysops) of or
  8159.         organizations owning bulletin board systems, on line services, etc...
  8160.         may charge subscribers.
  8161.  
  8162.    C.  AceComm must be copied in unaltered form, complete with files containing
  8163.         license information, the FULL documentation and all accompanying
  8164.         files.  The self-extracting archive distributed by MGP Programming
  8165.         Services must not be altered in ANY respect.
  8166.  
  8167.    D.  All shareware houses/distribution firms must make explicitly clear that
  8168.         the diskette purchase containing any shareware program has NOT
  8169.         registered the software with the author MGP Programming Services
  8170.         Software/Michael G Phelps.
  8171.  
  8172.  
  8173.  
  8174.  
  8175.  
  8176.  
  8177.  
  8178.  
  8179.  
  8180.  
  8181.  
  8182.  
  8183.  
  8184.  
  8185.  
  8186.  
  8187.        Page 143              AceComm (tm) v 1.81
  8188.  
  8189.  
  8190. Chapter 20  LICENSE
  8191.  
  8192.  
  8193. System Operators may make AceComm available for download only if the above
  8194. conditions are met.  The archive (Acennnn.EXE) distributed by AceComm or an
  8195. equivalent archive may be made available only in complete form.  Refer to
  8196. FILELIST.DOC to verify complete package contents.  If the contents appear
  8197. altered or not complete, you may obtain the latest release of AceComm directly
  8198. from MGP Programming Services by sending a formatted diskette labeled with the
  8199. word "AceComm".  Please include $5 for handling.
  8200.  
  8201. The latest version of AceComm is also available on Compuserve.
  8202.  
  8203. Commercial distributors of "Public Domain", "Shareware", and/or User Supported
  8204. software may distribute AceComm subject to the above conditions only after
  8205. obtaining WRITTEN permission from MGP Programming Services.  This condition
  8206. statement supersedes all previous agreements.
  8207.  
  8208. Please refer to the section entitled registration/ordering section for
  8209. additional information on registration, corporate site-licensing and related
  8210. topics.
  8211.  
  8212.  
  8213.  
  8214.  
  8215.  
  8216.  
  8217.  
  8218.  
  8219.  
  8220.  
  8221.  
  8222.  
  8223.  
  8224.  
  8225.  
  8226.  
  8227.  
  8228.  
  8229.  
  8230.  
  8231.  
  8232.  
  8233.  
  8234.  
  8235.  
  8236.  
  8237.  
  8238.  
  8239.  
  8240.  
  8241.  
  8242.  
  8243.        Page 144              AceComm (tm) v 1.81
  8244.  
  8245.  
  8246. Chapter 20  LICENSE
  8247.  
  8248.  
  8249. The above license statement does not apply to the REGISTERED version of
  8250. AceComm.  The registered software of MGP Programming Services is protected
  8251. under United States Copyright and Trademark Laws.  It must be treated just like
  8252. a book with certain exceptions as follows:
  8253.  
  8254.    A.  MGP Programming Services authorizes the making of archival copies of the
  8255.        registered software for the sole purpose of backing-up your software and
  8256.        protecting your investment from possible loss.
  8257.  
  8258.    B.  The medium on which the registered software is recorded is transferred
  8259.        to the customer, but not the title to the software.
  8260.  
  8261.    C.  The customer may resell or distribute unmodified copies of the
  8262.        registered software provided the customer has purchased from MGP
  8263.        Programming Services one copy of the registered software for each one
  8264.        sold or distributed.  The provisions of this software license shall also
  8265.        be applicable to third parties receiving copies of the registered
  8266.        software from the customer.
  8267.  
  8268.    D.  By saying, "just like a book", MGP Programming Services means that the
  8269.        registered software may be used by any number of people and may be
  8270.        freely moved from one computer location to another so long as there is
  8271.        ABSOLUTELY NO POSSIBILITY of it being used at one location while being
  8272.        used at another.  Just like a book that cannot be read by two different
  8273.        people in two different locations at the same time.
  8274.  
  8275.  
  8276.  
  8277.  
  8278.  
  8279.  
  8280.  
  8281.  
  8282.  
  8283.  
  8284.  
  8285.  
  8286.  
  8287.  
  8288.  
  8289.  
  8290.  
  8291.  
  8292.  
  8293.  
  8294.  
  8295.  
  8296.  
  8297.  
  8298.  
  8299.        Page 145              AceComm (tm) v 1.81
  8300.  
  8301.  
  8302. Chapter 20  LICENSE
  8303.  
  8304.  
  8305.  
  8306.  
  8307. You can get more help by contacting the
  8308. author Michael Phelps at the following
  8309.  
  8310. - VOICE 602-846-4563 6 days 12-7pm MST
  8311.  
  8312. - BBS   602-846-2940 24 hours
  8313.  
  8314. - COMPUSERVE User ID 75120,3306
  8315.  
  8316. - FIDONET ADDRESS 1:114/35
  8317.  
  8318. - FIDONET ACECOMM ECHO
  8319. I distribute the "ACECOMM" echo to
  8320. USA NODES, until it makes BACKBONE.
  8321.  
  8322. - Write to: AceComm Software Support
  8323.             3003 North Central Ave
  8324.             Suite 121-171
  8325.             Phoenix, AZ  85012  USA
  8326.  
  8327.  
  8328.  
  8329.  
  8330.  
  8331.  
  8332.  
  8333.  
  8334.  
  8335.  
  8336.  
  8337.  
  8338.  
  8339.  
  8340.  
  8341.  
  8342.  
  8343.  
  8344.  
  8345.  
  8346.  
  8347.  
  8348.  
  8349.  
  8350.  
  8351.  
  8352.  
  8353.  
  8354.  
  8355.        Page 146              AceComm (tm) v 1.81
  8356.  
  8357.  
  8358. Chapter 21  AceComm Registration
  8359.  
  8360.  
  8361.  
  8362.              AceComm (Tm) Version  1.8
  8363.  
  8364. AceComm is distributed to you as "Try before you buy" software.
  8365.  
  8366. Continued use of the AceComm package requires the registration fee be sent to
  8367. the author.
  8368.  
  8369. Registering AceComm gives you access to one of the more powerful and innovative
  8370. communications programs available.
  8371.  
  8372. AceComm registration costs just $45.  (includes shipping) You will receive an
  8373. up-to-date printed bound user manual, the very latest AceComm software on disk,
  8374. your registration card and serial number, 1 FREE upgrade card, major revision
  8375. upgrade notices mailed to you, all future upgrades at very low cost of 20%
  8376. registration fee.
  8377.     (Wow, major upgrades include printed manual for just $9)
  8378. To place an order, please use the order form contained in the file
  8379. ACEORDER.FRM, or print directly from the program Help menu.
  8380.  
  8381.         800-242-4775  (Toll free) To register by credit card.
  8382.         FAX at 713-524-6398
  8383.         Part number 10805
  8384.  
  8385.  
  8386.  
  8387.  
  8388.  
  8389.  
  8390.  
  8391.  
  8392.  
  8393.  
  8394.  
  8395.  
  8396.  
  8397.  
  8398.  
  8399.  
  8400.  
  8401.  
  8402.  
  8403.  
  8404.  
  8405.  
  8406.  
  8407.  
  8408.  
  8409.  
  8410.  
  8411.        Page 147              AceComm (tm) v 1.81
  8412.  
  8413.  
  8414. Chapter 22  Order Form
  8415.  
  8416.  
  8417.  
  8418.  
  8419.  
  8420.                     AceComm & Utilities (Tm)
  8421.                          Version  1.8
  8422.                           ORDER FORM
  8423.  
  8424.  
  8425.  
  8426. FROM:
  8427.  
  8428.      Name: ____________________________________________________
  8429.  
  8430. [Company]: ____________________________________________________
  8431.  
  8432.   [Title]: ____________________________________________________
  8433.  
  8434.   Address: ____________________________________________________
  8435.  
  8436.      City: ____________________________________________________
  8437.  
  8438.     State: ___________________________ Zip Code: ______________
  8439.  
  8440.   Country: ___________________________ Phone: _________________
  8441.  
  8442.  
  8443.  
  8444.  
  8445.  
  8446.                                    TO:
  8447.                                        AceComm Software
  8448.                                        3003 N. Central Ave. #121-171
  8449.                                        Phoenix, AZ    85012   USA
  8450.  
  8451.  
  8452.               ┌─────────┐
  8453.         ┌─────┴───┐     │              (R)
  8454.       ──│         │o    │──────────────────
  8455.         │   ┌─────┴╨──┐ │  Association of
  8456.         │   │         │─┘  Shareware
  8457.         └───│    o    │    Professionals
  8458.       ──────│    ║    │────────────────────
  8459.             └────╨────┘    MEMBER
  8460.  
  8461.  
  8462.  
  8463.  
  8464.  
  8465.  
  8466.  
  8467.        Page 148              AceComm (tm) v 1.81
  8468.  
  8469.  
  8470. Chapter 22  Order Form
  8471.  
  8472.  
  8473.                     AceComm & Utilities (Tm)
  8474.                          Version  1.8
  8475.                           ORDER FORM
  8476.  
  8477. Telephone   (602) 846-4563     AceComm Support Services
  8478. AceComm BBS (602) 846-2940     3003 N. Central Ave Suite 121-171
  8479. CompuServe  75120,3306         Phoenix, AZ  85012  USA
  8480. ================================================================
  8481. Individual Registration Licensing use of AceComm and Utilities
  8482.  
  8483. - commercial version software  & documentation on diskette
  8484. - printed bound manual, upgrade notices)
  8485. - 1 upgrade sent FREE (you choose the version)
  8486. - all future upgrades at very low cost of 20%
  8487.   1'st FREE & all future upgrades include disk/printed manual
  8488.  
  8489. for MS-DOS:   1 Purchase at $45 (includes shipping) . . . ______
  8490. ================================================================
  8491. INTERNAL SITE LICENSE for the use of AceComm & Utilities for DOS
  8492.  
  8493. - commercial version software  & documentation on diskette
  8494. - 1 upgrade sent FREE (you choose the version)
  8495. - all future upgrades at very low cost of 20%
  8496.  
  8497.   Quantity Registrations
  8498.   ----------------------
  8499.      10 - 50 ..         at $32 each, nbr computers ___x 32 _____
  8500.      50+                call for special discount
  8501.      custom features available
  8502.      call for quantity manual pricing
  8503. ================================================================
  8504. Overseas add $7.00/order  for shipping and handling        _____
  8505.  
  8506. Diskette format (choose one)  5.25" disk (__)  3.5" disk (__)
  8507. ================================================================
  8508. TOTAL PRODUCTS                                             _____
  8509.  
  8510.  Sales tax for Arizona residents                   6.5%    _____
  8511.  
  8512. TOTAL ORDER                                                _____
  8513.  
  8514. For payment by non-USA BANK CHECK, add $40.00              _____
  8515.  
  8516. Payment method:                            TOTAL ENCLOSED  _____
  8517.            ( ) Check           ( ) Cash
  8518.            ( ) Money order
  8519.            ( ) Credit card - See instructions in file CREDIT.CRD
  8520.  
  8521.  
  8522.  
  8523.        Page 149              AceComm (tm) v 1.81
  8524.  
  8525.  
  8526. Chapter 22  Order Form
  8527.  
  8528.  
  8529.  
  8530.  
  8531.  
  8532.                     AceComm & Utilities (Tm)
  8533.                          Version  1.8
  8534.                     Credit Card Order Form
  8535.  
  8536.  
  8537.  
  8538.  
  8539.  
  8540.  
  8541.  
  8542.  
  8543.      As a service to AceComm customers who want to register by  credit
  8544.      card,  arrangements  have  been  made  with  the  Public Software
  8545.      Library (PSL) to  handle  all  credit  card  registrations.   PSL
  8546.      accepts Visa, MasterCard, American Express, and Discover Card.
  8547.  
  8548.      Non-U.S.   residents  are  encouraged to register by credit card.
  8549.      In many  cases,  paying  by  credit  card  will  be  easier  than
  8550.      acquiring U.S.  funds.
  8551.  
  8552.      PSL will take the order information and forward it to the AceComm
  8553.      author,   MGP   Programming  Services  &  Michael  G  Phelps  for
  8554.      processing and shipping.
  8555.  
  8556.  
  8557.  
  8558.  
  8559.  
  8560.  
  8561.  
  8562.  
  8563.  
  8564.  
  8565.  
  8566.  
  8567.  
  8568.  
  8569.  
  8570.  
  8571.  
  8572.  
  8573.  
  8574.  
  8575.  
  8576.  
  8577.  
  8578.  
  8579.        Page 150              AceComm (tm) v 1.81
  8580.  
  8581.  
  8582. Chapter 22  Order Form
  8583.  
  8584.  
  8585.  
  8586.                     AceComm & Utilities (Tm)
  8587.                          Version  1.8
  8588.           AceComm Software Credit Card Registration Form
  8589.                     PSL Part number 10805
  8590.  
  8591.  
  8592.  
  8593.  
  8594.      The PSL part number for AceComm is: 10805
  8595.  
  8596.      Credit card registrations may be made by the following methods:
  8597.  
  8598.      -- Phone PSL at:
  8599.         800-242-4775  (Toll free) To register by credit card.
  8600.         713-524-6394  To  register  by  credit  card  and  for   order
  8601.                       inquiries.
  8602.  
  8603.      Be sure to have BOTH the credit card form at the end of this file
  8604.      PLUS the order form in the file ORDERFRM.DOC  available  to  give
  8605.      order information to PSL.
  8606.  
  8607.      ACCURACY in phone ordering is important!  Misspellings can result
  8608.      in delays or an erroneous registration.
  8609.  
  8610.      -- FAX PSL at 713-524-6398
  8611.  
  8612.      -- Email PSL at CompuServe user id 71355,470
  8613.  
  8614.      -- Write PSL at:
  8615.         The Public (Software) Library
  8616.         P.O. Box 35705
  8617.         Houston, TX 77235-5705
  8618.         USA
  8619.         PSL Part number 10805
  8620.  
  8621.      For FAX, email, or mail to PSL, send BOTH the credit card form at
  8622.      the   end   of  this  file  PLUS  the  order  form  in  the  file
  8623.      ORDERFRM.DOC.
  8624.  
  8625.      The Public Software Library also  maintains  a  vast  library  of
  8626.      shareware  and  public  domain  programs  and  prints  a  monthly
  8627.      magazine announcing new releases and general software news.
  8628.  
  8629.  
  8630.  
  8631.  
  8632.  
  8633.  
  8634.  
  8635.        Page 151              AceComm (tm) v 1.81
  8636.  
  8637.  
  8638. Chapter 22  Order Form
  8639.  
  8640.  
  8641.  
  8642.  
  8643.  
  8644.                     AceComm & Utilities (Tm)
  8645.                          Version  1.8
  8646.           AceComm Software Credit Card Registration Form
  8647.                     PSL Part number 10805
  8648.  
  8649.  
  8650.  
  8651.  
  8652.  
  8653.  
  8654.      Please complete this form AND the regular order form in the file
  8655.      ORDERFRM.DOC and send BOTH *** DIRECTLY *** to:
  8656.  
  8657.                         The Public (Software) Library
  8658.                         P.O. Box 35705
  8659.                         Houston, TX 77235-5705
  8660.                         USA
  8661.  
  8662.  
  8663.                                         Date ________________________
  8664.  
  8665.          Name:  _____________________________________________________
  8666.  
  8667.      [Company:] _____________________________________________________
  8668.  
  8669.       Address:  _____________________________________________________
  8670.  
  8671.              :  _____________________________________________________
  8672.  
  8673.              :  _____________________________________________________
  8674.  
  8675.  
  8676.          Payment by:   ( ) MasterCard          ( ) Visa
  8677.                        ( ) American Express    ( ) Discover Card
  8678.  
  8679.  
  8680.      Card #:  ______________________________  Exp. Date:  ___________
  8681.  
  8682.  
  8683.      Signature of card holder: ______________________________________
  8684.  
  8685.      PSL Part number 10805
  8686.  
  8687.  
  8688.  
  8689.  
  8690.  
  8691.        Page 152              AceComm (tm) v 1.81
  8692.  
  8693.  
  8694. Chapter 22  Order Form
  8695.  
  8696.  
  8697.  
  8698.  
  8699.  
  8700.  
  8701.  
  8702.  
  8703. ┌───────────────────────────────────────────────────────────────────────────┐
  8704. │            AceComm (tm)   version 1.81   1/16/94                          │
  8705. │                                                                           │
  8706. │           Copyright (c) 1990-1994 by MGP Software                         │
  8707. ├───────────────────────────────────────────────────────────────────────────┤
  8708. │                                                                           │
  8709. │ AceComm was first released in May of 1993.  The AceComm source code is    │
  8710. │ written in 100% assembly language, using TASM versions 2, and 3.1.  A     │
  8711. │ Windows version of AceComm is well under way, and should be released by   │
  8712. │ March of 94.  All of the generic code written for AceComm DOS version is  │
  8713. │ available to the Windows version.  This allows the two versions to evolve │
  8714. │ together, and operate much the same.                                      │
  8715. │                                                                           │
  8716. │ Registering AceComm gives you access to one of the more powerful and      │
  8717. │ innovative communications programs available.  AceComm registration costs │
  8718. │ just $45.  (includes shipping)                                            │
  8719. │                                                                           │
  8720. │ Your registration package includes the printed bound user manual, which   │
  8721. │ is sure to save you back the registration fee in on line time. AceComm's  │
  8722. │ highly configurational interface provides a progressive path to more      │
  8723. │ efficient on line sessions.                                               │
  8724. │                                                                           │
  8725. └───────────────────────────────────────────────────────────────────────────┘
  8726.  
  8727.  
  8728.  
  8729.  
  8730.