home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Aktief 1995 #3 / CDA3.iso / comm / ace186b.zip / ACECOMM.DOC < prev    next >
Text File  |  1994-04-07  |  299KB  |  10,628 lines

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