home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
DP Tool Club 8
/
CDASC08.ISO
/
VRAC
/
ACE170.ZIP
/
ACE.DOC
< prev
next >
Wrap
Text File
|
1993-09-05
|
206KB
|
5,612 lines
AceComm & Utilities (Tm)
Version 1.7
"Leading Software Technology" for todays hi-speed modem
Evaluation copy 09/05/93
AceComm
AceComm & Utilities User Manual
Version 1.7
Copyright (c) 1990 - 1993 all rights reserved
by
MGP Programming Services & Michael G Phelps
┌─────────┐
┌─────┴───┐ │ (R)
──│ │o │──────────────
AceComm Support Services │ ┌─────┴╨──┐ │Association of
Michael G Phelps │ │ │─┘ Shareware
3003 N. Central Ave Suite 121-171 └───│ o │ Professionals
Phoenix, AZ 85012 USA ──────│ ║ │────────────────
└────╨────┘ MEMBER
Telephone (602) 846-4563 (12 - 7pm MST 6 days)
AceComm BBS (602) 846-2940
CompuServe 75120,3306
CONTENTS
-----------------------------------------------------------------
Chapter 1 INTRODUCTION........................................2
PRESS TEXT.......................................2
FEATURES.........................................4
Chapter 2 QUICK START.........................................5
Chapter 3 TERMINAL AREA.......................................9
Pop Up Reference................................10
Chapter 4 PRM-data MENUS AREA................................12
General Controls................................13
Memory Manager..................................15
Internal Protocol Options.......................17
Dialing Area Options............................18
Terminal Area Options...........................19
Serial Port Setup...............................21
Port Select/Configure...........................22
UART Line Control...............................24
Modem Connect Strings...........................28
Modem Response Strings..........................30
Modem Commands..................................30
Modem Control...................................31
Default Video Emulation.........................32
Key Translation Sequence file (.KTS)............34
Keyboard MACRO Assignments......................35
Directories in Use Menu.........................44
Executable Utilities............................46
Auto Engage Sequence Triggers...................49
Auto Log On Sequence Triggers...................52
Mass Menu Attribute Changes.....................54
Interactive EMSI data...........................56
CONTENTS
-----------------------------------------------------------------
Chapter 5 INTERNAL / EXTERNAL PROTOCOLS......................59
Internal, Defined-External Receiving Units......59
Internal, Defined-External Sending Units........63
Chapter 6 TELEPHONE DIRECTORY AREA...........................67
Chapter 7 INTERNAL FILE LISTER...............................74
Chapter 8 POINT MAIL FUNCTIONS...............................77
Chapter 9 MOUSE SUPPORT......................................79
Chapter 10 ACECOMM DATA FILES.................................80
ACE.PRM / .CTL..................................81
KTS files.......................................81
KBD files.......................................82
REQ/MLF,BCH,SCR,FON files.......................84
Chapter 11 WARRANTY...........................................86
Chapter 12 LICENSE............................................87
Chapter 13 ACECOMM User Support...............................90
Contacting the author...........................90
Chapter 14 Registering AceComm................................91
Page 1 "AceComm & Utilities"(Tm) v 1.7
Chapter 1 INTRODUCTION
PRESS TEXT
AceComm Support Services
Michael G Phelps
3003 N. Central Ave. Suite 121-171
Phoenix, AZ 85012 USA
Telephone (602) 846-4563 (12 - 7pm MST 6 days)
AceComm BBS (602) 846-2940
CompuServe 75120,3306
AceComm & Utilities (Tm) -- Version 1.7
"Leading Software Technology" for todays Hi-Speed Modem
For DOS IBM-PC/clone, monochrome or color video adapter
"AutoScriptGen" (Tm)
"Intelligent Auto Log On Technology" (Tm)
--Ease of Use--
o AceComm's basic setup provides a powerful and potently
complex communications interface, at introductory level.
--Very Configurational--
o Key Translation Sequence customizer (create custom terminal
emulation from keyboard)
o MACRO Language and Keyboard Re-Assignment provide custom
control at any user level. Users may easily re-configure
AceComm's keyboard to imitate other software they have
grown used to.
o Multiple (custom) KeyBoarD definition files are supported
o Custom Keyboards associated to Fon.Record can be loaded on
Dial/Connect
o Colors/Menus/Sounds customizer
--Multi Thread Functions--
o Multi-level MACROS provide Pop-up services inside all
windows
--Full Featured--
o Full mouse support using Microsoft mouse driver
Page 2 "AceComm & Utilities"(Tm) v 1.7
Chapter 1 INTRODUCTION
PRESS TEXT (continued)
specification
o Script Language with AutoScriptGen (Tm)
o Internal protocols Xmodem to 1k, Ymodem to 1k/G, Zmodem to
8k, ASCII text, EMSI/IEMSI
o Color Scroll-Back-Buffer, Screen-Tag, Screen-To-File, Screen
Blank
o Context sensitive help lines, Area sensitive Pop-up
Reference
o Filelister/Utility Area, unlimited external program support
o Unlimited phone directories, FON files can hold up to 5000
records each
Page 3 "AceComm & Utilities"(Tm) v 1.7
Chapter 1 INTRODUCTION
FEATURES
AceComm & Utilities (Tm)
Version 1.7
Copyright (c) 1990 - 1993 all rights reserved
by
MGP Programming Services & Michael G Phelps
Features list
* Auto Engaging Sequence Trigger support
* "AutoScriptGen" (Tm)
* Color Scroll Back Buffer
* Configurational PORT Address/IRQ, RX/TX Buffers
* Context Sensitive On Line Help
* EMSI protocol Point Mail System, FIDO File Requests
* EMS/XMS/DISK SWAP support
* FIFO (16550) UART support
* FON files to 2500 records (1000 in conventional memory)
* FON Import / Conversion / Merge functions
* Highly Configurational User Interface
* IEMSI protocol data handshaking
* "Intelligent Auto Log On Technology" (Tm)
* Internal Memory Manager (smart memory usage)
* Internal Protocols (Ascii, Xmodem, Xmodem1k, Ymodem,
Ymodem1k YmodemG, Zmodem, Zmodem-ZedZap(to 8k)
* Internal Screen Blanker (screen saver)
* Key Translation Sequence customizer
(create custom keyboard emulation)
* Keyboard Re definition
* Macro Programing Language (supports stacking, data args)
* Mouse support for On line character I/O and all menus
* Multiple Phone Directory support
* Screen Tag, File Tag, Line Tag function
* Video Terminal Support for TTY, ANSI, AVATAR
Page 4 "AceComm & Utilities"(Tm) v 1.7
Chapter 2 QUICK START
QUICK START INSTRUCTIONS FOR AceComm & Utilities
Last revised 9/5/93
--Distribution DISK--
The AceComm package is distributed in a compressed format. The
compression utility used with AceComm is the current version of
LHA (this writing LHA213). AceComm package and sub-packages are
compressed as SelF eXtracting "SFX" files. This means the
compressed file "ARCHIVE" uses an .EXE file extension. This SFX
format allows you the user to simply type the name of an
archive. The archive's SFX code will execute, and extract the
files to their un-compressed form.
--Electronic Distribution--
Many BBS systems will store the distributed SFX file inside an
archive envelope of their default archive.
The AceComm BBS provides the AceComm package in ARJ and ZIP
format. SFX files as described above are contained inside the
main package, and are SelF eXtracting.
FAST SETUP
Easiest way to AceComm is to just run INSTALL.BAT. The batch file
will run ACTL.EXE. ACTL.EXE copiles ACE.CTL into ACE.PRM.
ACTL creates subdirectories defined inside ACE.CTL. Directories
defined in the default setup are CAP, FON, FILES, KTS, SCR, and
MAIL. INSTALL.BAT copies FON files into FON, KTS files into KTS,
DOC files into a subdir DOC. INSTALL.BAT then runs ACE.EXE
QUICK SETUP STEPS
Step 1
- Un compress the AceComm package into it's own sub directory.
This example assumes the filename ACE170.EXE
ACE170 means version 1.70
.EXE means AceComm is distributed as a SelF eXtracting
archive (SFX)
Example
At the DOS prompt type: md \ace
At the DOS prompt type: copy ACE170.EXE \ACE
At the DOS prompt type: cd \ace
At the DOS prompt type: ACE170
Page 5 "AceComm & Utilities"(Tm) v 1.7
Chapter 2 QUICK START
The basic setup files will be ready in a sub directory ACE.
Other files that include SFX in the filename and end in .EXE
file extension, are also SelF eXtracting archives. These
files are enhancements to the basic setup.
Step 2
- Read ACTL.DOC (1 page)
- Run ACTL.EXE (complies ACE.CTL into ACE.PRM)
Example ACTL ace.ctl
ACTL.EXE need only be run when creating a new re-initialized
PRM file is desired. All PRM-data is edit able from within
inside AceComm.
Note: AceComm will invoke ACTL.EXE directly when no ACE.PRM
file is found in the start up directory.
Step 3
- Run ACE.EXE
At the DOS prompt type: ACE
- OPTIONAL -
Not required for QUICK START
After having become familiar with AceComm, you may decide to edit
ACE.CTL for some personal defaults. This will allow future
compilations to use your custom setup instructions.
ACE.CTL can store personal and custom setup data for times when
a new ACE.PRM file is generated. This will be most used when
upgrading AceComm versions.
The following are enhancements to the AceComm package
a) FON_SFX.EXE
FON_SFX contains several sample .BBS, FON, and .NOD files.
It is suggested that FON_SFX be un-compressed inside a
sub directory to the AceComm directory
Example: C:\ACE\FON
Page 6 "AceComm & Utilities"(Tm) v 1.7
Chapter 2 QUICK START
At the DOS prompt type: md \ace\fon
At the DOS prompt type: copy FON_SFX.EXE \ace\fon
At the DOS prompt type: cd \ace\fon
At the DOS prompt type: FON_SFX
At the DOS prompt type: cd \ace
NOTE: ACTL creates these directories if defined in ACE.CTL and
not found.
b) KTS_SFX.EXE
KTS_SFX contains the KTS files included in the default setup,
as well as the ascii versions. Ascii version KTS files share
the filename with KTS files, but use .ASC extension.
It is suggested that KTS_SFX be un-compressed inside a
sub directory to the AceComm directory
Example: C:\ACE\KTS
At the DOS prompt type: md \ace\kts
At the DOS prompt type: copy KTS_SFX.EXE \ace\kts
At the DOS prompt type: cd \ace\kts
At the DOS prompt type: KTS_SFX
At the DOS prompt type: cd \ace
(.KTS files are the Key Translation Sequence files for
terminals) This file contains ascii versions of .KTS files.
ASC files are compiled into KTS files using KTS.EXE.
c) UTIL_SFX.EXE
UTIL_SFX contains several utilities that enhance the AceComm
package. Each utility has it's .DOC file.
It is suggested that UTIL_SFX be un-compressed inside a
sub directory to the AceComm directory
Example: C:\ACE\UTIL
At the DOS prompt type: md \ace\util
At the DOS prompt type: copy UTIL_SFX.EXE \ace\util
At the DOS prompt type: cd \ace\util
At the DOS prompt type: UTIL_SFX
At the DOS prompt type: cd \ace
CBF.EXE can compile direct FBL output into a FON file. 'CBF
1_114.BBS'
Page 7 "AceComm & Utilities"(Tm) v 1.7
Chapter 2 QUICK START
IDX.EXE creates a very small index file so that AceComm can
use a RAW NODELIST file for mailer mode/file requests.
FBL.EXE creates a .BBS and .NOD file from the raw nodelist for
a given NET HOST
KTS.EXE compiles a Key Translation Sequence file from ascii to
binary format.
ANSI.EXE filters ANSI and AVATAR video control sequence codes
from files. ANSI.EXE can also be used to view the files.
Custom colors, sounds, etc.
- See bottom of ACE.CTL file.
- See MASS MENU area inside PRM-data editor (inside
AceComm)
Multiple .FON files
- Selectable from inside the FON LIST AREA
Page 8 "AceComm & Utilities"(Tm) v 1.7
Chapter 3 TERMINAL AREA
----------------------------------------------------------------
│Configure│Dialer│Files│Scroll_Back│Snapshot│Dnload│Upload│Shell
OK AceComm Copyright (c) 1990-1993 by MGP Programming & Michae
AceComm (Tm) Version 1.60, made in USA
OK Evaluation copy 07/22/93
...
AceComm ▒ 2,19200L,7E1 ▒ Av/An ▒ 08:06:48am ▒ ALT-V =PopUp Ref,
----------------------------------------------------------------
AceComm begins presenting to the user it's TERMINAL Area.
If a mouse is detected, the top row of the screen will contain
a 1 line mouse menu.
TERMINAL is the area in which all other areas are accessible, and
where serial I/O takes place for the user. Above is a sample of
the AceComm TERMINAL screen upon start up. A status line is
present, when it's flag is SET(default). If on line, the
'AceComm' would be replaced with 'CARRIER, and other information
particular to the current setup, and host. Note the 'L' after
baud(19200) indicates LOCK BAUD is SET. 'AV/AN' indicates the
current active VIDEO EMULATION.
Hold down the ALT key for a Pop Up Reference to key-combos
available from the TERMINAL area. Releasing the ALT key and the
POP-UP REFERENCE disappears. The Pop Up Reference menu is called
using the <ViewKeyCombos_> MACRO. ALT-V is assigned the
<ViewKeyCombos_> MACRO in AceComm's default keyboard setup
ACE_DEF.KBD file. The default Keyboard is completely re
definable by re-defining the KEY-COMBO a different MACRO(S) (see
below)
Page 9 "AceComm & Utilities"(Tm) v 1.7
Chapter 3 TERMINAL AREA
Pop Up Reference
(TERMINAL screen below with POP UP REFERENCE)
╔═Current KBD MACRO(S) Assignments════════════════════════════
║>ALT-A Script Learn
║ ALT-B Scroll Back Buffer
║ ALT-C Capture File
║ ALT-D Phone Dir/Dialer
║ ALT-E <AutoAnswer> ON
║ ALT-F File Lister/Utility
║ ALT-G EMSI File Request
║ ALT-H Hangup Modem
║ ALT-I <LocalEcho> On <SendEMSI_ICI> <LocalEcho> Off
║ ALT-J COMMAND SHELL
║ ALT-L <RunProgram> list
║ ALT-O Configuration Area
║ ALT-P Configuration Area
║ ALT-R Run Script File
║ ALT-S Screen SnapShot
║ ALT-T Screen TAG
║ ALT-V Pop Up Key Reference
║ ALT-X <EndAceComm> 0
║ ALT-Y <AutoAnswer> Off
║ ALT-Z <ClearWindow>
║ -----------------------------------------------------------
╚═══>PgDn< Display Template Quit Help ┤<>v^├═══════════════
o The AceComm keyboard is macro driven
o The Popup Reference displays each key press that has been
assigned to a MACRO, or MACROS.
o Current .KBD file is displayed, AceComm supports unlimited
.KBD files. Current .KBD filename is always displayed at the
right side of the Terminal Area's status line.
AceComm's Keyboard is re definable. Each key press can be re
assigned a different function, or set of functions. To
accomplish keyboard re definition, AceComm uses descriptive
text symbols called MACROS. MACROS are enclosed inside of
angled brackets.
The Pop Up Reference menu displays the current .KBD file's
MACRO(S) assignments. A .KBD file contains a copy of all
key-press MACRO(S) assignments. AceComm supports unlimited .KBD
Page 10 "AceComm & Utilities"(Tm) v 1.7
Chapter 3 TERMINAL AREA
Pop Up Reference (continued)
files. Each key press combination can be assigned a MACRO(S).
AceComm allows the user to re define the keyboard functions if so
desired. AceComm provides a rich set of MACRO functions for all
of AceComm's internal functions. A complete MACRO list with
descriptions is contained in the MACRO.DOC file.
- PgDn or <CR> will display the next key set at top of screen.
- Display toggles the display from a text description and
the actual macro assignments
The key press is displayed to the left, with it's MACRO
assignment to the right. The example below shows the MACRO for
AceComm's configurations area is assigned to ALT-P.
ALT-P <PrmDataMenus_> <= MACRO assign
ALT-P Configuration Area <= descriptive text
- Template allows you to print a list of keys that have MACRO
assignments. The default filename is "PRN". You may find it
handy to print to a FILE, (key.prn) or similar, this way you
can format the TEMPLATE, for a more custom print job.
Page 11 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
╔═D:\ACE\ACE.PRM══════════════════╗
║>General Controls/Menus ║
║ Serial Port/Modem Setup ║
║ KeyBoarD MACRO Assignments ║
║ Directories in Use Menu ║
║ Executables Menus ║
║ Auto Engage Sequence Triggers ║
║ Auto Log On Sequence Triggers ║
║ Menus / Colors ║
║ Interactive EMSI data ║
║ Point Mail Setup ║
║ AutoSave is ON ║
║ Print ACEORDER.FRM ║
╚═══ Select Quit Help ┤<>v^├════╝
o MACRO for this menu is: <PrmDataMenus_>
(default assignment is to both ALT O & ALT P)
o All PRM-data changes are auto-saved when Auto-Save flag is
"ON"
o Each sub-menu contains context sensitive HELP
Virtually any data contained inside the ACE.PRM file is
accessible and configurational from the PRM-data area. Above is
the menu you will see after pressing key-combo <PrmDataMenus_> is
assigned to from the TERMINAL area.
Notice the second to bottom line of text in the menu says
"AutoSave ON". AutoSave can be toggled On/Off from inside the
"General Controls" menu. When ON, changes made from inside the
PRM-data menus are saved to ACE.PRM automatically. If AutoSave
has been toggled OFF, the "AutoSave ON" is replaced on the menu
with "Save Changes" and this menu item must be selected for
changes to be kept past exiting AceComm. Note: If you toggle
"AutoSave" to Off, you will select the "Save Changes" option
before exiting AceComm, if you want the toggled option to remain
toggled. Otherwise, AceComm will be back to "AutoSave" when
re-started.
Page 12 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
General Controls
╔═General Controls/Menus════════════════════════╗
║ Allow enhanced keyboard detection Yes ║
║ Allow mouse detection Yes ║
║ Mouse horizontal sensitivity 6 ║
║ Mouse vertical sensitivity 4 ║
║ Auto Save Changes On ║
║ Snow (vertical retrace) checking Off ║
║ Screen Saver timeout value (minutes) ║
║ Keep Log file On ║
║ All Sounds Override Switch <> Sounds are On ║
║═Sub Menus═════════════════════════════════════║
║>Control Memory Use ║
║ Internal Protocol Options ║
║ Dialing Options ║
║ Terminal Area Options ║
╚═══ Edit Quit Help ┤<>v^├════════════════════╝
o The controls are enable/disable flags, some of which can
also contain a value for timers.
o Sub menus contain more categorized controls
Most controls are a series of flags which tell AceComm when to
use some of the features, and when not to. Flags with the ON/OFF
status are toggles, and will be toggled here in this menu.
Notice the "Screen Saver" flag description contains the number 5,
rather than an ON/OFF. Selecting Screen Saver mode 0 = OFF.
- Allow enhanced keyboard detection Yes
AceComm will detect and use enhanced BIOS keyboard functions.
Some systems may not fully support this mode properly. This
flag allows locking out AceComm's use of enhanced BIOS
keyboard functions.
- Allow mouse detection Yes
Setting this to "NO" will cause AceComm to act as if a mouse
is non existent, the mouse driver is never initialized, no
mouse menu is presented in the Terminal Area.
- Mouse horizontal sensitivity 6
Mouse sensitivity is already set in the mouse driver. This
Page 13 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
General Controls (continued)
value is internal to AceComm only
- Mouse vertical sensitivity 4
Mouse sensitivity is already set in the mouse driver. This
value is internal to AceComm only
- Auto Save Changes On
When "ON" AceComm will save PRM-data changes to the ACE.PRM
file. When "OFF" the prompt inside the main PRM-data menu must
be selected for PRM-data changes to be recorded to file. This
pertains to actual PRM-data below the menu system data. Menu
area attributes are ALWAYS SAVED, with exception to "Mass Menu
Area" changes, these must be affected using the appropriate
selection from inside "Mass Menu".
- Snow (vertical retrace) checking Off
AceComm uses direct video buffer writes for all it display
areas. Most areas will be able to handle SNOW CHECKING
properly before making screen updates.
- Screen Saver timeout value (minutes) 5
Screen Blanking function.
Screen Saver can be set from 0 - 10. Values above 0 are
minutes without a key press to AceComm blanking the screen.
Screen is restored with a key press. Un-blank-key-press is
valid. Use ALT alone for non-destructive key press to un-blank
the screen.
See also "Screen Saver if Data Carrier Detect" from Terminal
Area Options menu.
- Keep Log file On
Toggle AceComm use logging ON/OFF.
- All Sounds Override Switch <> Sounds are Off
Toggle, enable/disable all sounds. Master override.
Page 14 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Memory Manager
----------------------------------------------------------------
░░░░ AceComm (Tm) Version 1.7 -- Copyright (c) 1990-1993 by Mich
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░╔═D:\ACE\ACE.PRM══════════════════╗░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░║╔═General Controls/Menus════════════════════════╗────────────
░░░║║ Allow enhanced keyboard detection Yes ║re help from
░░░║║ Allow mouse detection Yes ║helps:
░░░║║ Mouse horizontal sensitivity 6 ║846-4563 12-
░░░║║╔═Control Memory Use═══════════════════════╗ ║846-2940 24
░░░║║║>XMS (kb) ok to use 64 ║ ║ User ID 751
░░░║║║ Scroll Back (kb) to use 64 ║f ║DRESS 1:114/
░░░║║║ Swap for <RunProgram> On ║ ║MM, ACECOMM
░░░║║║ Swap for <CommandShell_> On ║ ║e ACECOMM ec
░░░║║║═Current Memory Use═══════════════════════║ ║ it makes BA
░░░║║║ XMS allocated 65536 ║═══║
░░░║║║ XMS free at load 2424832 ║ ║ Support Ser
░░░╚║║ ACE.EXE load 227040 ║ ║ G Phelps
░░░░║║ Scroll Back allocated 65536 ║ ║ Central Ave
░░░░║║ PRM file allocated 36025 ║ ║, AZ 85012
░░░░╚║ Rx buffer allocated 8192 ║═══╝────────────
░░░░░║ Tx buffer allocated 256 ║░░░░░░░░░░░░░░░░
░░░░░╚═══ Select Quit Help ┤<>v^├═════════════╝░░░░░░░░░░░░░░░░
Allow internal memory manager swap to XMS (only needs 64k at pre
-----------------------------------------------------------------
o With version 1.7, AceComm begins managing memory usage.
o AceComm can swap the scroll back buffer memory to XMS prior
to allocating large chunks of memory for other operations.
o EMS will be supported in the next release.
o XMS and EMS are supported for the SWAP functions.
- XMS (kb) ok to use
AceComm's internal memory manager can save overall memory
requirements by swapping some internal data to XMS memory when
about to perform another memory hungary task.
- Scroll Back (kb) to use
Up to 64 kb (64 x 1024) memory can be used for the back
buffer.
Future versions of AceComm will begin allowing multiple
64 kb memory be used for scroll back buffer.
Page 15 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Memory Manager (continued)
The first 64 kb memory is conventional memory.
- Swap for <RunProgram> On
XMS, EMS, DISK swapping for the AceComm executable will take
place when this flag is set "ON". When SWAPPING is active,
AceComm 's SIO is deactivated while <RunProgram> MACRO is
active.
Notes: AceComm is currently using Ralf Brown's SWAP functions
for the SWAP service. SWAP is the only code inside
AceComm executable that is not written entirely by MGP
Programming Services. SWAP has proven to be the most
dependable code of this type that has been tested in our
executable files. MGP Programming Services would like
to thank Ralf Brown for permission to use his SWAP code
in our products.
- Swap for <CommandShell_> On
XMS, EMS, DISK swapping for the AceComm executable will take
place when this flag is set "ON". When SWAPPING is active,
AceComm 's SIO is deactivated while <CommandShell_> MACRO is
active.
Notes: The Notes for <RunProgram> apply to this MACRO
Page 16 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Internal Protocol Options
╔═Internal Protocol Options════════════════╗
║>Auto Engage On ║
║ File Resume On ║
║ Bell after internal protocol 3 ║
║ Time release from protocol Off ║
╚═══ Select Quit ┤<>v^├═══════════════════╝
- Auto Engage On
Activate/deactivate AutoD sequence triggers & Associated AutoM
MACROS.
- File Resume On
For internal Zmodem. Resume "ON" existing files, data is
appended to the file, "OFF", the file is created new, any
existing file of the same name is over written.
- Ring bell after internal protocol 3
Internal protocols will sound an alarm before returning to
Terminal Area. A value of "0" disables any sound after
internal protocols. A value of "1" plays a Victory tune.
Values from 2-30 become seconds to sound the internal bell.
See also <RingBell> 5 MACRO
- Time release from protocol Off
Time slices for Windows/ OS/2, DV, and DOS are supported.
This flag applies to the DV and DOS time releases.
Releasing time to Windows/ OS/2 using the interrupt 2fh
function causes so many missed interrupts that AceComm
never releases int 2fh time slices during an internal
protocol function.
Time slices are otherwise given up generously.
Page 17 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Dialing Area Options
╔═Dialing Options═══════════════════════════════╗
║>Inter byte delay 1 ║
║ Modem Response Timeout when dialing 60 ║
║ Seconds between re dials 1 ║
║ Ring BELL on Dial/Connect 1 ║
╚═══ Select Quit ┤<>v^├════════════════════════╝
- Inter Byte Delay 1
Add (value x 55 millisecond) delay between modem command
characters. With a value of '0' modem command strings are sent
just as fast as the UART's Transmit Hold Register is Empty
(THRE). (I've observed Supra modems behave much better using a
value of 1 for inter byte delay when in continuous re-dial)
- Modem Response Timeout when dialing 60
Master timeout when dialing. Overrides your modem's own S7
register.
Notes: It may be best to set this value several seconds above
your modem's S7 register.
- Seconds between re dials 1
AceComm will pause this many seconds between receiving a modem
response string, or timing out, and sending the next dial
string to the modem. The variable can be toggled from 0
seconds to 90 seconds.
- Ring BELL on Dial/Connect 1
Seconds to ring BELL on successful detection of either DCD or a
connect message response from the modem.
Page 18 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Terminal Area Options
╔═Terminal Area Options═══════════════════════════╗
║>Status line On ║
║ Mouse menu Yes ║
║ Screen Saver if Data Carrier Detect No ║
║ Terminal Area screen color (TTY mode) 7 ║
║ Drop DTR when quitting ACECOMM No ║
║ Log modem response while off line Yes ║
║ Strip high bit from incoming Off ║
║ Default Video Emulation Av/An ║
╚═══ Edit Quit Help ┤<>v^├══════════════════════╝
- Status line On
Toggle AceComm 's STATUS LINE On/Off
Notes: AutoScrGen (Tm) will assert the STATUS LINE, and restore
it on when through. The RunScript function will do the
same.
- Mouse Menu Yes
Display 1 line mouse menu on Terminal Area screen
- Screen Saver if Data Carrier Detect No
Screen Blanking service disabled during modem status DCD bit
detected to be ASSERTED.
- Terminal Area screen color (TTY mode) 7
This setting allows changing the Terminal Screen color that is
initially active when AceComm is started. The color will
remain constant through TTY video emulation.
- Drop DTR when quitting AceComm No
AceComm will or will not drop DTR when the <EndACECOMM> [n]
MACRO is run. Most modems will by default, drop carrier along
with a drop in DTR. DTR is a bit in the modem control register
of the UART. Setting this to "YES" will cause AceComm to drop
DTR when ever <EndACECOMM> [n] MACRO is executed.
- Log modem response while off line No
AceComm can log modem response strings that come in. This flag
will tells AceComm if it should log the responses. This is for
off line only. This flag is most use full when you want to
know when your phone rings, AceComm will TIME STAMP PRM-data
Area MDM_RESPONSE_RING responses strings. Many modem ROMS are
Page 19 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Terminal Area Options (continued)
now featuring caller ID. Modems that have caller ID ability
will be able to present to the terminal screen the caller ID
info, if available. This information will also be logged along
with the TIME STAMPED "RING".
- Strip high bit from incoming Off
"Off" data received from the modem is un altered. "ON" data
is stripped of any bits above the decimal value 128.
- Default Video Emulation Av/An
This selection brings up another menu. The menu displays the
available video terminal emulation modes. Along with their
associated KTS files. This setting affects the default video
terminal setting for AceComm. Individual FON RECORDS contain
their own video terminal settings.
Page 20 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Serial Port Setup
╔═══Serial Port/Modem Setup═══════════╗
║>Port Number Select 1 ║
║ Line Control Setup 19200L,8N1 ║
║ Modem Connect Strings ║
║ Modem Response Strings ║
║ Modem Command Strings ║
║ Modem Control Setup ║
╚═ Select Quit ┤<>v^├═════════════════╝
o The "Serial Port Setup Menu" contains sub-menus for all of
AceComm's serial port and serial port related configurations.
o Information presented to the right of menu selections are
current settings. The 'L' appended to BAUD indicates LOCK BAUD
is SET "ON".
Page 21 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Port Select/Configure
╓───Serial Port Setup──────────────────╖
║╓─Port Address IRQ Detected ───────╖
║║>1 03F8h 4 Yes ║
║║ 2 02F8h 3 In use ║
║║ 3 03E8h 4 Yes ║
║║ 4 02E8h 3 No ║
║║ 5 0230h 4 No ║
╙║ 6 0238h 4 No ║
║ 7 0240h 4 No ║
║ 8 0248h 4 No ║
║─ Other stuff ───────────────────────────────║
║ RBuf 8192 ║
║ TBuf 256 ║
║ FIFO trigger 14 ║
║ Chain IRQ Off ║
║ TX Off ║
║ CTS/RTS On ║
║ XON/XOFF On ║
╙─│Install│ Edit Quit Help ┤<>^v├───────────╜
Port numbers are merely symbolic for identification. Port
addresses and the Interrupt ReQuest line for the address is
configurational.
- Install option, AceComm will close the active port and install
it's SIO on the port selected. MDM_INIT string is sent to
modem.
- Edit option, you will be prompted for port address and IRQ.
Address is a HEX number. Entering a decimal value will fail.
- Rbuf/Tbuf are the buffer size used for serial I/O. Normally
there won't be any advantage to raising the TBuf size. RBuf
size will be adequate at about 1024 bytes for all normal use.
The larger value (default) will allow storage of incoming
during Back buffer, Tagger etc. RBuf range is from 1k to 32k,
TBuf 128 bytes to 32k. The Zmodem sending unit's window size
is equal to TBuf size. Window size is not data-frame size.
Window size means "how much data do we let build up into the TX
buffer at any one time. RBuf/TBuf can be changed at any time,
on line or not. It is recommended that the HOST be still when
re-sizing RBuf/TBuf. RBuf/TBuf changes take immediate affect.
Page 22 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Port Select/Configure (continued)
- FIFO trigger is the number of bytes buffered before a First In
First Out UART chip will alert the CPU by way of interrupt.
FIFO UART operation is automatically enabled when a FIFO UART
is detected. AceComm always checks for FIFO UART presence
whenever installing onto a PORT. FIFO trigger level changes
take immediate affect. Trigger level of "1" affectively
disables the FIFO affect.
- Chain IRQ "share IRQ" will cause AceComm 's SIO ISR to pass on
the interrupt request to the Interrupt Service Routine which
was present on the IRQ when AceComm installed onto the port.
The Chain IRQ toggle takes immediate affect. IRQ sharing is
not supported by -most- I/O cards. Use the option at your own
risk. Notes: IRQ sharing may appear to work properly on your
setup, even though your hardware was not designed for IRQ
sharing to take place. There are some good technical points to
be made for degradation that may be caused in the I/O cards,
when forced to drive the IRQ line HIGH, while another is doing
it's best to pull the same IRQ line LOW.
- TX is a flag that tells AceComm to use interrupt driven
output. Interrupt driven input is always on. The TX toggle
takes immediate affect. If you FAST computer/modem setup is
capable of overwhelming the other end when sending data,
toggling TX "OFF" may improve the situation.
- CTS/RTS hardware handshaking / FLOW control Hardware
handshaking may normally be left ON (default). High speed
modems using fast data rates and typically locked port rates
will require software to use FLOW control.
- XON/XOFF software handshaking / FLOW control Many HOST software
will recognize XON/XOFF FLOW control. You may need software
handshaking enabled for proper FLOW control while performing
ascii uploads.
Notes: AceComm uses FLOW control flags (above) primarily to
detect when not to send data to the modem.
AceComm will automatically use both forms of FLOW
control when it detects the receive buffer getting
full.
Page 23 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
UART Line Control
╔═══ Serial Port Setup Menu ═══════════╗
║ Port Number Select 1 ║
║╔═ UART Line Control ═══════════════╗ ║
║║>Data Bits 8 ║ ║
║║ Parity None ║ ║
║║ Stop Bits 1 ║ ║
║║ Max/Lock Baud Rate 19200 ║ ║
║║ Lockbaud On ║ ║
╚╚═ Select Quit Help ══════════════╝═╝
The UART's line control register can be set for several different
data arrangements. Most common being 8 data bits, no parity bit,
1 stop bit. Most BBS systems will use the 8N1 configuration.
The UART uses the line control information when assembling
incoming bits into a byte. Setting this information from the
PRM-data area, the format is stored in the default settings for
AceComm to use. When you look at the FON directory records you
will see that each record stores it's personal line control
setting to be used when dialing the record. Data format is saved
with each individual record in the record's .FON file. When
using AceComm in HOST mode the default setting will be used.
AceComm retains the default line control register setting in the
ACE.PRM file. FON record line control settings are stored in
their respective .FON files.
BAUD rate is also something that will normally be attached to a
FON record and used when dialing the record. This is of more
concern to users of modems that do not allow LOCKING the port.
LOCK BAUD is almost always available as an option when using a
modem that can support CONNECT rates above 2400 baud. When using
the LOCK BAUD option, AceComm will leave the port speed alone
when dialing. The modem handles speed translation between
'connect' and 'computer'. LOCK BAUD ON is generally preferable
with modems that support it. The status displays will reflect
'L' appended to the baud rate when LOCK BAUD is set ON. NOTE:
the 'L' is not appended in the Line Control Window's display
above.
Page 24 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
UART Line Control (continued)
╔═══ Serial Port Setup Menu ═══════════╗
║ Port Number Select 1 ║
║╔═ UART Line Control ═══════════════╗ ║
║║╔═ Data Bits ═══════════════════════╗║
║║║>5 ║║
║║║ 6 ║║
║║║ 7 ║║
║║║ 8 ║║
╚╚╚═ Select Quit ════════════════════╝╝
╔═══ Serial Port Setup Menu ═══════════╗
║ Port Number Select 1 ║
║╔═ UART Line Control ═══════════════╗ ║
║║ Data Bits 8 ║ ║
║║╔═ Parity ══════════════════════════╗║
║║║>None ║║
║║║ Odd ║║
║║║ Even ║║
╚╚║ Mark ║╝
║ Space ║
╚═ Select Quit ════════════════════╝
╔═══ Serial Port Setup Menu ═══════════╗
║ Port Number Select 1 ║
║╔═ UART Line Control ═══════════════╗ ║
║║ Data Bits 8 ║ ║
║║ Parity None ║ ║
║║╔═ Stop Bits ═══════════════════════╗║
║║║>1 ║║
║║║ 2 ║║
╚╚╚═ Select Quit ════════════════════╝╝
- Data Format
Stop bits, Parity, Data bits. Each character that comes in the
serial port arrives as a series of BITS. The BITS are
assembled in your serial port's UART's SERIAL DATA UNIT SDU).
AceComm's default setting of 8 data bits, no parity, and 1 stop
bit is the most popular arrangement, and that which most BBS
systems use. You will change the Data Format when necessary
for connecting with systems that don't use the standard 8N1.
Page 25 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
UART Line Control (continued)
----------------------------------------------------------------
░░░ AceComm (Tm) Version 1.7 -- Copyright (c) 1990-1993 by Micha
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░╔═D:\ACE\ACE.PRM══════════════════╗░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░║ General Controls/Menus ║░░░┌──────────────────────
░░░║╔═══Serial Port/Modem Setup═══════════╗To Get more help fro
░░░║║ Port Number Select 1 ║Michael Phelps:
░░░║║╔═UART Line Control═════════════════╗ ║OICE 602 846-4563 12
░░░║║║ Data Bits 8 ║ ║BS 602 846-2940 24
░░░║║║ Parity None ║ ║OMPUSERVE User ID 75
░░░║║║ Stop Bits 1 ║ ║IDONET ADDRESS 1:114
░░░║║║╔═Baud Select═══════════╗ ║ ║IDONET COMM, ACECOMM
░░░║╚║║ 300 ║ ║═╝distribute ACECOMM e
░░░║ ╚║ 1200 ║├════════╝NODES until it makes B
░░░║ A║ 2400 ║ ║░░░│-Write to:
░░░║ P║ 4800 ║ ║░░░│ AceComm Support Se
░░░╚══║ 9600 ║├════╝░░░│ Michael G Phelps
░░░░░░║>19200 ║░░░░░░░░░░│ 3003 N. Central Av
░░░░░░║ 38400 ║░░░░░░░░░░│ Phoenix, AZ 85012
░░░░░░║ 57600 ║░░░░░░░░░░└──────────────────────
░░░░░░║ 115200 ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░░░░╚═ Select Quit Help ══╝░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
----------------------------------------------------------------
o Connect speeds such as 12000, 14400 etc. are not actual
data rates that the UART (serial port) can be set to.
o Modems capable of connecting at 9600 and above can usually be
used with a "Locked port"
o Setting the Baud rate to 19200 for a 9600 baud modem will
allow better performance when down loading data.
o Locking the port means selecting a baud rate higher than the
highest connect speed the modem is capable of, and telling the
communications software to lock it there.
o Using a locked port requires your modem be in full handshake
mode.
"Selecting your highest port speed when LOCKing the port"
Page 26 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
UART Line Control (continued)
Locking the port at 57600 with a high speed modem causes the
UART to assemble a character off the bit stream VERY quickly.
If you experience serial input errors with HIGH locked rates,
drop down to 38400 or even 19200. The lower rate will cause
the UART to make characters available at a reduced speed. For
instance a 12 MHZ AT will probably experience data overruns
using a locked port above 19200 when down loading TEXT files
with ZMODEM.
A common miss-conception is when CRC errors occur with HIGH
LOCKED PORT rates, that it is the UART unable to keep up. This
is simply not true. The UART/modem combo is capable of out
running the computer/software combo. When using a TASK
switcher such as WINDOWS or DESQVIEW, a lower PORT RATE such as
19200 may very well be needed for efficient data transfers.
The idea is to set the port to a speed that the
computer/software combo is capable of responding to quickly
enough.
Page 27 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Modem Connect Strings
╓─D:\AC╓─Modem Connect Strings────╖
║ Gene║>CONNECT ║
║ Term║ CONNECT 1200 ║
║>╓───S║ CONNECT 2400 ║──────╖
║ ║ Por║ CONNECT 2400/ARQ ║ ║
║ ║ Lin║ CONNECT 4800 ║8N1 ║
║ ║>Mod║ CONNECT 9600 ║ ║
║ ║ Mod║ CONNECT 9600/ARQ ║ ║
║ ║ Mod║ CONNECT 14400/ARQ ║ ║
║ ║ Mod║ CONNECT 16800/ARQ ║ ║
║ ╙─ Se║ CONNECT 19200 ║──────╜
║ Prin║ CONNECT 38400 ║
║ Auto║ CONNECT 57600 ║
╙─── Se║ CARRIER ║
║ CARRIER 9600 ║
║ CARRIER 12000 ║
║ CARRIER 14400 ║
║ CARRIER 16800 ║
║ CARRIER 19200 ║
║ CARRIER 28800 ║
╙─ Edit Quit ─────────────╜
o There is no order of sequence for these strings
o Connect strings will allow non-locked ports "auto adjust"
AceComm will detect a connection after dialing, a few seconds
quicker when able to match a connect string with the modem's
connect message.
High Speed modem users may configure the modem for more than 1
connect message to be returned from the modem. AceComm need only
detect 1. The connect string fields are freely configurational,
and follow no specific order. Leave them, or edit them as needed
any way you see fit.
AceComm will fall out of re-dial on detection of CARRIER. For
the LOCK BAUD users, this detection is right away. For those who
use modems that don't allow port LOCKING, and want auto baud rate
adjustment to match the connect, CARRIER is checked only after
the dialing has timed out. AceComm will be trying it's best to
get a CONNECT string so that the baud can be verified.
Page 28 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Modem Connect Strings (continued)
╔═════════ACE.PRM Data Edit-Menus═══════╗
║ General Controls ║
║╔═══ Serial Port Setup Menu ═══════════╗║
║║ Port Number Select 1 ║║
║║ Line Control Setup 19200L,8N1 ║║
║║ Modem Connect Strings ║║
║║╔═Modem Response Strings════════════════════════╗
║║║>MDM_RESPONSE_OK OK ║
║║║ MDM_RESPONSE_RING RING ║
║║║ MDM_RESPONSE_NO_CARRIER NO CARRIER ║
╚╚║ MDM_RESPONSE_ERROR ERROR ║
║ MDM_RESPONSE_NO_DIAL_TONE NO DIAL TONE ║
║ MDM_RESPONSE_BUSY BUSY ║
║ MDM_RESPONSE_NO_ANSWER NO ANSWER ║
║ MDM_RESPONSE_RINGING RINGING ║
║ MDM_RESPONSE_VOICE VOICE ║
╚═ Edit Quit ══════════════════════════════════╝
o AceComm uses text response strings only
Modem response strings are normally UPPER CASE. Response strings
are used by AceComm when dialing to more quickly respond to BUSY,
NO CARRIER etc. HOSTMODE will be waiting for a RING code.(1) The
Response strings that can be matched while dialing are displayed
in the DIAL WINDOW as they come in.
(1) HOSTMODE also uses the UART's modem status register RI bit
when detecting "RING".
Page 29 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Modem Commands
╔═════════ACE.PRM Data Edit-Menus═══════╗
║ General Controls ║
║╔═══ Serial Port Setup Menu ═══════════╗║
║║ Port Number Select 1 ║║
║║ Line Control Setup 19200L,8N1 ║║
║║ Modem Connect Strings ║║
║║ Modem Response Strings ║║
║║╔═══Modem Command Strings════════════════════════════════╗
║║║>Init ATZ^M~~~~ATES7=40 ║
║║║ Dial Prefix ATEQ0X4DT ║
╚╚║ Dial Suffix ║
║ Answer ATA ║
║ Hang up +++~~~~~ATH0 ║
║ Off hook ATH1 ║
║ Abort ^M ║
║ Reset ATZ ║
║ Command Echo ATE1 ║
║ Host Init ATE ║
║ Cmd Terminator ^M ║
╚═══ Edit Select Quit ═════════════════════════════════╝
o Cmd Terminator is automatically appended to modem command
strings.
Here we have the modem commands AceComm uses to interact with
your modem. Please note the bottom of the menu contains the "Cmd
Terminator". AceComm appends this to all modem commands
automatically. Notice that "Init" has a ^M followed by ~~~~ and
another command. This is an example of command stacking.
'^' is an escape character AceComm recognizes and translates byte
following into control characters. ^M translates into a carriage
return, <CR>, (13d). A character following '^' is either upper
case or made upper case by AceComm, then subtracted by 64
converting 'A' to 1 etc.
'~' translate into 1/4 second delays.
AceComm modem command lines are limited to 40 characters in
length, including the Cmd Terminator. This is a standard maximum
command length used by modem manufacturers.
Page 30 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Modem Control
╔═════════ACE.PRM Data Edit-Menus═══════╗
║ General Controls ║
║╔═══ Serial Port Setup Menu ═══════════╗║
║║ Port Number Select 1 ║║
║║ Line Control Setup 19200L,8N1 ║║
║║ Modem Connect Strings ║║
║║ Modem Response Strings ║║
║║ Modem Command Strings ║║
║║╔═ Modem Control════════════════════╗ ║║
║║║>DTR On ║ ║║
╚╚║ RTS On ║═╝╝
║ GPO1 Off ║
║ GPO2 On ║
║ Loopback Off ║
║═Modem Status══════════════════════║
║ CTS On ║
║ DSR On ║
║ RI Off ║
║ DCD Off ║
╚═ Select Quit ════════════════════╝
--Modem Control--
o GPO2 must be set "ON" for interrupt to seen by the computer
o Normal operation requires LOOPBACK be left "OFF"
These controls are available for experienced users. The "Modem
Control" menu will allow setting or re-setting each of the bits
listed. If you want interrupts to continue to be recognized you
shall make sure and leave GPO2 "ON". GPO2 "OFF" will disable
interrupts for the port, and AceComm will not function properly.
Same with Loop back. If in doubt, you can use the above snapshot
as a reference to correct bit setting of the modem control
register.
--Modem Status--
o DSR will normally be SET when a modem is powered up. AceComm
will alert the user on DSR not SET when installing on a port.
Page 31 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Default Video Emulation
╔═════════ACE.PRM Data Edit-Menus═══════╗
║ General Controls ║
║╔═══ Serial Port Setup Menu ═══════════╗║
║║ Port Number Select 1 ║║
║║ Line Control Setup 19200L,8N1 ║║
║║ Modem Connect Strings ║║
║║ Modem Response Strings ║║
║║ Modem Command Strings ║║
║║ Modem Control Setup ║║
║║╔═Default Video Emulation════════════════════════════╗
╚╚║═Video Emulation <> Associated KTS file═══════════║
║ TTY TTY.KTS ║
║ Ansi ANSI.KTS ║
║>Avatar AVATAR.KTS ║
║ VT102 VT102.KTS ║
╚═ New_Vid Asso_KTS Quit View_Cur_KTS ════════════╝
o Video Terminal emulation is built into AceComm
o Associated KTS file is the Keyboard Translation Sequence file
that will be loaded for the given Video Type.
o Keyboard Terminal emulation is defined inside of *.KTS files
AceComm includes a separate utility KTS.EXE which allows the
user to define KTS files for any Keyboard Terminal emulation
desired.
AceComm emulates the selected VIDEO type. "Associated KTS file"
is the .KTS file you want to use with the VIDEO selection. Each
time AceComm activates a VIDEO type, the associated KTS file is
loaded and becomes active on the keyboard. KTS keyboard
definitions override MACRO assignments.
KTS (Key Translation Sequence) files contain assignments for
a sequence of characters to a key press. When a key is pressed
from inside TERMINAL area, AceComm first checks to see if the
key press has been defined in the current KTS data. If so,
AceComm sends the assigned sequence of characters to the modem.
The utility KTS.EXE (included) can be used to create new and or
custom KTS files. See the included .ASC examples for defining
and creating KTS files. Using KTS.EXE, the keyboard can be
deigned to emulate any possible combination of characters
available to the system.
Key press assignments defined in the KTS data area are given
top priority, and thus take presides over MACROS assigned to
Page 32 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Default Video Emulation (continued)
the same key.
Page 33 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Key Translation Sequence file (.KTS)
╔═════════ACE.PRM Data Edit-Menus════╔═VT102.KTS════════════
║ General Controls ║ TAB ^I
║╔═══ Serial Port Setup Menu ═════════║ Del/.
║║ Port Number Select 1 ║ Home/7 ^[[H
║║ Line Control Setup 19200L,8N1 ║ Up/8 ^[[A
║║ Modem Connect Strings ║ Left/4 ^[[D
║║ Modem Response Strings ║ Right/6 ^[[C
║║ Modem Command Strings ║ End/1 ^[[K
║║ Modem Control Setup ║ Down/2 ^[[B
║║╔═Default Video Emulation═══════════║ Keypad-0 ^[Op
╚╚║═Video Emulation <> Associated KT║ Keypad-1 ^[Oq
║ TTY TTY.KTS ║ Keypad-2 ^[Or
║ Ansi ANSI.KTS ║ Keypad-3 ^[Os
║ Avatar AVATAR.KTS ║ Keypad-4 ^[Ot
║>VT102 VT102.KTS ║ Keypad-5 ^[Ou
╚═ New_Vid Asso_KTS Quit View_Cur║ Keypad-6 ^[Ov
║ Keypad-7 ^[Ow
║ Keypad-8 ^[Ox
║ Keypad-9 ^[Oy
║ Keypad-- ^[Om
║>Keypad-* ^[Ol
╚═ Select Quit ═══════
KTS files contain a sequence of bytes to be sent to the modem
when a particular key press is made. AceComm emulates a video
type independently from the keyboard emulation. KTS files may be
edited to emulate any combination imaginable. KTS files may be
created and assigned to a video type using the "Associate" option
above.
AceComm comes with ready made KTS files.
Notes: .KTS files are compiled from .ASC files. .ASC files
may be created, maintained, customized with a TEXT
EDITOR in ASCII TEXT mode. The utility KTS.EXE is
provided for compiling .ASC files into .BIN files.
Rename the .BIN file with .KTS and copy the .KTS file
into the directory pointed to in PRM-data for ".KTS".
Page 34 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Keyboard MACRO Assignments
╓─D:\ACE\ACE.PRM───────────────╖
║ General Controls ║
║ Terminal Area Options ║
║ Serial Port Setup ║
║>╓─KeyBoard MACRO Assignments───╖
║ ║─Current Keyboard:ACE_DEF.KBD─║
║ ║> F1 - F12 ║
║ ║ ALT-F1 - F12 ║
║ ║ CTRL-F1 - F12 ║
║ ║ SHIFT-F1 - F12 ║
║ ║ ALT+KEY Combo ║
║ ║ CTRL+KEY Combo ║
║ ║ Extended Keys ║
╙─╙─── Select Write Quit───────╜
o Each of the above key sets is available for assignment to a
MACRO or MACRO stack. The MACROS provide a wide range of
services. All of AceComm's functionality is available with
MACROS.
o The "SHIFT-Fn" key-set is used by TAGGER to store TAGGED ITEMS
┌────────────────────────────────────┐
│ Menu options here allow each key │
│ press be re-assigned. The keyboard │
│ can be arranged thru the use of │
│ MACROS to resemble software you │
│ are more accustomed to. AceComm`s │
│ keyboard is totaly MACRO driven. │
│ Keyboard definitions are stored in │
│ .KBD files. ACE.CTL can be edited │
│ so future upgrades of AceComm will │
│ automatically configure with your │
│ keyboard preference. │
└────────────────────────────────────┘
--Write--
Prompts for a filename, and writes the current keyboard to a
new KBD file, or updates an existing KBD file of the same name.
When you choose "Write" the following occurs:
AceComm prompts for "filename"
"filename" is forced a ".KBD" extension
"filename" is written in the same directory as ACE.PRM
resides
AceComm writes the contents of "Key MACRO Assignments" menu
Page 35 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Keyboard MACRO Assignments (continued)
to the file
AceComm re-reads the original KBD file.
In short:
- All changes, once written to a KBD file with "Write", pertain
to the KBD file written to.
- Making changes and not "Writing" them, will be saved to the
current KBD file at program end.
To further explain, all changes made in this menu area to the
keyboard definitions, apply to the current KBD file. If you exit
the menu area, without choosing "Write", and say "ACE_DEF.KBD" is
active, the changes will be stored to "ACE_DEF.KBD" when you
leave the PRM-data area. If you choose "Write" from the above
menu, then the changes are stored to a new or existing KBD file,
and do not affect the current keyboard, as AceComm re-loads the
current KBD file after a "Write". Unless you "Write" to the
current KBD file, which is un necessary, because AceComm will
update it automatically anyway.
"SHIFT-Fn" is the key-set the TAGGER function assigns TAGGED
ITEMS to.
When you tag a word or line from the screen, the tagged item
becomes associated with the first available SHIFT-Fn key by way
of the <SEND_SendStr> MACRO.
╔═════════ACE.PRM Data Edit-Menus═══════╗
║ General Controls ║
║ Serial Port Setup ║
║╔═KeyBoard MACRO Assignments═══╗ ║
╔═ F# Keys ════════════════════════════════════════════════════
║ 1<SendStr>Michael Phelps^M
║ 2<SendStr>[FON_REC_PWD]^M
║ 3<SendStr>Phoenix, AZ
║ 4<SendStr>[PASSWORD]^M
║ 5
║ 6
║ 7<SendAscii> %P
║ 8
║ 9
║ 10<SendStr>password^M
║>11
║ 12<SendFile> message.txt
╚═══ Edit Zap Quit ══════════════════════════════════════════
- Edit
Page 36 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Keyboard MACRO Assignments (continued)
Allows editing the MACRO assignment.
- Zap
Clears field (Zaps) the MACRO assignment.
Page 37 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Keyboard MACRO Assignments (continued)
╔═════════ACE.PRM Data Edit-Menus═══════╗
║ General Controls ║
║ Serial Port Setup ║
║╔═KeyBoard MACRO Assignments═══╗ ║
╔═ ALT F# Keys ═════════════════════════════════════════════════
║ 1<ChgDir>FILES <RunProgram> list <ChgDir>..
║ 2<RunProgram> list
║ 3<RunProgram> dsz rz -rm
║ 4<RunProgram> COMMAND /C dir /w %WK
║> 5
║ 6
║ 7
║ 8
║ 9
║ 10
║ 11
║ 12
╚═══ Edit Zap Quit ═══════════════════════════════════════════
"ALT-n keys" key-set that POP UP REFERENCE displays
╔═════════ACE.PRM Data Edit-Menus═══════╗
║ General Controls ║
║ Serial Port Setup ║
║╔═KeyBoard MACRO Assignments═══╗ ║
╔═ CTRL F# Keys ════════════════════════════════════════════════
║ 1<LocalEcho> ON <DIALNUM> 846-2940 <LocalEcho> OFF
║ 2<SetDTR> Off <Delay> 5 <SetDTR> ON
║ 3
║ 4
║> 5
║ 6
║ 7
║ 8
║ 9
║ 10
║ 11
║ 12
╚═══ Edit Zap Quit ═══════════════════════════════════════════
Page 38 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Keyboard MACRO Assignments (continued)
╔═════════ACE.PRM Data Edit-Menus═══════╗
║ General Controls ║
║ Serial Port Setup ║
║╔═KeyBoard MACRO Assignments═══╗ ║
╔═ SHIFT F# Keys ═══════════════════════════════════════════════
║ 1<SENDSTR>80XXX_92.ARJ
║ 2
║ 3
║ 4
║> 5
║ 6
║ 7
║ 8
║ 9
║ 10
║ 11
║ 12
╚═══ Edit Zap Quit ═══════════════════════════════════════════
"SHIFT-Fn" key-set the TAGGER function assigns TAGGED ITEMS to.
When you tag a word or line from the screen, the tagged item
becomes associated with the first available SHIFT-Fn key by way
of the <SEND_SendStr> MACRO.
Page 39 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Keyboard MACRO Assignments (continued)
╔═ALT+KEY Combo═════════════════════════════════════════════════
║>A <AutoScrGen>
║ B <Back buffer_>
║ C <CaptureFile>
║ D <FonListDialer_>
║ E <HostMode>
║ F <FileLister_>
║ G <FileRequest_>
║ H <MdmHangUp>
║ I
║ J <CommandShell_>
║ K
║ L
║ M
║ N
║ O
║ P <PrmDataMenus_>
║ Q <EndAceComm>
║ R <RunScrFile_>
║ S <ScrnSnapshot_>
║ T <ScrnTag_>
╚═══ Edit More Quit ══════════════════════════════════════════
PgDn/PgUp toggles display between above and below
Page 40 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Keyboard MACRO Assignments (continued)
╔═ALT+KEY Combo═════════════════════════════════════════════════
║>U
║ V
║ W
║ X <EndAceComm>
║ Y
║ Z <ClearWindow>
║ 1
║ 2
║ 3
║ 4
║ 5
║ 6
║ 7
║ 8
║ 9
║ 0
║ -
║ = <DoorWayMode>
╚═══ Edit More Quit ══════════════════════════════════════════
PgDn/PgUp toggles display between above and below
Page 41 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Keyboard MACRO Assignments (continued)
╔═CTRL+KEY Combo════════════════════════════════════════════════
║>A
║ B
║ C
║ D
║ E
║ F
║ G
║ H
║ I
║ J
║ K
║ L
║ M
║ N
║ O
║ P
║ Q
║ R
║ S
║ T
║ U
╚═══ Edit More Quit ══════════════════════════════════════════
PgDn/PgUp toggles display between above and below
Page 42 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Keyboard MACRO Assignments (continued)
╔═CTRL+KEY Combo════════════════════════════════════════════════
║>V
║ W
║ X
║ Y
║ Z
║ CTRL-2/@
║ CTRL-6/^
║ CTRL--/_
║ CTRL-BKSP
║ CTRL-[/{
║ CTRL-]/}
║ CTRL-ENTER
║ CTRL-\/|
║ CTRL-PRTSC
║ CTRL-HOME
║ CTRL-PGUP
║ CTRL-LEFT
║ CTRL-RIGHT
║ CTRL-END
║ CTRL-PGDN
╚═══ Edit More Quit ══════════════════════════════════════════
PgDn/PgUp toggles display between above and below
Page 43 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Directories in Use Menu
╓─D:\ACE\ACE.PRM───────────────╖
║ General Controls ║
║ Terminal Area Options ║
║ Serial Port Setup ║
║ KeyBoarD MACRO Assignments ║
║>╓─Directories in Use Menu─────────────────────────────────
║ ║>.FON files: D:\ACE
║ ║ .CAP files: D:\ACE
║ ║ .SCR files: D:\ACE
║ ║ .KTS files: D:\ACE
║ ║ Downloads: D:\ACE
║ ║ Nodelist: D:\ACE
║ ║ .REQ/.MLF: D:\ACE
╙─╙─── Edit Quit ──────────────────────────────────────────
- .FON
Where AceComm expects .FON files to be.
- .CAP
Where AceComm will create and or re-open CAPTURE files. A
CAPTURE file is a means for "capturing" all port I/O to DISK.
When you open a capture file, AceComm records everything that
comes into the serial port, exactly as it comes in. No
filtering, no translation of any kind.(1) AceComm does not
overwrite CAPTURE files. You have the option of renaming the
file, or AceComm will append new data to the end of the
file(2).
- .SCR
Where AceComm will create and or look for .SCR files. The
MACRO <RunScript_> lists this directory.
- .KTS
Where AceComm expects to find it's KTS files. It's ok to store
your .ASC files in this directory.
- Downloads
This is the directory that AceComm 's internal protocols will
receive into. AceComm will also list this directory when
building upload LISTFILES.
- Nodelist
When you select the FileRequest option, AceComm expects to find
either (a) a valid RAW FIDO NODELIST and NLIST.IDX file(3).
Page 44 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Directories in Use Menu (continued)
or (b) a .NOD file(4)
- .REQ/.MLF
Mailer activities.
.REQ files are used when doing File Requests. When you ask
AceComm to make a File Request, the filename is created using
the NET/NODE number in ascii hex, and the file extensions is
".REQ".
.MLF files (Mail List File) are used when you want to File
Attach to a NET/NODE. File Attach may be any file(s), and will
also serve as a means for point mail operators to send their
mail bundle to the HOST.
(1) ANSI.EXE is a provided utility that can filter VIDEO CONTROL
SEQUENCES from DISK files.
(2) If you have edited a CAPTURE file, or by other means used any
utility that added the 26d character to the file, AceComm
will not overwrite the END OF FILE character. This may
result in some editors not recognizing new data that follows
the 26d character. There exists utilities that can filter
this and other characters from TEXT files.
(3) NLIST.IDX is a file created using the AceComm utility
IDX.EXE. IDX.EXE will create a small index into the RAW
FIDO NODELIST file, for all ZONE:NET pairs.
(4) .NOD files are FBL output for a NET. FBL.EXE is another
AceComm utility.
Page 45 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Executable Utilities
╔═════════ACE.PRM Data Edit-Menus═══════╗
║ General Controls ║
║ Serial Port Setup ║
║ KeyBoard Text Macros ║
║ Directories in use ║
║╔═ Executable files Menus ═════╗ ║
║║>*.ARJ ║ ║
║║ *.ARC ║ ║
║║ *.LZH ║ ║
║║ *.SDN ║ ║
╚║ *.ZIP ║════════╝
║ *.ZOO ║
║ *.EXE ║
║ *.COM ║
║ *.DOC ║
║ All others ║
║ External Upload Protocols ║
║ External Download Protocols ║
╚═══ Select Quit ═════════════╝
The extensions are used with the following menus, and are called
when a filename has been selected that contains the .EXT as
listed. Selections are made while in <FileLister_> menu area.
Executable files are then handed over to AceComm's SPAWN
function. (<RunProgram> equivalent) SPAWN can find files along
the DOS PATH. SPAWN can also determine a files extension (.COM,
.EXE) SPAWN will use XMS,EMS,DISK swapping if the option is
selected. SWAP for SPWAN is selected from inside PRM-data
"General Controls" menu.
Page 46 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Executable Utilities (continued)
╔═════════ACE.PRM Data Edit-Menus═══════╗
║ General Controls ║
║ Serial Port Setup ║
║ KeyBoard Text Macros ║
║ Directories in use ║
║╔═ Executable files Menus ═════╗ ║
║║╔═%Fn = *.ARJ══════════════════════════════════════════════
║║║><RUNPROGRAM> ARJ a -s %FN %WK
║║║ <RUNPROGRAM> ARJ x %FN %WK
║║║ <RUNPROGRAM> ARJ v %FN %WK
╚║║
║║
║╚═ Select Edit Quit ═════════════════════════════════════
║ *.COM ║
║ *.DOC ║
║ All others ║
║ External Upload Protocols ║
║ External Download Protocols ║
╚═══ Select Quit ═════════════╝
Sample menu when a "Highlighted" file's extension of ".ARJ".
AceComm changes to the directory being listed, so that any WORK
done by the utility is done in the LISTED directory. AceComm
will use the SWAP functions if allowed. (see SWAP enable flags
located inside "General Controls" Menu Area.
Page 47 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Executable Utilities (continued)
╔═════════ACE.PRM Data Edit-Menus═══════╗
║ General Controls ║
║ Serial Port Setup ║
║ KeyBoard Text Macros ║
║ Directories in use ║
║╔═ Executable files Menus ═════╗ ║
║║ *.ARJ ║ ║
║║ *.ARC ║ ║
║║ *.LZH ║ ║
║║ *.SDN ║ ║
╚║ *.ZIP ║════════╝
║ *.ZOO ║
║╔═%FN = *.EXE══════════════════════════════════════════════
║║><RUNPROGRAM> %FN %WK
║║ <RUNPROGRAM> LIST %FN
║║
║║
║║
╚╚═ Select Edit Quit ═════════════════════════════════════
Sample menu for executable files. Notice that the <RunProgram>
MACRO will be handed the current "Highlighted" filename with the
%FN MACRO. In the above example the %WK argument will cause
AceComm to wait for a key press afterward. This allows the user
to view any finishing screens generated from the executable file
argument to <RunProgram>.
This type of MACRO programming allows the user to fire up that
QWK Mail Reader (and what have you) on the fly without exiting
AceComm.
Page 48 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Auto Engage Sequence Triggers
╔═════════ACE.PRM Data Edit-Menus═══════╗
║ General Controls ║
║ Serial Port Setup ║
║ KeyBoard Text Macros ║
║ Directories in use ║
║ Executable files Menu ║
╔═Auto Engage Sequence Triggers═════════════════════════════════
║═Sequence Trigger -- Responding MACRO STACK════════════════════
║>rz^M**^X <RecvZmo>
║ HS*^B <RunProgram>hslink -P1 <SendStr>^M
║ ^`^H^`^H^`^H^`^H <RunProgram>bimodem bimodem.pth <SendStr>^M
║ MPt^`^V^H <RunProgram>MPT R <SendStr> ^M
║
║
║
║
║ **EMSI_REQA77E <SendEMSI_CLI>
║ **EMSI_IRQ8E08 <SendEMSI_ICI>
║═Pre/Post AutoM MACROS═════════════════════════════════════════
║
║
╚═══ Edit Quit Help ┤<>v^├════════════════════════════════════
o The last byte in a Sequence Trigger is the sequence scan
trigger byte
o The last byte in a Sequence Trigger should end in an un
common character (as designed above)
o EMSI_REQ detection can allow swift access to a BBS when
mailer software answers the phone
o EMSI_IRQ is sent by BBS software to tell the caller it can do
Interactive EMSI data handshaking
The above defaults have been working very well for the
protocols associated.
- Sequence Trigger
A sequence trigger is a character string that is used by a
remote HOST, protocol etc. as an attempt to engage some
action from the other end.
- Trigger Character
Page 49 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Auto Engage Sequence Triggers (continued)
AceComm scans back thru it's receive buffer for a trigger
sequence with each occurrence of the "last byte of the
sequence". This means that AceComm will scan for the string
each time it sees the trigger byte arrive from the modem. For
this reason a sequence trigger will end in a non-common byte.
While 'rz^M' (^M being <CR>, 13 decimal) would be a valid
sequence trigger, we don't want AceComm to search on every
carriage return character that comes in. Look at Bimodem's
sequence trigger, we don't want to end the sequence with a <SP>
character (^' is the control code for SPACE CHARACTER 32
decimal).
Characters 32(Space) and below need be escape encoded with
the '^' ^A becomes 1, ^B 2, ^C 3, ^M <CR>, ^` 32 <SP> etc.
When entering sequence text, you may simply type the <SP>
character, AceComm will do the conversion for you.
**EMSI_REQA77E
Most FIDONET mailer software will send an EMSI_REQ string to a
caller. This string is an attempt to determine the caller
type. AceComm's <SendEMSI_CLI> MACRO tells the mailer this is
a human caller, bypassing the common "Press ESC to enter BBS"
prompt. DBridge mailer software is in complete and won't
recognize this advanced EMSI handshaking. All other mailer
software does.
**EMSI_IRQ8E08
IEMSI capable BBS systems will send an EMSI_IRQ string to a
caller. Detection of EMSI_IRQ is responded to with IEMSI data
handshaking. AceComm's <SendEMSI_ICI> MACRO handles IEMSI log
on. (see PRM-data IEMSI Setup menu)
- Responding MACRO Stack
The MACRO defined to the right of each sequence trigger will be
used when a sequence has been detected. This allows AceComm to
be configured with auto download detection for up to 10
protocols. MACRO STACKING is valid with AutoM MACROS.
The sending of a carriage return as the last macro is use full
for moving the BBS display upon return from the external
protocol. AceComm completely disables the serial port before
calling any external programs.
- PreAutoM MACRO
The "PreAutoM" MACRO, if defined, will be processed prior to
the AutoM MACRO about to be processed. This allows for some
Page 50 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Auto Engage Sequence Triggers (continued)
extra maneuvering to be done which might otherwise be common to
all AutoM MACROS anyway. For instance the practice of changing
to your "FILES" directory will insure that downloads are
received into the "FILES" directory, even with protocols that
do not allow file redirection.
Notes: If you use PreAutoM MACRO for changing directories,
remember that protocols such as BIMODEM which you may be
up loading with at the same time, will need full path
names to files they are to send. Also protocols or what
have you that use PRM, CFG etc. files need know where
to find these control files.
- PostAutoM MACRO
The "PostAutoM" MACRO, if defined will be processed immediately
following the AutoM MACRO. Again this is some extra MACRO
processing power for those common to all AutoM MACRO jobs.
- To Disable Auto Engage Sequence Triggers
Located in the "Terminal Area Options" is a over ride flag with
which Auto downloads may be completely disabled. This flag
affects all Sequence Trigger / AutoM MACROS pairs defined.
Auto Engage On <=-ENABLE
Auto Engage Off <=-DISABLE
Page 51 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Auto Log On Sequence Triggers
╔═Auto Log On Sequence Triggers═════════════════════════════════
║═Sequence Trigger -- Responding MACRO STACK════════════════════
║ is^`your^`name: <SendStr>[USER_NAME]^M~Y^M~[FON_REC_PWD]^M
║ is^`your^`name: <SendStr>[USER_NAME]^M^M~[FON_REC_PWD]^M^M
║>Host^`Name: <SendStr>CIS^M~75120,3306^M~[FON_REC_PWD]^M
║ first^`name^`? <SendStr>[USER_NAME]^MY^M[FON_REC_PWD]^M
║
║
║
║
║
║
╚═══ Select Edit Null_Selection Quit Help ┤<>v^├════════════
Intelligent Auto Log On (Tm)
o Each Fon.Record FLAGS can be toggled to perform auto log on
by either use of a script file, or character sequence trigger
and associated macro stack.
o AceComm responds to a sequence trigger by processing the macro
stack.
o Log on sequence trigger scanning is available immediately after
connect, and until the sequence has been found, or 2 minutes of
on line time has passed.
o When a log on sequence has been processed, or 2 minutes of on
line time has passed AceComm stops scanning for log on
sequences for the remainder of the on line session.
On Dial/Connect Acecomm will, if the AutoL flag for the
current Fon.Record is SET, begin scanning incoming data for
Auto Log On Sequence Triggers. When any of the 10 possible
sequences is found, the sequence's associated macro stack is
processed.
Once a sequence has been found, scanning stops until the next
Dial/Connect.
If a sequence has not been found after the first 2 minutes of
on line time has passed, Intelligent Auto Log On (Tm) is
disabled until the next Dial/Connect.
- Sequence Trigger
A sequence trigger is a character string that is used by a
remote HOST, protocol etc. as an attempt to engage some
Page 52 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Auto Log On Sequence Triggers (continued)
action from the other end.
- Trigger Character
AceComm scans back thru it's receive buffer for a trigger
sequence with each occurrence of the "last byte of the
sequence". This means that AceComm will scan for the string
each time it sees the trigger byte arrive from the modem. For
this reason a sequence trigger will end in a non-common byte.
While 'rz^M' (^M being <CR>, 13 decimal) would be a valid
sequence trigger, we don't want AceComm to search on every
carriage return character that comes in. Look at Bimodem's
sequence trigger, we don't want to end the sequence with a <SP>
character (^' is the control code for SPACE CHARACTER 32
decimal).
Characters 32(Space) and below need be escape encoded with
the '^' ^A becomes 1, ^B 2, ^C 3, ^M <CR>, ^` 32 <SP> etc.
When entering sequence text, you may simply type the <SP>
character, AceComm will do the conversion for you.
- To Disable Auto Log On Sequence Triggers Located in the
"Fon.Record Edit" FLAGS menu is a over ride flag with which
Auto Log On for the record may be completely disabled. This
flag only affects the currently selected record.
Page 53 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Mass Menu Attribute Changes
╔═Menus / Colors═════════════════════════╗
║>Status line color <CR> to change ║
║ Curtain color ║
║ Help screen color ║
║ Paint Menus ║
║ Update All Menus ║
║ Video Rows (VGA) Detect ║
║═"Update" uses values below═════════════║
║ Border Attr 113 ║
║ Border Type 1 ║
║ Title Color 30 ║
║ ITitle Color 116 ║
║ Selector Color 112 ║
║ Left Field Color 112 ║
║ Right Field Color 112 ║
║ Burst Mode Off ║
║ Menu Chatter Off ║
║ Menu Whistle Off ║
╚═══ Select Quit ┤<>v^├═════════════════╝
----------------------------------------------------------------
o Here you can play with the colors for this menu only, unless
you choose the "Update All Menus" option
- Status Line Color
Toggle the AceComm status line back ground color (1 - 7)
- Curtain Color
Toggle color of back drops for various Areas
- Customize
All changes are limited to the current active menu "Mass Box".
Just as selecting the "Customize" option from any other menu,
changes are reflected and remain permanent.
- Help Screen Colors
AceComm's on line help uses 4 separate colors. Certain error
conditions can trigger a help screen to be displayed. When
this occurs, the error message is displayed at the top of the
help screen, followed by the help screen's Title, help text,
and bottom selector bar.
- Update All Menus
Selecting this option write a clone of the active menu "Mass
Page 54 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Mass Menu Attribute Changes (continued)
Box" to *all* AceComm menus.
The values on the right side of the menu are in decimal. They
may be copied and used in the .CTL file as defaults. (See
ACE.CTL(1) "Menu Attributes")
╔═ Customizer <ENTER>-Select ═══════════════════════════
╚═══ Color_Border Type_Border Left_Field Right_Field More
................................................................
╔═ Customizer <ENTER>-Select ═══════════════════════════
╚═══ Title ITitle Selector Burst On Chatter Off Whistle On
(1) ACE.CTL may be renamed. AceComm package contains the
default ,CTL file ACE.CTL, but it may be renamed to another
filename.
Page 55 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Interactive EMSI data
╔═Interactive EMSI data═══════════════════════════════╗
║ User Name Michael Phelps ║
║ Alias AceComm ║
║ Location Phoenix, AZ USA ║
║ Data # (602) 846-2940 ║
║ Voice # (602) 846-4563 ║
║> Password ║
║ CRT def ANSI,23,80,0 ║
║ Protocols Zap,ZMO ║
║ Capability CHT,TAB,ASCII8 ║
║ Requests NEWS,MAIL,FILE,HOT,CLR,HUSH,MORE,FSED ║
╚═══ Edit Quit Help ┤<>v^├══════════════════════════╝
o Interactive Electronic Mail Standard Identification (IEMSI)
o IEMSI is an auto log on interface designed to present caller
information to the HOST quickly and automatically. Few BBS
systems currently support IEMSI. RA supports IEMSI log on.
o Interactive EMSI log on function is called with the
<SendEMSI_ICI> MACRO function
o Data defined here will be used by the <SendEMSI_ICI> MACRO
function
o All IEMSI data need not be defined. The BBS system will
prompt the user for any invalid or missing information.
- User Name and Alias
Enter your name as you want it to appear to a BBS system.
There is also a PRM-data MACRO [USER_NAME] that uses this
field.
There is also a PRM-data MACRO [ALIAS] that uses this field.
- Location
City, State, Country
There is also a PRM-data MACRO [LOCATION] that uses this field.
- Data # and Voice #
If you have no Data #, leave the field blank. There is also a
PRM-data MACRO [DATA_PNUM] that uses this field.
There is also a PRM-data MACRO [DATA_PNUM] that uses this
field.
Page 56 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Interactive EMSI data (continued)
- Password
This is a default password, any FON.RECORD.PASSWORD always will
override this IEMSI PASSWORD.
There is also a PRM-data MACRO [PASSWORD] that uses this field.
- Birthdate (currently unused)
- CRT def (current session only)
╔═CRT Def═════════════════╗
║>AVATAR/0+ / ANSI ║
║ ANSI X3.64 ║
║ TTY (raw mode) ║
╚═══ Select Quit ┤<>v^├══╝
Consists of four sub-fields separated by commas, from left to
right:TERMINAL EMULATION,ROWS,COLUMNS,NULS
AceComm fills in the ROWS,COLUMNS,NULS fields automatically
when building IEMSI data packets.
Example CRTDEF: AVT0,24,80,0
TERMINAL EMULATION
Video type
AVT0 (AVATAR/ANSI)
ANSI
TTY
ROWS
Video rows for current session only
COLUMNS
Video columns for current session only
NULS
00h character required after line feeds.
- Protocols
╔═Protocols═════════════════════════╗
║>ZedZap (Zmodem to 8k) Yes ║
║ Zmodem Yes ║
╚═══ Select Quit ┤<>v^├════════════╝
AceComm internal protocols support ZMO,ZAP fields.
ZMO is normal zmodem
ZAP is zmodem with up to 8k data frames.
- Capability (current session only)
╔═Capabilities══════════════════════╗
Page 57 "AceComm & Utilities"(Tm) v 1.7
Chapter 4 PRM-data MENUS AREA
Interactive EMSI data (continued)
║>Can do full screen chat Yes ║
║ Can handle TAB characters Yes ║
║ Can handle 8-bit characters Yes ║
╚═══ Select Quit ┤<>v^├════════════╝
CHT Can do full screen on line conversation (CHAT)
TAB Can handle TAB (ASCII 09h) characters
AceComm supports TAB
ASCII8 Can handle 8-bit IBM PC ASCII characters
- Requests (current session only)
╔═Requests══════════════════════════╗
║>Show bulletins, anouncements Yes ║
║ Check for new mail Yes ║
║ Check for new files Yes ║
║ Hot-keys Yes ║
║ Screen clearing Yes ║
║ Do not disturb Yes ║
║ Page pausing, `More` Yes ║
║ Full-screen editor Yes ║
╚═══ Select Quit ┤<>v^├════════════╝
NEWS Show bulletins, announcements, etc.
MAIL Check for new mail
FILE Check for new files
HOT Hot keys "ON"
CLR Screen clearing
HUSH Do not disturb
MORE Page pausing, often referred to as "More"
FSED Full screen editor
Page 58 "AceComm & Utilities"(Tm) v 1.7
Chapter 5 INTERNAL / EXTERNAL PROTOCOLS
Internal, Defined-External Receiving Units
╔═Receiver Protocols══════════════════════════════
║═Internal Batch Capable══════════════════════════
║>Zmodem
║ Ymodem 128/1024 adobtive
║ YmodemG
║═Internal Single File════════════════════════════
║ Xmodem 128/1024 adobtive
║ Ascii file XON/CTS
║═External Protocols (user defined)═══════════════
║ BIMODEM %WK
║ HSLINK %WK
║ MPT %WK
║ JMODEM %PF %WK
║ DSZ port %P speed %B rz -mrr [DIR_DNLDS]
║ Setup Menu (External Protocols)
║═Auto Engaging Menu══════════════════════════════
║ Setup Menu (Auto Engaging)
║═EMSI Protocol═══════════════════════════════════
║ Recv Mail / File Request
╚═ Select Options Quit Help ┤<>v^├═════════════
AceComm contains internal Xmodem, Xmodem 1k, Ymodem, Ymodem 1k,
Ymodem G, Zmodem, and a Zmodem variant ZedZap (8k).
--Internal Batch Capable--
Batch protocols receive the incoming filenames as part of the
file data sent from the sender. AceComm will append filenames
received from the remote sender to the directory path contained
in the PRM-data area under "FILES".
--Internal Single File--
Single file protocols require a filename be given locally, by
the user. The user is prompted for a filename between the menu
selection and calling the internal protocol function.
--External Menu--
"Externals" are defined as menu selectable executable that will
become arguments to the <RunProgram> MACRO.
You may find it simpler to assign external protocols to a "Hot
Key" from inside PRM-data Key Definition menu. This menu is
provided for those who want a "menu driven" affect.
--Auto Engaging Menu--
Page 59 "AceComm & Utilities"(Tm) v 1.7
Chapter 5 INTERNAL / EXTERNAL PROTOCOLS
Internal, Defined-External Receiving Units (continued)
AutoDnlds are protocols whose sending units begin by sending a
documented sequence of characters. AceComm allows up to 10
separate sequences be defined, and associates each sequence
with a MACRO STACK. the MACRO STACK can be setup to call the
external protocol associated with the sequence. "AutoDnLds" is
documented in more detail above. Shown below is a snippet
reminder display.
╔═ AutoDnLd Sequence Triggers ═════════════════════════════════
║ rz^M**^X <RecvZmo>
║ HS*^B <RunProgram>hslink -P1 <SendStr>^M
║ ^`^H^`^H^`^H^`^H <RunProgram>bimodem /C \ace <SendStr>^M
║ MPt^`^V^H <RunProgram>MPT R <SendStr> ^M
║ at^`is^`your^`name: <SendStr>Michael Phelps^M~^M~PASS^M
See "AutoDnLd Sequence Trigger" menu for more information.
--Recv Mail / File Request--
"FileRequest" is a point mail function.
Selecting File Request function will bring up the menu below
if the PRM-data directory field for NODELIST points to either
- FIDONET NODELIST and compiled NLIST.IDX file
- FBL.EXE output .NOD file
FBL output .NOD file is used in the example below.
╔═══════════════════════════════════════╗
║> 1:114/12 ║
║ Format => ZONE:NET/NODE ║
╚═══════════════════════════════════════╝
This menu prompts the user for a ZONE:NET/NODE number of the
system we want to call. Having entered the above "1:114/12"
the menu below is presented.
╔═1:114/12══════════════════════════════╗
╔═D:\ACE\fon\══════════════════════════╗║
║ 1_105.NOD 19595 05/12/93 10:09 ║║
║> 1_114.NOD 11220 05/12/93 10:09 ║╝
O║ 1_125.NOD 7886 05/12/93 10:09 ║
║ 1_282.NOD 7623 05/12/93 10:09 ║
O║ 1_382.NOD 10291 05/12/93 10:09 ║
╚═│Grab│ Quit ┤<>v^├═══════════════════╝
This menu lists FBL output .NOD files found in the directory
field NODELIST. FBL produces these files and names them
according to their ZONE_NET number. We want to select the file
1_114.NOD because 1_114.NOD is an extracted listing of all NET
114 zone 1, from the FIDONET NODELIST. Selecting the 1_114.NOD
file produces the following menu.
Page 60 "AceComm & Utilities"(Tm) v 1.7
Chapter 5 INTERNAL / EXTERNAL PROTOCOLS
Internal, Defined-External Receiving Units (continued)
╔═1:114/12══════════════════════════════╗
║╔═1:114/12═══════════════════════════════════════════╗
║║ System Name ORAC/2 ║
╚║ City Phoenix_AZ ║
║ Operator Name Eugene_Glover ║
║ Phone Number 1-602-277-1334 ║
║ Baud Rate 9600 ║
║ Flags H16,CM,XA ║
║ .CFG Password mailman ║
╚═│File_Request│ Human call Poll_for_Mail Quit ════╝
Here AceComm has found the desired node information from the
file 1_114.NOD.
Notice the "Phone Number" field contains a long distance
number. The following "Dial Filter" statement" contained in
"Point Mail Setup" menu is used to convert the phone number to a
local number.
1-602-
(A) (B)
Explanation: Field (A) defines what to look for in phone numbers
Filed (B) defines what to replace field (A) with.
Here we left field (B) blank. AceComm then
replaces "1-602-" with nothing.
Notice the "Password field. The following "Password"
definition was made in "Point Mail Setup" menu.
1:114/12 mailman
The selector bar at the bottom of the above menu contains
several choices. The first being "File Request". Selecting
"File Request" produces the following screen.
╔═Input Window═════════════════════
║══════════════════════════════════
║>FileName: files
╚══════════════════════════════════
AceComm is prompting for file names. The example uses the file
name "files". Many systems will recognize "files" as a MAGIC
file name, and send an "all files listing" for the system in
response. Pressing <ENTER> alone when finished entering file
names causes AceComm to begin dialing the target system.
╔══Record Number 1:114/12══════════════════════════════════
Page 61 "AceComm & Utilities"(Tm) v 1.7
Chapter 5 INTERNAL / EXTERNAL PROTOCOLS
Internal, Defined-External Receiving Units (continued)
║> System Name ORAC/2
║ Phone Number 1-602-277-1334
OK ║ Line Control 9600L,8N1
║ Video Type
OK ║ Control Flags AutoMACRO,
║ Dial Prefix
║ Log on Script
║ Capture File
║ Password mailman
║ Load KBD File
║ Log on triggers
║═Last Connect -- Total Connects ═══════════════════════
║ 0
║═Cycles -- Dial String Last
║ 0 ATEQ0X4DT277-1334
║ 00:03 00:03 58
╚═│Quit│ <SpaceBar>-ReCycle ┤<>v^├═════════════════════════
----------------------------------------------------------------
CONNECT 9600/ARQ
Address 1:114/12 Using BinkleyTerm-OS/2 Ver. 2.56
Welcome to ORAC/2 - Home of Log/2 (Log for OS/2)
Press <escape> to enter BBS!
ORAC/2
Eugene Glover, Phoenix, AZ USA1-602-277-1334
BinkleyTerm, 9600, CM,XA,V32B,HST
Outgoing D:\ACE\mail\0072000C.REQ
File Info 7 06/26/1993 11:55
0 7 0 CPS 00:00 ZEOF
CPS ZDATA
Incoming c:\fil\orac.lzh
File Info 90401 06/24/1993 20:00
90401 289 1089 CPS 01:23 ZSendHexHdr
TIMEOUT
NO CARRIER
OK
----------------------------------------------------------------
AceComm uses it's text based display for the Point Mail protocol
displays.
Page 62 "AceComm & Utilities"(Tm) v 1.7
Chapter 5 INTERNAL / EXTERNAL PROTOCOLS
Internal, Defined-External Sending Units
╔═Sender Protocols════════════════════════════════
║═Internal Batch Capable══════════════════════════
║>Zmodem
║ Ymodem
║ Ymodem 1k
║ YmodemG
║═Internal Single File════════════════════════════
║ Xmodem
║ Xmodem 1k
║ Ascii file XON/CTS
║═External Protocols (user defined)═══════════════
║ BIMODEM bimodem.pth
║ HSLINK -P%P @UPLDS.LST
║ MPT S @UPLDS.LST %WK
║ JMODEM S %PF %WK
║ DSZ port %P speed %B sz @[DIR_START]\UPLDS.LST
║ Setup Menu (External Protocols)
║═EMSI Protocol═══════════════════════════════════
║ Send Mail / File Attach
╚═ Select Options Quit Help ┤<>v^├═════════════
AceComm contains internal Xmodem, Xmodem 1k, Ymodem, Ymodem 1k,
Ymodem G, Zmodem, and a Zmodem variant ZedZap (8k).
--Internal Batch Capable--
AceComm's internal "Batch" capable protocols are capable of
sending from a LISTFILE. A LISTFILE is an ascii text file
containing <CR> <LF> terminated filenames. One filename per
line. Filenames may contain a full DRIVE:\PATH specifier.
AceComm looks in the current directory for a filename
"UPLDS.LST". When selecting any of the "Batch" capable
internal sending units, AceComm will always look for
"UPLDS.LST", if the file exists, AceComm displays the following
screen.
╓─────────────────╖ AceComm always prompts to send the
║ Found UPLDS.LST ║ from the LISTFILE "UPLDS.LST", when the
║ Send contents? ║ "UPLDS.LST" file exists in the directory.
║>(Y)es/(n)o?: ║ Pressing <CR> defaults to (Y)es, (n)o
╙─────────────────╜ brings up the regular file selection
menu.
Page 63 "AceComm & Utilities"(Tm) v 1.7
Chapter 5 INTERNAL / EXTERNAL PROTOCOLS
Internal, Defined-External Sending Units (continued)
╓───────────────────╖ If the (Y)es selection was selected,
║ UPLDS.LST ║ AceComm will, after the transfer,
║ Delete this file? ║ present the menu at left, prompting to
║>(Y)es/(n)o?: ║ delete the LISTFILE, or leave it exist.
╙───────────────────╜
The "Regular file selection" menu (below) allows "on the fly"
LISTFILE creation. The "on the fly" LISTFILE is not named
"UPLDS.LST", but a temporary unique filename is selected. "On
the fly" LISTFILE is deleted after transfer without any prompt.
╓─Make Uploads List────────────────╖
║>Batch Tag ║
║ Manual entry ║
║ Finished / ESC-key ║
╙─ Select Quit ───────────────────╜
Batch Tag
This selection brings up the "FileLister" menu. This
menu allows tagging filenames to the LISTFILE. PRM-data
DIR "DNLDS" is the default directory displayed by
"FileLister" when called by the "Sender Protocols" menu.
Manual entry
The menu below is presented with the "Manual entry"
selection.
╓─Make Uploads List─────────────────╖
║ Batch Tag ║
║╓─Input Window───────────────────────────────────────────────
║║>FileName: c:\fil\
╙║─Input Window<ENTER> alone when done────────────────────────
╙────────────────────────────────────────────────────────────
The "Manual entry" filename prompt pre pends the prompt space
with any PATH found in PRM-data DNLDS field.
"Batch Tag/ Manual entry" are recorded to a temporary unique
LISTFILE as explained above. Temporary unique LISTFILE is
automatically deleted after use.
Page 64 "AceComm & Utilities"(Tm) v 1.7
Chapter 5 INTERNAL / EXTERNAL PROTOCOLS
Internal, Defined-External Sending Units (continued)
- Single File
AceComm's internal protocols that send 1 filename per
invocation use the "Manual entry" window shown below.
╓─Input Window───────────────────────────────────────────────
║>FileName: c:\fil\
║─Input Window<ENTER> alone when done────────────────────────
╙────────────────────────────────────────────────────────────
--Externals--
This selection brings up a menu listing up to five
configurations for external protocol setup/selection. This
menu allows storing configurations for external protocols to be
used. The menu storage below functions the same as any MACRO
stack assigned to a key press. Here you have a menu where you
may find it easier to to store specific upload protocol
definitions.
╓─ External Protocols (UpLd) ──────────────────────────────────
║><RunProgram>BIMODEM %WK
║ <RunProgram>HSLINK %PF %WK
║ <RunProgram>MPT S @UPLDS.LST %WK
║ <RunProgram>JMODEM S %PF %WK
║ <RunProgram>DSZ sz %PF
╙─ Select Edit Quit ─────────────────────────────────────────
Page 65 "AceComm & Utilities"(Tm) v 1.7
Chapter 5 INTERNAL / EXTERNAL PROTOCOLS
Internal, Defined-External Sending Units (continued)
-- Send Mail / File Attach--
This selection allows the user to send files to EMSI capable
mailer software. The menu shown below prompts the user for a
FIDONET style ZONE:NET/NODE number.
╓───────────────────────────────────────╖
║> ║
║ Format => ZONE:NET/NODE ║
╙───────────────────────────────────────╜
The number is required for naming a LISTFILE. LISTFILE in the
mode uses "MLF" file extension. (Mail ListFile) AceComm allows
normal Tag or manual entry when adding filenames to LISTFILE.
Those who want to "File Attach" or are running under a HOST as
a point mail system will use this option. Point mail operators
may upload their mail bundles with this "Send Mail" selection.
AceComm requires a NODELIST or FBL output .NOD file when using
"Send Mail/Attach". AceComm uses the ZONE:NET/NODE number
entered above for looking up system information about the HOST
to be called. AceComm is able to retrieve the phone number and
system name from NODELIST/.NOD files.
Page 66 "AceComm & Utilities"(Tm) v 1.7
Chapter 6 TELEPHONE DIRECTORY AREA
╔═ Telephone_Directory D:\ACE\1_114.FON, 136 Records════════════
║═ System Name Phone Number Line Control Vid
║ 1 AceComm Software Support 1-602-846-2940 9600,8N1 A
║ 2 ADTBBS 1-602-840-5611 9600,8N1 A
║ 3 ADTBBS 1-602-840-5611 9600,8N1 A
║ 4 AMUG Preferred 1-602-553-0721 9600,8N1 A
║ 5 APPS Software Int'l 1-602-947-7678 9600,8N1 A
║ 6 AZ Legislature BBS 1-602-253-0065 2400,8N1 A
║ 7 AZ MAC UG 1-602-553-0749 9600,8N1 A
║ 8 AZ MAC UG 2 1-602-947-0587 9600,8N1 A
║ 9 Am Az! West BBS 1-602-843-6574 9600,8N1 A
║ 10 Anime Archive 1-602-863-6599 9600,8N1 A
║ 11 Answering Machine 1-602-242-3158 9600,8N1 A
║ 12 Answering Machine 1-602-242-3158 9600,8N1 A
║ 13 Ariseth Keep 1-602-843-0998 9600,8N1 A
║>14 Artemis Lair bbs 1-602-841-4474 9600,8N1 A
║ 15 Astroland 1-602-381-8708 9600,8N1 A
║ 16 Bob's Place BBS Node 1 1-602-497-2173 2400,8N1 A
║ 17 Bob's Place BBS Node 2 1-602-545-8745 9600,8N1 A
║ 18 Broadcaster's BBS 1-602-872-9148 9600,8N1 A
║ 19 CADE BBS 1-602-931-3468 2400,8N1 A
║ 20 Cactus Bulletin Board Sy 1-602-945-3493 2400,8N1 A
║ Dial Edit <SPACEBAR>-Que Circular_Redial_Que Fon_files
╚═ Add_record Remove_record UnMark_All Import Paint Quit ┤<
The Telephone Directory Area lists binary .FON files in their
full ASCII representation. The current loaded .FON file is
identified at the top of the menu. Notice that the number of
records contained in the '1_114.FON' file is presented at the top
right. .FON files are not fixed to any certain record size, and
can have records added or deleted, from here, in the Directory
list area. Maximum record count for a FON file is 250 records
per FON file. AceComm supports unlimited FON files, and provides
easy directory List/Grab function for changing FON files.
- Dial
Dial the "highlighted" record. The function continues dialing
until:
(a) a connection has been established
(b) USER ABORT.
- Edit
Another menu contains the "highlighted" record's data is
presented for editing, or just a closer view. All changes are
automatically save to disk.
Page 67 "AceComm & Utilities"(Tm) v 1.7
Chapter 6 TELEPHONE DIRECTORY AREA
- <SPACEBAR>-Que
Mark the "highlighted" record for 'RedialQue'.
- Circular_Redial_Que
Switch into The 'Que' Menu. At least 1 record needs be marked
"Queued" for AceComm to present this area. From the 'Que'
Menu, 'Dial' goes into single dial mode, and each record is
dialed 1 time, followed by the next record until all records in
the 'Que' have been dialed. The 'Que' then revolves around to
the first record and begins again. When a connection has been
established, the record is removed from the 'Que'.
╔═ Circular_Redial_Que D:\ACE\1_114.FON, 6 Records══════════════
║═ System Name Phone Number Line Control Vid
║>14 Artemis Lair bbs 1-602-841-4474 9600,8N1 A
║ 15 Astroland 1-602-381-8708 9600,8N1 A
║ 16 Bob's Place BBS Node 1 1-602-497-2173 2400,8N1 A
║ 17 Bob's Place BBS Node 2 1-602-545-8745 9600,8N1 A
║ 18 Broadcaster's BBS 1-602-872-9148 9600,8N1 A
║ 19 CADE BBS 1-602-931-3468 2400,8N1 A
║ Dial Edit <SPACEBAR>-Zap Telephone_Directory
╚═ Add_record Remove_record UnMark_All Import Paint Quit ┤<
-Fon_files
List PRM-data directory .FON, allow selection of new .FON file
- Add_record
Function appends a new record to the current loaded .FON file,
and immediately brings up the 'Edit' Menu. The new record is
automatically saved.
- Remove_record
The "highlighted" record is removed from the current loaded
.FON file. No hole is left, the .FON file is reduced a 'record
size' in bytes.
- UnMark_All
Clear TAG bit from all records in the current FON file.
- Import
"Import" selection brings up the FON file conversion menu
displayed below. The menu provides the following functions.
() Convert another software's FON type file to AceComm FON
file.
() Merge two AceComm format FON files into one file.
Page 68 "AceComm & Utilities"(Tm) v 1.7
Chapter 6 TELEPHONE DIRECTORY AREA
() Initialize a new FON file of video rows number of
blank records.
╔═ Telephone_directory D:\ACE\fon\ACE.FON, 9 Records════════════
║═ System Name Phone Number Line Control V
║>1 ACECOMM Support BBS 1-602-846-2940 19200,8N1 A
║ 2 CIS (local phoenix 9600) 468-0285 19200,7E1 A
║ 3 CIS (phones) 1-800-346-3247 2400,7E1 A
║ 4 Comp USA #2 ╔═Covert to AceComm FON═══╗ 19200,8N1 A
║ 5 Supra Modem BB║ ║ 19200,8N1 A
║ 6 Comput Connect║> BOYAN 5 ║ 19200,8N1 A
║ 7 Comp USE (Dall║ Qmodem 4 ║ 19200,8N1 A
║ 8 Leprechan Cast║ Qmodem 5 ║ 19200,8N1 A
║ 9 Xanathar's Cas║ Procomm 2.43 ║ 19200,8N1 A
║ Dial Edit <SPACE║ PcPlus 1 ║ue Fon_files S
╚═ Add_record Remove║ PcPlus 2 ║ Paint Quit H
║ Telemate 3.01 ║
║ TELIX 3.15 - 3.21 ║
║ Combine 2 Ace FON ║
║ Create a blank FON ║
╚═══ Select Quit ┤<>v^├══╝
- Paint
Customize the current menu only. All changes are save
automatically.
- Quit to Terminal Area. (ESC-key)
.FON files
AceComm uses a binary .FON file for storing it's telephone
directory records. Each record contains data specific to the
system. FON files must be edited inside AceComm, using The Edit
menu.
Page 69 "AceComm & Utilities"(Tm) v 1.7
Chapter 6 TELEPHONE DIRECTORY AREA
- Fon.Record Edit Menu
╔═ Telephone_directory c:\fil\PHOENIX.FON, 394 Records══════════
║═ System Name Phone Number Line Control V
║ 181 Intimidator BBS, The 492 0560 2400,8N1 A
║ 182╔══Record Number 188═══════════════════════════════════════
║ 183║ System Name JCCS Node 3 $L
║ 184║ Phone Number 582 4299
║ 185║ Line Control 2400L,8N1
║ 186║ Video Type Av/An
║ 187║ Control Flags Macro,DTag,Capture,Text,IEMSI,AutoL
║>188║ Dial Prefix
║ 189║> LogOn Script ACECOMM_.SCR
║ 190║ Capture File ACECOMM_.CAP
║ 191║ Password jccs
║ 192║ Load KBD File
║ 193║ Log on triggers
║ 194║═Last Connect -- Total Connects ═══════════════════════
║ 195║ 00 04:26:05pm 4
║ 196║═Cycles -- Dial String Last
║ 197║ 0 ATEQ0X4DT582 4299
║ 198║ 00:00 00:00 60
║ 199╚═ Edit Paint Quit Help ┤<>v^├══════════════════════════
║ 200 Lejentia BBS 493 8633 2400,8N1
║ Dial Edit <SPACEBAR>-Que Circling_dial_queue Fon_files S
╚═ Add_record Remove_record UnMark_All Import Paint Quit H
- System Name AceComm Software Support
The name defined here, is presented onto the revolving status
line (right side of status line) when "on line".
- Phone Number 1-602-846-2940
This phone number, although long distance, can be modified by
AceComm when dialing, with use of "Dial" statements in the
Point Mail Menu.
Example: lets say we are local Phoenix, where our area code is
602, we have an entire phone directory of long
distance numbers. The following dial statement
defined inside "Point Mail Setup" will cause AceComm
to translate all of the long distance numbers to local
numbers.
Dial 1-602-
AceComm will see this definition and translate it into
Page 70 "AceComm & Utilities"(Tm) v 1.7
Chapter 6 TELEPHONE DIRECTORY AREA
anything following the definition. In this case, we
did not put anything after the "1-602-", so AceComm
will strip "1-602-" from all phone numbers that
contain "1-602-" as part of the number. This is valid
for all phone numbers that are processed thru the
AceComm Dialer Menu. Mailer mode, File Requests which
get their phone numbers from either a FIDO NODELIST,
of FBL output .NOD file do use the Dialer Menu and do
receive number translation from "Dial" statements.
- Line Control 2400L,8N1
Most remote HOSTS will be set up using 8 data bits, No parity,
and 1 stop bit. Compuserve uses 7 data bits, Even parity, and
1 stop bit. AceComm will configure the UART to assemble the in
coming bit stream into characters, based on the configuration
defined here. Baud rate means nothing when LOCKBAUD is set, as
is with the "L" appended to baud in this example. Other wise,
when LOCKBAUD is not set, AceComm will set the UART up to the
Fon.Record baud rate.
Note: When LOCKBAUD is not set, AceComm is also capable of
resetting the baud rate to a connect string. If you dial
out at 2400, and connect at 9600, and 9600 is detected in
the the connect string, AceComm will automatically set
the baud to 9600. If LOCKBAUD is set, AceComm leaves
baud alone.
- Terminal Emulation Av/An
This option will present the Terminal emulations menu, you may
select the video ,type you want associated with this record.
"Av/An means AVATAR and ANSI video emulation.
- Control Flags Macro,DTag,Capture,Text,IEMSI,AutoL
╔═ Control Flags═════════════════╗
║ Tag dial attempts On ║
║ Auto log on method Macro, ║
║ Open Capture file on On ║
║ Capture mode Text, ║
║>Allow IEMSI log on On ║
║ Allow auto log on On ║
╚═══ Edit Quit ┤<>v^├═════════════╝
"Script" when set,
AceComm will attempt to load and run the filename defined next
to "AutoLogOn Script". If a script file is not found, AceComm
ignores the error and continues normal operation.
Notes: .SCR files are looked for in the directory defined
Page 71 "AceComm & Utilities"(Tm) v 1.7
Chapter 6 TELEPHONE DIRECTORY AREA
inside PRM-data Area "Directories"
"Macro" when set,
AceComm will enable the defined Auto Log on Sequence Triggers
and corresponding MACRO stacks.
"DTag" when set,
AceComm will tag un-successful dial attempts (busy, etc.) to
the Que Dialer. An "*" character appears to the left of a
Fon.Record's display line, when it is either Q tagged or, D
tagged. When this flag is not set, the only other way to Q tag
a record is by manually selecting the menu option
"<SPACEBAR>-Que" from the fon list display.
"Capture"
When this flag is selected, a capture file is opened upon
Dial/Connect. Any previously open capture file is first closed.
"IEMSI"
Allow Interactive EMSI log on
"AutoL"
Allow auto log on methods (script/macro)
- Dialing Prefix
The Fon.Record dial prefix overrides The PRM-data default
prefix. If this field is null (blank), AceComm uses the
PRM-data default dial prefix.
- AutoLogOn Script ACE_S.SCR
When SCRIPT flag is set, for the current Fon.Record, AceComm
will use this filename, opening it as a SCRIPT file, and run
the contents. This action takes place upon successful
Dial/Connect. If the filename does not exist, AceComm simply
goes about it's business, and you will log on normally.
AceComm will look for the SCRIPT filename in PRM-data DIR .SCR
path.
- Capture File ACE_S.CAP
Default filename presented to user when opening a "capture data
to file" file.
- Password my/password
See also: Expandable MACRO Parameters <SendStr> [FON_PASSWORD]
would replace "[FON_PASSWORD]" with "my/password" for this
example. You may define the Fon.Record PASSWORD field to any
character combination, the field maximum length is 19
Page 72 "AceComm & Utilities"(Tm) v 1.7
Chapter 6 TELEPHONE DIRECTORY AREA
characters.
- Custom .KBD File MY.KBD
KeyBoard File, AceComm will first remember what the current KBD
filename is, load the Fon.Record's custom KBD file, if defined,
and finally restore the original KBD file after session
disconnect. Say What?
You are about to log onto Compuserve. You have CIS.KBD file
defined for the Fon.Record. When dial/connect is detected,
AceComm will load the contents of CIS.KBD, overlaying your
current keyboard MACRO assignments. When you log off of
Compuserve, and AceComm detects the carrier drop (no DCD),
AceComm will load back the original keyboard file, overlaying
your custom CIS.KBD.
You will need to distinguish KBD files from KTS files. Where a
KBD file overlays the keyboard MACRO assignments. The KTS file
defines the ultimate sequence that will be sent to the modem
for a given key-press. Keys assigned a MACRO, are processed as
MACRO functions.
Keys not assigned a MACRO(s) will be sent to the modem, and are
candidates for KTS.
Keys with extended codes, are sent as they would be seen in
DoorWay mode. Normal keys (a-z,A-Z,1-0,CTRL A-CTRL Z, etc.)
are sent in their normal lower ascii representation (as you
would expect). Now, any of these key-presses that have been
defined inside the KTS file, are translated into their defined
sequence. AceComm & Utilities provides ASCII examples for
compiling KTS files, as well as KTS.EXE the custom Keyboard
Sequence Translation (Tm) compiler.
- Auto Log on Sequence Trigger/MACRO Stack
Each Fon.Record can be assigned to one of the Auto Log on
definitions available from a menu when selecting this option.
AceComm will respond to a sequence trigger by processing the
MACRO stack. Log on sequence trigger scanning is available
immediately after connect, and until the sequence has been
found. When a log on sequence has been processed, AceComm
stops scanning for the log on sequence.
Page 73 "AceComm & Utilities"(Tm) v 1.7
Chapter 7 INTERNAL FILE LISTER
╔═D:\ACE═══════════════════════════════╗
║> 1_114.FON 26368 06/27/93 07:25 ║
║ ACE.ASM 8269 06/26/93 18:00 ║
║ ACE.CTL 13589 06/25/93 08:04 ║
║ ACE.EXE 196102 06/27/93 07:24 ║
║ ACE.FON 1600 06/27/93 04:13 ║
║ ACE.HLP 44572 06/27/93 07:09 ║
║ ACE.LOG 3694 06/27/93 07:29 ║
...
║ ACTL.ASM 101998 06/25/93 14:22 ║
║ Utility New_Dir Change_Drive ║
╚═ Tag Delete Quit Help ┤<>v^├══════╝
- Utility
This selection brings up a sub-menu of pre-defined executable.
AceComm contains several sub-menus for this purpose. Sub-menu
selected is determined by the "highlighted" files's extension.
The %FN symbol is documented in MACRO.DOC. %FN is an
Expandable MACRO Function. %FN argument to a MACRO from
anywhere inside the "File Lister" menus is replaced with FULL
PATH NAME for the current high lighted filename.
╔═C:\DOC═══════════════════════════════╗
║ A.SNA 1242 06/27/93 07:53 ║
║ ACE.BAK 117893 06/26/93 12:25 ║
║ ACE.CHA 2706 06/27/93 07:46 ║
║>╔═%FN = C:\DOC\ACE.DOC══════════════════════════════════
║ ║ <RunProgram> BB %FN
║ ║><RunProgram> LIST %FN
║ ║ <RunProgram> QEDIT %FN
║ ║ <RunProgram> GREP %PF %FN %PF
║ ║ <RunProgram> PATCH %FN
║ ╚═ Select Edit Quit ┤<>v^├════════════════════════════
║ COVER 213 06/25/93 16:22 ║
║ CREDIT.CRD 2918 06/25/93 15:30 ║
...
║ FILE_ID.DIZ 392 06/26/93 13:14 ║
║ Utility New_Dir Change_Drive ║
╚═ Tag Delete Quit Help ┤<>v^├══════╝
- New_Dir
Allows changing directories. AceComm changes directories right
along with the display. When you use AceComm's "Utils" Menu,
work is done in the currently listed directory unless otherwise
redirected via MACRO arguments or overriding external
Page 74 "AceComm & Utilities"(Tm) v 1.7
Chapter 7 INTERNAL FILE LISTER
executable configurations.
Notes: AceComm always returns to the starting directory after
leaving the FileLister Area.
╔═D:\ACE═══════════════╗
╔═D:\ACE═══════════║>>D:\ACE ║
║> 1_114.FON 263║ >.. ║
║ ACE.ASM 826║ >CAP ║
║ ACE.CTL 135║ >CVTFON ║
║ ACE.EXE 196║ >FILES ║
║ ACE.FON 160║ >FON ║
║ ACE.HLP 445║ >KTS ║
║ ACE.LOG 369║ >MAIL ║
║ ACE.MAP 920║ >SCR ║
║ ACE.OBJ 271║ >SND ║
║ ACE.PRM 378║ >XTRA ║
║ ACEBOX.INC 345║ >ZEN ║
║ ACEM 253║ >F ║
║ ACEORDER.FRM 588╚═ Select Quit ┤<>v^├═╝
║ ACET.SCR 809 05/17/93 21:33 ║
...
║ ACTL.ASM 101998 06/25/93 14:22 ║
║ Utility New_Dir Change_Drive ║
╚═ Tag Delete Quit Help ┤<>v^├═════╝
- Change Drive
Allows listing another drive.
╔═D:\ACE═══════════╔══════════════════════╗
║> 1_114.FON 263║>A ║
║ ACE.ASM 826║ B ║
║ ACE.CTL 135║ C ║
║ ACE.EXE 196║ D ║
║ ACE.FON 160║ E ║
║ ACE.HLP 445╚═ Select Quit ┤<>v^├═╝
║ ACE.LOG 3694 06/27/93 07:29 ║
...
║ ACTL.ASM 101998 06/25/93 14:22 ║
║ Utility New_Dir Change_Drive ║
╚═ Tag Delete Quit Help ┤<>v^├══════╝
- Tagged files
Tagged files are stored in the file "UPLDS.LST" when tagged from
inside the <FileLister_> MACRO. When tagged from any of
AceComm's internal protocol sending units, tagged filenames are
stored into a temporary file. The temporary file is deleted
after each use. UPLDS.LST files are not deleted, but instead
Page 75 "AceComm & Utilities"(Tm) v 1.7
Chapter 7 INTERNAL FILE LISTER
stored ready.
AceComm will look for UPLDS.LST when any internal batch capable
protocols are selected. If found, AceComm will ask the user is
sending the contents of UPLDS.LST is desired, if (Y)es, AceComm
will attempt to send all filenames listed in the UPLDS.LST file,
if (n)o, AceComm will present the the File Input' menu.
╔═D:\ACE═══════════════════════════════╗╔═UPLDS.LST════════════
║ 1_114.FON 26368 06/27/93 07:25 ║║>D:\ACE\1_114.FON
║> ACE.ASM 8269 06/26/93 18:00 ║║
║ ACE.CTL 13589 06/25/93 08:04 ║║
║ ACE.EXE 196102 06/27/93 07:24 ║║
║ ACE.FON 1600 06/27/93 04:13 ║║
║ ACE.HLP 44572 06/27/93 07:09 ║║
║ ACE_MAIL.CFG 430 06/22/93 14:23 ║║
...
║ ACTL 591 06/22/93 14:08 ║║
║ ACTL.ASM 101998 06/25/93 14:22 ║║
║ Utility New_Dir Change_Drive ║╚══════════════════════
╚═│Tag│ Delete Quit Help ┤<>v^├══════╝
- Delete
Delete option presents a full path spec for the high lighted
filename, prompting confirmation before deletion.
╔═D:\ACE═══════════════════════════════╗
║ 1_114.FON 26368 06/27/93 07:25 ║
║>╔═══════════════════╗ 06/27/93 07:31 ║
║ ║ D:\ACE\A.SNA ║ 06/26/93 18:00 ║
║ ║ Delete this file? ║ 06/27/93 07:31 ║
║ ║>(Y)es/(n)o?: ║ 06/25/93 08:04 ║
║ ╚═══════════════════╝ 06/27/93 07:24 ║
║ ACE.FON 1600 06/27/93 04:13 ║
║ ACE.HLP 44572 06/27/93 07:09 ║
║ ACE_DEF.KBD 11120 06/27/93 07:29 ║
...
║ ACE_MAIL.CFG 430 06/22/93 14:23 ║
║ Utility New_Dir Change_Drive ║
╚═ Tag Delete Quit Help ┤<>v^├══════╝
Page 76 "AceComm & Utilities"(Tm) v 1.7
Chapter 8 POINT MAIL FUNCTIONS
╔═Point Mail Setup═════════════════════════════════════╗
║> Address 1:114/35 ║
║ Sys Name AceComm Support ║
║ City Phoenix, AZ ║
║ Operator Michael Phelps ║
║ Sys Phone (602) 846-2940 ║
║ Baud 14.4 ║
║ Flags v32b ║
║ Dial filter ║
║ Dial filter ║
║ Dial filter ║
║ Dial filter 1-602-451 1-451 ║
║ Dial filter 1-602- ║
║ Password 1:114/12 mailman ║
║ Password 1:114/7 doorman ║
║ Password 1:114/116 pdnman ║
║ Password ║
║ Password ║
║ Nodelist: D:\ACE\fon ║
║ .REQ/.MLF: D:\ACE\mail ║
╚═══ Edit Quit ┤<>^v├═════════════════════════════════╝
EMSI handshake data
The following data is presented to the remote mail system
during EMSI handshaking.
Address
Sys Name AceComm Support
City Phoenix, AZ
Operator Michael Phelps
Sys Phone (602) 846-2940
Baud 14.4
Flags v32b
Password -- Pre arranged between two systems.
The following example will cause AceComm to fill in the EMSI
data field for "password" with 'mailman' when the target
system's address is 1:114/12.
Password 1:114/12 mailman
Dial filter -- AceComm will use Dial statements to modify
phone numbers. Dial filter statements are used when dialing
from inside of AceComm's phone directory, and or with mail
functions.
A long distance BBS directory list can be used without
editing phone numbers.
Page 77 "AceComm & Utilities"(Tm) v 1.7
Chapter 8 POINT MAIL FUNCTIONS
The following dial statement filter "1-602-" from all phone
numbers the string is found in.
Dial filter 1-602-
The following dial statement converts "1-602-451" found in
phone numbers to "1-451".
Dial filter 1-602-451 1-451
Dial statements are required when using point mail
functions, because NODELIST phone numbers contain area
codes. AceComm uses dial statements to know how to modify
phone numbers.
Point mail functions look in the PRM-data directory "NODELIST"
for systems directories. Point mail functions require either
of two types systems directories.
Systems directory type (FIDO NODELIST)
FIDO NODELIST is a systems directory that most EMSI capable
HOST systems use. AceComm can use a FIDO NODELIST. To use
the FIDO NODELIST, you must first compile an INDEX file.
AceComm uses NLIST.IDX. NLIST.IDX contains a quick look up
table for Zone:Net/Nodes in the FIDO NODELIST. The AceComm
package provides IDX.EXE as a utility to create the
NLIST.IDX file. NLIST.IDX and the NODELIST are to be found
inside of the PRM-data directory "NODELIST".
Systems directory type (FBL.EXE output .NOD file)
.NOD file is a NET extraction from the FIDO NODELIST.
FBL.EXE (provided) is capable of creating this file. .NOD
files contain a listing for a single NET. .NOD files are
very small and may be preferable for point mail use where
calling 1 or a few pre know NETS is intended. .NOD files
are to be found inside of the PRM-data directory "NODELIST".
Page 78 "AceComm & Utilities"(Tm) v 1.7
Chapter 9 MOUSE SUPPORT
Support for a pointer device has been implemented into AceComm
using the Microsoft Mouse Driver functions. Your Microsoft
compatible mouse should work with AceComm.
-- Mouse in Terminal Area --
o Pressing the left mouse button sends <CR>
o Pressing right mouse button sends the character the mouse
cursor is highlighting.
From Terminal Area, a one line mouse menu is presented on the top
row of the screen. This menu presents several of the more
commonly used MACRO functions otherwise available from the
Terminal Area with a key press.
Placing the mouse cursor over a menu choice and pressing the left
button selects the menu item.
The menu can be toggled off from the PRM-data Terminal Options
menu.
The mouse can be used for Character I/O with the HOST. The left
button sends <CR> character. The right button sends the current
highlighted character.
-- Mouse in Menu Areas --
o Pressing the left button selects an item.
o Pressing the right button is the same as <ESC> or Quit
Horizontal and vertical sensitivity can be adjusted from
inside the PRM-data general controls menu.
The mouse detection can be toggled "OFF" from inside the
PRM-data General Controls menu.
Turning "OFF" mouse detection completely disables AceComm
from any mouse function related use, including Terminal Area
mouse menu.
Page 79 "AceComm & Utilities"(Tm) v 1.7
Chapter 10 ACECOMM DATA FILES
- ACE.PRM
ACE.PRM is a binary file which contains all of AceComm's
memory, so to speak. When AceComm is started it reads the
ACE.PRM file. All your serial data, modem data, the keyboard
assignments, menu-usage, customizing and so on is stored in
ACE.PRM. PRM-data Area edits the ACE.PRM data, and when
AutoSave is "ON", all data is saved each time you leave
PRM-data Area. When AceComm is terminated, the PRM-data is
saved to ACE.PRM.
- ACE.CTL
ACE.PRM can be rebuilt using the ACTL.EXE utility. ACTL.EXE
reads and formats a .CTL file into ACE.PRM. A default .CTL
file comes with the AceComm package. The default filename is
ACE.CTL.
Page 80 "AceComm & Utilities"(Tm) v 1.7
Chapter 10 ACECOMM DATA FILES
KTS files
- .KTS/.ASC/.BIN files
Key Translation Sequence files are used when you want a key
press to be translated into a sequence of characters. A good
example of KTS is in the ANSI.KTS file. Here, keys such as Up
Arrow are defined to send an ansi escape sequence that the
HOST'S video can read, and bounce back, decrementing the cursor
position by 1.
A utility KTS.EXE is provided with the AceComm package, which
allows you the user to compile .ASC files into .KTS file.
You can look at the included .ASC files, that come inside
KTS_SFX.EXE, as an example to work from. The ANSI.ASC file was
compiled by KTS.EXE into ANSI.BIN. ANSI.BIN is exactly the
same as ANSI.KTS. The .BIN extensions is used so that a
working .KTS file is not overwritten. You need to rename .BIN
files to .KTS when ready for use.
Notes: Keys assigned KTS are processed only if not defined in
KBD. When a key is assigned to a MACRO(s), the MACRO(s)
take priority and are processed. Do not assign MACRO(s)
to key-presses you want to KTS.
.KTS has it's directory definition optionally defined inside
PRM-data area.
Page 81 "AceComm & Utilities"(Tm) v 1.7
Chapter 10 ACECOMM DATA FILES
KBD files
- .KBD
KBD files give the user ability to keep more than one keyboard
layout for AceComm operations.
KBD KeyBoarD files contain the MACRO assignments for the
keyboard. When AceComm is first installed, the file
"ACE_DEF.KBD" is used as a default keyboard (KBD). When
AceComm is started, it reads the "current" KBD file. "Current"
KBD file is the default ("ACE_DEF.KBD" or the last KBD "Load"ed
from inside the PRM-data menu area.
When you "Load" a KBD file from inside PRM-data area, The KBD
file becomes "current". This means that any changes you make
to the key definitions are saved to the "current" KBD file.
Updating the "current" KBD file is done automatically when
leaving PRM-data area when "AutoSave" is "ON" (default). When
"AutoSave" is "OFF" you need to manually select the "Save"
option from the main PRM-data menu. Do not confuse "Save"
with "Write". "Write" is an option found inside the "KeyBoarD
MACRO Assignments" menu. "Write does not save changes to the
"current" KBD file, but prompts the user for a filename, and
creates or overwrites a new or existing KBD file. Then "Write"
re-loads the "current" KBD file.
KBD files are also used with Fon.Records. The AceComm package
comes with a "CIS.KBD" file example. The ACE.FON file, also
provided with the AceComm package, contains a record for CIS
(local Phoenix). This Fon.Record (CIS) has defined as a KBD
file, "CIS.KBD". When dialing a Fon.Record that contains a KBD
file definition, AceComm will upon successful Dial/Connect,
load the KBD file associated with the Fon.Record. This custom
KBD file is valid for the time that AceComm detects CARRIER
(DCD), or the user loads another KBD file from inside the
PRM-data area. When AceComm detects that the Dial/Connect call
is over, (DCD drops),
AceComm will:
Write the Fon.Record's KBD file, saving any
changes that may have been made to it while on
line.
Re-load the KBD file that was in affect before the
connection was established to system that had a
KBD file associated with it's Fon.Record.
Page 82 "AceComm & Utilities"(Tm) v 1.7
Chapter 10 ACECOMM DATA FILES
KBD files (continued)
KBD files may be associated to a Fon.Record from inside the
telephone directory area, "Edit" option.
Page 83 "AceComm & Utilities"(Tm) v 1.7
Chapter 10 ACECOMM DATA FILES
REQ/MLF,BCH,SCR,FON files
- .REQ/MLF
Filenames created with ".REQ" extensions are used when making
File Requests on EMSI FIDONET style systems. REQ files are a
list of <CR> <LF> terminated filenames. This REQ file is sent
to the system the File Request is being made on, the system
will send from the list.
Filenames created with ".MLF" extensions are used for
Attaching (sending) files to EMSI FIDONET style systems. MLF
files are a list of <CR> <LF> terminated filenames. AceComm
sends from the list (LISTFILE).
.REQ/MLF has it's directory definition optionally defined
inside PRM-data area.
- .LST
AceComm creates LISTFILES with .BCH extensions. A .BCH
extended LISTFILE is created from inside the "FileLister"
(<FileLister_> MACRO) area. Filenames "Tagged" from inside
"FileLister" are stored inside a file "UPLDS.LST". AceComm's
internal batch protocols will send from "UPLDS.LST" by default,
you do have the option of creating another LISTFILE, or
entering filenames manually.
- .SCR
AceComm forces ".SCR" file extensions onto script files.
Script files may be generated automatically using AceComm's
AutoScriptGen (Tm). Script files may be loaded from the
terminal area, or used as AceComm's only argument when starting
AceComm. Script files may be associated with
Fon.Records from inside "Edit" option. Script files associated
with a Fon.Record are:
Upon successful Dial/Connect AceComm creates an "Event" just
prior to exiting back to terminal Area. The "Event" is to run
the Script file associated with the Fon.Record. Typically,
this Script file will contain some auto log on MACROS. The
Script plays out, end of "Event"
.SCR has it's directory definition optionally defined inside
PRM-data area.
- .FON
Telephone directory files are forced the ".FON" file
Page 84 "AceComm & Utilities"(Tm) v 1.7
Chapter 10 ACECOMM DATA FILES
REQ/MLF,BCH,SCR,FON files (continued)
extensions. All Fon.Records are stored inside of FON files.
AceComm FON files can hold up to 250 records each. AceComm
allows unlimited FON files. Selection of FON files is made
available from inside the Fon.List area using "Fon_Files"
option.
.FON has it's directory definition optionally defined inside
PRM-data area.
Page 85 "AceComm & Utilities"(Tm) v 1.7
Chapter 11 WARRANTY
DISCLAIMER - AGREEMENT
Users of AceComm must accept this disclaimer of warranty:
AceComm is supplied as is. The author disclaims all warranties,
expressed or implied, including, without limitation, the
warranties of merchantability and of fitness for any purpose.
The author assumes no liability for damages, direct or conse-
quential, which may result from the use of AceComm.
Page 86 "AceComm & Utilities"(Tm) v 1.7
Chapter 12 LICENSE
AceComm is not a Public Domain program and is not free. AceComm
is copyright (C) 1990-1993 by MGP Programming Services.
Non-registered users of this program are granted a limited 30 day
license to evaluate the programs suitability for their
requirements. Any usage of AceComm beyond the evaluation time
period requires registration of each copy of the program used.
Use of non- registered copies of AceComm beyond the original
evaluation period is prohibited.
AceComm may NOT be modified in any respect, for any reason,
including but not limited to, de-compiling, disassembling, or
reverse engineering of the program. The opening title screen,
help screens, and all other proprietary program output must never
be altered, removed, bypassed or modified by any means.
You are free to distribute the PUBLICLY AVAILABLE evaluation
version of AceComm to others subject to the above restrictions
and also the following:
A. No fee is charged for its use.
B. No re numeration may be accepted for AceComm. This does
not apply to computer access charges the system
operators (Sysops) of or organizations owning bulletin
board systems, on line services, etc... may charge
subscribers.
C. AceComm must be copied in unaltered form, complete with
files containing license information, the FULL
documentation and all accompanying files. The
self-extracting archive distributed by MGP Programming
Services must not be altered in ANY respect.
D. All shareware houses/distribution firms must make
explicitly clear that the diskette purchase containing
any shareware program has NOT registered the software
with the author MGP Programming Services Software/Michael
G Phelps.
Page 87 "AceComm & Utilities"(Tm) v 1.7
Chapter 12 LICENSE
System Operators may make AceComm available for download only if
the above conditions are met. The archive (Acennnn.EXE)
distributed by AceComm or an equivalent archive may be made
available only in complete form. Refer to FILELIST.DOC to verify
complete package contents. If the contents appear altered or not
complete, you may obtain the latest release of AceComm directly
from MGP Programming Services by sending a formatted diskette
labeled with the word "AceComm". Please include $5 for handling.
The latest version of AceComm is also available on Compuserve.
Commercial distributors of "Public Domain", "Shareware", and/or
User Supported software may distribute AceComm subject to the
above conditions only after obtaining WRITTEN permission from MGP
Programming Services. This condition statement supersedes all
previous agreements.
Please refer to the section entitled registration/ordering
section for additional information on registration, corporate
site-licensing and related topics.
Page 88 "AceComm & Utilities"(Tm) v 1.7
Chapter 12 LICENSE
The above license statement does not apply to the REGISTERED
version of AceComm. The registered software of MGP Programming
Services is protected under United States Copyright and Trademark
Laws. It must be treated just like a book with certain
exceptions as follows:
A. MGP Programming Services authorizes the making of archival
copies of the registered software for the sole purpose of
backing-up your software and protecting your investment
from possible loss.
B. The medium on which the registered software is recorded is
transferred to the customer, but not the title to the
software.
C. The customer may resell or distribute unmodified copies of
the registered software provided the customer has
purchased from MGP Programming Services one copy of the
registered software for each one sold or distributed.
The provisions of this software license shall also be
applicable to third parties receiving copies of the
registered software from the customer.
D. By saying, "just like a book", MGP Programming Services
means that the registered software may be used by any
number of people and may be freely moved from one computer
location to another so long as there is ABSOLUTELY NO
POSSIBILITY of it being used at one location while being
used at another. Just like a book that cannot be read by
two different people in two different locations at the
same time.
Page 89 "AceComm & Utilities"(Tm) v 1.7
Chapter 13 ACECOMM User Support
Contacting the author
You can get more help by contacting th
author Michael Phelps at the following
- VOICE 602-846-4563 6 days 12-7pm MST
- BBS 602-846-2940 24 hours
- COMPUSERVE User ID 75120,3306
- FIDONET ADDRESS 1:114/35
- FIDONET ACECOMM ECHO
I distribute the "ACECOMM" echo to
USA NODES, until it makes BACKBONE.
- Write to: AceComm Software Support
3003 North Central Ave
Suite 121-171
Phoenix, AZ 85012 USA
Page 90 "AceComm & Utilities"(Tm) v 1.7
Chapter 14 Registering AceComm
Registering AceComm gives you access to one of the most
powerful communications programs available.
o Registering AceComm allows you to legally use the product after
the trial period.
o You need only Register AceComm 1 time
o Registration gives you a license to use the AceComm
package for un limited use, and the following advantages.
- Up to date printed bound manual
- Major Version upgrade notices sent
- Commercial AceComm on Disk
Eventually Registered copies of AceComm versions will run 1
year or more ahead of the publicly available "try before you
buy" versions. AceComm will continue to provide "pace
setting" features, "intelligent software technology" making
the most of your on line time.
- Unlimited software support (See SUPPORT.DOC)
- 1 Free upgrade to a version of your choice
The FREE upgrade package includes the above and can be
obtained at any time down the road by sending in an AceComm
order form with the FREE upgrade information line filled out.
Most importantly, registered users know they are helping to make
sure that high-quality software like AceComm continues to be
offered at low cost.
To place an order, please use the order form contained in
the file "ACEORDER.FRM".
Page 91 "AceComm & Utilities"(Tm) v 1.7
Chapter 14 Registering AceComm
AceComm & Utilities (Tm)
Version 1.7
ORDER FORM
FROM:
Name: ____________________________________________________
[Company]: ____________________________________________________
[Title]: ____________________________________________________
Address: ____________________________________________________
City: ____________________________________________________
State: ___________________________ Zip Code: ______________
Country: ___________________________ Phone: _________________
TO:
AceComm Software
3003 N. Central Ave. #121-171
Phoenix, AZ 85012 USA
┌─────────┐
┌─────┴───┐ │ (R)
──│ │o │──────────────────
│ ┌─────┴╨──┐ │ Association of
│ │ │─┘ Shareware
└───│ o │ Professionals
──────│ ║ │────────────────────
└────╨────┘ MEMBER
Page 92 "AceComm & Utilities"(Tm) v 1.7
Chapter 14 Registering AceComm
AceComm & Utilities (Tm)
Version 1.7
ORDER FORM
Telephone (602) 846-4563 AceComm Support Services
AceComm BBS (602) 846-2940 3003 N. Central Ave Suite 121-171
CompuServe 75120,3306 Phoenix, AZ 85012 USA
================================================================
Individual Registration Licensing use of AceComm and Utilities
- commercial version software & documentation on diskette
- printed bound manual, upgrade notices)
- 1 upgrade sent FREE (you choose the version)
- all future upgrades at very low cost of 20%
1'st FREE & all future upgrades include disk/printed manual
for MS-DOS: 1 Purchase at $45 . . . . . . . . . . . . . ______
================================================================
INTERNAL SITE LICENSE for the use of AceComm & Utilities for DOS
- commercial version software & documentation on diskette
- 1 upgrade sent FREE (you choose the version)
- all future upgrades at very low cost of 20%
Quantity Registrations
----------------------
10 - 50 .. at $32 each, nbr computers ___x 32 _____
50+ call for special discount
custom features available
call for quantity manual pricing
================================================================
Overseas add $7.00/order for shipping and handling _____
Diskette format (choose one) 5.25" disk (__) 3.5" disk (__)
================================================================
TOTAL PRODUCTS _____
Sales tax for Arizona residents 6.5% _____
TOTAL ORDER _____
For payment by non-USA BANK CHECK, add $40.00 _____
Payment method: TOTAL ENCLOSED _____
( ) Check ( ) Cash
( ) Money order ( ) Send FREE Upgrade
Page 93 "AceComm & Utilities"(Tm) v 1.7
Chapter 14 Registering AceComm
( ) Credit card - See instructions in file CREDIT.CRD
================================================================
AUTHORIZED SIGNATURE: __________________________________________
TITLE: ____________________________________ DATE: _____________
Page 94 "AceComm & Utilities"(Tm) v 1.7
Chapter 14 Registering AceComm
AceComm & Utilities (Tm)
Version 1.7
Credit Card Order Form
As a service to AceComm customers who want to register by credit
card, arrangements have been made with the Public Software
Library (PSL) to handle all credit card registrations. PSL
accepts Visa, MasterCard, American Express, and Discover Card.
Non-U.S. residents are encouraged to register by credit card.
In many cases, paying by credit card will be easier than
acquiring U.S. funds.
PSL will take the order information and forward it to the AceComm
author, MGP Programming Services & Michael G Phelps for
processing and shipping.
Page 95 "AceComm & Utilities"(Tm) v 1.7
Chapter 14 Registering AceComm
AceComm & Utilities (Tm)
Version 1.7
AceComm Software Credit Card Registration Form
PSL Part number 10805
The PSL part number for AceComm is: 10805
Credit card registrations may be made by the following methods:
-- Phone PSL at:
800-242-4775 (Toll free) To register by credit card.
713-524-6394 To register by credit card and for order
inquiries.
Be sure to have BOTH the credit card form at the end of this file
PLUS the order form in the file ORDERFRM.DOC available to give
order information to PSL.
ACCURACY in phone ordering is important! Misspellings can result
in delays or an erroneous registration.
-- FAX PSL at 713-524-6398
-- Email PSL at CompuServe user id 71355,470
-- Write PSL at:
The Public (Software) Library
P.O. Box 35705
Houston, TX 77235-5705
USA
PSL Part number 10805
For FAX, email, or mail to PSL, send BOTH the credit card form at
the end of this file PLUS the order form in the file
ORDERFRM.DOC.
The Public Software Library also maintains a vast library of
shareware and public domain programs and prints a monthly
magazine announcing new releases and general software news.
Page 96 "AceComm & Utilities"(Tm) v 1.7
Chapter 14 Registering AceComm
AceComm & Utilities (Tm)
Version 1.7
AceComm Software Credit Card Registration Form
PSL Part number 10805
Please complete this form AND the regular order form in the file
ORDERFRM.DOC and send BOTH *** DIRECTLY *** to:
The Public (Software) Library
P.O. Box 35705
Houston, TX 77235-5705
USA
Date ________________________
Name: _____________________________________________________
[Company:] _____________________________________________________
Address: _____________________________________________________
: _____________________________________________________
: _____________________________________________________
Payment by: ( ) MasterCard ( ) Visa
( ) American Express ( ) Discover Card
Card #: ______________________________ Exp. Date: ___________
Signature of card holder: ______________________________________
PSL Part number 10805
Page 97 "AceComm & Utilities"(Tm) v 1.7