home *** CD-ROM | disk | FTP | other *** search
/ World of Ham Radio 1997 / WOHR97_AmSoft_(1997-02-01).iso / misc / pams_20 / amsoft.iii next >
Text File  |  1997-02-01  |  67KB  |  1,674 lines
  1.                                32
  2.  
  3.  
  4.                       Operators Manual for
  5.               PAMS - Personal Amtor Mailbox System
  6.             AMCS - Amtor Message Center System (MARS)
  7.                 February 22, 1992 - Version 2.00
  8.                                 
  9.          Copyright (c) 1991-1992 - Victor D. Poor, W5SMM
  10.                                 
  11.                                 
  12.               Introduction . . . . . . . CHAPTER 1
  13.                                 
  14.               Hardware Installation  . . CHAPTER 2
  15.                                 
  16.               Software Installation  . . CHAPTER 3
  17.                                 
  18.               The Configuration File . . CHAPTER 4
  19.                                 
  20.               Character Sets . . . . . . CHAPTER 5
  21.                                 
  22.               The Forwarding File  . . . CHAPTER 6
  23.                                 
  24.               Starting the System  . . . CHAPTER 7
  25.                                 
  26.               Bulletins  . . . . . . . . CHAPTER 8
  27.                                 
  28.               Logs . . . . . . . . . . . CHAPTER 9
  29.                                 
  30.               Console Operation . . . . CHAPTER 10
  31.                                 
  32.               Program Distribution  . . CHAPTER 11
  33.                                 
  34.               AMTOR Channel Commands  . APPENDIX A
  35.                                 
  36.                                 
  37.                             CHAPTER 1
  38.                                 
  39.                           Introduction
  40.                                 
  41. TWO SYSTEMS IN ONE
  42.  
  43.      This program has two personalities.  If the program is
  44. started with a configuration file named PAMS.CNF it is a Personal
  45. Amtor Mailbox System (PAMS) for use on amateur radio.  If the
  46. program is started with a configuration file named AMCS.CNF it is
  47. an Amtor Message Center System (AMCS) for use on the U.S.
  48. Military Affiliate Radio System (MARS).  Because of the
  49. differences in protocols between the two services the two modes
  50. are incompatible and require different operating modes.
  51.  
  52. WHAT THE SYSTEM DOES...
  53.  
  54.      The PAMS/AMCS is a software system that runs under MS-DOS
  55. 3.x or higher on an IBM-XT or compatible computer.  It provides
  56. an AMTOR terminal program and personal mailbox (MBO) system that
  57. is compatible with APLINK when configures as PAMS.  PAMS/AMCS
  58. contains all of the required protocol to send and receive
  59. messages automatically between other PAMS/AMCS' and between PAMS
  60. and APLINK stations.  It may be operated unattended to accept
  61. connections from other stations automatically.
  62.  
  63.      The system conforms as closely as possible to the
  64. conventions that have evolved for the use of packet BBSs. There
  65. are differences necessitated by the nature and constraints of the
  66. AMTOR mode.  For this reason, as well as the fact that AMTOR does
  67. not automatically identify a sending station, the system requires
  68. positive identification during login.  The system will also
  69. request confirmation of the addressee when entering messages into
  70. the system (unless the user has selected 'EXPERT' mode).
  71.  
  72.      By setting certain parameters in the configuration and
  73. forwarding files, PAMS/AMCS may serve as a general purpose AMTOR
  74. mailbox, operating exactly as APLINK except that there is no
  75. facility for interconnecting with the packet system.
  76.  
  77.  
  78. THE OPERATOR INTERFACE
  79.  
  80.      The keyboard commands for this program use a minimum of
  81. function and special keys.  It has been designed to be easy to
  82. use across all of the keyboard types found on personal PCs
  83. including lap top and notebook versions.  In particular, the TAB
  84. key - which is of no other use when using AMTOR - is used to
  85. initiate virtually all channel commands.  All keyboards have the
  86. TAB key in nearly the same place.
  87.  
  88.      For those operators already familiar with running APLINK a
  89. little extra time may be needed for 'retraining'.
  90.  
  91.  
  92.  
  93.                             CHAPTER 2
  94.                                 
  95.                       Hardware Installation
  96.                                 
  97. The equipment required to run this system includes:
  98.  
  99.      1. IBM-XT or close clone running MS-DOS 3.x or higher.  A
  100. hard disk is needed if you are serving as a general access
  101. mailbox.  When simply running as a personal mailbox you should be
  102. able to run using only diskettes.  At least one COM port must be
  103. installed and available. (No COM port is required if you are
  104. using a HAL PCI-3000.)  The minimum acceptable free memory is
  105. about 250k.
  106.  
  107.      2. An AMT-1 AMTOR Terminal Unit, a PK-232 AEA AMTOR Terminal
  108. Unit, or a HAL Communications PCI-3000 Terminal Unit.
  109.  
  110.      WARNING - THIS VERSION OF PAMS/AMCS WAS DEVELOPED
  111.      AND TESTED WITH THE FOLLOWING VERSION OF ROMS: IN
  112.      THE AMT-1, VERSION 07A; IN THE PK-232, JULY 1991;
  113.      AND IN THE PCI-3000, VERSION 1.7C.  YOU SHOULD USE
  114.      ONE OF THESE, OR LATER, ROMS IN YOUR AMTOR
  115.      CONTROLLER.  IT IS STRONGLY RECCOMENDED THAT YOU
  116.      NOT RUN THIS VERSION OF PAMS/AMCS WITH EARLIER
  117.      VERSION ROMS.
  118.      
  119.      Contact Jim, KE5HE @ KE5HE.TX.USA if you need new ROMs for
  120. the AMT-1 or the PCI-3000.  Contact AEA for the latest ROM for
  121. the PK-232.
  122.  
  123.      If the AMT-1 is used it should be configured for 110 baud.
  124. All soft configuring is done by PAMS/AMCS at startup.  Only Rx
  125. and Tx signals are used between the AMT-1 and the computer.  Flow
  126. control is performed through use of the status byte from the
  127. AMT-1.  The COM port of choice must be set in the PAMS.CNF for
  128. AMCS.CNF configuration file (see below).
  129.  
  130.      If a PK-232 AEA Terminal Unit is used, the interconnecting
  131. cable between the PK-232 and the serial port should include wires
  132. 1 through 8 and 20 and no others.
  133.  
  134.      If a HAL PCI-3000 is used, simply install the unit as
  135. received from the factory.  Do not use a serial port or connect
  136. to the "host" port on the PCI-3000.  The interface between the
  137. PCI-3000 and PAMS is on the internal PC bus.
  138.  
  139.      3. The r.f. hardware that connects to your chosen terminal
  140. unit I will leave to your imagination.
  141.  
  142.  
  143.                             CHAPTER 3
  144.                                 
  145.                       Software Installation
  146.                                 
  147.      The delivery disk normally contains a self-extracting
  148. archive file.  Create a temporary directory on your hard disk and
  149. copy the archive file into that directory and then run it.  The
  150. following files should appear in the temporary directory:
  151.  
  152.    PAMSAMT.EXE - The main program when using the AMT-1,
  153.    PAMS232.EXE - The main program when using the PK-232,
  154.    PAMSPCI.EXE - The main program when using the HAL PCI-3000,
  155.  
  156.    READ.ME - Read it!,
  157.    COPYRITE - Author's copyright statement,
  158.    HELPWDO - A help file used by PAMS,
  159.    PAMS.ASC - The operator's manual (ASCII format),
  160.    PAMS.DOC - The operator's manual (Microsoft Word format),
  161.    USERS.EXE - The users' file editor,
  162.    PAMS.CNF - A sample system configuration file,
  163.    FORWARD.APS - A sample autoforward routing file,
  164.    HELP - The short form help file,
  165.    INFO - The info file (should be operator edited),
  166.    HELP1. thru HELP9. - Detailed help files the operator will
  167.       install using the SH command.
  168.    INTRCPT.APS - A sample intercept file,
  169.    MBBIOS.COM - A TSR communications port driver,
  170.    MBBCONFG.EXE - The MBBIOS.COM configuration program,
  171.    MBBIOS.DOC - Documentation for MBBIOS.COM,
  172.  
  173. In addition the operator must obtain a copy of the Norton Editor.
  174.  
  175.      To install the system for the first time, simply copy all of
  176. the above files and the Norton Editor (renamed E.COM) into a hard
  177. disk subdirectory named \PAMS or \AMCS.  Rename either
  178. PAMSAMT.EXE, PAMS232.EXE, or PAMSPCI.EXE to PAMS.EXE (or
  179. AMCS.EXE), depending upon which AMTOR terminal you are using.
  180. Add \PAMS\MBBIOS.COM to your AUTOEXEC.BAT file.  When you run
  181. PAMS\AMCS the first time the system will create two
  182. subdirectorys: \PAMS\MESSAGES and \PAMS\ARCHIVE (or
  183. \AMCS\MESSAGES and \AMCS\ARCHIVE).
  184.  
  185.      If you are using a PK-232 for on the AMTOR channel you may
  186. have to use MBBCONFG.EXE to change the configuration of slot
  187. number 1 to hardware handshaking equal to 'Y'.
  188.  
  189.      If you are going to run AMCS, rename PAMS.CNF to AMCS.CNF.
  190.  
  191.      Using the Norton Editor, edit the files PAMS.CNF (or
  192. AMCS.CNF), INTRCPT.APS, and INFO to fit your station.  Edit
  193. USERS.APS with USERS.EXE to add or delete whatever stations you
  194. wish or just let each station be entered into the USERS.APS file
  195. as they log on for the first time.
  196.  
  197.      Your computer's system clock (TIME and DATE command in MS-
  198. DOS) should be set to your local time.  You should add the
  199. following line to your AUTOEXEC.BAT file: 'SET TZ=aaann' where
  200. aaa is a three letter code for your local time zone and nn is the
  201. number of hours difference between your local time zone and GMT
  202. (UTC).  Use a positive number if your are west of Greenwitch and
  203. a negative number if you are east.  For example:
  204.  
  205. SET TZ=EST5
  206.  
  207. should be used for Eastern Standard Time (USA).
  208.  
  209.      Several other files will be created by the system in the
  210. PAMS/AMCS directory when it is first run.
  211.  
  212.      Look at the sample INFO file with the Norton Editor.  You
  213. will see what needs to be done there.
  214.  
  215.      The intercept file, INTRCPT.APS, provides a very special
  216. service.  Each line of the file should contain a station's call
  217. letters, white space, and an h-route - AND NOTHING ELSE.  Each
  218. time a message is entered into PAMS/AMCS (either from over the
  219. air or from the operator) the file is searched for a match to the
  220. TO field of the incoming message, if nothing is found then a
  221. search is made on the first token of the AT field.  If the first
  222. call on any line matches, then the h-route is placed in the AT
  223. field of the message.   Note in the sample provided that the
  224. first line of the file reads:
  225.  
  226. W5SMM   WA8DRZ.#NOCAL.CA.USA.NA
  227.  
  228. This means that any message for W5SMM entering the system will be
  229. forwarded to him at WA8DRZ.  (In fact, W5SMM requests that all
  230. sysops leave his call in the intercept file as shown.)
  231.  
  232.  
  233.                         INSTALLATION NOTE
  234.                                 
  235.      If you are using Desqview be sure to allow PAMS/AMCS
  236.      enough time to run.  There is no hard and fast rule
  237.      since it depends strongly on the speed of your
  238.      computer.  If the time allotment gets too short the
  239.      system is painfully slow for your users and in some
  240.      cases will fall far enough behind to cause timeouts.
  241.      This is especially true if you are using the PK-232 .
  242.      The software overhead to run a PK-232 on AMTOR is very
  243.      much higher than for other AMTOR controllers.
  244.      
  245.      
  246.                  NOTE FOR EXISTING APLINK USERS
  247.                                 
  248.      All files with the extension .APS are compatible with
  249.      PAMS/AMCS.  You may switch between PAMS/AMCS and APLINK
  250.      without any problem but you may not run them at the
  251.      same time. To start PAMS/AMCS copy your APLINK.CNF file
  252.      to PAMS.CNF (or AMCS.CNF) and make new HELP and INFO
  253.      files.
  254.      
  255.      
  256.      Now set up the configuration file as described in the next
  257. chapter.
  258.  
  259.  
  260.                             CHAPTER 4
  261.                                 
  262.                      The Configuration File
  263.  
  264.      For PAMS/AMCS to run you must first edit the PAMS.CNF or
  265. AMCS.CNF file to suit your particular station.  The following
  266. parameters must included in the file for the system to function.
  267.  
  268. MYCALL=W5XYZ       The call letters for your station.
  269. MYSELCAL=WXYZ      The selcal for your station.
  270.  
  271. The remaining parameters are optional and the system will assume
  272. a default value if nothing is given.
  273.  
  274.  
  275. AAB            Default: AAB=1 - Enables the automatic answerback
  276.                for this station.
  277.  
  278. ADELAY         PK-232 Only.  Default: The parameter set in the PK-
  279.                232 at startup.  Sets the value of the transmit
  280.                delay for the PK-232.  Multiply the parameter by
  281.                10 milliseconds.  Example: ADELAY=5 sets the
  282.                transmit delay to 50 ms.
  283.  
  284. ALMOFF         Default: ALMOFF=<null> - Sets the hour of the day
  285.                (local time) to disable the sysop alarm.  Example:
  286.                ALMOFF=7 turns off the sysop alarm at 0700 local
  287.                time.
  288.  
  289. ALMON          Default: ALMON=<null> - Sets the hour of the day
  290.                (local time) to turn on the sysop alarm.  Example:
  291.                ALMON=15 enables the sysop alarm at 1500 local
  292.                time.
  293.  
  294. ALOG           Default: ALOG=LOG - The path/filename for the
  295.                AMTOR log file.  Set ALOG=NONE if you do not want
  296.                a system log.
  297.  
  298. AMT-D          AMT-1 only.  Default: AMT-D=0 - Sets the error
  299.                threshold for the AMT-1 (when the version 07A or
  300.                later ROM is installed).  1 is the tightest and 5
  301.                is the loosest error threshold.  The AMT-1
  302.                designer recommends a setting of 4.
  303.  
  304. AMT-F          AMT-1 only.  Default: AMT-F=1 - If 1, enables FEC
  305.                mode in the AMT-1 (when the version 07A or later
  306.                ROM is installed), if 0, disables the FEC mode.
  307.                Disabling the FEC mode is useful when scanning
  308.                since it prevents the scanner from pausing on FEC
  309.                signals.
  310.  
  311. AMTPORT        Default: AMTPORT=1 - Sets the choice of
  312.                communications port used by the computer to
  313.                connect to the AMTOR controller.  If AMTPORT is
  314.                set to 0 the AMTOR port is disabled and no
  315.                communications port is used or required in the
  316.                computer.
  317.  
  318. AMTRATE        Default: AMTPORT=2400 - Sets the baud rate between
  319.                the AMTOR controller and the computer.  Allowable
  320.                rates are 1200, 2400, 4800 and 9600.  This
  321.                parameter has no effect when using the AMT-1.
  322.  
  323. ASCII          Default: ASCII=0 - Enables the extended (full) set
  324.                of ascii punctuation characters on the AMTOR
  325.                channel.  Read the next chapter before including
  326.                this parameter in the PAMS.CNF or AMCS.CNF file.
  327.  
  328. AUTOLOG        Default: AUTOLOG=1 - Enables the system's
  329.                automatic AMTOR login feature.
  330.  
  331. AUTOREGISTER   Default: AUTOREGISTER=1 - Enables a new user to
  332.                automatically be entered into the users file.  If
  333.                disabled only calls entered into the users file by
  334.                the sysop may log into the system.
  335.  
  336. CALL           Default: CALL=<null> - Presets a call for a
  337.                distant station at system startup.  Example:
  338.                CALL=WA8DRZ
  339.  
  340. EVENTLOG       Default: EVENTLOG=0 - If set to 1 enables the
  341.                writing of an event log.  See chapter 9.
  342.  
  343. HEAP           Default: HEAP=0 = If set to 1 enables a diagnostic
  344.                feature that displays the status and amount of
  345.                free memory available to the program.
  346.  
  347. LCMD           Default: LCMD=1 - When set to 1 enables the 'L'
  348.                command on the AMTOR port.  When set to 0 disables
  349.                the 'L' command on the AMTOR port.
  350.  
  351. LOGFEC         Default: LOGFEC=1 - Enables writing FEC mode
  352.                signals into the AMTOR log.
  353.  
  354. LOWERCASE      Default: LOWERCASE=0 - Enables upper and lower
  355.                case mode on the AMTOR channel.  Please read the
  356.                next chapter before including this parameter in
  357.                the PAMS.CNF or AMCS.CNF file.
  358.  
  359. MAXLINES       Default: MAXLINES=60 - Sets the number of printed
  360.                lines on your printer between form feeds.
  361.  
  362. MSGFF          Default: MSGFF=0 - Enables automatic form feed at
  363.                the end of a message printed on the system
  364.                printer.
  365.  
  366. MYROUTE        Default: MYROUTE=<null> - If you set MYROUTE to
  367.                the full h-route for your station it will appear
  368.                in headers generated by PAMS/AMCS.  Default is
  369.                your own call without any h-routing.  You must
  370.                still set the parameter MYCALL as well, without
  371.                any extensions.
  372.  
  373. MYSUFFIX       Default: MYSUFFIX=<null> - An extension to your
  374.                call such as a different call area.  Do not
  375.                include the / in entry.
  376.  
  377. NLS            Default: NLS=1 - Stands for No Leading Space.  If
  378.                set to 1 you cannot type a leading space on a new
  379.                line from the keyboard while transmitting in
  380.                keyboard mode on the air.
  381.  
  382. NORTON         Default: NORTON=1 - If you prefer to use a
  383.                'generic' ascii text editor rather than the Norton
  384.                Editor set NORTON=0.  Whatever editor you use must
  385.                me named E.COM, E.EXE, or be invoked by a properly
  386.                constructed E.BAT file.
  387.  
  388. OWNHEADER      Default: OWNHEADER=0 - Enables the addition of
  389.                your station's header to a message when it is
  390.                originated at your station.  If you are not
  391.                running an MBO serving other users it should be
  392.                set to 0.
  393.  
  394. PCIAD          Default: PCIAD=5 - Set the value in milliseconds
  395.                of the audio delay in the PCI-3000.
  396.  
  397. PCICD          Default: PCICD=30 - Sets the value in milliseconds
  398.                of the control delay in the PCI-3000.
  399.  
  400. PCIDLY         Default: PCIDLY=0 - Setting PCIDLY=1 enables a
  401.                long timeout delay on a lost ARQ link, otherwise
  402.                the timeout delay is normal.
  403.  
  404. PCIPD          Default: PCIPD=5 - Set the value in milliseconds
  405.                of the ptt delay in the PCI-3000.
  406.  
  407. PCISCAN        Default: PCISCAN=0 - Setting PCISCAN=1 enables a
  408.                level (low) scan stop signal output from the PCI-
  409.                3000 upon receipt of a selcal otherwise the scan
  410.                stop signal is a pulse.
  411.  
  412. PCITD          Default: PCITD=20 - Sets the value in milliseconds
  413.                of the transmit delay in the PCI-3000.
  414.  
  415. PK232REV       Default: PK232REV=0 - For PK-232 users only.  If
  416.                set to 1 reverses the sense of the mark and space
  417.                tones.
  418.  
  419. PRINTER        Default: PRINTER=NONE - The path to your printer.
  420.                A typical setting is PRINTER=LPT1.
  421.  
  422. PRTLOG         Default: PRTLOG=1 - Specifies the channel that
  423.                prints to your printer when the system starts.
  424.  
  425.                     PRTLOG=1 for system printer (default),
  426.                     PRTLOG=2 for AMTOR channel printer, or
  427.                     PRTLOG=3 for PACKET channel printer.
  428.                     
  429. QTH            Default: QTH=<null> - Your QTH and postal code.
  430.                This text will appear in your message headers.
  431.                Example: QTH=MIAMI, FL Z:32132
  432.  
  433. SELCAL         Default: SELCAL=<null> - Presets a selcal for a
  434.                distant station at system startup.  Example:
  435.                SELCAL=WDRZ
  436.  
  437. SHORTHEADERS   Default: SHORTHEADERS=0 - If set to 1 only the
  438.                first and last header will be forwarded on AMTOR.
  439.                Intermediate headers will be dropped.  This acts
  440.                only on messages forwarded on AMTOR.  All the
  441.                headers will still be forwarded on the packet
  442.                channel.
  443.  
  444. SIGNON         Default: SIGNON=NEED HELP? TYPE 'HELP+?' - The pre-
  445.                login message.
  446.  
  447. SYSMSG         Default: SYSMSG=<null> - The post-login message.
  448.                This is not normally set but may be used to draw
  449.                attention to an important bulletin.  Example:
  450.                SYSMSG=URGENT: READ MSG 1234
  451.  
  452. TUPDATE        Default: TUPDATE=999 - Set the hour of the day
  453.                (local time) that the system update will occur
  454.                automatically.  Set to 999 to prevent automatic
  455.                updating.  Automatic updating is strongly
  456.                recommended.
  457.  
  458.  
  459.      You may change the colors displayed on the screen.  Use the
  460. following range of numeric values to set the color parameters.
  461.  
  462.       0  BLACK
  463.       1  BLUE
  464.       2  GREEN
  465.       3  CYAN
  466.       4  RED
  467.       5  MAGENTA
  468.       6  BROWN
  469.       7  LIGHT GREY
  470.       8  DARK GREY
  471.       9  LIGHT BLUE
  472.       10 LIGHT GREEN
  473.       11 LIGHT CYAN
  474.       12 LIGHT RED
  475.       13 LIGHT MAGENTA
  476.       14 YELLOW
  477.       15 WHITE
  478.  
  479. Backgrounds may only use 0 thru 7.
  480.  
  481. STATFORE       Default: STATFORE=0 (BLACK) - Status line
  482.                foreground.
  483.  
  484. STATBACK       Default: STATBACK=7 (LIGHT GREY) - Status line
  485.                background.
  486.  
  487. WDOFORE        Default: WDOFORE=15 (WHITE) - Text windows
  488.                foreground.
  489.  
  490. WDOBACK        Default: WDOBACK=1 (BLUE) - Text windows
  491.                background.  (Black on black and white screens)
  492.  
  493. POPFORE        Default: POPFORE=15 (WHITE) - Popup windows
  494.                foreground.
  495.  
  496. POPBACK        Default: POPBACK=7 (LIGHT GREY) - Popup windows
  497.                background.
  498.  
  499.  
  500.      Once you have set up the PAMS.CNF or AMCS.CNF file you
  501.      need to create a forwarding file as described in
  502.      chapter 7.
  503.      
  504.      
  505.                             CHAPTER 5
  506.                                 
  507.                          Character Sets
  508.                                 
  509.      Beginning with PAMS version 2.00 there are two new features
  510. which, at the sysop's option, may be activated to extend the
  511. range of characters available on AMTOR.  One is upper and lower
  512. case alpha characters and the second is an extension of the
  513. available set of punctuation characters to include the entire
  514. ASCII set.
  515.  
  516.  
  517. UPPER/LOWER CASE
  518.  
  519.      To activate the upper/lower case feature include the
  520. following in the PAMS.CNF or AMCS.CNF file:
  521.  
  522. LOWERCASE=1
  523.  
  524. This feature will work with any PK-232 controller, any AMT-1
  525. controller with a version 07A ROM or later, and any PCI-3000 with
  526. versio 1.7C ROM or later.  If you need a new AMT-1 or PCI-3000
  527. ROM contact Jim, KE5HE @ KE5HE.TX.USA.
  528.  
  529.      The addition of lower case is achieved by transmitting a
  530. case 'toggle' or shift character, a Baudot blank, whenever the
  531. text changes between upper and lower case.  (The Baudot blank is
  532. the Baudot character with all bits set to 0, not to be confused
  533. with the Baudot space.) The beginning of any transmission is
  534. always assumed to be in upper case.  Any Baudot figures character
  535. always shifts the alpha case back to upper.
  536.  
  537.      Since the Baudot blank character is ignored by virtually all
  538. receiving devices this mode is 'backwards' compatible with your
  539. existing user's system.  A user not equipped with a system that
  540. interprets the Baudot blank continues to see all upper case
  541. characters.
  542.  
  543.      This method of transmitting upper and lower case was
  544. originated by Peter, G3PLX.  It is used in the 'PLX' AMTOR
  545. mailboxes that he has written so that upper and lower case
  546. characters can be preserved on traffic exchanged between the two
  547. systems.
  548.  
  549.      WARNING - The latest versions of the PK-232 also
  550.      implement upper and lower case using a different
  551.      technique.  Your users must not use that mode or the
  552.      upper and lower cases will become confused and/or stray
  553.      graphics characters may appear in their text.  Tell
  554.      your PK-232 users to set the parameter 'CODE 0' in
  555.      their controllers.
  556.      
  557. EXTENDED ASCII PUNCTUATION SET
  558.  
  559.      The extended ASCII punctuation set is not 'backward'
  560. compatible with existing systems so must be activated on a
  561. station by station basis either by the sysop or by the user
  562. himself.  A user must be using PAMS version 2.0 or later or
  563. APLINK version 6.0 or later.
  564.  
  565.      To enable your system to offer the extended ASCII characters
  566. you must add ASCII=1 to your PAMS.CNF or AMCS.CNF file.  This
  567. only enables the code in your PAMS/AMCS to permit this mode and
  568. does not activate it for any specific user.  For this feature to
  569. work you must have the following ROMS: In the PK-232, July 1991
  570. or later, the AMT-1, version 07A or later, and the PCI-3000,
  571. version 1.7C or later.  DO NOT SET ASCII=1 UNLESS YOU HAVE A
  572. PROPER ROM.
  573.  
  574.      To activate the extended ASCII character set for a
  575. particular user, set the ASCII tag in your user file to 1 (using
  576. USERS.EXE) for that user and then link with him on the AMTOR
  577. channel and set his system to ASCII mode with the 'ASCII'
  578. command.
  579.  
  580.      The user may set this tag in your user file for his call by
  581. sending the command 'ASCII' while logged into your system.  This
  582. command is a toggle and will switch the user's tag between ON and
  583. OFF each time the command is received.  PAMS/AMCS will echo the
  584. state of the selection each time the command is received.  Once
  585. the tag is set it remains set until the user or sysop changes it
  586. again and does not have to be set each time a user logs in.
  587.  
  588.      The technique used for transmitting the extended punctuation
  589. characters is to send an 'escape' code (again, a Baudot blank)
  590. ahead of a Baudot figures character to 'reassign' it to an
  591. alternate value.  For example, to send a colon in the Baudot code
  592. the system transmits a 'Figs-C'.  This may be one or two
  593. characters depending on whether the controller is already in
  594. 'Figs' case.  To send a semicolon, which is an ASCII character
  595. but not a Baudot character, the system precedes the 'Figs-C' with
  596. the Baudot blank.  This does not interfere with the upper/lower
  597. case alpha toggle since any figures character resets the system
  598. to upper case alpha.
  599.  
  600.      Here is the 'escape' table used for the extended characters:
  601.  
  602.  
  603.           No Null Escape           With Null Escape
  604.           --------------           ----------------
  605.           Figs-A: - Dash           _ Underscore
  606.           Figs-B: ? Query
  607.           Figs-C: : Colon          ; Semicolon
  608.           Figs-D: <Reserved for WRU>
  609.           Figs-E: 3
  610.           Figs-F: % Percent        `  Reverse Apostrophe
  611.           Figs-G: @ At Symbol      }  Closing Brace
  612.           Figs-H: # Hash Mark      {  Opening Brace
  613.           Figs-I: 8
  614.           Figs-J: * Asterisk
  615.           Figs-K: ( Open Paren     [ Opening Square Bracket
  616.           Figs-L: ) Close Paren    ] Closing Square Bracket
  617.           Figs-M: . Period         > Closing Angle Bracket
  618.           Figs-N: , Comma          < Opening Angle Bracket
  619.           Figs-O: 9                ~ Tilde
  620.           Figs-P: 0
  621.           Figs-Q: 1                ! Exclamation Point
  622.           Figs-R: 4                $ Dollar Sign
  623.           Figs-S: ' Apostrophe     " Quotation Marks
  624.           Figs-T: 5
  625.           Figs-U: 7                @ And Symbol
  626.           Figs-V: = Equal          | Vertical Bar
  627.           Figs-W: 2
  628.           Figs-X: / Slash Mark     \ Reverse Slash Mark
  629.           Figs-Y: 6                ^ Caret
  630.           Figs-Z: + Plus
  631.  
  632.  
  633.                             CHAPTER 6
  634.                                 
  635.                        The Forwarding File
  636.                                 
  637.      Using the Norton editor, create an ASCII file named
  638. FORWARD.APS.  Make entries into the file that look something like
  639. this (assume you are N6FW for this example):
  640.  
  641. . A line beginning with a period is ignored
  642. . Blank lines are ignored
  643.  
  644. . The first entry should be your call
  645. N6FW        N6FW
  646. . The second entry is a '*' followed by the calls of any or
  647. . all APLINK or PAMS station that you forward messages to.
  648. *           WA8DRZ N0IA
  649.  
  650.      That takes care of it if you are running a simple personal
  651. MBO and not providing message forwarding for others.  Any time
  652. you have a message(s) entered into your system that are not
  653. addressed to you and have an entry in the 'AT' field, they will
  654. be forwarded automatically whenever you are linked to one of the
  655. stations in the second entry and you use the command TAB-F or
  656. started the link with the command TAB-D.  If any of those
  657. stations link to you and initiate a reverse forward command your
  658. pending messages will be forwarded.
  659.  
  660.      If you wish to run PAMS/AMCS as a full amtor MBO or
  661. segregate your traffic between different APLINK stations then
  662. your FORWARD.APS file gets more complicated.  Read on:
  663.  
  664. . The first entry should be your call typically (see below)
  665. N6FW        N6FW
  666. VK2AGE      AH6D   VK2AGE VK3EHQ
  667. TG9VT       TG9VT
  668. #SOCAL.CA   N0IA
  669. #NOCAL.CA   WA8DRZ
  670. . This entry routes all NTS traffic with a zip code starting with
  671. . 78 to KE5HE
  672. 78*         KE5HE
  673. . The next entry would hold all Alaska traffic in the system
  674. AL          N6FW
  675. . The following state code entries are exceptions to the rule
  676. . that USA traffic goes to WA8DRZ
  677. HI          AH6D
  678. TX          KE5HE
  679. IL          WA1URA WB7QWG
  680. IN          WA1URA WB7QWG
  681. USA         WA8DRZ
  682. AUS         AH6D   VK2AGE VK3EHQ
  683. EU          TG9VT  ZF1GC
  684. NA          WA8DRZ
  685. AS          TG9VT  ZF1GC
  686. OC          AH6D
  687. SA          TG9VT  ZF1GC
  688. AF          TG9VT  ZF1GC
  689.  
  690. and so on.  The first entry on a line is a routing token and the
  691. remaining entries on the same line are bbs/mbo stations that
  692. messages with those routing tokens may be sent to.  Messages that
  693. have nothing in the 'AT' field will not move unless there is an
  694. exact match to the 'TO' field.
  695.  
  696.      You may use a wild card (a '*') on the left hand token.  DO
  697. NOT USE WILD CARDS EXCEPT FOR ZIP CODES OR WHERE THE FIRST THREE
  698. LETTERS ARE 'NTS'.  Wild cards on anything else will potentially
  699. confuse the h-routing scan process.
  700.  
  701.      If you have a token with a leading '#' then the expected
  702. following token must be included also: see #NOCAL.CA above.
  703.  
  704.      If you put a call (other than your own and the call of the
  705. packet bbs you forward to) in a routing token field then also put
  706. that call in the intercept file with full h-routing so that down
  707. stream stations will know how to deal with it.
  708.  
  709.      Put the most specific tokens first, such as call letters,
  710. followed by tokens beginning with '#', followed by zip codes
  711. (including zip codes with wild cards), followed by state codes,
  712. followed by country codes, followed by continental codes.  The
  713. scanning process is complicated and the order of entries in
  714. FORWARD.APS is very important.  For example, if a message has
  715. HI.USA in the 'AT' field it will not forward to WA8DRZ in the
  716. above sample file because it will have 'hit' on AH6D first and
  717. the system will hold the message for that station.  Put your own
  718. call in the first line in both the first and second field to
  719. insure that traffic addressed 'AT' your station stays there.
  720.  
  721.      MESSAGES THAT DO NOT MATCH ANY ROUTING ON THE LIST WILL NOT
  722. MOVE.
  723.  
  724.      Messages with the call of the station that you are linked to
  725. in the 'TO' field move unconditionally to that station.
  726.  
  727.      Any number of mbo calls can follow the routing token as long
  728. as they are separated by one or more spaces and do not exceed a
  729. total line length of 80 characters.
  730.  
  731.      The routing table is kept in memory to speed things up a
  732. bit.  If you change FORWARD.APS the system will see a change in
  733. the file time stamp and reload the routing table the next time
  734. routing is requested.
  735.  
  736.  
  737. HINTS
  738.  
  739.      Do not try to put every possible h-routing token in your
  740. FORWARD.APS file.  It is enough to put 'USA' for the station(s)
  741. that handles most of your U.S. traffic and then just enter the
  742. state codes that are exceptions ahead of it.  Use country codes
  743. for the station(s) that take your foriegn traffic, etc...  If
  744. your FORWARD.APS file is growing large you may not be making the
  745. best of it.  Make sure there is at least one entry for each
  746. country that you are likely to handle traffic for.
  747.  
  748.  
  749. REJECTED MESSAGES
  750.  
  751.      If the system attempts to forward a bulletin and it is
  752. rejected (usually meaning that the other station already has it)
  753. its status is changed to STATIC and it is left in the system for
  754. all to read.
  755.  
  756.      If a private or NTS message is rejected it is marked as
  757. REJECTED and held for the sysop to take action on it.  A
  758. rejection of a private or NTS message usually means there is some
  759. problem, typically a case of "round robin" routing.  In any case
  760. the sysop should look into it.  When the sysop does a message
  761. listing rejected messages will show a '*' in the status column,
  762. or '**' if it is over 24 hours old.  The message status is
  763. restored, of course, by the MCB editor once the problem has been
  764. solved.
  765.  
  766.  
  767.                             CHAPTER 7
  768.                                 
  769.                        Starting the System
  770.                                 
  771.      If you have not already done so, re-boot the system to make
  772. sure MBBIOS.COM has been loaded.  To start the system the first
  773. time, keep your transmitter turned off but your AMTOR terminal
  774. unit on, and run PAMS.EXE (or AMCS.EXE).  (Be sure you renamed
  775. one of the PAMSxxx.EXE file to either PAMS.EXE or AMCS.EXE.)  The
  776. system will go through its initialization procedure and when it
  777. is ready for service will display the copyright notice on the
  778. screen.
  779.  
  780.      Type the following sysop commands to enter the tutorial help
  781. files:
  782.  
  783. SH PAMS HELP1(return)
  784. SH PAMS HELP2(return)
  785. etc. thru HELP9
  786.  
  787. To see if it all worked type:
  788.  
  789. LH(return)
  790.  
  791. and you should get the message list with the help files showing.
  792. If uncertain about this procedure read KEYBOARD OPERATION and
  793. SYSOP COMMANDS sections first.
  794.  
  795.      This completes the installation.  You should be up and
  796. running.
  797.  
  798.  
  799. SPECIAL NOTE REGARDING THE PK-232
  800.  
  801.      You may 'cold start' the PK-232 provided you have the PK-232
  802. 19 July 1990 (or later) ROM installed.  You can continue as your
  803. are now or you can remove the battery (or pull jumper JP-1) and
  804. simply turn the PK-232 on just before running PAMS and PAMS will
  805. do a full configuration including setting the baud rate to
  806. whatever you have set in the PAMS.CNF file (AMTRATE=nnnn, default
  807. is 2400).  This should work OK where you want the system to
  808. automatically restart from a power failure.
  809.  
  810.  
  811.                             CHAPTER 8
  812.                                 
  813.                             Bulletins
  814.                                 
  815.      Bulletins entered into the system from the AMTOR channel or
  816. by the Sysop are visible to everyone who uses the system.
  817.  
  818.      Bulletins may be entered by any station.  If there is no
  819. entry in the 'AT' field then the bulletin will remain in the
  820. system but will not be forwarded to any other station.  If there
  821. is an entry in the 'AT' field the bulletin will be forwarded once
  822. only to the station indicated by the FORWARD.APS file for that
  823. routing.  PAMS does not do "flood" forwarding of bulletins.  If
  824. the bulletin is ultimately forwarded to a packet bbs however,
  825. that bbs may "flood" the bulletin to many stations.
  826.  
  827.      All bulletins are held in the system until deleted by the
  828. sysop or the originating station.
  829.  
  830.  
  831.                             CHAPTER 9
  832.                                 
  833.                               Logs
  834.                                 
  835. SYSTEM LOG
  836.  
  837.      The system maintains a log file.  The path (file name) of
  838. the file declared in the PAMS.CNF or AMCS.CNF file (the default
  839. is LOG if not named).  The log records everything transmitted or
  840. received on the channel.  The main purpose is diagnostic and can
  841. be turned off once the system is known to be stable and free of
  842. programmer errors.  In order not to fill the disk with endless
  843. text logs, the current text log is renamed LOG.OLD when UPDATE is
  844. executed and the previous LOG.OLD file is deleted.
  845.  
  846.      The log file may be read with the TAB-L command or off line
  847. with the Norton Editor or any ascii text editor.
  848.  
  849.      If a failure occurs during system operation the log file
  850. should immediately be saved to give the programmer half a chance
  851. at finding what happened.
  852.  
  853.  
  854. EVENT LOG
  855.  
  856.      The system is also capable of maintaining an event log which
  857. is named EVENTLOG.APS.  To activate this log include EVENTLOG=1
  858. in your PAMS.CNF or AMCS.CNF file.  This log records the receipt
  859. and delivery of all messages to and from your system.
  860.  
  861.      If the UPDATE command is run on the first day of the month
  862. then the current event log is renamed EVENLOG.OLD and a new event
  863. log is started.
  864.                                 
  865.                                 
  866.                            CHAPTER 10
  867.                                 
  868.                         Console Operation
  869.                                 
  870.      When the system is started, two windows will be displayed
  871. with the copyright notice showing on the top window when the
  872. system has completed initialization.
  873.  
  874.      The top window is devoted to displaying characters received
  875. on the AMTOR channel or and the bottom window to characters
  876. received from the keyboard or files being transmitted.  Over each
  877. window is a status bar related to that window.
  878.  
  879.      In channel mode the keyboard is word buffered.  The word is
  880. transmitted when the spacebar, return, a control character, or +?
  881. is pressed.
  882.  
  883.      The system can be in either of two modes: channel mode or
  884. message manager mode (message manager mode is the same as sysop
  885. mode in the APLINK system).
  886.  
  887.  
  888. CHANNEL COMMANDS
  889.  
  890.      The system comes up in channel mode and is returned to
  891. channel mode whenever the TAB key is pressed.  Pressing the TAB
  892. key causes a prompt window to open with a list of the channel
  893. commands in view.  The TAB key is followed by a alpha character
  894. which invokes the following commands:
  895.  
  896. TAB A     Switch the amtor controller to ARQ monitor mode.  The
  897.           MBO is disabled.
  898.  
  899. TAB B     In ARQ mode, send a 'break' command - i.e., force the
  900.           link into send mode for your station.  Use sparingly.
  901.  
  902. TAB C     Start an ARQ call.  A window will open prompting you
  903.           for call letters.  Enter call letters only if you want
  904.           to use the default selcal otherwise enter call letter
  905.           and selcal seperated by a space or '/'.  The enter key
  906.           starts the call, the ESC key cancels the operation.
  907.           The last call you used my be repeated by just typing
  908.           the enter key.
  909.  
  910. TAB D     Starts an ARQ call as above but automatically goes into
  911.           autoforward mode once GA+? is received from the called
  912.           station.  If you are already linked it begins
  913.           autoforwarding.  This command should only be used with
  914.           another APLINK, PAMS, or compatible MBO.
  915.  
  916. TAB E     Ends an ARQ link.  It only takes effect when your
  917.           station is in the send mode.
  918.  
  919. TAB F     Set a new remote station call and selcal.
  920.  
  921. TAB G     Switches the displayed time to GMT (or back to local).
  922.  
  923. TAB H     Displays additional help.
  924.  
  925. TAB I     Sends station identification.
  926.  
  927. TAB K     Switches the system between keyboard and MBO operation.
  928.           If the system is left in keyboard mode it will
  929.           eventually time out and return to MBO operation.
  930.  
  931. TAB L     Read the log.  Brings up the Norton editor with the log
  932.           file loaded.  All channel operation are frozen during
  933.           this time.
  934.  
  935. TAB M     Switches the system to message manager mode while
  936.           linked to a station.  This is not required when you are
  937.           not linked since typing a message manager command from
  938.           the keyboard will switch the system automatically.
  939.  
  940. TAB N     Sends a 'top of form' command to your printer.
  941.  
  942. TAB P     Switches the printer between the channel and the
  943.           message manager.  The system comes up with the printer
  944.           attached to the message manager unless you have made a
  945.           special entry in the configuration file.
  946.  
  947. TAB Q     Quit PAMS.  You will get a prompt asking you to confirm
  948.           this.
  949.  
  950. TAB R     Channel reset.  This forces the amtor controller back
  951.           to FEC/ARQ standby no matter what is going on.  This is
  952.           the 'panic' button.
  953.  
  954. TAB S     Send a file to the station you are linked with.  It
  955.           functions when you are in either ARQ or FEC mode and
  956.           are sending.
  957.  
  958. TAB T     Invokes a carrier test.  Turns on a steady carrier for
  959.           adjusting you transmitter.  Press any key to stop it.
  960.  
  961. TAB W     Clear the windows of any text.  This does not clear any
  962.           send or receive buffers.
  963.  
  964. TAB Z     APLINK/PAMS logout.  This sends your identification and
  965.           logout command to another APLINK or PAMS station.  Use
  966.           this rather than just dropping the link.
  967.  
  968. There are some channel commands that do not use the TAB key:
  969.  
  970. ESC       Clears all transmit buffers and stop any file
  971.           transmission or automatic forwarding.
  972.  
  973.  
  974. DEL       If the amtor controller is stuck in figures case this
  975.           key will set it to letters case.
  976.  
  977. F1        Shows you the help screen (same as TAB H).
  978.  
  979. F3        Same as the TAB key (this is done for parity with the
  980.           Norton Editor).
  981.  
  982. F9        Send command.  If in FEC standby it start an FEC
  983.           transmission.  If in ARQ it sends a break command (same
  984.           as TAB B).
  985.  
  986. F10       Received command.  If transmitting in FEC mode, it
  987.           returns the amtor controller to FEC standby mode.  If
  988.           transmitting in ARQ mode it sends the +? command.
  989.  
  990.  
  991. MESSAGE MANAGER COMMANDS
  992.  
  993.      Remember, the following are message manager commands used by
  994. the system operator.  They are not the same as the commands used
  995. over the air by a remote station.  These commands are not
  996. normally invoked while linked but may be usually without harm
  997. unless autoforwarding is in progress.  The system will delay
  998. response to an online user while message manager commands are
  999. being executed.
  1000.  
  1001.      In the table below <number> is any integer between 0 and
  1002. 999999, <id>, <id1> and <id2> are standard 1 to 6 character
  1003. routing designators (usually call letters) as used in Packet, and
  1004. <filename> is any valid MS-DOS path/filename.
  1005.  
  1006. COMMAND                  FUNCTION
  1007. -------                  --------
  1008. E <number>               Invokes the Message Control Block Editor
  1009.                          for message <number>.  See the separate
  1010.                          section describing the MCB Editor.
  1011.  
  1012. K <number>               Cancel message <number>.
  1013.  
  1014. K <number 1> <number 2>  Cancel message <number 1> thru <number
  1015.                          2>.
  1016.  
  1017. KB <number>              Same as K <number> except bulletins
  1018.                          only.
  1019.  
  1020. KB <number 1> <number 2> Same as K <number 1> <number 2> except
  1021.                          bulletins only.
  1022.  
  1023. L                        List all messages in the system except
  1024.                          bulletins.
  1025.  
  1026. L <number>               List all messages in the system equal to
  1027.                          or greater than <number>, except
  1028.                          bulletins.
  1029.  
  1030. LP                       List all "pending" messages; messages
  1031.                          awaiting forwarding or delivery.
  1032.  
  1033. LT                       List all messages addressed to this
  1034.                          station and to "SYSOP".
  1035.  
  1036. LT <id>                  List all messages to <id>.
  1037.  
  1038. LF                       List all messages from this station.
  1039.  
  1040. LF <id>                  List all messages from <id>.
  1041.  
  1042. LB                       List all bulletins.
  1043.  
  1044. LH                       List all help files.
  1045.  
  1046. LR                       List users logging into the system on
  1047.                          the AMTOR channel in the last 24 hours.
  1048.  
  1049. LU                       List all users registered for the AMTOR
  1050.                          channel.
  1051.  
  1052. NTS                      List all NTS messages in the system.
  1053.  
  1054. P <number>               Print message <number> to your printer.
  1055.                          If the message is addressed to your
  1056.                          station it will be marked as forwarded.
  1057.  
  1058. PN                       Print all new messages to your station
  1059.                          and mark them as forwarded.
  1060.  
  1061. R <number>               Read message <number>.  This invokes the
  1062.                          Norton Editor with message <number>.
  1063.                          Not only can the Sysop read but he can
  1064.                          also modify any message in the system.
  1065.                          It is generally not socially acceptable
  1066.                          to modify other people's messages.  Any
  1067.                          message accessed in this way addressed
  1068.                          to your station will be marked as
  1069.                          forwarded.
  1070.  
  1071. RESTORE <number>         Restores a canceled message provided it
  1072.                          has not been archived.
  1073.  
  1074. SP <id1> [AT <id2>] [<filename>]   If file name is included,
  1075.                          copies <filename> into APLINK as a
  1076.                          message to <id1>.  If <filename> is not
  1077.                          included then the Norton Editor in
  1078.                          invoked.  After the message has been
  1079.                          typed and edited, exiting the editor
  1080.                          stores the message into APLINK.  If the
  1081.                          Norton Editor is exited without saving
  1082.                          the text (i.e., F3 Q Y) then the
  1083.                          operation is canceled.
  1084.  
  1085. SB . . .                 Same as the SP command above except the
  1086.                          message is marked BULLETIN.
  1087.  
  1088. ST . . .                 Same as the SP command above except that
  1089.                          the message is marked NTS.  Certain
  1090.                          restrictions may apply to NTS messages.
  1091.                          See the section on NTS operations.
  1092.  
  1093. SH . . .                 Same as the SP command above except the
  1094.                          "message" is a help file only.
  1095.  
  1096. UPDATE                   Manually initiates the system update
  1097.                          routines.  This should be done once a
  1098.                          day or on first use if the system has
  1099.                          not be used for more than a day.  If you
  1100.                          run your system continuously then this
  1101.                          is normally done by setting the
  1102.                          'TUPDATE' parameter in the PAMS.CNF or
  1103.                          AMCS.CNF file.
  1104.  
  1105.      NOTE: Message that are removed from the active
  1106.      directory at UPDATE time are copied into a subdirectory
  1107.      under the current PAMS directory named ARCHIVE.  In a
  1108.      typical installation this directory path would be
  1109.      C:\PAMS\ARCHIVE.  The archive subdirectory is created
  1110.      automatically by the system.
  1111.      
  1112.      
  1113. IN AND OUT OF AMTOR MBO MODE
  1114.  
  1115.      The system is toggled in and out of MBO mode by pressing TAB-
  1116. K.  The system will automatically return to MBO mode after about
  1117. ten minutes time, once the system is no longer linked, in the
  1118. highly unlikely event that the operator forgets to return it.
  1119.  
  1120.      If a user is using the MBO when TAB-K is invoked, all
  1121. operations will stop, any open message files closed and the
  1122. system will send:
  1123.  
  1124.           ...PLEASE STANDBY
  1125.  
  1126. At that point you may converse with the user.  TAB-K again will
  1127. return the system to MBO mode.  Once out of MBO mode the program
  1128. operates as an ordinary AMTOR terminal program and may be used to
  1129. call stations, send files manually, etc.
  1130.  
  1131.      If a station that you want to talk to has logged off before
  1132. you could catch them just press TAB-C(return) and if the other
  1133. station is still on the frequency the link will be re-
  1134. established.
  1135.  
  1136. Whenever an ARQ call is initiated (TAB-C or TAB-D) the MBO mode
  1137. is switched off.  It may be restored by the TAB-K toggle.
  1138.  
  1139.  
  1140. STATUS INDICATORS
  1141.  
  1142.      Here is the meaning of the status bar indicators:
  1143.  
  1144. AMTOR:aaa/bbb:cccc  <time and date>  ddd/eee/fff
  1145.  
  1146.      aaa = MBO when the AMTOR Mailbox is alive and well.
  1147.      aaa = KSR when the SYSOP has shut off the mailbox
  1148.  
  1149.      bbb = SBY when the MBO is waiting for a logon.
  1150.      bbb = OPN when someone has logged on, but there is no
  1151.      command outstanding.
  1152.      bbb = INP when receiving a file.
  1153.      bbb = OUT when transmitting a file.
  1154.      bbb = TSF when transmitting files in response to an RN
  1155. command.
  1156.      bbb = CFM during the time a message header is being
  1157.      confirmed.
  1158.  
  1159.      cccc = Is the call of the last user to have signed onto the
  1160.      AMTOR mailbox; or, if the system has just been initialized,
  1161.      it is the call specified in the CALL parameter of the
  1162.      configuration file.
  1163.  
  1164.      ddd = RCV when the AMTOR link is in the receive direction.
  1165.      ddd = SND when the AMTOR link is in the transmit direction.
  1166.  
  1167.      eee = FEC during standby and when operating in FEC mode.
  1168.      eee = ARQ when linked or operating in ARQ-Listen mode.
  1169.  
  1170.      fff = ERR, RQ, TFC, IDL, OVR, PHA, SBY, or ESC depending on
  1171.      the state of the AMTOR controller.  See your controller
  1172.      manual for explanations.
  1173.  
  1174.  
  1175. KBD:aaaaa                                            PTR:bb
  1176.  
  1177.      aaaaa = CHANNEL when the keyboard is assigned to the AMTOR
  1178.      channel.
  1179.      aaaaa = MSGMGR when the keyboard is assigned to the message
  1180.      manager command handler.
  1181.  
  1182.      bb = NC when the printer is not configured.
  1183.      bb = MM when the printer is assigned to the message manager.
  1184.      bb = CH when the printer is assigned to the AMTOR channel.
  1185.  
  1186. USING THE PRINTER
  1187.  
  1188.      If the printer has been declared in the configuration file
  1189. it is available for either logging or printing messages.
  1190.  
  1191.      To log the channel to the printer, press TAB-P.  To return
  1192. the printer to standby press TAB-P again.
  1193.  
  1194.  
  1195. THE MCB EDITOR
  1196.  
  1197.      Each message in the system has a tag record called a message
  1198. control block maintained in a separate file.  This record
  1199. contains pertinent information about the message such as its
  1200. type, filing time, from and to fields, etc., etc.  Any item of
  1201. data in the MCB may be changed by the Sysop except the message
  1202. number and the filing and forwarding times.  This is done with
  1203. the MCB Editor which is invoked with a message manager command:
  1204.  
  1205.    E <message number>
  1206.  
  1207. Once the Editor's window is opened on the display, typing any of
  1208. the following key words (upper or lower case) will change the
  1209. appropriate parameter in the MCB:
  1210.  
  1211.      AMTOR, SYSOP, PRIVATE, BULLETIN, NTS
  1212.      HELP, CANCELLED, PENDING, FORWARDED, STATIC
  1213.      BID... TO... AT... FROM... BBS...
  1214.  
  1215. The TO, AT, FROM, and BBS fields may be changed by typing:
  1216.  
  1217.    TO <new field>,
  1218.    AT <new field>, etc...
  1219.  
  1220. Pressing return with no other entry will record any changes and
  1221. return to the message manager command line.
  1222.  
  1223.  
  1224. THE USER FILE MAINTENANCE PROGRAM
  1225.  
  1226.      Supplied with PAMS/AMCS is the program USERS.EXE.  This
  1227. program can only be run when PAMS/AMSC is not running, even if
  1228. you are using a multitasking system such as Desqview.  Operation
  1229. of the program is reasonably self-evident.  A user is
  1230. automatically entered into the USERS.APS file upon the first
  1231. logging into PAMS/AMCS unless AUTOREGISTER has been set to 0 in
  1232. the PAMS.EXE or AMCS.EXE file.  A call may also be entered
  1233. directly with USERS.EXE.
  1234.  
  1235.      There are a number of parameters that may be set for any
  1236. given user using USERS.EXE.  Here is a list and their meanings:
  1237.  
  1238.      MBO       Set this to 1 for any station that you directly
  1239.                autoforward traffic to on AMTOR.  This enables
  1240.                that station to read any uncancelled message in
  1241.                your system in order to obtain fills and to enable
  1242.                the RF and RI commands.
  1243.  
  1244.      PROTECTED Prevents removal of the station from the file when
  1245.                the user file maintenance program purge command is
  1246.                used.
  1247.  
  1248.      ASCII     Enables use of the full ascii printing characters
  1249.                set with the user.  This must only be set if the
  1250.                user is fully compatible with the full ascii
  1251.                protocol.
  1252.      
  1253.      EXPERT    1 sets EXPERT mode for a user.
  1254.  
  1255.      LOCKOUT   1 prevents the indicated call from logging into
  1256.                your system.
  1257.  
  1258.      The LAST MESSAGE and LAST BULLETIN parameters cannot be
  1259. changed except to set them to zero with the zero command.  These
  1260. two parameters determine what number the message and bulletin
  1261. lists begin with.
  1262.  
  1263.      LAST LOGIN shows the time and date of the last time the
  1264. indicated call logged into the system.  The purge command removes
  1265. all calls from the file that have not logged in within the last
  1266. 180 days.
  1267.  
  1268.  
  1269.  
  1270.                            CHAPTER 11
  1271.                                 
  1272.                       Program Distribution
  1273.                                 
  1274.                                 
  1275. USER ASSISTANCE
  1276.  
  1277.      If you are having problems bringing up PAMS/AMCS for the
  1278. first time please read, and then re-read the documentation
  1279. provided on the disk. Most questions received to date are covered
  1280. in this information.
  1281.  
  1282. If you still are having problems, or have other questions
  1283. relating to PAMS system operation please direct them, in writing,
  1284. to Craig, WA8DRZ/6:
  1285.  
  1286.      Craig McCartney, WA8DRZ
  1287.      160 Montalvo Road
  1288.      Redwood City, CA 94062
  1289.      USA
  1290.  
  1291. Via AMTOR, leave an note on the WA8DRZ/6 APLINK system on 20 or
  1292. 30 meters.
  1293.  
  1294. Via Packet, send a message to:
  1295.  
  1296.       WA8DRZ @ WA8DRZ.#NOCAL.CA.USA.NA
  1297.  
  1298. Via CIS send a note on Hamnet or Email to user id 73126,3260.
  1299.  
  1300.  
  1301. If you are having problems related to AMCS (MARS) operation
  1302. contact:
  1303.  
  1304.      Art Wertz, N5AEN/AAR6SX
  1305.      8019 Riata Drive
  1306.      San Antonio, TX 78227
  1307.      512-674-8468
  1308.  
  1309.  
  1310. Most APLINK operators are willing to give you a hand in getting
  1311. started.
  1312.  
  1313.  
  1314.                            APPENDIX A
  1315.                                 
  1316.                      AMTOR Channel Commands
  1317.                                 
  1318.      The following is a verbatim copy of the help files included
  1319. in the PAMS distribution.  Note that these help files are only
  1320. appropriate for PAMS operation.  They require modification for
  1321. AMCS (MARS) operation.
  1322.  
  1323.      The difference between the two modes of operation are
  1324. changes of symbols and indicators as follows:
  1325.  
  1326.                        PAMS           AMCS
  1327.  
  1328.                        NNNN           ZZZZ
  1329.                        LOGIN          ZKB
  1330.                        LOGON          ZKB
  1331.                        LOGOUT         ZKJ
  1332.                        LOGOFF         ZKJ
  1333.                        SK             AR
  1334.                        NTS            ATS
  1335.                        GMT            Z
  1336.                        STANDBY        WAIT
  1337.                        MBO            MCS
  1338.                        GA+?           K +?
  1339.  
  1340.  
  1341. AMTOR Channel Commands
  1342.  
  1343. Type any of the following commands on a new line and end with
  1344. either (CR/LF) or the + ? sequence (but not both).  If you do not
  1345. use the + ? sequence the system will change the direction of the
  1346. link for you when it recognizes a valid command.
  1347.  
  1348. H or HELP - Send the help file
  1349.  
  1350. CNCN - Cancel whatever is in progress. (Usually a message you are
  1351.        entering into the system)
  1352.  
  1353. LOGIN (your call) - Logs you in
  1354. LOGON (your call) - Same as LOGIN
  1355.  
  1356. L - List all available messages in the system, not including
  1357.     bulletins (see note)
  1358. L (number) - As above equal or greater than (number)
  1359. LTO or LM - List all messages to you
  1360. LTO (call) - List all messages to (call)
  1361. LFM - List all messages from you
  1362. LFM (call) - List all messages from (call)
  1363. LT - List all NTS messages
  1364. LB - List all general interest bulletins (see note)
  1365. LB (number) - As above equal or greater than (number)
  1366. LR - List users who have logged on in the past 24 hours
  1367.  
  1368. NTS - List all unforwarded NTS messages
  1369.  
  1370. RN or RM - Read all new messages addressed to you
  1371. R (number) - Read message (number)
  1372. RH (number) - Read message (number) including routing headers
  1373.  
  1374. SP (call) - Send a message to (call), end with NNNN
  1375. SB (name) - Enter a bulletin with (name), end with NNNN
  1376. SB (name) AT (route) BID (bid) - Enter a bulletin with (name) at
  1377.             (route) with a bid of (bid)
  1378.  
  1379. SP (call) AT (route) - Send a message to (call) to be forwarded
  1380.    via (route)
  1381. ST (zipcode) AT (NTS statecode) - Send an NTS message (use
  1382.    accepted NTS subject and message format)
  1383.  
  1384. NNNN - End a message.  Must have been started with SP, SB, or ST.
  1385.  
  1386. CANCEL (number) - Cancels message (number) if originated by you
  1387.  
  1388. T - Talk to the sysop
  1389.  
  1390. I - Information about this system
  1391.  
  1392. V - Read version number
  1393.  
  1394. A - (After seizing the link) Abort a file being received
  1395.  
  1396. LOGOUT - Logs you off
  1397. LOGOFF - Same as LOGOUT
  1398.  
  1399. /// - Anywhere on the line cancels the line (except in messages)
  1400.  
  1401. NOTE: The L, and LB commands will only list messages you have not
  1402. previously listed.  Follow the command with a number to override
  1403. this feature.  Use 0 to list all messages in the category.
  1404.  
  1405. Here are some special commands for the expert user:
  1406.  
  1407. EXPERT - Toggles the 'EXPERT' mode
  1408. ASCII - Toggles the full ascii character set mode.  Do not
  1409.    use this command unless your system is compatible with the full
  1410.    ascii protocol.
  1411. RI - Reads the MBO's intercept file
  1412. RF - Reads the MBO's AMTOR autoforward routing file
  1413.    Note: RI and RF are available to other MBO's only
  1414. F - (After seizing the link) Abort a file being received and mark
  1415.    it forwarded if it is for you.  (This is for use with
  1416.    duplicate messages.)
  1417.  
  1418.  
  1419. (File: HELP2) LOGGING IN ON AMTOR
  1420.  
  1421. Logging In On AMTOR
  1422.  
  1423. This MBO has an automatic login procedure for registered stations
  1424. with automatic answerback (AAB) enabled.  When you first link with
  1425. the system, it seizes the link, identifies, sends a 'WRU' character
  1426. (figs-D), and waits for an answerback response.  The expected
  1427. response is:
  1428.  
  1429. (CR/LF)QRA CALL SELCAL + ?
  1430.  
  1431. or
  1432.  
  1433. (CR/LF)DE CALL SELCAL + ?
  1434. For example '(CR/LF)QRA WA8DRZ WDRZ + ?' IS TYPICAL RESPONSE.
  1435.  
  1436. If no AAB response is received the system sends a manual login
  1437. request followed by the + ? sequence.  At this point a user should
  1438. send either 'LOGIN (call)(CR/LF)' OR 'LOGON (call)(CR/LF)'.  If the
  1439. call has been registered the system will respond with a 'GA'
  1440. prompt.  If an error was received or the call is not registered the
  1441. system will ask you to confirm the call.  If you answer the
  1442. confirmation request with 'YES' the call becomes registered.
  1443.  
  1444. APLINK will disconnect after three minutes if no login has been
  1445. recognized.
  1446.  
  1447. Once you have logged on, the system is ready for your command
  1448. whenever it sends a 'GA' (Go Ahead) prompt.
  1449.  
  1450. You may log out of the system with 'LOGOUT(CR/LF)' or 'LOGOFF(CR/LF)'.
  1451. any time the link is lost the current user is automatically
  1452. logged out.
  1453.  
  1454. If a message is being sent to the system during a link failure,
  1455. that part of the message that was received is filed and is
  1456. available to the addressee.
  1457.  
  1458.  
  1459. (File: HELP3) RECEIVING YOUR MESSAGES ON AMTOR
  1460.  
  1461. Receiving Your Messages on AMTOR
  1462.  
  1463. The quickest and simplest way to receive your messages is to give
  1464. the 'RN' (meaning 'Read New') command as soon as you sign on.  All
  1465. messages in the system not already marked 'forwarded' will be
  1466. transmitted to you automatically without further action on your
  1467. part.  As each message is completely forwarded to you it is marked
  1468. 'forwarded' and will not be transmitted again with this command.
  1469. (You may read it again with the 'R (number)' command.
  1470.  
  1471. If you are receiving an unforwarded message and the link is lost
  1472. it will still be available to the 'RN' command.
  1473.  
  1474. If you have logged into the system with your automatic answerback
  1475. then the system will mark your messages 'forwarded' only after it
  1476. triggers your answerback at the end of each message.
  1477.  
  1478. You do not have to (in fact, cannot) delete a message.  Once it is
  1479. forwarded the system will delete it 24 or more hours later.  In the
  1480. meantime it may be read again using the 'R (number)' command.
  1481.  
  1482. Use the list commands to see what messages are available.
  1483.  
  1484.  
  1485.  
  1486. (File: HELP4) ENTERING A MESSAGE ON AMTOR
  1487.  
  1488. Entering a Message On AMTOR
  1489.  
  1490. Messages may be entered directly from your keyboard into the
  1491. system, however it is better if you prepare a file before logging
  1492. on and then send it at machine speed.  This reduces the connect
  1493. time to the system and the potential for transmission errors.
  1494.  
  1495. You may send three kinds of messages:
  1496.  
  1497. 'SP (call)' which is a message to a specific station and may only
  1498. be read by that station (or you or the sysop) and will appear on
  1499. the message list only for those stations.  For others, it simply
  1500. isn't there.  'SP' messages will remain in the system for 21 days
  1501. or 24 hours after being marked 'forwarded', whichever comes first.
  1502.  
  1503. 'SP' type messages may also be entered for automatic forwarding
  1504. to another MBO/BBS.  They may be entered in the form 'SP (call)
  1505. TO (route)' where (call) is the addressee and (route) is the
  1506. hierarchical route to his local MBO/BBS.  Since AMTOR does not
  1507. provide for a number sign character (unless you are in full
  1508. ascii mode),  use the equal sign character in its place when
  1509. required in an h-route address and APLINK will convert it to a
  1510. number sign character.
  1511.  
  1512. 'ST (zipcode) TO (NTS statecode)' is used to enter a message to
  1513. anyone to be delivered by the National Traffic System.  The
  1514. subject (first line) should read: QTC (city, state) and the body
  1515. of the message should be in standard ARRL message format.
  1516.  
  1517. 'SB (id)' addresses a message to 'id' and marks it as a bulletin. You
  1518. may also include a bulletin identification (BID) by adding 'BID '
  1519. followed by the bin on the same line.  For example:
  1520.  
  1521.    SB ALL BID 12345W1ABC
  1522.  
  1523. is a message to 'ALL' with a bid of 12345W1ABC.
  1524.  
  1525. Bulletin type messages will remain in the system until removed
  1526. (cancelled) by either the originator or the sysop.
  1527.  
  1528. To send a message, type the command (i.e., 'SP W5SMM(CR/LF)')
  1529. and wait for a response from the system.  The line will be typed
  1530. back and you will be requested to confirm with 'YES' or 'NO'.
  1531. At the 'GA SUBJ/MSG' prompt type the subject of the message on
  1532. its own line and then enter the text of the message.
  1533.  
  1534. At the end of the message send 'NNNN' on a new line.  'NNNN'
  1535. embedded in text is ignored.  After sending 'NNNN' wait for a new
  1536. 'GA' prompt to enter a new command.
  1537.  
  1538. Identify your station at regular intervals by sending your
  1539. identification after a 'GA' prompt.  Any character sequence that
  1540. is not a valid command is ignored by the system.
  1541.  
  1542. If you have already sent a partial command line and want to cancel
  1543. the line just send three or more '/'s in a row anywhere on the
  1544. line.  That line will be ignored.  This only works on command
  1545. lines.  /// embedded in a message will be passed on to the
  1546. addressee.
  1547.  
  1548. While transmitting a message and before sending the 'NNNN' you
  1549. may cancel the message with the command 'CNCN' on a new line.
  1550.  
  1551. After you have transmitted a message you may cancel it with the
  1552. 'CANCEL (number)' command.  This is normally used to remove a
  1553. bulletin you have placed in the system, but it may be used to
  1554. remove any message you have previously sent.
  1555.  
  1556.  
  1557. (File: HELP5) MESSAGE LIST EXPLANATION
  1558.  
  1559. Message List Explanation
  1560.  
  1561. The format for the message list is similar to that of commonly
  1562. used packet BBS programs.  The symbols for type and status are
  1563. consistent with the packet system.
  1564.  
  1565. Msg = Message number (assigned by the system)
  1566.  
  1567. T = Message type as follows:
  1568.    P - A private message, may only be read by the addressee,
  1569.        originator or sysop
  1570.    B - A bulletin
  1571.    T - An NTS message
  1572.  
  1573. S = Status as follows:
  1574.    N - Message not yet accessed forwarded to the addressee
  1575.    + - Same as 'N' except over 24 hours old
  1576.    ++ - Same as 'N' except over 48 hours old
  1577.    Y - Message forwarded
  1578.  
  1579. TO = Call of addressee
  1580.  
  1581. AT = Call of addressee's BBS (followed by a period when hierarchical
  1582.      routing is used.
  1583.  
  1584. FROM = Call of originator
  1585.  
  1586. FILED = Date/Time message was entered into the originating BBS
  1587.  
  1588. SUBJECT = The subject line of the message
  1589.  
  1590.  
  1591. (File: HELP6) LISTING MESSAGES
  1592.  
  1593. Listing Messages
  1594.  
  1595. There are several commands for listing messages that are in the
  1596. system.  The 'LTO (call)', and 'LFM (call)' ('List To' and 'List
  1597. From') default to the call of the user logged into the system if
  1598. no argument is given.
  1599.  
  1600. The 'L', and 'LB' commands when given without arguments will list
  1601. only messages not previously listed for you.  You may override this
  1602. feature by adding a number following the 'L', or 'LB'. The argument
  1603. 0 will list all the messages in the category.
  1604.  
  1605. NTS messages that are waiting to be delivered may be listed with
  1606. the 'NTS' command.  This is the preferred way to list NTS
  1607. traffic.  The 'LT' command will also list NTS traffic but
  1608. includes traffic that has already been accepted.
  1609.  
  1610. Messages that have been cancelled will not appear on the message
  1611. list even though they may still be in the system.
  1612.  
  1613. Messages that are type 'private' will only appear on lists for the
  1614. addressee and originator of the message.
  1615.  
  1616. Read the help files named 'System Maintenance' and 'Message List
  1617. Explanation'.
  1618.  
  1619.  
  1620. (File: HELP7) SYSTEM MAINTENANCE
  1621.  
  1622. System Maintenance
  1623.  
  1624. The maintenance routines for this system are typically run once a
  1625. day by the sysop.  At that time the following rules apply to all
  1626. message files:
  1627.  
  1628. 1. All messages marked cancelled are removed.
  1629.  
  1630. 2. All messages marked as forwarded for more than 24 hours are
  1631. removed.
  1632.  
  1633. 3. All messages except bulletins that are over 21 days old are
  1634. removed.
  1635.  
  1636.  
  1637.  
  1638. (File: HELP8) AMTOR PORT OPERATING HINTS
  1639.  
  1640. AMTOR Port Operating Hints
  1641.  
  1642. If you have been sitting idle for a few seconds before typing a
  1643. command, type CR/LF just before issuing the command.  This
  1644. clears any stray leading characters from the buffer that may
  1645. have been received in error during the idle period.
  1646.  
  1647. If you get a long file started and would like to abort, simply
  1648. seize the link, wait for idle status on your AMTOR controller,
  1649. and type 'A(CR/LF)'.  The system will return a 'BK GA' prompt
  1650. and accept a new command from you.
  1651.  
  1652. Remember that the first line of a message will appear on the
  1653. message list as the subject.  Make it meaningful to someone
  1654. scanning the list.
  1655.  
  1656.  
  1657. (File: HELP9) USING 'EXPERT' MODE
  1658.  
  1659. Using 'EXPERT' Mode
  1660.  
  1661. An 'EXPERT' mode has been added.  It is toggled by the AMTOR
  1662. user by entering the command 'EXPERT'.  The expert mode shortens
  1663. the exchange when entering a new message.  When on, the
  1664. beginning of a message looks like this:
  1665.  
  1666. From user:    SP W1ABC AT WA8DRZ.=NOCAL.CA
  1667. From system:  SP W1ABC at WA8DRZ.=NOCAL.CA GA Subj/Msg+?
  1668.  
  1669. If there is a hit in the response the user must type the 'CNCN' command
  1670. to kill the message and start over.  NNNN, of course, files the message.
  1671. CNCN may be typed anywhere in the message on a line by itself.
  1672.  
  1673.  
  1674.