home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / ra / sx400doc.zip / XP400.TXT < prev   
Text File  |  1993-05-02  |  210KB  |  3,766 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                     Silver Xpress                                    Silver Xpress                                    Silver Xpress
  8.  
  9.                                Off-line Mail, Fax And                               Off-line Mail, Fax And                               Off-line Mail, Fax And
  10.  
  11.                                   Data Entry System                                  Data Entry System                                  Data Entry System
  12.  
  13.  
  14.  
  15.                                     Version 4.00                                    Version 4.00                                    Version 4.00
  16.  
  17.                                  Santronics Software                                 Santronics Software                                 Santronics Software
  18.  
  19.                                  30034 SW 153 Court                                 30034 SW 153 Court                                 30034 SW 153 Court
  20.  
  21.                                 Leisure City, Florida                                Leisure City, Florida                                Leisure City, Florida
  22.  
  23.                                         33033                                        33033                                        33033
  24.  
  25.  
  26.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page _                                                                       1
  27.  
  28.  
  29.                                _________________                               TABLE OF CONTENTS                               _________________                               TABLE OF CONTENTS                               _________________                               TABLE OF CONTENTS
  30.  
  31.  
  32.           1.Introduction to Silver Xpress. ........................2
  33.           2.Installation ..........................................5
  34.                2.1.Running Install.................................5
  35.           3.Testing XPMAIL.EXE the first time. ....................10
  36.           4.What happened to the Version 3.00 Xpress Sysop Flag? ..11
  37.           5.Setting up the BBS to call XPMAIL .....................12
  38.           6.Multi-Node/Multi-Line Operations ......................17
  39.           7.Packers and Tossers - Post Mail Operations ............19
  40.           8.Configuration .........................................22
  41.                8.1.Defining or changing Protocols..................23
  42.                8.2.Defining or changing Archivers..................24
  43.           9.Maintenance ...........................................27
  44.                9.1.Running XPADM Update Operations.................27
  45.           10.Advanced Xpress Services..............................29
  46.                10.1.Optional Bulletins.............................29
  47.                10.2.Xpress Node List...............................30
  48.                10.3.Off-line Reader Services.......................31
  49.                10.4.Xpress Master Services.........................34
  50.                10.5.Upload Mail Services...........................36
  51.                10.6.Sample Fax Application.........................36
  52.                10.7.Xpress Forms System............................37
  53.                10.8.Sample Order Entry Xpress Forms Application....38
  54.                10.9.Xpress Vacation Saver..........................39
  55.           11.Changing the Xpress Menus and Display Files...........41
  56.                11.1.Changing the default Xpress Door menus.........41
  57.                11.2.Changing the Silver Xpress Reader Menu.........49
  58.                11.3.Modifying the Silver Xpress Help Files.........50
  59.           APPENDIX A: LIMITATIONS..................................53
  60.           APPENDIX B: EXEC SWAPPING................................54
  61.           APPENDIX C: OPTIONAL SWITCHES............................55
  62.           APPENDIX D: USING THE DEBUG SWITCH.......................60
  63.           APPENDIX E: ERROR CODES..................................63
  64.           APPENDIX F: PRODUCT COMPARISON...........................64
  65.           APPENDIX G: SECURITY AND SYSOP ACCESS....................67
  66.           APPENDIX H: Acknowledgments..............................70
  67.  
  68.  
  69.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page _                                                                       2
  70.  
  71.  
  72.  
  73.  
  74.           __          1.          __          1.          __          1.__                          __                          __                           ______________________________             Introduction to Silver Xpress.             ______________________________             Introduction to Silver Xpress.             ______________________________             Introduction to Silver Xpress.
  75.  
  76.  
  77.  
  78.           Welcome to the most powerful off-line electronic mail system, the
  79.           Silver Xpress Off-line Mail Door System!          Silver Xpress Off-line Mail Door System!          Silver Xpress Off-line Mail Door System!
  80.  
  81.           Silver Xpress is a sophisticated electronic mail product designed
  82.           for many  of today's  popular electronic  bulletin board  systems
  83.           (BBS).  In BBS  terminology, Silver Xpress  is an "off-line  mail
  84.           door" supporting the OPX and QWK mail packet formats.
  85.  
  86.           If you  are  a  veteran  Xpressor, or  a  sysop  with  mail  door
  87.           experience, you  may skip  this section  and go  directly to  the
  88.           installation section.
  89.  
  90.           The Silver Xpress off-line mail door  will allow you to set up  a
  91.           capability on your BBS  guaranteed to make  your BBS popular  and
  92.           efficient, while  increasing the  number of  users on  your  BBS.
  93.           With Silver Xpress your users will be able to download mail  from
  94.           their preferred mail forums and read the mail, Off-line, on their
  95.           PC.  By off-line, it it meant  that the user is not connected  to
  96.           your PC and is reading and creating mail using his own computer!
  97.  
  98.           This off-line processing  technology has  revolutionized the  BBS
  99.           industry.  Today, BBSs  and users are  more efficient, and  users
  100.           are saving  lots  of money  by  processing mail  in  an  off-line
  101.           fashion.   Sysops save  money in  many ways  as well.   By  using
  102.           Silver Xpress,  you  reduce the  need  to acquire  more  computer
  103.           lines.  Users  quickly log  onto the  BBS, use  Silver Xpress  to
  104.           collect the new mail and quickly  log off.  This opens the  lines
  105.           for other users, and  if you having  a subscription system,  that
  106.           spells addition income!  But more importantly, Silver Xpress will
  107.           make your BBS  popular.  Today  users demand off-line  processing
  108.           capabilities!  By installing Silver  Xpress, you are catering  to
  109.           the users' demands and, thereby, making  your BBS that much  more
  110.           attractive.
  111.  
  112.           There are many BBS packages in  the world and there is a  version
  113.           of Silver  Xpress, all  working the  same, for  most popular  BBS
  114.           packages.
  115.  
  116.           The suite  of  Silver Xpress  Mail  Doors directly  supports  the
  117.           following bulletin boards:
  118.  
  119.              o All versions of Opus CBCS
  120.              o All versions of QuickBBS
  121.              o RBBS version 17.3, 17.4 including MABLE version
  122.              o All versions of Remote Access
  123.              o PCBoard 17.5
  124.              o SuperBBS
  125.              o Robo-BBS
  126.  
  127.  
  128.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page _                                                                       3
  129.  
  130.  
  131.              o TAG 2.6
  132.              o Proboard
  133.              o Maximus 2.00x
  134.  
  135.           And indirectly supports, with conversion tools, the following BBS
  136.           packages:
  137.  
  138.              o Fido version 11.0 12.x
  139.              o Maximus 1.02
  140.              o SearchLight
  141.              o WildCat
  142.  
  143.  
  144.           As you can see, Silver Xpress is, by far, the only off-line  mail
  145.           door system supporting most bulletin boards, making it truly  the                                                                        the                                                                        the
  146.           universal mail door!          universal mail door!          universal mail door!
  147.  
  148.           Why Silver Xpress?          Why Silver Xpress?          Why Silver Xpress?
  149.  
  150.           BBS usage  has been  growing at  an incredible  pace, and  Silver
  151.           Xpress was designed to address the  growing needs of both  system
  152.           operators and users  in their quest  to viably handle  electronic
  153.           mail.   Reading  and replying  to  bulletin board  mail  is  time
  154.           consuming for both the user and the BBS.  If you find your  users
  155.           are reading a lot of mail and  spending a great deal of time  on-
  156.           line replying to and entering new mail, Silver Xpress is a  great
  157.           utility to offer your users!  Since its inception, Silver  Xpress
  158.           sysops and users have  realized considerable reductions in  their
  159.           phone bills and on-line charges.
  160.  
  161.           With Silver  Xpress, your users can capture mail in an  organized
  162.           manner, for off-line reading  and replying.   Users do this  with
  163.           any BBS offering Silver Xpress in the same consistent manner.  By
  164.           offering Silver Xpress to your users, your BBS operations will be
  165.           improved by increasing user turnaround time, and by enhancing the
  166.           image of your BBS.  If  your BBS is subscription based, there  is
  167.           no doubt  your  users and  your  BBS operation  will  benefit  by
  168.           implementing Silver Xpress.
  169.  
  170.           Silver Xpress operates  by offering users  the ability to  select
  171.           desirable mail conferences or forums for the purpose of  scanning
  172.           new mail.   When Silver Xpress  scans mail from  the user's  pre-
  173.           selected message conferences, it will check for all new messages,
  174.           and present a table summary of all new messages in each  selected
  175.           mail conference.  The table summary will present not only all new
  176.           messages, but will indicate if there  are any direct messages  or
  177.           messages found using keywords pre-defined by the user.  The  user
  178.           can determine how much mail he or she wants, or simply type  "GO"
  179.           to take all the new messages available.
  180.  
  181.           This user "flexible" ability, to examine the amount of mail prior
  182.           to packing, is one of the  unique features of Silver Xpress.   We
  183.           call it the "Flex Select" Mail Bundling system!  An Xpress first!
  184.  
  185.  
  186.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page _                                                                       4
  187.  
  188.  
  189.           Silver Xpress packs  the new mail  into a  compressed format  for
  190.           downloading to the user's PC.  The new compressed file is  called
  191.           an Xpress mail  packet and will  have the extension  OPX or  QWK,
  192.           depending on the mail format selected by the Xpress user.
  193.  
  194.           Once the user downloads the Xpress mail packet to his PC, he  can
  195.           log off  the BBS  and use  the  powerful and  interactive  Silver
  196.           Xpress Mail Reader to read and reply to mail.
  197.  
  198.           Imagine the time  savings offered to  the user  by providing  the
  199.           ability to read his mail on  his own PC, thereby leaving an  open
  200.           line for other users.
  201.  
  202.           Silver Xpress is a  wonderful product and  is guaranteed to  give
  203.           your BBS benefits never imagined before!
  204.  
  205.           But Silver Xpress is not just a mail door!          But Silver Xpress is not just a mail door!          But Silver Xpress is not just a mail door!
  206.  
  207.           Silver Xpress was the first off-line mail system.  Our dedication
  208.           to customer support and  needs allowed us to  provide not just  a
  209.           mail door, but a true data gateway system!  No other mail door in
  210.           the market has the power of Silver Xpress.
  211.  
  212.           Silver Xpress offers:
  213.  
  214.              o faxing capabilities,
  215.              o off-line data entry capabilities,
  216.              o door and reader menu customization capabilities,
  217.              o mail event driven processes,
  218.              o built-in file scanner,
  219.              o file requesting and attaching capabilities and
  220.              o much more.
  221.  
  222.           With Silver Xpress, you can customize your application for any of
  223.           your "groupware" communication needs.
  224.  
  225.           This   documentation   will   discuss   the   installation    and
  226.           configuration for  the Silver  Xpress Mail  System.   It  is  the
  227.           single source document for all models of Silver Xpress.  A  model
  228.           is defined as a version of Silver Xpress for your particular  BBS
  229.           package.
  230.  
  231.           Information pertaining to a  particular bulletin board system  is
  232.           clearly defined and highlighted throughout the manual.  All other
  233.           topics of discussion are of a general nature.
  234.  
  235.  
  236.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page _                                                                       5
  237.  
  238.  
  239.  
  240.  
  241.           __          2.          __          2.          __          2.__                          __                          __                           ____________             Installation             ____________             Installation             ____________             Installation
  242.  
  243.  
  244.  
  245.           The Silver Xpress  Mail System has  been packaged and  compressed
  246.           using the ZIP (version 1.10) format.  The ZIP files are verified,
  247.           authenticated, and virus checked.
  248.  
  249.           The install program  is designed to  unzip the  files into  their
  250.           appropriate sub-directory.
  251.  
  252.           Silver Xpress is distributed under the file name SX400xx.ZIP.
  253.  
  254.           where XX is the Xpress model number for your BBS.
  255.  
  256.              _              _____________              XPRESS MODEL ___                              ________                              BBS TYPE
  257.  
  258.  
  259.               F1              OPUS 1.03 and FIDO
  260.               F2              OPUS 1.1x+
  261.               F3              OPUS 1.7x+
  262.               M1              MAXIMUS
  263.               P1              PCBOARD
  264.               R1              RBBS
  265.               H1              QBBS, RA, SBBS, ROBO, PROBOARD, TAG
  266.  
  267.           For example,  if  you are  interested  in installing  the  Silver
  268.           Xpress  Mail  System  for  your   PCBOARD  BBS,  you  will   need
  269.           SX400P1.ZIP.
  270.  
  271.           The H1  model  is  considered the  generic  HMS  (Hudson  Message
  272.           Structure) model.  HMS is a mail format used by many BBS packages
  273.           following the technical details of the original HMS system called
  274.           QBBS.   Version 4.00  of HMS  Xpress  will directly  support  all
  275.           packages currently in  the market supporting  HMS, including  any
  276.           other mail  format  an HMS  package  supports, such  as  the  new
  277.           PROBOARD, which supports HMS, SQUISH and  FIDO mail formats.   If
  278.           you have an HMS package not directly supported by Silver  Xpress,
  279.           it is  quite possible  to use  the original  QBBS 2.64  model  to
  280.           support the package.
  281.  
  282.           The first thing you should do is unzip the SX400xx.ZIP file  into
  283.           a high density diskette to make a backup copy.
  284.  
  285.           If  you  don't  have  a  high  density  drive,  skip  the  backup
  286.           suggestion and  proceed to  unzip the  package into  a  temporary
  287.           directory.
  288.  
  289.           Customers who have  already received a  diskette from  Santronics
  290.           Software do not need to make a backup.
  291.  
  292.  
  293.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page _                                                                       6
  294.  
  295.  
  296.  
  297.           2.1.          2.1.          2.1. Running Install               Running Install               Running Install
  298.  
  299.           Run the Xpress INSTALL.EXE installation program.
  300.  
  301.           The install program is  designed to present, in  a menu, the  key
  302.           reading material and the option to begin the install process.
  303.  
  304.           When the "begin install option" is selected, INSTALL will  search
  305.           the hard disk for all possible hard drive partitions and  display
  306.           the drives with the minimum required disk space.
  307.  
  308.           The minimum  required  space is  2  megabytes.   Any  hard  drive
  309.           partition below this amount will not be shown.
  310.  
  311.           For example:
  312.  
  313.              +-----------------------------------------------------+
  314.              |  Drive C: 32 megabytes with  6 megabytes remaining  |
  315.              |  Drive F: 32 megabytes with  3 megabytes remaining  |
  316.              |  Drive G: 32 megabytes with 10 megabytes remaining  |
  317.              +-----------------------------------------------------+
  318.  
  319.           In the above example, notice how INSTALL did not show drive D and
  320.           E.  This  is probably because  drive D and  E do not  have the  2
  321.           megabytes disk  space  requirement.   Two  megabytes  is  a  very
  322.           conservative number.  INSTALL will uncompress the Xpress files to
  323.           about  600K,  but  checking   for  2  megabytes  insures   proper
  324.           operations in  production  mode.   Ideally,  you  should  not  be
  325.           running a BBS with anything less.
  326.  
  327.           NOTE: If you want  to change this  hard disk space  requirement,
  328.                 modify the INSTALL.DAT file and change the keyword MINIMUM
  329.                 2000.  This amount is in kilobytes.
  330.  
  331.           Select the drive on which to install Silver Xpress.
  332.  
  333.           Next, INSTALL will ask for the source and target drives.
  334.  
  335.           +---------------------------------------------------------+
  336.           |  SOURCE DRIVE\DIRECTORY: A:\                            |
  337.           |  TARGET DRIVE\DIRECTORY: C:\XPRESS                      |
  338.           |                                                         |
  339.           |          Press F10 to Accept, ESCape to Abort           |
  340.           +---------------------------------------------------------+
  341.  
  342.           The source  path will  default to  the  drive and  directory  the
  343.           INSTALL.EXE is located.  If the paths are OK, hit the F10 key.
  344.  
  345.           VERY IMPORTANT!  DO NOT INSTALL  XPRESS INTO YOUR BBS  DIRECTORY!
  346.           DEFINE A DIRECTORY FOR XPRESS.
  347.  
  348.           INSTALL will now begin uncompressing  the *.ZIP files into  their
  349.           respective sub-directories below the target directory.
  350.  
  351.  
  352.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page _                                                                       7
  353.  
  354.  
  355.           INSTALL will create the following sub-directories:
  356.  
  357.  
  358.                      \XPRESS ---   HELP
  359.                              ---   MISC
  360.                              ---   BULL
  361.                              ---   DOCS
  362.  
  363.           INSTALL will then run XPADM.EXE automatically.
  364.  
  365.           NOTE: PCBOARD and RBBS sysops should  see the discussion at  the
  366.                 end of this section.
  367.  
  368.           Consider XPADM.EXE as  your partner.   It is  your Silver  Xpress
  369.           administration and  configuration program.    You will  use  this
  370.           program to maintain Silver Xpress.
  371.  
  372.           When XPADM  starts  to  run,  XPADM  will  always  look  for  the
  373.           XPMAIL.PRM control file.   If it is missing,  it will assume  you
  374.           are a first time configuration and run the "QUICK  CONFIGURATION"
  375.           option.
  376.  
  377.           NOTE: If you ever feel like you want to start  fresh, delete the
  378.                 XPMAIL.PRM and any  *.RAW files and  run XPADM again.   It
  379.                 will initiate the QUICK CONFIGURATION option.
  380.  
  381.           Except for RBBS Xpress (the R1 model), the QUICK configuration of
  382.           XPADM will go directly to your  BBS configuration files and  read
  383.           as much as it can  to quickly setup up  Silver Xpress.  The  RBBS
  384.           version of Silver  Xpress does not  have this  luxury.   However,
  385.           during the INSTALL process RBBS Xpress will run a utility  called
  386.           MAKEDEF.EXE to read the RBBS CONFMAIL.DEF file.
  387.  
  388.           After XPADM gets as much as it can from the BBS, it will  present
  389.           questions for  you to  answer.   Each BBS  is different  so  some
  390.           questions will not be necessary or  asked.  If XPADM can not  get
  391.           it from the BBS  configuration files, you will  be asked for  the
  392.           information.  For some  BBS's, it may only  be 1 or 2  questions.
  393.           For others, it may be 5 or 6 questions.
  394.  
  395.           The key questions to understand (if asked by XPADM):
  396.  
  397.           ENTER BOARD ID:          ENTER BOARD ID:          ENTER BOARD ID:
  398.  
  399.                Silver Xpress  scans  and  packs mail  into  a  file  called
  400.                XXXXXXX.OPX where XXXXXXX is your board  ID.  This board  ID
  401.                is used as an  identifier for your BBS.   If users use  more
  402.                than  one  BBS  for  Xpress   Mail,  this  will  help   them
  403.                distinguish mail packets.   Normally, the  board ID  closely
  404.                resembles the  name  of your  BBS  within 8  letters.    For
  405.                example, for Emerald City  BBS, a board  ID such as  EMERALD
  406.                would be a good choice.
  407.  
  408.  
  409.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page _                                                                       8
  410.  
  411.  
  412.                NOTE: This BOARD ID is used for registration.  Make sure it
  413.                      is unique for your BBS.
  414.  
  415.           FIDONET ADDRESS:          FIDONET ADDRESS:          FIDONET ADDRESS:
  416.  
  417.           DO YOU HAVE A FIDONET ADDRESS? [N]          DO YOU HAVE A FIDONET ADDRESS? [N]          DO YOU HAVE A FIDONET ADDRESS? [N]
  418.  
  419.                If you  belong  to the  FIDONET  Network, and  you  have  an
  420.                address, answer Y.  If you do not have an address, or do not
  421.                belong to the FIDONET Network, answer N.
  422.  
  423.                NOTE: The address, whether you have one or not, is required
  424.                      for registration.  If you do not have  one, make sure
  425.                      you indicate  on your  registration form  you do  not
  426.                      have a  FIDONET address.   If  you do  not have  one,
  427.                      Xpress  and  our  registration  department  will  use
  428.                      999:999/999 for registration purposes.
  429.  
  430.           ENTER YOUR BBS TELEPHONE NUMBER:          ENTER YOUR BBS TELEPHONE NUMBER:          ENTER YOUR BBS TELEPHONE NUMBER:
  431.  
  432.                Future Xpress communication products  will make use of  your
  433.                telephone number.   Provide one now  so that  users will  be
  434.                able to  take  advantage  of this  information  for  dialing
  435.                purposes.
  436.  
  437.           ENTER THE READER DIRECTORY:          ENTER THE READER DIRECTORY:          ENTER THE READER DIRECTORY:
  438.  
  439.                This version of Xpress has a powerful script language.   One
  440.                default script, accessible  from the main  menu, will  allow
  441.                users to download the  Silver Xpress Reader.   In order  for
  442.                this to work, you must tell Silver Xpress the directory  the
  443.                default script is located.
  444.  
  445.           WOULD YOU LIKE A MULTI-NODE SETUP FOR XPRESS [N]          WOULD YOU LIKE A MULTI-NODE SETUP FOR XPRESS [N]          WOULD YOU LIKE A MULTI-NODE SETUP FOR XPRESS [N]
  446.  
  447.                If you answer yes to this question, Xpress will place the  #
  448.                characters in  various  file path  definitions  for  Xpress,
  449.                particularly the UPLOAD, DOWNLOAD and WORK directories.
  450.  
  451.                The # character is used as a substitution character for  the
  452.                task number or node number.
  453.  
  454.                If you answer YES to this question, you will need to use the
  455.                -T# task  switch  when  running  XPMAIL  (except  for  OPUS,
  456.                PCBOARD, and RBBS).  See the section on Multi-node or Multi-
  457.                line setups.
  458.  
  459.           After XPADM's QUICK CONFIGURATION, it  will create all the  files
  460.           necessary for XPMAIL.EXE  to run (XPMAIL.EXE  is the main  Xpress
  461.           mail door).
  462.  
  463.           If all is successful, you are ready to run XPMAIL.EXE.
  464.  
  465.  
  466.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page _                                                                       9
  467.  
  468.  
  469.           ___________________________________________________________          PCBOARD AND RBBS SYSOPS OR ANYONE USING THE P1 or R1 MODELS          ___________________________________________________________          PCBOARD AND RBBS SYSOPS OR ANYONE USING THE P1 or R1 MODELS          ___________________________________________________________          PCBOARD AND RBBS SYSOPS OR ANYONE USING THE P1 or R1 MODELS
  470.  
  471.  
  472.           Silver Xpress  for PCBOARD  and RBBS  uses an  ASCII file  called
  473.           XPAREAS.CTL for  defining mail  conferences, and  an ASCII  file,
  474.           called XPFIDO.CTL,  for  defining FidoNet  *.MSG  message  areas.
  475.           This makes for a very powerful system, which allows you to define
  476.           two mail formats for Silver Xpress.
  477.  
  478.           XPADM for PCBOARD will only understand PCBOARD mail areas when it
  479.           does its QUICK CONFIGURATION.  It  will read the PCBOARD.DAT  and
  480.           the CNAMES files.   So  if you  are not  concerned about  FIDONET
  481.           areas, you  may stop  right  here and  ignore  the rest  of  this
  482.           section.
  483.  
  484.           For RBBS, XPADM  will not read  any RBBS  configuration files  at
  485.           all.  We apologize for this,  but RBBS has a history of  changing
  486.           its configuration  file formats  overnight and,  thus, we  cannot
  487.           reliably create  a super  duper install  and quick  configuration
  488.           system.
  489.  
  490.           Running INSTALL  will not  automatically run  XPADM.EXE for  RBBS
  491.           like it will  for the others.   It will  stop and  allow you  the
  492.           opportunity to  first  run  a program  called  MAKEDEF  which  is
  493.           designed to read the  RBBS CONFMAIL.DEF file  in the RBBS  system
  494.           directory.  MAKEDEF will create the XPAREAS.CTL and XPFIDO.CTL.
  495.  
  496.           Once you have the XPAREAS.CTL file, you can use XPADM to maintain
  497.           the file from then on.
  498.  
  499.           To define FidoNet mail areas, XPADM will look for the  XPFIDO.CTL
  500.           file.  It is equivalent in structure to the XPAREAS.CTL, however,
  501.           it is used to  keep FidoNet mail areas  separate from normal  BBS
  502.           mail areas.
  503.  
  504.           The best way to initially create  XPFIDO.CTL is by using  XPADM's
  505.           MAIL  CONFERENCE  DEFINITION  option.    Once  you  have  defined
  506.           XPAREAS.CTL, run XPADM and select the MAIL CONFERENCE  DEFINITION
  507.           option.  A list of areas will be  shown.  At this point, hit  the
  508.           INSert key, and XPADM  will append a new  area using FIDO as  the
  509.           default mail area type.
  510.  
  511.  
  512.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       10
  513.  
  514.  
  515.  
  516.  
  517.           __          3.          __          3.          __          3.__                          __                          __                           __________________________________             Testing XPMAIL.EXE the first time.             __________________________________             Testing XPMAIL.EXE the first time.             __________________________________             Testing XPMAIL.EXE the first time.
  518.  
  519.  
  520.  
  521.           You may test Silver Xpress immediately by typing XPMAIL -J.
  522.  
  523.           The -Jxxx  switch is  a LOCAL  MODE switch  only.   It will  grab
  524.           record xxxx (default  0 or 1  for TAG and  ROBOBBS) from the  BBS
  525.           user file and use  it to start  Xpress.  By  doing this, you  get
  526.           your name as the first name into the Xpress User File.
  527.  
  528.           NOTE:  PCBOARD SYSOPS  CANNOT  TEST  FROM  DOS.   YOU  MUST  RUN
  529.                  PCBOARD FIRST AND  CALL XPRESS FROM  THERE.   In general,
  530.                  PCBOARD Xpress cannot be  run locally outside of  the BBS
  531.                  unless  a   USERS.SYS   and   PCBOARD.SYS  are   present.
  532.  
  533.                  RBBS SYSOPS  CANNOT  TEST  FROM  DOS  UNLESS YOU  HAVE  A
  534.                  DORINFOx.DEF created for your SYSOP NAME.  If you want to
  535.                  create a  DORINFOx.DEF, run  RBBS and  shell to  DOS, and
  536.                  then log off.  In the RBBS directory, you should see your
  537.                  personal DORINFOx.DEF  file where  X is  the node  number
  538.                  (default is 1).
  539.  
  540.           If you wish  to test a  multi-node setup, use  the -T# switch  as
  541.           well, where # is the task or node number.
  542.  
  543.  
  544.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       11
  545.  
  546.  
  547.  
  548.  
  549.           __          4.          __          4.          __          4.__                          __                          __                           ____________________________________________________             What happened to the Version 3.00 Xpress Sysop Flag?             ____________________________________________________             What happened to the Version 3.00 Xpress Sysop Flag?             ____________________________________________________             What happened to the Version 3.00 Xpress Sysop Flag?
  550.  
  551.  
  552.  
  553.           In the past, Silver Xpress had an Xpress Sysop security  concept,
  554.           where an Xpress user could be designated as a special user.   The
  555.           Xpress Sysop had the  extra menus and  options for sysop  related
  556.           operations.  When you installed version 3.00, we told you to  set
  557.           up the BBS  sysop (you) as  the Xpress Sysop  by using the  XPADM
  558.           user editor.
  559.  
  560.           In version 4.00,  there no longer  is this  special Xpress  Sysop
  561.           flag for  users.   Version 4.00  now relies  on a  unique  Xpress
  562.           security value  system  0  to  32K.   If  you  are  a  new  sysop
  563.           installing Silver Xpress,  you might see  some old references  to
  564.           the phrase  "Xpress Sysop"  lingering around.   It  is no  longer
  565.           used.
  566.  
  567.           In Version 4.00, all menus and menu options have security values.
  568.           Like a BBS,  you can assign  an Xpress user  a security value  in
  569.           relationship to the Xpress menu security values.  This gives  you
  570.           complete control and flexibility over what the Xpress user can do
  571.           in Silver Xpress.
  572.  
  573.           After you have installed Silver Xpress, and tested out the system
  574.           as yourself, the sysop, you should immediately use XPADM and edit
  575.           the USER record belonging to you  and change the security  value.
  576.           We recommend you give  yourself a high  Xpress security value  of
  577.           32000.  By doing this, you  will have complete access to all  the
  578.           Xpress menus and  options.  See  the section on  the Xpress  Menu
  579.           System if you wish to customize the menus and security values.
  580.  
  581.           Keep in  mind, Xpress  is a  very powerful  package.   It can  be
  582.           abused if you are not careful with your customization efforts.
  583.  
  584.  
  585.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       12
  586.  
  587.  
  588.  
  589.  
  590.           __          5.          __          5.          __          5.__                          __                          __                           _________________________________             Setting up the BBS to call XPMAIL             _________________________________             Setting up the BBS to call XPMAIL             _________________________________             Setting up the BBS to call XPMAIL
  591.  
  592.  
  593.  
  594.           The  Silver  Xpress   Mail  System's  main   program  is   called
  595.           XPMAIL.EXE.  You should call this program using a batch file.
  596.  
  597.           NOTE:  Current Xpress Sysops should not use their old XPRESS.BAT
  598.                  without first studying the changes.  See the full list of
  599.                  command line switches in Appendix C.
  600.  
  601.           The basic Xpress batch file is:
  602.  
  603.                cd \xpress               cd \xpress               cd \xpress
  604.                XPMAIL %1 %2 %3 %4 %5 %6 %7 %8 %9               XPMAIL %1 %2 %3 %4 %5 %6 %7 %8 %9               XPMAIL %1 %2 %3 %4 %5 %6 %7 %8 %9
  605.                cd \bbs               cd \bbs               cd \bbs
  606.  
  607.           PCBOARD uses  a  different arrangement  for  a batch  file.    It
  608.           normally looks like this:
  609.  
  610.                @echo off               @echo off               @echo off
  611.                CD \XPRESS               CD \XPRESS               CD \XPRESS
  612.                SET XPA=%PCBDOOR%               SET XPA=%PCBDOOR%               SET XPA=%PCBDOOR%
  613.                XPMAIL               XPMAIL               XPMAIL
  614.                SET XPA=               SET XPA=               SET XPA=
  615.                %PCBDRIVE%               %PCBDRIVE%               %PCBDRIVE%
  616.                CD %PCBDIR%               CD %PCBDIR%               CD %PCBDIR%
  617.                BOARD               BOARD               BOARD
  618.  
  619.           NOTE:  As of this  writing, only PCBOARD  14.5 and  Maximus 2.00
  620.                  can be  made  to work  with  the  Xpress XPA  environment
  621.                  string used.
  622.  
  623.           For each BBS model, a sample  XPRESS.BAT (XPRESS for PCBOARD)  is
  624.           provided.
  625.  
  626.           Usually, the batch file is called from the BBS subdirectory.  The
  627.           first step is to copy the  batch file to your BBS directory,  and
  628.           modify it to change directories to the Xpress directory and  back
  629.           to the BBS  directory.   For PCBOARD, this  is taken  care of  by
  630.           using PCBoard's environmental strings.
  631.  
  632.           XPMAIL.EXE requires no switches to run  in most cases.  For  some
  633.           BBS packages,  you  will need  a  few, particularly  if  you  are
  634.           running a multi-line operation.  Xpress was designed so that  you
  635.           can pass  most of  the  information it  will  need from  the  BBS
  636.           itself.
  637.  
  638.           In an ideal Xpress setup, you don't need any switches, except for
  639.           OPUS 1.03, Maximus 2.00 and TAG, because most of the  information
  640.           is taken from the door interface files or set up during the quick
  641.           installation.
  642.  
  643.  
  644.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       13
  645.  
  646.  
  647.           MINIMUM REQUIRED TO CALL XPMAIL.EXE          MINIMUM REQUIRED TO CALL XPMAIL.EXE          MINIMUM REQUIRED TO CALL XPMAIL.EXE
  648.  
  649.                OPUS 1.03     XPMAIL     -P<comport>
  650.                OPUS 1.10     XPMAIL
  651.                OPUS 1.7x     XPMAIL
  652.                MAX 2.00      XPMAIL     -P<comport>
  653.                RBBS          XPMAIL     -B if MAIN MSG FILE undefined
  654.                PCBOARD       XPMAIL
  655.                REMOTE ACCESS XPMAIL
  656.                QBBS          XPMAIL
  657.                TAG           XPMAIL     -B%7
  658.                PROBOARD      XPMAIL
  659.                SUPERBBS      XPMAIL
  660.                ROBO-BBS      XPMAIL
  661.  
  662.           That's it!  In an  ideal setup, your BBS  should be able to  pass
  663.           all the information Xpress needs to get started from the BBS.
  664.  
  665.           What is ideal?
  666.  
  667.           Ideal is where Xpress can be  set up with one configuration  file
  668.           to fit  a single  line  or a  multiple  line BBS  without  having
  669.           multiple setups or batch files all over the place.
  670.  
  671.           In each BBS model (except PCBOARD), a file called BBSTOOLS.ZIP is
  672.           available, and contains sample files for your system for  calling
  673.           Xpress, using a menu when possible.
  674.  
  675.           For each BBS Model, BBSTOOLS.ZIP contains the following:
  676.  
  677.           OPUS 1.03 SXMENU.OEC SXWHAT.OEC
  678.           OPUS 1.10 SXMENU.OEC SXWHAT.OEC
  679.           OPUS 1.7x SXMENU.OEC SXWHAT.OEC SXMENU.CTL SXHELP.OEC
  680.           MAX 2.00  SXMENU.MEC SXWHAT.MEC SXMENU.CTL SXHELP.MEC 
  681.                     SXMHDR.MEC
  682.           RBBS      none required
  683.           PCBOARD   none required (built-in)
  684.           RA        SXMENU.MNU
  685.           QBBS      SXMENU.MNU
  686.           SUPERBBS  SXMENU.MNU
  687.           TAG       TAG.ZIP
  688.           ROBO-BBS  ROBO.ZIP
  689.           PROBOARD  SXMENU.MNU
  690.  
  691.  
  692.           These files  will give  your BBS  the ability  to perform  Xpress
  693.           automatic operations,  pass  proper  switches  from  the  BBS  to
  694.           XPRESS.BAT, as well as give a professional menu feel to your BBS.
  695.  
  696.           We could not provide a menu for TAG because Tag Menus are in  one
  697.           big file, and  providing one  would overwrite  your current  menu
  698.           system for non-Xpress related sessions.  However, an explaination
  699.           is given in TAG.ZIP.
  700.  
  701.  
  702.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       14
  703.  
  704.  
  705.           For ROBO-BBS, we  provided a complete  graphical menu system  for
  706.           Silver Xpress.  It includes Robo-BBS bitmatps and icons for  your
  707.           Silver Xpress setup. The ROBO.ZIP has Tony Mace's complete  setup
  708.           description.
  709.  
  710.           In summary, each BBS sysop should perform the following:
  711.  
  712.           ____          OPUS          ____          OPUS          ____          OPUS_                             _                             _               _________               1.03/1.10               _________               1.03/1.10               _________               1.03/1.10
  713.  
  714.  
  715.            1.  Copy the XPRESS.BAT to the BBS directory.  Edit it and  make
  716.                sure the directory switching is correct.
  717.  
  718.            2.  Copy the SXMENU.OEC to your  OPUS MISC \directory.   Compile
  719.                it.
  720.  
  721.            3.  Copy the SXWHAT.OEC to your  OPUS MISC \directory.   Compile
  722.                it.
  723.  
  724.            4.  Set up your bulletin menu or  OPUS main menu to display  the
  725.                compiled SXMENU.BBS.
  726.  
  727.           ____          OPUS          ____          OPUS          ____          OPUS_                             _                             _               ____               1.73               ____               1.73               ____               1.73
  728.  
  729.  
  730.           Method 1: Using OEC files
  731.  
  732.            1.  Copy the XPRESS.BAT to the BBS directory.  Edit it and  make
  733.                sure the directory switching is correct.
  734.  
  735.            2.  Copy the SXMENU.OEC to your  OPUS MISC \directory.   Compile
  736.                it.
  737.  
  738.            3.  Copy the SXWHAT.OEC to your  OPUS MISC \directory.   Compile
  739.                it.
  740.  
  741.            4.  Set up your bulletin menu or  OPUS main menu to display  the
  742.                compiled SXMENU.BBS.
  743.  
  744.           Method 2 : Using Custom Menus
  745.  
  746.            1.  Copy the XPRESS.BAT to the BBS directory.  Edit it and  make
  747.                sure the directory switching is correct.
  748.  
  749.            2.  Insert the following to the MAIN MENU in your MENUS.CTL.
  750.  
  751.            3.  Insert the following as a CUSTOM menu in your MENUS.CTL.
  752.  
  753.           ________          MAX 2.00          ________          MAX 2.00          ________          MAX 2.00
  754.  
  755.  
  756.           Method 1 : Using MEC Files
  757.  
  758.  
  759.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       15
  760.  
  761.  
  762.            1.  Copy the XPRESS.BAT to the BBS directory.  Edit it and  make
  763.                sure the directory switching is correct.
  764.  
  765.            2.  Copy the SXMENU.MEC to your  OPUS MISC \directory.   Compile
  766.                it.
  767.  
  768.            3.  Copy the SXHELP.MEC to your  OPUS MISC \directory.   Compile
  769.                it.
  770.  
  771.            4.  Copy the SXWHAT.MEC to your  OPUS MISC \directory.   Compile
  772.                it.
  773.  
  774.            5.  Set up your bulletin menu or  OPUS main menu to display  the
  775.                compiled SXMENU.BBS.
  776.  
  777.           Method 2 : Using Custom Menus
  778.  
  779.            1.  Copy the XPRESS.BAT to the BBS directory.  Edit it and  make
  780.                sure the directory switching is correct.
  781.  
  782.            2.  Insert the following to the MAIN MENU in your MENUS.CTL.
  783.  
  784.            3.  Place the following at the bottom of your MENUS.CTL file.
  785.  
  786.           __________________________________          HMS - RA, QBBS, SUPERBBS, PROBOARD          __________________________________          HMS - RA, QBBS, SUPERBBS, PROBOARD          __________________________________          HMS - RA, QBBS, SUPERBBS, PROBOARD
  787.  
  788.  
  789.            1.  Copy the XPRESS.BAT to the BBS directory.  Edit it and  make
  790.                sure the directory switching is correct.
  791.  
  792.            2.  Copy the SXMENU.MNU file to your BBS menus directory.
  793.  
  794.            3.  Modify your menu system to use SXMENU.MNU with a GOSUB  Type
  795.                command.
  796.  
  797.           _____________          HMS - ROBOBBS          _____________          HMS - ROBOBBS          _____________          HMS - ROBOBBS
  798.  
  799.  
  800.            1.  Copy the XPRESS.BAT to the BBS directory.  Edit it and  make
  801.                sure the  directory switching  is correct.   Also,  add  the
  802.                following switch to it.
  803.  
  804.                XPMAIL ..... /RLR
  805.  
  806.                /RLR will  tell Xpress  to create  a special  file for  Tony
  807.                Mace's last read utility.  Unfortunately, ROBO was not quite
  808.                ready for mail doors.  Consequently, this last read  utility
  809.                is required  to  maintain  pointers  correctly  with  Silver
  810.                Xpress.  The last  read utility should  be inserted in  your
  811.                LOGOFF section of your RUN BBS batch file.
  812.  
  813.            2.  Copy the ROBO Xpress menu and icon files into your BBS menus
  814.                directory.
  815.  
  816.  
  817.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       16
  818.  
  819.  
  820.            3.  Modify your menu system to use Xpress ROBO graphic sub-menu.
  821.  
  822.           _________          HMS - TAG          _________          HMS - TAG          _________          HMS - TAG
  823.  
  824.  
  825.            1.  Read the  XP4TAG.DOC file  and follow  the instructions  for
  826.                installing Xpress.
  827.  
  828.           _______          PCBOARD          _______          PCBOARD          _______          PCBOARD
  829.  
  830.  
  831.             1. Edit the file XPRESS and make sure it is prepared  with the
  832.                proper drives and  directories.   Insert the  CD drive  for
  833.                Xpress, if Xpress  is installed on  a different drive  than
  834.                PCBOARD.
  835.  
  836.             2. If you edit the DOORS.LST manually, add the following line:
  837.  
  838.                    XPRESS,,10,-1,0,C:\XPRESS\,0,N
  839.  
  840.                If you  are using  PCBSETUP, edit  DOORS.LST,  and add  the
  841.                XPRESS door option.  Make sure  USER.SYS is set to Y to  be
  842.                created.
  843.  
  844.           ____          RBBS          ____          RBBS          ____          RBBS
  845.  
  846.  
  847.              1.Copy the XPRESS.BAT file to your RBBS directory.   Edit the
  848.                file XPRESS.BAT  and  make sure  it  is prepared  with  the
  849.                proper drives and directories.
  850.  
  851.              2.Add  the  following  line  to  the  RBBS   DOORS.DEF  file:
  852.  
  853.                "XPRESS",O,,D,"XPRESS.BAT  [BAUD]   [PORT#]   [NODE]",N,,60
  854.  
  855.                Notice  the  order  of   the  [BAUD]  [PORT#]  and   [NODE]
  856.                parameters.   The  XPRESS.BAT provided  is  expecting  this
  857.                order of parameters.   If you change  the above line,  make
  858.                sure to make the proper changes to XPRESS.BAT.
  859.  
  860.  
  861.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       17
  862.  
  863.  
  864.  
  865.  
  866.           __          6.          __          6.          __          6.__                          __                          __                           ________________________________             Multi-Node/Multi-Line Operations             ________________________________             Multi-Node/Multi-Line Operations             ________________________________             Multi-Node/Multi-Line Operations
  867.  
  868.  
  869.  
  870.           For  multiple  lines  or  installations  where  one  line  is  in
  871.           operation, and you are using a  second node for local usage,  use
  872.           the TASK switch (-T and -N are the same).
  873.  
  874.           The ideal  Xpress setup  for  multiple lines  is  to use  the  -T
  875.           switch.
  876.  
  877.                 @ECHO OFF                @ECHO OFF                @ECHO OFF
  878.                 CD \XPRESS                CD \XPRESS                CD \XPRESS
  879.                 XPMAIL -T%1 -P%2                XPMAIL -T%1 -P%2                XPMAIL -T%1 -P%2
  880.                 CD \BBS                CD \BBS                CD \BBS
  881.  
  882.           Where %1 could be the node or task number for your system, and %2
  883.           could be the port number, depending  on how your BBS passes  such
  884.           information.
  885.  
  886.           In some  cases,  like OPUS  1.7x,  the -P  switch  is  completely
  887.           ignored.
  888.  
  889.           For PCBOARD 14.5,  the PCBNODE environmental  string is  checked.
  890.           If it exists, it will be used as  the task or node number.   This
  891.           is equivalent (and redundant for PCBOARD Xpress) to use:
  892.  
  893.                XPMAIL -T%PCBNODE%
  894.  
  895.           Each BBS has its own way  to pass the task number to  XPMAIL.EXE.
  896.           Study the files in  BBSTOOLS.ZIP to see the  ideal way to set  up
  897.           and use a multi-line Xpress.  PCBOARD and RBBS sysops do not have
  898.           a BBSTOOLS.ZIP file, so they do not need to do this.
  899.  
  900.           Within XPADM's SETUP NODAL FILES/DIRECTORIES menu option, use the
  901.           # (pound) character for task number substitution on the files and
  902.           directories declared in that section.
  903.  
  904.           When XPMAIL starts up, it will look for those specific files  and
  905.           directories.  This ideal situation allows for a single XPMAIL.PRM
  906.           setup, where there is no need for the -C option.
  907.  
  908.           However, if  you  have  a need  to  define  different  multi-line
  909.           setups, where Xpress configuration options will be different  for
  910.           each  node,  use  the  -C  switch  to  define  the  name  of  the
  911.           configuration file, and allow one for  each setup and node.   For
  912.           Example:
  913.  
  914.                    XPADM -Cxpmail1                   XPADM -Cxpmail1                   XPADM -Cxpmail1
  915.                    XPADM -Cxpmail2                   XPADM -Cxpmail2                   XPADM -Cxpmail2
  916.                    XPADM -Cxpmail3                   XPADM -Cxpmail3                   XPADM -Cxpmail3
  917.  
  918.  
  919.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       18
  920.  
  921.  
  922.           This is usually the case if you opt to install separate copies of
  923.  
  924.           Xpress in a  multi-node setup,  or you  find some  of the  common
  925.           Xpress information  is  not so  common  after all  in  the  XPADM
  926.           program for your particular multi-line setup or LAN topology.
  927.  
  928.           If you do use the -C  switch, change your XPRESS.BAT file to  use
  929.           the -C as well.
  930.  
  931.           For Example:
  932.  
  933.                @ECHO OFF               @ECHO OFF               @ECHO OFF
  934.                CD \XPRESS               CD \XPRESS               CD \XPRESS
  935.                XPMAIL -T%1 -CXPMAIL%1 -P%2               XPMAIL -T%1 -CXPMAIL%1 -P%2               XPMAIL -T%1 -CXPMAIL%1 -P%2
  936.                CD \BBS               CD \BBS               CD \BBS
  937.  
  938.           where %1 is the task number and %2 is the port number.
  939.  
  940.           It would also be a good idea to create a batch file for XPADM  to
  941.           work with each node.
  942.  
  943.           For example:
  944.  
  945.           XPNODE.BAT - Batch file to run XPADM for each node.
  946.  
  947.                @ECHO OFF               @ECHO OFF               @ECHO OFF
  948.                IF %1. == . GOTO HELP               IF %1. == . GOTO HELP               IF %1. == . GOTO HELP
  949.                XPADM -CXPMAIL%1 %2 %3 %4 %4 %5               XPADM -CXPMAIL%1 %2 %3 %4 %4 %5               XPADM -CXPMAIL%1 %2 %3 %4 %4 %5
  950.                GOTO END               GOTO END               GOTO END
  951.                :HELP               :HELP               :HELP
  952.                ECHO SYNTAX: XPNODE node#               ECHO SYNTAX: XPNODE node#               ECHO SYNTAX: XPNODE node#
  953.                :END               :END               :END
  954.  
  955.           This makes it easy to type:
  956.  
  957.                XPNODE 1
  958.  
  959.           or
  960.  
  961.                XPNODE 2
  962.  
  963.           when you wish to edit a particular node configuration.
  964.  
  965.  
  966.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       19
  967.  
  968.  
  969.  
  970.  
  971.           __          7.          __          7.          __          7.__                          __                          __                           __________________________________________             Packers and Tossers - Post Mail Operations             __________________________________________             Packers and Tossers - Post Mail Operations             __________________________________________             Packers and Tossers - Post Mail Operations
  972.  
  973.  
  974.  
  975.           If you do not belong to a FIDONET network, skip this section.
  976.  
  977.           PCBOARD systems can also skip this  section even if you are in  a
  978.           PCBOARD related network like RIME or RelayNet.  PCBOARD and  RBBS
  979.           Sysops using  FIDONET  (*.MSG)  message areas  should  read  this
  980.           section.  The following discussion is FIDONET related only.
  981.  
  982.           Bulletin Board Systems belonging to "echo" mail networks such  as
  983.           FIDONET must use programs which "package" and "toss" new messages
  984.           to and from  the BBS message  files.  These  programs are  called
  985.           MAIL Packers & Tossers.
  986.  
  987.           Silver Xpress itself has nothing to do with them.  However,  most
  988.           BBS systems,  which work  well in  a  mail network,  can  usually
  989.           toggle a  flag of  some  sort to  trigger  the MAIL  PACKERS  AND
  990.           TOSSERS when mail is created on-line.  Since Silver Xpress allows
  991.           for the creation of mail off-line, Silver Xpress needs to trigger
  992.           the same  flag,  so  that  there  is  a  smooth  integration  and
  993.           interface with the MAIL TOSSERS and PACKERS.
  994.  
  995.           ____________          MAIL TOSSING          ____________          MAIL TOSSING          ____________          MAIL TOSSING
  996.  
  997.  
  998.           Normally, when a  BBS collects mail  from its BOSS  mail hub,  it
  999.           uses a mail tosser to toss the newly received mail into the  mail
  1000.           sections.
  1001.  
  1002.           If you use such a system and you are using FIDO-based system, you
  1003.           must set up your MAIL TOSSER  to use the "NEW STYLE OPUS  DATES".
  1004.           You may see  this referred to  as "USE OPUS  DATES" in your  mail
  1005.           tosser configuration files.
  1006.  
  1007.           This is very important  to avoid the  small possibility of  users
  1008.           seeing "BUG DATES" in the older Silver Xpress Readers.
  1009.  
  1010.           If you see "BUG  DATES" with the reader,  add the -FBD switch  to
  1011.           the XPMAIL.EXE command line.  This should clear up any bug  dates
  1012.           you may  have, however,  it does  add a  small overhead  in  mail
  1013.           bundling time.
  1014.  
  1015.           NOTE: The BUG DATES issue is a very old dilemma in  FIDONET.  If
  1016.                 you're an old Mail Tosser, you will need the -FBD switch.
  1017.  
  1018.           ____________          MAIL PACKING          ____________          MAIL PACKING          ____________          MAIL PACKING
  1019.  
  1020.  
  1021.           Normally, when a user enters a new message directly into the  BBS
  1022.           message files, using the BBS on-line, the BBS will  automatically
  1023.  
  1024.  
  1025.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       20
  1026.  
  1027.  
  1028.           know when new mail is available.  When the user logs off, a  post
  1029.           mail operation  begins  to  "Pack"  the  mail  for  network  mail
  1030.           distribution.
  1031.  
  1032.           Since Silver Xpress is an off-line  mail system, mail is  created
  1033.           off-line, away from  direct control  of the  BBS.   When mail  is
  1034.           uploaded to the Xpress Door, Silver Xpress must somehow "trigger"
  1035.           or "tell" the BBS  there is NEW  mail to be  processed.  This  is
  1036.           only true for NET MAIL and ECHO MAIL conferences.
  1037.  
  1038.           How Xpress tells the  BBS new mail is  available depends on  your
  1039.           BBS:
  1040.  
  1041.           ____________________________________________          OPUS 1.7x, MAX 2.00, QuickBBS, Remote Access
  1042.  
  1043.  
  1044.                Because  of  offline  readers  like  Silver  Xpress,   these
  1045.                bulletin board  systems  have  evolved  and  include  direct
  1046.                methods for  Silver  Xpress to  tell  the BBS  new  mail  is
  1047.                available.  Nothing has to be done by you.
  1048.  
  1049.           ___________________________________          OPUS 1.03/OPUS 1.1x or PCBOARD/RBBS
  1050.  
  1051.  
  1052.                There is  no  direct method  to  tell these  bulletin  board
  1053.                systems  new  mail  (uploaded  and  tossed  by  XPMAIL)   is
  1054.                available.    In  this  case,   turn  on  the  "USE   XPRESS
  1055.                SEMAPHORES" option under the Xpress Miscellaneous Options in
  1056.                XPADM.
  1057.  
  1058.                This option will tell XPMAIL  to create "Flag Files"  called
  1059.                file semaphores, which can be checked for existence by other
  1060.                programs.  File semaphores are created during the  following
  1061.                XPMAIL events:
  1062.  
  1063.                    _____                   Event                   _____                   Event                   _____                   Event_                                                 _                                                 _                         _____                                                       _____                                                       _____                              _____                                                                 _____                                                                 _____                                   ______________                                   File Semaphore                                   ______________                                   File Semaphore                                   ______________                                   File Semaphore
  1064.  
  1065.  
  1066.                    GOODBYE         $GOODBYE.SEM
  1067.                    NORMAL EXIT     $EXIT.SEM
  1068.                    NETMAIL         $NET.SEM
  1069.                    ECHO MAIL       $ECHO.SEM
  1070.                    LOCAL           $LOCAL.SEM
  1071.                    NET+ECHO        $ECHONET.SEM
  1072.  
  1073.                For POST  MAIL  operations,  you  will  want  to  check  the
  1074.                existence of the  $NET.SEM, $ECHO.SEM,  or the  $ECHONET.SEM
  1075.                files.
  1076.  
  1077.                Normally, you will  check for  these flag  files during  the
  1078.                post logoff logic in your "RUNBBS.BAT" batch file.
  1079.  
  1080.                For example;
  1081.  
  1082.  
  1083.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       21
  1084.  
  1085.  
  1086.                    ----RUNBBS.BAT----
  1087.  
  1088.                    OPUS %1 %2 %3
  1089.                    IF ERRORLEVEL 5 GOTO LOGOFF
  1090.                      .
  1091.                      .
  1092.                    :LOGOFF
  1093.                    IF EXIST \XPRESS\$ECHO.SEM GOTO PACKUP
  1094.                    IF EXIST \XPRESS\$NET.SEMGOTO PACKUP
  1095.                    IF EXIST \XPRESS\$ECHONET.SEM GOTO PACKUP
  1096.                    GOTO END
  1097.                    :PACKUP
  1098.                    DEL \XPRESS\*.SEM > NUL
  1099.                    OMMM PACK
  1100.  
  1101.                For RBBS  and PCBOARD,  the logic  is  very similar.    Your
  1102.                RBBS.BAT or BOARD.BAT  should have some  check for the  file
  1103.                semaphores to perform a Mail Scan and Pack operation.
  1104.  
  1105.                There is one other way to check to see if XPMAIL has  tossed
  1106.                the mail into the BBS mail system.  Check for the  existence
  1107.                of the ECHOTOSS.LOG file.  If you told Xpress you have  echo
  1108.                areas, Xpress will add or append  the ECHO TAG LINE  defined
  1109.                for this area into the ECHOTOSS.LOG.   If this file  exists,
  1110.                you can use  this file as  a "file semaphore"  to perform  a
  1111.                mail scan and pack.  For example;
  1112.  
  1113.                    OPUS %1 %2 %3
  1114.                    IF ERRORLEVEL 5 GOTO LOGOFF
  1115.                      .
  1116.                      .
  1117.                    :LOGOFF
  1118.                    IF EXIST ECHOTOSS.LOG GOTO PACKUP
  1119.                    GOTO END
  1120.                    :PACKUP
  1121.                    OMMM PACK
  1122.                    GOTO RESTART
  1123.  
  1124.                This allows you to turn off the XPRESS SEMAPHORE system, and
  1125.                still have a simple method to pack mail.
  1126.  
  1127.                If you are using a bare  bone OPUS 1.7x system, you can  use
  1128.                the new OPUS command line switch -s to perform an  immediate
  1129.                mail scan.  Your  batch file may look  like this for a  bare
  1130.                bone OPUS 1.7x setup:
  1131.  
  1132.                    :LOGOFF
  1133.                      IF EXIST ECHOTOSS.LOG GOTO PACKUP
  1134.                      GOTO END
  1135.                    :PACKUP
  1136.                      OPUS -s
  1137.                      GOTO RESTART
  1138.  
  1139.  
  1140.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       22
  1141.  
  1142.  
  1143.  
  1144.  
  1145.           __          8.          __          8.          __          8.__                          __                          __                           _____________             Configuration             _____________             Configuration             _____________             Configuration
  1146.  
  1147.  
  1148.  
  1149.           XPADM is your main administration program for Silver Xpress.  Use
  1150.           it  to  edit  user  information  and  to  set  up   configuration
  1151.           information.
  1152.  
  1153.           XPADM will always reload its data  files.  It will check for  the
  1154.           mail XPMAIL.PRM (unless you change the name with the -C  option).
  1155.           If  this  file  is  missing,  XPADM  will  perform  a  new  quick
  1156.           configuration.
  1157.  
  1158.           If you use  XPADM to edit  Xpress user information,  there is  no
  1159.           need to save and recompile when you quit XPADM.
  1160.  
  1161.           If  you  edit  any  information   in  the  REGISTRATION  or   the
  1162.           CONFIGURATION section, you must save  and recompile.  XPADM  will
  1163.           recreate the XPMAIL.PRM, XPFILES.* and XPAREAS.* files.
  1164.  
  1165.           This section will not cover every option in XPADM.  XPADM has  an
  1166.           extensive HELP system.  Hit F1 when there is a question about  an
  1167.           option.
  1168.  
  1169.           This section will  cover only  the main  topics deemed  important
  1170.           which require extra  discussion or clarification  outside of  the
  1171.           extensive interactive  help  system.   Most  other  configuration
  1172.           topics have their own sections, especially in the area of  Xpress
  1173.           Services.
  1174.  
  1175.           Registration:          Registration:          Registration:
  1176.  
  1177.           Silver Xpress  Registration for  a BBS  requires three  items  of
  1178.           information:
  1179.  
  1180.              SYSOP NAME
  1181.              FIDONET ADDRESS
  1182.              OPX BOARD ID
  1183.  
  1184.           The Sysop Name should be the name of the person who owns and runs
  1185.           the BBS.  Is it also the name of the person who will register the
  1186.           Silver Xpress Reader for his own  personal usage on the BBS?   It
  1187.           is not the name "SYSOP" or some alias name.
  1188.  
  1189.           The FIDONET ADDRESS is your netmail address for the BBS.  If  you
  1190.           do not have one, enter the netmail address 999:999/999.
  1191.  
  1192.           The OPX BOARD ID is an 8 letter  file name to be used for  Silver
  1193.           Xpress mail packets.  XPMAIL will automatically add the extension
  1194.           OPX to this file name.  Usually the board ID is made up from your
  1195.           BBS name.  It should be a unique name.  For example, Emerald City
  1196.           BBS, might use EMERALD as their Silver Xpress Board ID.
  1197.  
  1198.  
  1199.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       23
  1200.  
  1201.  
  1202.           When you register Silver Xpress, please provide all three  pieces
  1203.           of information for each node.
  1204.  
  1205.  
  1206.           8.1.          8.1.          8.1. Defining or changing Protocols               Defining or changing Protocols               Defining or changing Protocols
  1207.  
  1208.           Silver Xpress stores a list of protocols it uses to transfer mail
  1209.           in a file called XPPROT.CTL.
  1210.  
  1211.           Use the Xpress Administrator (XPADM.EXE) or a text editor in DOS,
  1212.           to edit the XPPROT.CTL file.
  1213.  
  1214.           By default, XPPROT.CTL   uses XMT.EXE,  the Xpress File  Transfer
  1215.           program.  XMT has X, Y, Z modem file transfer capabilities.
  1216.  
  1217.           After installation is complete, there should be 3 PROTOCOL files:
  1218.  
  1219.              XPPROT.CTL             XPPROT.CTL             XPPROT.CTL  active protocol file XPMAIL.EXE will read
  1220.  
  1221.              XPPROT.XMT             XPPROT.XMT             XPPROT.XMT  backup file using XMT as the file transfer system
  1222.  
  1223.              XPPROT.DSZ             XPPROT.DSZ             XPPROT.DSZ  protocol file  using  DSZ  as  the  file  transfer
  1224.                          system
  1225.  
  1226.           If you plan on using the DSZ file transfer program, copy the file
  1227.           XPPROT.DSZ over the  main XPROTO.CTL.   If  you want  to use  GSZ
  1228.           instead, edit all  references to DSZ  to GSZ  in the  appropriate
  1229.           file.
  1230.  
  1231.           Below is an example of how a protocol is defined.
  1232.  
  1233.              Protocol Z-Modem
  1234.               HotKey   Z
  1235.               Download $XMT  /F /C %p /B %b /T /Z  %f
  1236.               Upload   $XMT  /F /C %p /B %b /R /Z /O %f
  1237.               Batch    Yes
  1238.               TwoWay   No
  1239.              End Protocol
  1240.  
  1241.  
  1242.           Everything after  the word  PROTOCOL, on  the first  line of  the
  1243.           definition,  will  be  displayed  to  callers  to  describe   the
  1244.           protocol.  You then  define a letter (hotkey)  the user will  use
  1245.           for selecting the protocol.  Make sure there are no duplicate hot
  1246.           keys.
  1247.  
  1248.           Next come  the  Download and  Upload  commands.   These  are  the
  1249.           commands used to download and upload mail (and files).
  1250.  
  1251.           You must indicate  if the  protocol accepts  BATCH file  transfer
  1252.           (this is currently ignored),  and whether the  protocol is a  two
  1253.           way (bi-directional) protocol like HSLINK or BIMODEM.
  1254.  
  1255.  
  1256.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       24
  1257.  
  1258.  
  1259.           The download  and upload  commands take  substitution  parameters
  1260.           passed by XPMAIL.
  1261.  
  1262.              %p  - comm port
  1263.              %lb - Lock Baud Rate
  1264.              %b  - user connect rate
  1265.              %f  - full path name of file
  1266.              %ud - upload directory
  1267.              %dd - download directory
  1268.  
  1269.           The %ud and  %dd variables are  normally used for  bi-directional
  1270.           file transfers with programs such as HSLINK or BIMODEM.
  1271.  
  1272.           Bi-directional file transfers  only make sense  in Silver  Xpress
  1273.           when the user is  downloading mail and wishes  to upload mail  at
  1274.           the same time and NOT visa versa.
  1275.  
  1276.           If the TwoWay option is enabled  for the protocol, Silver  Xpress
  1277.           will check  the upload  directory after  a  download of  mail  is
  1278.           finished.  If reply packets are found in the upload directory, it
  1279.           will begin to toss the new mail immediately.
  1280.  
  1281.           Here is an example bi-directional protocol using HSLINK:
  1282.  
  1283.              Protocol HS-LINK (bi-directional)
  1284.               HotKey   H
  1285.               Download $HSLINK -B%lb -E%b -P%p %f -U%ud
  1286.               Download $HSLINK -B%lb -E%b -P%p -U%ud
  1287.               Batch    NO
  1288.               TwoWay   Yes
  1289.              End Protocol
  1290.  
  1291.  
  1292.  
  1293.           8.2.          8.2.          8.2. Defining or changing Archivers               Defining or changing Archivers               Defining or changing Archivers
  1294.  
  1295.           Silver Xpress stores a list of archivers it uses to compress  and
  1296.           expand mail in a file called XPARCH.CTL.
  1297.  
  1298.           Use the Xpress Administrator (XPADM.EXE),  or with a text  editor
  1299.           in DOS, to edit the XPARCH.CTL file.
  1300.  
  1301.           The structure of each definition is defined below:
  1302.  
  1303.              Archiver Phil Katz's PKZIP 1.10
  1304.               HotKey     Z
  1305.               Extension  ZIP
  1306.               Ident      0,504b0304
  1307.               Add        PKZIP -m %f %s
  1308.               Extract    PKUNZIP -o %f
  1309.               View       PKZIP -v %f
  1310.               Delete     PKZIP -d %f
  1311.               EstCRatio  38
  1312.              End Archiver
  1313.  
  1314.  
  1315.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       25
  1316.  
  1317.  
  1318.           The header and  footer (Archiver &  End Archiver statements)  are
  1319.           required for each archiver definition.
  1320.  
  1321.           The HotKey  is  used  as  the  selection  character  when  XPMAIL
  1322.           presents the list of archivers to the user.  Make sure there  are
  1323.           no duplicate hot keys.
  1324.  
  1325.           The extension is not used and not required at this time.
  1326.  
  1327.           The Add, Extract, View,  & Delete lines  are the commands  XPMAIL
  1328.           will use to compress, expand, view and delete files respectively.
  1329.           Currently, the  view and  delete options  are  not used  for  any
  1330.           process in Xpress.
  1331.  
  1332.           The commands can take the following substitution parameters:
  1333.  
  1334.              %f      full path name to the OPX (or REP) file.
  1335.              %s      source of files to compress.
  1336.  
  1337.           The Ident  is  the offset  location  and  set of  bytes  used  to
  1338.           uniquely identify a compressed file format.  The Ident must be  a
  1339.           unique identifier for each archiver.
  1340.  
  1341.           The Ident  allows  XPMAIL  to check  uploaded  reply  files,  and
  1342.           automatically detects the compression  format in which the  reply
  1343.           file is.  If it  detects the ident in  the file at the  specified
  1344.           offset,  it  will  use   the  corresponding  EXPAND  command   to
  1345.           decompress REP file.
  1346.  
  1347.           This process  is called  "Archiver Detection"  and it  eliminates
  1348.           mismatches; problems with what the user selected for  compression
  1349.           and what compression format was actually used by the reader.
  1350.  
  1351.           If you add a new compression  utility, and do not know the  ident
  1352.           for the utility, contact Santronics Software or post a message in
  1353.           the XPRESS_SYSOP  support  conference.   We  will assist  you  in
  1354.           identifying a proper ident for the new utility.
  1355.  
  1356.           The EstCRatio is a percentage factor used by XPMAIL during a mail
  1357.           download to approximate the  size of the OPX  mail packets.   The
  1358.           default, 38(38%  compression),  was  found  to  be  a  very  good
  1359.           conservative number.
  1360.  
  1361.           Note:In the Xpress language  file, XPLANG.CTL, if the  statement
  1362.                #73 is commented out (or blank),  XPMAIL will not show  the
  1363.                approximate opx file  size to  the user.   Commenting  this
  1364.                line is not recommended because it  really is a good  piece
  1365.                of information for the user to have, but if you  prefer not
  1366.                to use this approximation, you can shut it off by putting a
  1367.                comment character in front of statement #73.
  1368.  
  1369.  
  1370.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       26
  1371.  
  1372.  
  1373.  
  1374.  
  1375.           __          9.          __          9.          __          9.__                          __                          __                           ___________             Maintenance             ___________             Maintenance             ___________             Maintenance
  1376.  
  1377.  
  1378.  
  1379.           Santronics Software has done as much as possible at this time  to
  1380.           make life easier with regard to maintaining Silver Xpress.
  1381.  
  1382.           The most critical  maintenance aspect of  Silver Xpress and  your
  1383.           BBS is  making  sure  Silver  Xpress  is  up  to  date  with  the
  1384.           configuration information on  your BBS, such  as mail areas  and,
  1385.           more importantly, security.
  1386.  
  1387.           When you use XPADM, it creates the following Xpress System Files:
  1388.  
  1389.           XPMAIL.PRM
  1390.  
  1391.              Basic information about  your Xpress setup,  BBS directories,
  1392.              etc.
  1393.  
  1394.           XPAREAS.DAT, XPAREAS.RAW  (XPAREAS.CTL, XPFIDO.CTL)
  1395.  
  1396.              XPAREAS.DAT is compiled  mail conference information  used by
  1397.              XPMAIL.EXE.  XPAREAS.RAW is  a local copy  used by XPADM.EXE.
  1398.              PCBOARD and RBBS do  not have the  RAW file, so  they use the
  1399.              XPAREAS.CTL and XPFIDO.CTL files.
  1400.  
  1401.           XPFILES.DAT, XPFILES.RAW
  1402.  
  1403.              XPFILES.DAT is compiled file area information for XPMAIL.EXE.
  1404.              XPFILES.RAW is a local copy for XPADM.
  1405.  
  1406.           If the  XPMAIL.PRM is  missing, and  you run  XPADM, Xpress  will
  1407.           automatically perform a new Quick Configuration.
  1408.  
  1409.           Except for RBBS  Xpress, if  any of  the RAW  files are  missing,
  1410.           XPADM will attempt to reread the  BBS mail (or file) area  system
  1411.           files and recompile new RAW files.
  1412.  
  1413.           For PCBOARD,  if  you  delete the  XPAREAS.CTL  file,  or  it  is
  1414.           missing, XPADM will reread the CNAMES file.
  1415.  
  1416.           If you change your BBS configuration, you must always update  the
  1417.           Xpress data files by using XPADM.  Otherwise, you risk the chance
  1418.           of having mail area mismatches and security related issues.
  1419.  
  1420.  
  1421.           9.1.          9.1.          9.1. Running XPADM Update Operations               Running XPADM Update Operations               Running XPADM Update Operations
  1422.  
  1423.           To update the  Xpress system files,  use the XPADM  -U switch  to
  1424.           automatically tell  Xpress to  reread the  BBS system  files  and
  1425.           recompile the Xpress system files.
  1426.  
  1427.  
  1428.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       27
  1429.  
  1430.  
  1431.           For example:
  1432.  
  1433.              XPADM -U
  1434.  
  1435.           If you run a  relative, dynamic mail  area system (always  adding
  1436.           and deleting areas), you may put  this command in one of you  BBS
  1437.           batch files, and run it nightly just to make sure Xpress is up to
  1438.           par with the BBS.
  1439.  
  1440.           But if you make occasional, minor changes, like adding,  deleting
  1441.           or moving a new message area, manually running XPADM -U would  be
  1442.           all that is required.
  1443.  
  1444.           For RBBS, you will  have to manually edit  (with XPADM or a  text
  1445.           editor) the XPAREAS.CTL or XPFIDO.CTL file to match your BBS mail
  1446.           areas and recompile.
  1447.  
  1448.           For PCBOARD, you have two choices:
  1449.  
  1450.           1. You can delete XPAREAS.CTL and recompile, or
  1451.  
  1452.           2. You can manually edit XPAREAS.CTL and recompile.
  1453.  
  1454.           When you perform an automatic update  to Silver Xpress, you  will
  1455.           probably lose all override                            override                            override information you have done in the XPADM
  1456.           Mail Area Definition section.  This is probably the only admitted
  1457.           weakness in Silver Xpress.  This will change.  The main issue  is
  1458.           direct BBS interface  with BBS  and Xpress  system files,  versus
  1459.           Xpress's "added  value" of  providing the  opportunity to  define
  1460.           "extra" information for the mail conferences.  There is also  the
  1461.           software engineering dilemma, "Single Source Development"  versus
  1462.           "Multiple Source  File Development".   You  will understand  this
  1463.           better if you're developing and supporting 14 different models of
  1464.           Silver Xpress  and,  at  the same  time,  reaching  the  goal  of
  1465.           providing a consistent  software design.   This is  why there  is
  1466.           only 1 door documention  and not 14.   Can you imagine trying  to
  1467.           write and  maintain  14  different manuals,  one  for  each  BBS?
  1468.  
  1469.  
  1470.           PCBOARD and RBBS sysops have the luxury of the ASCII text file in
  1471.           XPAREAS.CTL and XPFIDO.CTL.  These  sysops can retain the  Xpress
  1472.           extra mail conference information by manually editing these files
  1473.           (or by using XPADM).   You can expect  future versions of  XPMAIL
  1474.           and XPADM to follow the ASCII control file concept for all models
  1475.           of Silver Xpress.
  1476.  
  1477.  
  1478.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       28
  1479.  
  1480.  
  1481.  
  1482.  
  1483.           ___          10.          ___          10.          ___          10._                           _                           _                           ________________________             Advanced Xpress Services             ________________________             Advanced Xpress Services             ________________________             Advanced Xpress Services
  1484.  
  1485.  
  1486.  
  1487.           This section  is  intended for  System  Integrators who  wish  to
  1488.           migrate or  develop  an advanced  professional  application  with
  1489.           Silver Xpress.
  1490.  
  1491.           There are 6 kinds of services Silver Xpress can offer to users.
  1492.  
  1493.                o  Optional Bulletins.
  1494.                o  Xpress Node List.
  1495.                o  Off-line Reader Services.
  1496.                o  Uploaded Mail Service.
  1497.                o  Xpress Master Service.
  1498.                o  Off-line Forms.
  1499.  
  1500.  
  1501.           10.1.          10.1.          10.1.     Optional Bulletins                    Optional Bulletins                    Optional Bulletins
  1502.  
  1503.  
  1504.  
  1505.           The Silver Xpress Reader 3.0x has the ability to display optional
  1506.           bulletins or screen displays to the user off-line.
  1507.  
  1508.           If the file called BULLETIN.LST  exists in the XPRESS  directory,
  1509.           XPMAIL will look for  the bulletin files  declared in this  file,
  1510.           and pass them to the user during a download session.
  1511.  
  1512.           Optional Bulletins are passed to the user if, and only if, he has
  1513.           not yet seen them.  The criteria to pass them or not is based  on
  1514.           the user's  last  usage date  of  Xpress,  and the  date  of  the
  1515.           bulletin file.
  1516.  
  1517.           The format for the BULLETIN.LST file is as follows:
  1518.  
  1519.                 [option] filename_1   description_1
  1520.                 [option] filename_2   description_2
  1521.                 .
  1522.                 .
  1523.  
  1524.           The option can consist of the following commands:
  1525.  
  1526.                 UNREG:                UNREG:                UNREG:   Send file if the user is NOT registered
  1527.                 REG:                REG:                REG:     Send file if the user is registered
  1528.  
  1529.           If the  file  path  portion  of  the  bulletin  filename  is  not
  1530.           provided, Xpress  will look  in the  bulletin (default  is  BULL)
  1531.           directory first to see if the file exists.
  1532.  
  1533.           You may edit the BULLETIN.LST file  using an ASCII editor or  use
  1534.           the Xpress Administration program, XPADM, to edit this file.
  1535.  
  1536.  
  1537.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       29
  1538.  
  1539.  
  1540.           Example:
  1541.  
  1542.           c:\bbs\fidonews.024           Fidonew newsletter
  1543.           c:\bbs\xphelp.txt             How to user Silver Xpress
  1544.           c:\bbs\products.txt           New Product Listings for Month
  1545.           UNREG: C:\bbs\register.txt    How to register Silver Xpress
  1546.  
  1547.           In the above example, the first  three files will be sent to  the
  1548.           user if the file date is  less than the user's last Xpress  usage
  1549.           date.  The last file will only be passed if he is an unregistered
  1550.           user and follows the date criteria as well.
  1551.  
  1552.           There are two methods by which  to force bulletins to be sent  to
  1553.           the user:
  1554.  
  1555.              1. change the file date using a "touch" program.
  1556.  
  1557.              2. Pass the file as a reader bulletin instead  of an optional
  1558.                 bulletin.
  1559.  
  1560.  
  1561.           10.2.          10.2.          10.2.     Xpress Node List                    Xpress Node List                    Xpress Node List
  1562.  
  1563.           If you offer  FIDONET net mail  support for your  users, you  can
  1564.           help reduce incorrect net mail  addresses by allowing your  users
  1565.           to download a reduced node list called the Xpress Node List.
  1566.  
  1567.           The Xpress Node  List is a  set of special  index files for  fast
  1568.           validation of net mail addresses.
  1569.  
  1570.           Currently, only the node list compiler called XLAXNODE can create
  1571.           these files.  At this  time, we do not  have our own Xpress  Node
  1572.           List compiler.
  1573.  
  1574.           To compile the Xpress Node List,  set the XLAXNODE control  items
  1575.           in the XLAXNODE Control file:
  1576.  
  1577.                     XPRESS1
  1578.                     XPRESS2
  1579.  
  1580.           Set the NODE LIST Path in  XPADM to the directory where you  keep
  1581.           your node list files.
  1582.  
  1583.           XPADM will be set  to the directory defined  in your BBS  Control
  1584.           File, so you will probably not need to change it, but check  just
  1585.           to be sure.
  1586.  
  1587.           If you allow your  users to have access  to NETMAIL, you can  set
  1588.           the users to receive the Xpress node list in the EDIT USER, SYSOP
  1589.           FLAGS section of XPADM.
  1590.  
  1591.           These files will only be passed to them when they download  mail.
  1592.           Only new compilations of the node list will be passed.
  1593.  
  1594.  
  1595.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       30
  1596.  
  1597.  
  1598.           The off-line reader will store it  on the users defined  Nodelist
  1599.           directory, so that netmail entry is easy.
  1600.  
  1601.  
  1602.           If you wish to allow all users with access to netmail to  receive
  1603.           the nodelist, you can use the Edit User, Set Global flags  option
  1604.           or set it as a default user definition.
  1605.  
  1606.  
  1607.  
  1608.           10.3.          10.3.          10.3.     Off-line Reader Services                    Off-line Reader Services                    Off-line Reader Services
  1609.  
  1610.           Off-line Reader Services  offer the  ability to  define new  menu
  1611.           options at the reader.
  1612.  
  1613.           The 3.0x  reader has  the menu  option "Remote  Services".   When
  1614.           selected, the reader will display the list of services  available
  1615.           on your system.
  1616.  
  1617.           You can think  of services  as extended  applications offered  by
  1618.           your BBS.  The service applications you can create are unlimited.
  1619.  
  1620.           Some example applications which can be created are:
  1621.  
  1622.              1. Off-line  questionnaires  for   order  entry  or   product
  1623.                 purchasing, BBS registration, Surveys, etc.
  1624.  
  1625.              2. File Viewers.
  1626.  
  1627.              3. Fax services.
  1628.  
  1629.           The applications are only limited by your imagination.
  1630.  
  1631.           To create an off-line reader  service, edit the SERVICES.XP  file
  1632.           using a DOS  text editor, or  use the XPRESS  SERVICES option  in
  1633.           XPADM.
  1634.  
  1635.           This file defines the  new remote service  options the user  will
  1636.           see when he selects the REMOTE SERVICE option in the reader.   If
  1637.           no  services  are  defined,  the  reader  will  not  display  any
  1638.           services.
  1639.  
  1640.  
  1641.           SERVICES.XP uses the following format:
  1642.  
  1643.  
  1644.                 [option] description | command
  1645.  
  1646.           The option can be one of the following commands:
  1647.  
  1648.                 UNREG:                UNREG:                UNREG:   Send service if the user is NOT registered
  1649.                 REG:                REG:                REG:     Send service if the user is registered
  1650.  
  1651.  
  1652.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       31
  1653.  
  1654.  
  1655.           If no option is provided, the service application is sent to  the
  1656.           user with each download.
  1657.  
  1658.  
  1659.           example:
  1660.  
  1661.           UNREG: Purchase Silver Xpress. |*FORM SXORDER.FRM
  1662.           Company X Purchase Order       |*FORM COMPANYX.FRM
  1663.           Special Access Questionnaire   |*FORM ACCESS.FRM
  1664.           Send Mail To Sysop             |*NEW 1 /TO=SYSOP
  1665.           Fax Mail to Sales Office       |*NEW 1 /TO=SALES /S=412-645-3486
  1666.           FidoNews                       |*VIEW FIDONEWS.TXT
  1667.  
  1668.  
  1669.           The * commands are  special reader commands.   The following  are
  1670.           the current * Commands available:
  1671.  
  1672.           *EDIT <filename>
  1673.  
  1674.                Edit or view the filename passed.  VERSION 3.02 Reader Only.
  1675.  
  1676.           *FORM <form filename>
  1677.  
  1678.                Silver Xpress  offers  you  the ability  to  have  the  user
  1679.                process order entry forms off-line.  The output of the  data
  1680.                entry can then be directed to a special conference, or  sent
  1681.                to the EDI directory for later processing.
  1682.  
  1683.                The *FORM command will process the form for data entry.  The
  1684.                section on Xpress Forms System will  show you how to  create
  1685.                the form files.  You need to define form files and pass them
  1686.                to the user automatically using the forms system.
  1687.  
  1688.           *VIEW <filename>
  1689.  
  1690.                Similar to *EDIT, you do  not have any editing  capabilities
  1691.                using this  option.   *VIEW  is  excellent for  viewing  new
  1692.                letters.  VERSION 3.02 Only.
  1693.  
  1694.           *NEW <area#> [/TO=] [/S=] [/I=] [/A=]
  1695.  
  1696.                *NEW allows  you to  create a  new message  in area#.    The
  1697.                optional parameters are:
  1698.  
  1699.                /T= Name of recipient (fills in the ToWhom Field).
  1700.  
  1701.                /S= Subject Line (For  FaXXpress, the  subject line  is the
  1702.                    fax phone number).
  1703.  
  1704.                /I= Import File Name.  This File will become the message.
  1705.  
  1706.                /A= Netmail Address.
  1707.  
  1708.  
  1709.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       32
  1710.  
  1711.  
  1712.                *NEW is a  great feature  for creating  canned messages  for
  1713.                your customized service.
  1714.  
  1715.                VERSION 3.02 reader Only.
  1716.  
  1717.           *READ <area#>
  1718.  
  1719.                The *READ command will read message area #.
  1720.  
  1721.                VERSION 3.02 Reader Only.
  1722.  
  1723.           *DOS <command>
  1724.  
  1725.                This command will execute the  command at the remote  user's
  1726.                PC.
  1727.  
  1728.                NOTE:  Santronics Software will not be  responsible for any
  1729.                       malicious usage of  this command.   This  command is
  1730.                       available for customizing the application to process
  1731.                       special programs that you provide to users.
  1732.  
  1733.                VERSION 3.02 Reader Only
  1734.  
  1735.           SPECIAL NOTE:
  1736.  
  1737.           Please note:   Due to a  bug in the  3.00 and  3.01 reader,  most
  1738.           commands are  not  understood except  for  *FORM in  the  readers
  1739.           "REMOTE SERVICE" option.  All  others commands will be  processed
  1740.           as  DOS  commands.    Customers  who  wish  to  provide  off-line
  1741.           services, other than  the *FORM option  to 3.00  and 3.01  reader
  1742.           users, can do so using a modified reader pull down menu.
  1743.  
  1744.           The above  commands  can be  executed  within the  3.00  or  3.01
  1745.           readers using modified  pull down menus  for the user.   See  the
  1746.           reader documentation on the Silver Xpress Dynamic Menu System for
  1747.           a full list  of * commands  and how to  send a customized  reader
  1748.           pull down menu to the user.
  1749.  
  1750.           Silver Xpress  has the  power to  create any  type of  customized
  1751.           application.
  1752.  
  1753.           As an example service application, we provided the Silver  Xpress
  1754.           off-line order entry forms (SXORDER.*):
  1755.  
  1756.  
  1757.                 SXFORM.FRM    Form Definition File
  1758.                 SXFORM.WIN    Form Outline (MAKER.EXE required)
  1759.                 SXFORM.PL     Prolog File
  1760.  
  1761.  
  1762.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       33
  1763.  
  1764.  
  1765.           SXFORM.WIN is similar to  a BSV (binary save)  file, but we  used
  1766.           our simple  screen designer  called MAKER.EXE,  which allows  the
  1767.           creation of a window rather than a full screen outline.
  1768.  
  1769.           Your users will get these forms  if they have not registered  the
  1770.           Silver Xpress Reader.
  1771.  
  1772.           To turn off this application, remove the off-line reader  service
  1773.           *FORM SXORDER.FRM using XPADM and remove the SXORDER.* forms from
  1774.           the XFORMS.DAT file.
  1775.  
  1776.  
  1777.           10.4.          10.4.          10.4.     Xpress Master Services                    Xpress Master Services                    Xpress Master Services
  1778.  
  1779.           Xpress Master Services are special  messages to the user  "XPRESS
  1780.           MASTER".
  1781.  
  1782.           When an Xpress user creates a message to XPRESS MASTER, depending
  1783.           on the subject line (the master service command), you can have an
  1784.           external program executed on your PC.  This allows you to  create
  1785.           "MAIL DRIVEN EVENTS".
  1786.  
  1787.           There are two built-in Xpress Master Service commands:
  1788.  
  1789.                XAM               XAM               XAM            Create an answering machine message.
  1790.                XPRESS CONFIG               XPRESS CONFIG               XPRESS CONFIG  Perform an off-line configuration.
  1791.  
  1792.           All others master service commands will be checked against a list
  1793.           defined in the file XMASTER.DAT.
  1794.  
  1795.           If this file  is not available  in the  Xpress directory,  Xpress
  1796.           Master Services are disabled except  for the two built-in  master
  1797.           commands.
  1798.  
  1799.           The format for the XMASTER.DAT is:
  1800.  
  1801.  
  1802.                 <MASTER TAG> | program [%f] [%u] [%s]
  1803.  
  1804.                 %f Xpress Formatted Uploaded Message.
  1805.                 %u User Name in Caps.
  1806.                 %s Subject line.
  1807.  
  1808.           i.e.,
  1809.  
  1810.                 DATABASE      |YOURDB.EXE %s
  1811.                 TODAY LOG     |TODAYLOG.BAT
  1812.                 FAX MAIL      |MYFAX.EXE /psubject %f
  1813.                 PROCESS EDI   |PROEDI.EXE %f %u
  1814.  
  1815.  
  1816.           There is  no limit  to  the number  of  Master services  you  can
  1817.           define.
  1818.  
  1819.  
  1820.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       34
  1821.  
  1822.  
  1823.           All Xpress Formatted  uploaded messages are  in the Xpress  FIDO-
  1824.           like mail  format.    There are  slight  differences  for  Xpress
  1825.           purposes.  To  get the exact  format of an  Xpress uploaded  FIDO
  1826.           mail format, contact us.  We will be glad to give it to you.
  1827.  
  1828.           The best method to gaining full  usage of a master service is  to
  1829.           have your master service  create a private  mail response in  the
  1830.           name of the user who sent the master service command.  This would
  1831.           be great for a database inquiry system, where the response is the
  1832.           output of the database inquiry, or in an order entry application,
  1833.           where the the response can be a validation or confirmation.
  1834.  
  1835.           Example Applications:
  1836.  
  1837.           1. The DATABASE example above will call  the YOURDB.EXE program.
  1838.              The subject can be database keywords.  The YOURDB.EXE program
  1839.              will search  your database  for the  keywords  and produce  a
  1840.              ASCII text report.  In order to make the report automatically
  1841.              available for the user  to download, the YOURDB  program will
  1842.              create a Xpress FIDO message.  Xpress will  pick up after the
  1843.              YOURDB.EXE is finished executing  and toss the message.   The
  1844.              user  can  proceed  to  download,  and  his  report  will  be
  1845.              available.
  1846.  
  1847.           2. The PROCESS EDI  master service is  coupled with  an off-line
  1848.              forms application.  The PROEDI.FRM file is set up to create a
  1849.              FIDO message with the  TOWHOM Field set up  at XPRESS MASTER,
  1850.              and the SUBJECT field setup as PROCESS EDI.  When the form is
  1851.              processed off-line,  the  output  will  be  saved as  a  FIDO
  1852.              message.  When the user uploads his reply packet, XPMAIL will
  1853.              process the  master  service, PROCESS  EDI,  and execute  the
  1854.              program PROEDI.EXE, passing to it the  file name.  PROEDI.EXE
  1855.              is designed to read  a FIDO message  and process the  body of
  1856.              the text  as EDI  order data.    PROEDI is  also designed  to
  1857.              create a  response  message to  the  person  in the  FROMWHOM
  1858.              field.
  1859.  
  1860.           All Master Service Messages created by  the user are killed  (not
  1861.           tossed) once the message has been serviced.
  1862.  
  1863.  
  1864.  
  1865.           10.5.          10.5.          10.5.     Upload Mail Services                    Upload Mail Services                    Upload Mail Services
  1866.  
  1867.           UPLOADED MAIL SERVICES is somewhat  similar in concept to  master
  1868.           services, but  is triggered  by area  number (or  applied to  all
  1869.           areas).
  1870.  
  1871.           It is a very powerful system, and  there is no limit in the  Work
  1872.           Flow Application on the ways you  may wish to use Silver  Xpress.
  1873.           To create an uploaded mail service, use the XPADM program.
  1874.  
  1875.           An example uploaded mail service is the default service  provided
  1876.           by Xpress "SILVER XPRESS FaXXpress SYSTEM".
  1877.  
  1878.  
  1879.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       35
  1880.  
  1881.  
  1882.           You can install a Fax Service for your users using the  SXFAX.EXE
  1883.           program.  SXFAX is designed for CAS-BASED Fax cards only, and  it
  1884.           is a "Lite" version of our commercial version FAX XPRESS system.
  1885.  
  1886.           The lite version does not do any accounting.  All it does is FAX.
  1887.  
  1888.  
  1889.           10.6.          10.6.          10.6.     Sample Fax Application                    Sample Fax Application                    Sample Fax Application
  1890.  
  1891.           To install FaXXpress Lite, create  an Uploaded Mail Service  Call
  1892.           option and install the following FaXXpress information:
  1893.  
  1894.                Service Log Tag          : FAXX
  1895.                Active Service           : YES
  1896.                Apply to all Areas       : NO
  1897.                When to Apply Service    : AFTER TOSS
  1898.                Mail Area Number         : 99
  1899.                ASCII Convert            : NO
  1900.                Add Header               : YES
  1901.                Erase Xpress Message     : NO
  1902.                Strip Kludge for text    : YES
  1903.                Text Storage Directory   : C:\FAXQ
  1904.                DOS command to Issue     : !C:\XPRESS\SXFAX.EXE %f C:\FAXQ
  1905.                Processing Message       : FAX REQUEST!
  1906.                Success Message          : FAX HAS BEEN QUEUED FOR SENDING!
  1907.                Error Message            : FAX ERROR. REPORT TO SYSOP!
  1908.  
  1909.           The Mail Area Number is important.  It must exist.
  1910.  
  1911.           Xpress will  create the  TEXT Storage  Directory if  it does  not
  1912.           exist.
  1913.  
  1914.           Note: The BBS area must exist and  it should be designated  as a
  1915.                 FAX area  for OUTBOUND  faxes only.   You  should make  it
  1916.                 PRIVATE ONLY  so  that  people  will  not  see  other  fax
  1917.                 messages.
  1918.  
  1919.           SXFAX.EXE will take the fax request  and immediately fax it.   No
  1920.           log.
  1921.  
  1922.           For FaXXpress,  you must  run the  XPMAIL program  using the  -XF
  1923.           switch.  In this example, the call to XPMAIL should include -XF99
  1924.           where 99 is  the fax area  number.  This  tells the READER  which
  1925.           mail area  is a  fax area.   The  reader will  change the  prompt
  1926.           SUBJECT: to FAX NUMBER:
  1927.  
  1928.  
  1929.  
  1930.           10.7.          10.7.          10.7.     Xpress Forms System                    Xpress Forms System                    Xpress Forms System
  1931.  
  1932.           Silver Xpress implements a powerful forms processing facility.
  1933.  
  1934.           It is the only mail system in the BBS World to offer this new and
  1935.           exciting capability.
  1936.  
  1937.  
  1938.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       36
  1939.  
  1940.  
  1941.           Forms Processing can be called Data  Entry.  Silver Xpress  Forms
  1942.           Processing is the ability to ask  users a series of questions  or
  1943.           prompts in a pop-up window.   All the forms in the  configuration
  1944.           section are data  entry windows.   Silver Xpress  now offers  the
  1945.           ability to create forms for a specific application.
  1946.  
  1947.           Normally, forms processing  is defined  by the  BBS, where  forms
  1948.           will  be  passed  to  the  users  to  fill  out  and  send  back,
  1949.           XPMAIL.EXE.
  1950.  
  1951.           You might have a need to offer products on your professional  BBS
  1952.           system, and you may  wish to allow users  to order products  off-
  1953.           line, or you may find a BBS wishing to ask a series of  questions
  1954.           for a survey.  You might be a company with a sales force and wish
  1955.           to provide a  mail, fax,  and order  entry system  to your  sales
  1956.           people.  The applications are endless.
  1957.  
  1958.           Here are a  set of applications  defined by  customers of  Silver
  1959.           Xpress:
  1960.  
  1961.                 o Off-line Order Entry Forms
  1962.                 o Off-line Database Inquiry
  1963.                 o Off-line Customer Surveys
  1964.                 o Off-line UUCP Mailing
  1965.                 o Off-line MHS Electronic Mail
  1966.  
  1967.           Users of Silver Xpress may define  their own forms for their  own
  1968.           applications.  However, users are limited with the types of forms
  1969.           output your BBS will accept.  Generally, users can only create or
  1970.           define a form  for creating  a message for  the BBS.   A  perfect
  1971.           example is to create a message form to send a canned message on a
  1972.           regular basis.
  1973.  
  1974.           If you are using Silver Xpress with the Xpress MHS system, or you
  1975.           are using Xpress within a GROUP environment, the applications for
  1976.           Xpress Forms  grow.   For  instance, you  may  want to  create  a
  1977.           "Conference Room Scheduling" form when using the Xpress MHS in  a
  1978.           LAN environment.
  1979.  
  1980.           If you  are  a  professional  Systems  Integrator,  and  wish  to
  1981.           investigate the possibilities  Silver Xpress Forms  may have  for
  1982.           your organization,  or simply  need assistance,  call  Santronics
  1983.           Software.  We will be glad to assist you with this new,  powerful
  1984.           capability.  We  have a complete  Xpress Forms documentation  and
  1985.           testing utility available called  XFORM100.ZIP.  It is  available
  1986.           to registered sysops of Silver Xpress.
  1987.  
  1988.  
  1989.           10.8.          10.8.          10.8.     Sample Order Entry Xpress Forms Application                    Sample Order Entry Xpress Forms Application                    Sample Order Entry Xpress Forms Application
  1990.  
  1991.           Silver Xpress is  the only system  in the BBS  market capable  of
  1992.           processing forms or data entry screens  off-line.  With this  new
  1993.           store and forward electronic order  entry system, you can  create
  1994.  
  1995.  
  1996.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       37
  1997.  
  1998.  
  1999.           off-line  store  and  forward  solutions  for  your  professional
  2000.           organization.
  2001.  
  2002.           As an example, the a SXORDER.* files are provided.  To make  this
  2003.           work, edit  the file  SXORDER.FRM and  edit the  keyword AREA  to
  2004.           point to your netmail area.
  2005.  
  2006.           Here is how this works:
  2007.  
  2008.              1. The SXORDER.* files are forms created by Santronics.  They
  2009.                 are real order entry forms.
  2010.  
  2011.              2. When users download mail,  these forms are sent  over with
  2012.                 the packet if the user is not registered with the reader.
  2013.  
  2014.              3. If the user  wishes to purchase  the Silver Xpress  reader
  2015.                 using this form, he can simply fill it out  and upload the
  2016.                 reply packet back to the XPRESS system on the BBS.
  2017.  
  2018.              4. The Xpress door  will create  a netmail  message with  the
  2019.                 order information in the body of the message to Santronics
  2020.                 at FIDONET  1:135/382.   This  means you  must  be on  the
  2021.                 FIDONET network.
  2022.  
  2023.              5. When Santronics receives the  order, it will  be processed
  2024.                 immediately and a verification  of the order will  be sent
  2025.                 back to your BBS.  This process takes about 5-10 minutes.
  2026.  
  2027.              6. It is your  responsibility to post  the verification as  a
  2028.                 private message  to the  user.   This  is  done either  by
  2029.                 giving your users netmail privileges, or by you forwarding
  2030.                 the netmail message.
  2031.  
  2032.  
  2033.           This is  a REAL  working example  of  an electronic  order  entry
  2034.           system, the first of its kind for the BBS market.
  2035.  
  2036.           We call  it the  Silver  Xpress EDI  system  which is  short  for
  2037.           Electronic Data Interchange system.
  2038.  
  2039.           In the commercial industry, EDI is often referred to as the  X.12
  2040.           protocol.  If you are a professional organization with electronic
  2041.           order entry needs,  the Silver Xpress  off-line forms system  and
  2042.           automatic work flow solution is a  very cost effective system  to
  2043.           provide an EDI system within your organization.  If your  company
  2044.           requires consultation  to  set up  an  EDI system,  please  don't
  2045.           hesitate to call us.
  2046.  
  2047.  
  2048.           10.9.          10.9.          10.9.     Xpress Vacation Saver                    Xpress Vacation Saver                    Xpress Vacation Saver
  2049.  
  2050.           Silver Xpress has a  built-in feature to  run the XPMAIL  program
  2051.           automatically to  pack up  user packets,  and  save them  in  the
  2052.           user's mailbox  directory for  later pickups.   This  process  is
  2053.  
  2054.  
  2055.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       38
  2056.  
  2057.  
  2058.           called Vacation Saver because it was designed for users who go on
  2059.           vacation, but wish to have the BBS save mail for them before  the
  2060.           BBS renumbering process would delete mail.
  2061.  
  2062.           To set up vacation saver:
  2063.  
  2064.           First, determine that you have enough disk space for saving  user
  2065.           packets.  You may decide that  it should not be a general  option
  2066.           but one on request only.  If you decide to turn off the  vacation
  2067.           saver, you should delete the menu option from XPMENU.CTL.
  2068.  
  2069.           Set up a BBS event  for the best time  to run the vacation  saver
  2070.           event.   This event  time should  be  prior to  your  renumbering
  2071.           process.
  2072.  
  2073.           The event should call  the following commands  in your BBS  batch
  2074.           file:
  2075.  
  2076.            :EVENT
  2077.                 CD \XPRESS
  2078.                 XPVAC -DF -NLW -VS
  2079.                 CALL XVS
  2080.                 GOTO RESTART
  2081.  
  2082.           XPVAC is a  utility to read  the Xpress user  database file,  and
  2083.           check for users  who have turned  on the  vacation saver  option.
  2084.           XPVAC will create the batch file XVS.BAT with XPMAIL commands for
  2085.           each user.  XPMAIL  will use the -J  switch, which means  PCBOARD
  2086.           and RBBS cannot utilize this feature at this time.
  2087.  
  2088.           Once XVS is executed, it will  create mail packets for each  user
  2089.           requesting vacation mail, and store it in their personal mailbox.
  2090.  
  2091.           The user will have the ultimate responsibility for picking up the
  2092.           mail.   When the  user  returns from  vacation,  he can  start  a
  2093.           download, and Xpress  will tell him  he has vacation  mail.   The
  2094.           user can also use the "Check Vacation Mail" option to see if  any
  2095.           mail packets are available.
  2096.  
  2097.           Once the user downloads the vacation mail, it is deleted from his
  2098.           mailbox.
  2099.  
  2100.  
  2101.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       39
  2102.  
  2103.  
  2104.  
  2105.  
  2106.           ___          11.          ___          11.          ___          11._                           _                           _                           ___________________________________________             Changing the Xpress Menus and Display Files             ___________________________________________             Changing the Xpress Menus and Display Files             ___________________________________________             Changing the Xpress Menus and Display Files
  2107.  
  2108.  
  2109.  
  2110.           Silver Xpress now has a powerful,  dynamic menu system to  better
  2111.           suit your  customization needs  for off-line  mail  applications.
  2112.           The menu system has security values, making it possible to set up
  2113.           the Xpress  menus  for  individual users  based  on  Xpress  user
  2114.           security.
  2115.  
  2116.           Keep in mind the security values used for the menus in Xpress are
  2117.           completely independent of the BBS user security system.
  2118.  
  2119.           Silver Xpress offers sysops the ability to customize menus on the
  2120.           door side and on the reader side.
  2121.  
  2122.  
  2123.           11.1.          11.1.          11.1.     Changing the default Xpress Door menus                    Changing the default Xpress Door menus                    Changing the default Xpress Door menus
  2124.  
  2125.           The Xpress mail  door menus are  defined in  the XPMENU.CTL  file
  2126.           stored in your Xpress directory.
  2127.  
  2128.           In  the  past,  Santronics   Software  resisted  providing   menu
  2129.           customization because users  might have to  learn multiple  menus
  2130.           from different Silver Xpress  installations.  This is  especially
  2131.           true  for  script   users  who   would  have   to  change   their
  2132.           communication scripts for each customized Xpress setup.
  2133.  
  2134.           However, we think we have achieved a compromise between  allowing
  2135.           Silver Xpress to grow  and the need to  keep a consistent  dialog
  2136.           for users.  This is done  using Xpress Menu Action Codes  (XMAC).
  2137.           Xpress Menu Actions codes allow users, utilizing telcommunication
  2138.           scripts or interactive video text telecommunication programs,  to
  2139.           keep a dialog with XPMAIL.
  2140.  
  2141.           Each menu option in  XPMAIL.CTL has a unique  XMAC.  If the  user
  2142.           types in a XMAC value, the option will be activated regardless of
  2143.           which menu is currently  being displayed.   XMAC is discussed  in
  2144.           more detail at this end of this section.
  2145.  
  2146.           The control file XPMENU.CTL defines the visual interface for  the
  2147.           menus remote  users  will  see.    XPMAIL  will  read  this  file
  2148.           directly.  No compiler is necessary.
  2149.  
  2150.           You can define up to 20  different menus.  Each menu begins  with
  2151.           the keyword MENU and terminates with keyword ENDMENU.
  2152.  
  2153.           For each menu, there are menu  items (MENUITEM).  A menu item  is
  2154.           the menu option the user will see if he is given access.
  2155.  
  2156.           The entire menu  system is  structured around  XMAC, Xpress  Menu
  2157.           Action Codes.  The following table shows the current XMAC.
  2158.  
  2159.  
  2160.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                  _____                                                                  Page                                                                  __                                                                       __                                                                       40
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.                MENUITEM NAME           DESCRIPTION                               XPRESS
  2167.                                MENU
  2168.                                ACTION
  2169.                                CODE
  2170.  
  2171.  
  2172.                _USRLIST                Show Xpress User List                               101
  2173.  
  2174.  
  2175.                _RUSRLIST               Show registered Xpress users                               102
  2176.                                        on BBS
  2177.  
  2178.  
  2179.                _LOG                    Show Xpress Log for Current                               103
  2180.                                        Node
  2181.  
  2182.  
  2183.                _SHELL                  Call XPSHELL.BAT file                               104
  2184.  
  2185.  
  2186.                _DNLDFILE  <fn>         Download File                               105
  2187.  
  2188.  
  2189.                _UPLDFILE  <fn> 106     Upload File
  2190.  
  2191.  
  2192.                _DNLDMAIL               Scan and download mail packet                               107
  2193.  
  2194.  
  2195.                _UPLDMAIL               Upload Reply packet                               108
  2196.  
  2197.  
  2198.                _USERLOG                Show user personal log                               109
  2199.  
  2200.  
  2201.                _SELECT         110     Select Mail Conferences
  2202.  
  2203.  
  2204.                _XFERTYPE               Select File Transfer Method                               111
  2205.  
  2206.  
  2207.                _ARCHTYPE       112     Select Mail Compression Method
  2208.  
  2209.  
  2210.                _BULLETINS      113     Toggle Bulletin Status
  2211.  
  2212.  
  2213.                _KEYWORDS               Define or edit Keywords                               114
  2214.  
  2215.  
  2216.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       41
  2217.  
  2218.  
  2219.  
  2220.                _OWNMAIL        115     Toggle Receive Own Mail Status
  2221.  
  2222.  
  2223.                _GRPMAIL        116     Toggle Receive Group Mail
  2224.                                        Status
  2225.  
  2226.  
  2227.                _LASTDATE       117     Change Last Usage Date (Fido
  2228.                                        Rescan). Not in HMS models
  2229.  
  2230.  
  2231.                _RESETLRF       118     Reset Entry Last Pointers
  2232.  
  2233.  
  2234.                _COLOR          119     Set Ansi Mode
  2235.  
  2236.  
  2237.                _HOTKEY         120     Toggle Menu Hotkey Status
  2238.  
  2239.  
  2240.                _IBMCHAR        121     Toggle IBM Characters Status
  2241.  
  2242.  
  2243.                _NOVICE         122     Set Novice Menus
  2244.  
  2245.  
  2246.                _VETERAN        123     Set Veteran (expert) menus
  2247.  
  2248.  
  2249.                _GXPRESS        124     Set Gold Xpress menus
  2250.  
  2251.  
  2252.                _RPASSWORD      125     Define reader password
  2253.  
  2254.  
  2255.                _DPASSWORD      126     Define DoorPass Password
  2256.  
  2257.  
  2258.                _VACSAVER       127     Toggle Vacation Saver Status
  2259.  
  2260.  
  2261.                _FILESCAN       128     Toggle File Scan Status
  2262.  
  2263.  
  2264.                _FILEDATE       129     Change File Scan Date
  2265.  
  2266.  
  2267.                _DELXAM         130     Kill Xpress Mail Answer
  2268.                                        Message
  2269.  
  2270.  
  2271.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       42
  2272.  
  2273.  
  2274.  
  2275.                _QUIT           131     Quit Silver Xpress
  2276.  
  2277.  
  2278.                _HELP           132     Display Help For Current Menu
  2279.  
  2280.  
  2281.                _RETURN         133     Return to Previous Menu
  2282.  
  2283.  
  2284.                _GOODBYE        134     Hangup and Quit Silver Xpress
  2285.  
  2286.  
  2287.                _SYSPARM        144     Show System Parameters
  2288.  
  2289.  
  2290.                _CHAT           145     Activate Chat Mode
  2291.  
  2292.  
  2293.                _DISPLAY   <fn> 146     Display File
  2294.  
  2295.  
  2296.                _VACPAC         147     Check for Vacation Mail
  2297.  
  2298.  
  2299.                _DISPVER        148     Display VERSION.XPV file
  2300.  
  2301.  
  2302.                _DNLDUPD        149     Download GX Update Files in
  2303.                                        @GXUPDATE
  2304.  
  2305.  
  2306.                _SAVEINFO       150     Save user configuration
  2307.  
  2308.  
  2309.                _AVATAR         151     Set avatar graphics
  2310.  
  2311.  
  2312.                _TTYMODE        151     Set TTY mode
  2313.  
  2314.  
  2315.                _PKTOPX         153     Select OPX packet format
  2316.  
  2317.  
  2318.                _PKTQWK         154     Select QWK packet format
  2319.  
  2320.  
  2321.                _PKTTEXT        155     Select TXT packet format (NOT
  2322.                                        USED)
  2323.  
  2324.  
  2325.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       43
  2326.  
  2327.  
  2328.  
  2329.                _QWKSTRIPK      156     Strip kludge lines for QWK
  2330.                                        downloads
  2331.  
  2332.  
  2333.                _QWKCAPHDR      157     Capitalize message headers
  2334.  
  2335.  
  2336.                _QWKNDX         158     Include QWK *.NDX during mail
  2337.                                        downloads
  2338.  
  2339.  
  2340.                _SENDXFILES     159     Include Xpress QWK/X files
  2341.                                        during mail downloads. NOT
  2342.                                        USED YET
  2343.  
  2344.  
  2345.                _SELAREAS       160     Send only selected areas to
  2346.                                        reader.
  2347.  
  2348.  
  2349.                _PKTCOUNT       161     Toggle Packet Extension file
  2350.                                        name system.
  2351.  
  2352.  
  2353.                _CHANGELR       162     Change last read pointers
  2354.  
  2355.  
  2356.                _GOSUB <menu>   165     Jump to new menu
  2357.  
  2358.  
  2359.                _USEFLEXASST    166     Toggle Flex Assistant
  2360.  
  2361.  
  2362.                _SHOWMAILONLY   167     Show areas w/ mail during scan
  2363.  
  2364.  
  2365.                _QWKWWRAP       168     Toggle word wrapping for QWK
  2366.                                        mail packets
  2367.  
  2368.  
  2369.                _JUNK           -1      Nothing
  2370.  
  2371.  
  2372.  
  2373.  
  2374.           See the XPMENU.CTL file which came  with the package. Notice  the
  2375.           security values  place  on  some of  the  menu  items.  The  more
  2376.           sensitive menu items are grouped together under the SYSOP menu.
  2377.  
  2378.           Each menu efinition has the following format:
  2379.  
  2380.  
  2381.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       44
  2382.  
  2383.  
  2384.           MENU <XMAC MENU NAME> <security>          MENU <XMAC MENU NAME> <security>          MENU <XMAC MENU NAME> <security>
  2385.           VTITLE          VTITLE          VTITLE    <color> [string]                    <color> [string]                    <color> [string]
  2386.           NTITLE          NTITLE          NTITLE    <color> [string]                    <color> [string]                    <color> [string]
  2387.           MENUTITEM          MENUTITEM          MENUTITEM [security] [hcolor] [ncolor] [XMAC] [data] [string]                    [security] [hcolor] [ncolor] [XMAC] [data] [string]                    [security] [hcolor] [ncolor] [XMAC] [data] [string]
  2388.           RETURNKEY          RETURNKEY          RETURNKEY [hotkey]                    [hotkey]                    [hotkey]
  2389.           VETERAN          VETERAN          VETERAN   [hcolor] [ncolor] [string]                    [hcolor] [ncolor] [string]                    [hcolor] [ncolor] [string]
  2390.           GXPROMPT          GXPROMPT          GXPROMPT  [string]                    [string]                    [string]
  2391.           PROMPT          PROMPT          PROMPT    [hcolor] [ncolor] [pcolor] [string]                    [hcolor] [ncolor] [pcolor] [string]                    [hcolor] [ncolor] [pcolor] [string]
  2392.           HELP          HELP          HELP      <file name>                    <file name>                    <file name>
  2393.           ENDMENU          ENDMENU          ENDMENU
  2394.  
  2395.           All color  fields can  be  literal or  color  value.   The  color
  2396.           literals understood by XPMAIL are:
  2397.  
  2398.  
  2399.  
  2400.  
  2401.                          COLOR LITERAL                         COLOR LITERAL                         COLOR LITERAL   COLOR VALUE                                         COLOR VALUE                                         COLOR VALUE
  2402.  
  2403.  
  2404.                          BLACK                0
  2405.  
  2406.  
  2407.                          BLUE                 1
  2408.  
  2409.  
  2410.                          GREEN                2
  2411.  
  2412.  
  2413.                          CYAN                 3
  2414.  
  2415.  
  2416.                          RED                  4
  2417.  
  2418.  
  2419.                          MAGENTA              5
  2420.  
  2421.  
  2422.                          BROWN                6
  2423.  
  2424.  
  2425.                          GRAY                 7
  2426.  
  2427.  
  2428.                          DARKGRAY             8
  2429.  
  2430.  
  2431.                          LBLUE                9
  2432.  
  2433.  
  2434.                          LGREEN              10
  2435.  
  2436.  
  2437.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       45
  2438.  
  2439.  
  2440.  
  2441.                          LCYAN               11
  2442.  
  2443.  
  2444.                          LRED                12
  2445.  
  2446.  
  2447.                          LMAGENTA            13
  2448.  
  2449.  
  2450.                          YELLOW              14
  2451.  
  2452.  
  2453.                          WHITE               15
  2454.  
  2455.  
  2456.  
  2457.  
  2458.           If you wish to define a color with a color background,  calculate
  2459.           a color value with the following formula:
  2460.  
  2461.                COLOR VALUE = (background color X 16)+foreground color               COLOR VALUE = (background color X 16)+foreground color               COLOR VALUE = (background color X 16)+foreground color
  2462.  
  2463.                i.e., to display a white on blue color, use a color value of
  2464.                31.
  2465.  
  2466.           MENU <XMAC MENU NAME> <security>          MENU <XMAC MENU NAME> <security>          MENU <XMAC MENU NAME> <security>
  2467.  
  2468.                This statement begins a MENU group.  The XMAC menu name must
  2469.                be one of the 9  possible menus.  If  the XMAC menu name  is
  2470.                _SYSOP_ only the Xpress Sysop will have access to this menu.
  2471.  
  2472.           NTITLE <color> [string]          NTITLE <color> [string]          NTITLE <color> [string]
  2473.  
  2474.                This is the title shown to the user when the user's  current
  2475.                menu mode is "NOVICE".
  2476.  
  2477.                During NOVICE  menu,  Xpress  will  display  the  full  menu
  2478.                details.
  2479.  
  2480.           VTITLE <color> [string]          VTITLE <color> [string]          VTITLE <color> [string]
  2481.  
  2482.                This is the title shown to the user when the user's  current
  2483.                menu mode is "VETERAN".
  2484.  
  2485.                In this mode, Xpress will  display little details about  the
  2486.                menu which show only the available hotkeys.  XPMAIL displays
  2487.                the veteran menu using the format:
  2488.  
  2489.                line 1    veteran title
  2490.                line 2    veteran hot keys
  2491.                line 3    user prompt
  2492.  
  2493.           MENUITEM [security] [hcolor] [ncolor] [XMAC] [data] [string]          MENUITEM [security] [hcolor] [ncolor] [XMAC] [data] [string]          MENUITEM [security] [hcolor] [ncolor] [XMAC] [data] [string]
  2494.  
  2495.  
  2496.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       46
  2497.  
  2498.  
  2499.                Each MENUITEM has the following:
  2500.  
  2501.                SECURITY               SECURITY               SECURITY
  2502.  
  2503.                This is the security value required by the user to get
  2504.                access to this menu option.
  2505.  
  2506.                HCOLOR               HCOLOR               HCOLOR
  2507.  
  2508.                This is the color of the highlighted portion of the  string.
  2509.                The highlighted portion of the string is the part surrounded
  2510.                by carets (^).
  2511.  
  2512.                NCOLOR               NCOLOR               NCOLOR
  2513.  
  2514.                This is the color for the normal part of the string.
  2515.  
  2516.                XMAC (XPRESS MENU ACTION CODE)               XMAC (XPRESS MENU ACTION CODE)               XMAC (XPRESS MENU ACTION CODE)
  2517.  
  2518.                This is one of the XMAC codes shown in the XMAC table.   You
  2519.                may have a MENU ITEM with  nothing else following it.   This
  2520.                will produce a  blank line, which  is useful for  separating
  2521.                options.  You  may also define  a _JUNK XMAC  with a  string
  2522.                defined.  The string will be displayed, however, there is no
  2523.                hotkey associated  with this  option.   This is  useful  for
  2524.                displaying menu line separators.
  2525.  
  2526.                Some XMAC codes expect data immediately preceding the XMAC.
  2527.  
  2528.                The following XMACs require data:
  2529.  
  2530.                     _DISPLAY <filename>
  2531.                     _DNLDFILE <filename or ? for prompt>
  2532.                     _UPLDFILE <filename or ? for prompt>
  2533.  
  2534.                The string portion of the menuitem is the actual statement
  2535.                shown to the user in the menu.
  2536.  
  2537.                To define a selection character (hot key) for this menu
  2538.                item, the selection character must be surrounded by carets.
  2539.  
  2540.                If you precede the string option with a QUOTE, no leading
  2541.                spaces will be removed.
  2542.  
  2543.                If you end the line with a semi-colon, no carriage return
  2544.                and linefeed will be issued.  This is good for creating 2
  2545.                column menus.
  2546.  
  2547.                If the string option has any of the following % parameters,
  2548.                a substitution will be performed:
  2549.  
  2550.  
  2551.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       47
  2552.  
  2553.  
  2554.                     %sa - total # of selected areas
  2555.                     %tm - file transfer protocol
  2556.                     %cm - compression method
  2557.                     %gb - general bulletins on or off
  2558.                     %kw - total keywords
  2559.                     %ro - receive own mail  on or off
  2560.                     %rg - receive group mail on or off
  2561.                     %ld - last usage date
  2562.                     %ag - Color Graphics (Ansi) on or off
  2563.                     %hk - Menu Hot Keys on or off
  2564.                     %ic - IBM Characters on or off
  2565.                     %nm - Novice Menu Mode on or off
  2566.                     %xm - Veteran Menu Mode  on or off
  2567.                     %gx - Gold Xpress Menu Mode on or off
  2568.                     %vs - Vacation saver on or off
  2569.                     %fs - file scan on or off
  2570.                     %fd - file scan date
  2571.                     %pt - mail packet type
  2572.                     %sk - strip kludges line in mail
  2573.                     %ch - capitalize header in QWK mail
  2574.                     %sn - Send NDX files in QWK mail
  2575.                     %sx - Send QWK/X files
  2576.                     %so - Send selected areas only
  2577.                     %hr - HMS (QBBS/RA) last read value
  2578.                     %pc - Use packet counter
  2579.                     %fa - Use Flex Assistant
  2580.                     %mo - Show area with mail only
  2581.                     %ww - Perform word wrapping for QWK messages
  2582.  
  2583.           RETURNKEY [hotkey]          RETURNKEY [hotkey]          RETURNKEY [hotkey]
  2584.  
  2585.                Normally, XPMAIL will accept a carriage return from the user
  2586.                to return to the previous menu.   It will generally use  the
  2587.                hotkey from the  last MENUITEM  defined in  the menu  group.
  2588.                Since the last  menu item may  not be a  normal option,  the
  2589.                RETURNKEY statement is used to define the key which will  be
  2590.                used when the carriage return is hit.
  2591.  
  2592.           VETERAN [hcolor] [ncolor] [string]          VETERAN [hcolor] [ncolor] [string]          VETERAN [hcolor] [ncolor] [string]
  2593.  
  2594.                This is the line of keys shown during veteran mode.
  2595.  
  2596.                The hili color  is the color  of the portion  of the  string
  2597.                surrounded by carets (^).  The normal color is the color  of
  2598.                the remaining part of the string.
  2599.  
  2600.                Xpress will make one substitution  with this statement.   If
  2601.                it sees the  word %keys, the  current hotkeys available  for
  2602.                the current menu are substituted.
  2603.  
  2604.           GXPROMPT [string]          GXPROMPT [string]          GXPROMPT [string]
  2605.  
  2606.                This is the string  shown to the user  when he selects  GOLD
  2607.                XPRESS menus.
  2608.  
  2609.  
  2610.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       48
  2611.  
  2612.  
  2613.           PROMPT [hcolor] [ncolor] [pcolor] [string]          PROMPT [hcolor] [ncolor] [pcolor] [string]          PROMPT [hcolor] [ncolor] [pcolor] [string]
  2614.  
  2615.                This is  the  prompt  shown  to  users  after  the  menu  is
  2616.                displayed.
  2617.  
  2618.                The hili color  is the color  of the portion  of the  string
  2619.                surrounded by carets (^).  The normal color is the color  of
  2620.                the remaining part of  the string, and  the prompt color  is
  2621.                color of the keys the user types.
  2622.  
  2623.                Only two substitutions can be made;  %tr, which is the  time
  2624.                remaining in minutes,  and %fn,  which is  the user's  first
  2625.                name.
  2626.  
  2627.           HELP <file name>          HELP <file name>          HELP <file name>
  2628.  
  2629.                This is the name of help file displayed to the user for  the
  2630.                current active menu.
  2631.  
  2632.                It is also  the name of  an optional  ansi-based menu  file;
  2633.                filename.ANS for  ANSI mode  and filename.TXT  for  non-ANSI
  2634.                mode.
  2635.  
  2636.                If you define an ansi menu, Xpress will still interpret  the
  2637.                menu items for  hotkeys etc., but  will instead display  the
  2638.                menu file.
  2639.  
  2640.           ENDMENU          ENDMENU          ENDMENU
  2641.  
  2642.                This statement ends a menu group.
  2643.  
  2644.           See XPMENU.CTL for working examples.
  2645.  
  2646.  
  2647.           11.2.          11.2.          11.2.     Changing the Silver Xpress Reader Menu.                    Changing the Silver Xpress Reader Menu.                    Changing the Silver Xpress Reader Menu.
  2648.  
  2649.           The Silver Xpress  Reader version 3.xx  has the  ability to  load
  2650.           different menus the user will see and use to operate the reader.
  2651.  
  2652.           If the reader finds a menu file named BOARDID.LIB when it opens a
  2653.           mail packet, it will be loaded as the user's menu for the reader.
  2654.           If a BOARDID.LIB menu file is not found, the reader will use  the
  2655.           SXMENU.LIB file as a menu.
  2656.  
  2657.           To customize the reader menu on the user's side, define a  reader
  2658.           menu file with the name BOARDID.LIB,  where BOARDID is the  board
  2659.           ID you defined in the registration section.
  2660.  
  2661.           To pass your unique reader menu  file BOARDID.LIB to your  users,
  2662.           store it in your Xpress Directory.
  2663.  
  2664.           The Xpress mail  door will pass  this new menu  file to the  user
  2665.           during a download.  The reader  will use this menu when it  opens
  2666.           up the mail packets downloaded from  your system.  The user  will
  2667.  
  2668.  
  2669.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       49
  2670.  
  2671.  
  2672.           not have the option to disable your menu customization unless the
  2673.           user deletes the menu from the mail packet.
  2674.  
  2675.           To change the Silver Xpress Reader menu you will need the utility
  2676.           called SXDYMENU.EXE (Silver Xpress  Dynamic Menu Editor).   Begin
  2677.           by getting a copy of the  default reader menu SXMENU.LIB,  rename
  2678.           it BOARDID.LIB and edit it using the SXDYMENU utility.
  2679.  
  2680.           This Xpress  feature  gives you  the  ability to  customize  your
  2681.           applications with Silver  Xpress.  You  may want  to create  some
  2682.           special menu  options which  process an  Xpress form,  or run  an
  2683.           external program  or  create  a special  message  to  the  sysop.
  2684.           Silver Xpress gives  you the  power to  customize your  BBS as  a
  2685.           unique store and forward, groupware application.
  2686.  
  2687.           For example:
  2688.  
  2689.            Company X has a professional BBS.
  2690.  
  2691.            Company X  is  offering extra  off-line  services and  features
  2692.            using  Silver  Xpress.     To  customize  the   application,  a
  2693.            customized reader menu library was created.
  2694.  
  2695.            The company has a  Silver Xpress board  ID of COMPANYX,  so the
  2696.            name of the reader menu library created is  COMPANYX.LIB.  This
  2697.            is stored in the Xpress directory.
  2698.  
  2699.            When users scan  and download  mail, the  COMPANYX.LIB file  is
  2700.            packed up  in the  mail packet,  COMPANYX.OPX.   When the  user
  2701.            opens up the COMPANYX.OPX file using the  Silver Xpress Reader,
  2702.            the reader will use the COMPANYX.LIB menu library for its menu.
  2703.  
  2704.  
  2705.           11.3.          11.3.          11.3.     Modifying the Help Files                    Modifying the Help Files                    Modifying the Help Files
  2706.  
  2707.           The Xpress help files are located in the HELP subdirectory.  Each
  2708.           help file has an extension of HLP.
  2709.  
  2710.           The help  system in  Xpress uses  the  new XPRESS  VIDEO  CONTROL
  2711.           language.
  2712.  
  2713.           The *.VCC files in  the help directory are  the source files  for
  2714.           the help files.  If you are familiar to the OPUS OECC language or
  2715.           the MECC language  for Maximus, you  will see the  VCC files  are
  2716.           quite similar.
  2717.  
  2718.           The help files are  all set up to  produce an on-line,  hypertext
  2719.           link help system.
  2720.  
  2721.           If you would like to change the help files, edit the  appropriate
  2722.           help VCC  file, and  compile it  using  the provided  batch  file
  2723.           called  MAKEHLP.BAT.    MAKEHLP.BAT  will  call  the  Xpress  VCC
  2724.           compiler, VCC.EXE, with the proper switches.
  2725.  
  2726.  
  2727.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       50
  2728.  
  2729.  
  2730.           The following  are  the  VCC tokens  understood  by  the  VCC.EXE
  2731.           compiler:
  2732.  
  2733.           ___________          VCC Tokens:          ___________          VCC Tokens:          ___________          VCC Tokens:
  2734.  
  2735.  
  2736.           [cls]           Clear the screen.
  2737.           [readln]        prompt user for string input.
  2738.           [string]        return the string from the [readln] token.
  2739.           [menu]          menu prompt. i.e., [menu]XYZ accepts X Y Z keys.
  2740.           [if]            performs check on last menu character hit.
  2741.           [onexit]        sets the file to display when current ends.
  2742.           [exit]          exit the current file.
  2743.           [jump]          jump to [label].
  2744.           [show]          displays a new file as a subroutine.
  2745.           [display]       displays a new file. Last one lost.
  2746.           [pause]         prompt user for Press any key to continue.
  2747.           [dos]           executes the command which follows the token.
  2748.           [goto]          goto the [label].
  2749.           [ansi_toggle]   toggle ansi state.
  2750.           [ansi_on]       set ansi on.
  2751.           [ansi_off]      set ansi off.
  2752.           [hot_toggle]    toggle hot key state.
  2753.           [more_on]       set more on.
  2754.           [more_off]      set more off.
  2755.           [more]          prompts user for more Yes or No.
  2756.           [archiver]      select the archiver for mail packets.
  2757.           [protocol]      select file transfer system.
  2758.           [selectarea]    present the area selection session.
  2759.           [dnloadmail]    begin scanning of mail.
  2760.           [uploadmail]    begin uploading of reply mail files.
  2761.           [download]      download file which follows the token.
  2762.           [if_dl_error]   conditional check for download process.
  2763.  
  2764.  
  2765.           _______________________________          Color Token Table for VCC files          _______________________________          Color Token Table for VCC files          _______________________________          Color Token Table for VCC files
  2766.  
  2767.  
  2768.           The color tokens  for VCC use  literal statements  with a  format
  2769.           such as [WhiteOnBlue].  The first color is the foreground and the
  2770.           second color  is the  background.   To define  a color,  use  the
  2771.           foreground and background colors defined below, and put the  word
  2772.           ON between them:
  2773.  
  2774.  
  2775.  
  2776.  
  2777.                        ForeGround                       ForeGround                       ForeGround        Background                                         Background                                         Background
  2778.  
  2779.                        Black             Black
  2780.  
  2781.                        Blue              Blue
  2782.  
  2783.  
  2784.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       51
  2785.  
  2786.  
  2787.  
  2788.                        Green             Green
  2789.  
  2790.                        Cyan              Cyan
  2791.  
  2792.                        Red               Red
  2793.  
  2794.                        Magenta           Magenta
  2795.  
  2796.                        Yellow            Yellow
  2797.  
  2798.                        White             White
  2799.  
  2800.                        LtGray
  2801.  
  2802.                        Brown
  2803.  
  2804.                        DkGray
  2805.  
  2806.                        LtBlue
  2807.  
  2808.                        LtGreen
  2809.  
  2810.                        LtCyan
  2811.  
  2812.                        LtRed
  2813.  
  2814.                        LtMagenta
  2815.  
  2816.  
  2817.           Modifying the Miscellaneous Display Files          Modifying the Miscellaneous Display Files          Modifying the Miscellaneous Display Files
  2818.  
  2819.           The following is the  list of default display  files shown to the
  2820.           user during  various  points  of Xpress.    Some  of  these files
  2821.           required the VCC compiler to create files with XPV extensions.
  2822.  
  2823.              WELCOME   ANS    Welcome screen shown with ANSI on.
  2824.              WELCOME   TXT    Welcome screen shown with ANSI off.
  2825.              WELCOME   GX     Welcome screen shown with GX menus enabled.
  2826.              REGISTER  TXT    Registration information shown to non-
  2827.           registered users.
  2828.              NEWS      XPV    News information shown during when logging
  2829.           into XpMAIL.
  2830.              NEWS      VCC    Source file to NEWS.XPV.
  2831.              NEWUSER   XPV    If the user is new to Xpress, this file will
  2832.           be shown.
  2833.              NEWUSER   VCC    Source File to NEWUSER.VCC.
  2834.              GOODBYE   TXT    File shown when hangup from XPMAIL.
  2835.              GOODBYE   GX     File shown when hangup from XPMAIL with GX
  2836.           menus enabled.
  2837.              XPVSAVER  TXT    File shown when user enabled VACATION SAVER.
  2838.              EXIT      TXT    File shown when exits from XPMAIL.
  2839.              EXIT      GX     File shown when exits from XPMAIL with GX
  2840.           menus enabled.
  2841.  
  2842.  
  2843.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       52
  2844.  
  2845.  
  2846.              BADXPRV   TXT    File shown to user when using old version of
  2847.           Reader.
  2848.              BADXPRV   GX     GX menu version of BADXPRV.TXT.
  2849.              GOLDXP    XPV    File shown when user enables GX menus.
  2850.              GOLDXP    VCC    Source to GOLDXP.XPV.
  2851.              DLRDR     XPV    File shown when selects the DOWNLOAD READER
  2852.           option.
  2853.              DLRDR     VCC    Source to DLRDR.XPV.
  2854.              EXPLAIN   XPV    File shown when user selects the EXPLAIN a
  2855.           bbs.
  2856.              EXPLAIN   VCC    Source to EXPLAIN.XPV.
  2857.              ASSIST    XPV    File shown when user enables Xpress
  2858.           Assistant.
  2859.              ASSIST    VCC    Source to ASSIST.XPV.
  2860.  
  2861.           To compile a VCC file, use  the VCC.EXE compiler. i.e.,
  2862.  
  2863.  
  2864.             VCC XPVSAVER
  2865.  
  2866.  
  2867.           The logic XPMAIL will use to display these files is as follows:
  2868.  
  2869.           1) If the file does not exist, XPMAIL will skip the display.  If
  2870.                                          the
  2871.  
  2872.            file is a XPV file, XPMAIL will display a local console error.
  2873.  
  2874.                message.
  2875.  
  2876.            2) If the file is NOT a XPV type, XPMAIL will use the following
  2877.                                         order
  2878.  
  2879.                to look for the file:
  2880.  
  2881.                 ANSI ON:  Look for file  with ANS extension.  Fall back  to
  2882.                 TXT. ANSI OFF:  Look for file with TXT extension.
  2883.  
  2884.                 GX MENUS:   Look for file with GX extension.
  2885.  
  2886.           You should modify the  XPVSAVER file if you  intend to provide
  2887.           VACATION SAVER service  to your  users.   Tell them  when your
  2888.           events occur and when to pick up the mail.
  2889.  
  2890.  
  2891.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       53
  2892.  
  2893.  
  2894.  
  2895.  
  2896.           _______________________          APPENDIX A: LIMITATIONS          _______________________          APPENDIX A: LIMITATIONS          _______________________          APPENDIX A: LIMITATIONS
  2897.  
  2898.  
  2899.  
  2900.           _____________________________________          Silver Xpress Mail System Limitations          _____________________________________          Silver Xpress Mail System Limitations          _____________________________________          Silver Xpress Mail System Limitations
  2901.  
  2902.  
  2903.           NUMBER OF XPRESS USERS                  : 65536  (0-65535)
  2904.           NUMBER OF CONFERENCES                   : 32768  (0-32767)
  2905.           NUMBER OF CONFERENCES USER CAN SELECT   : 32768  (0-32767)
  2906.           NUMBER OF MAXIMUM LAN XPRESS NODES      : Unlimited
  2907.           NUMBER OF OPTIONAL BULLETINS (1)        : Unlimited
  2908.           NUMBER OF AUTO DISPLAY BULLETINS        : 10
  2909.           NUMBER OF ARCHIVALS                     : 10
  2910.           NUMBER OF TRANSFER PROTOCOLS            : 10
  2911.           NUMBER OF UPLOADED MAIL SERVICES        : 10
  2912.           NUMBER OF REMOTE USER SERVICES (1)      : Unlimited
  2913.           MAXIMUM NUMBER OF FILE DOWNLOADS        : 10
  2914.           MAXIMUM NUMBER OF FILE UPLOADS          : 10
  2915.           NUMBER OF FILE CABINETS (1)             : Unlimited
  2916.           NUMBER OF SIGNATURES (1)                : Unlimited
  2917.           NUMBER OF KEYWORDS AVAILABLE PER USER   : 20
  2918.           MAXIMUM # OF MESSAGES TO BE SCANNED     : 65536
  2919.           MEMORY REQUIRED FOR MESSAGE LIST        : 201 bytes per message
  2920.           MAXIMUM MESSAGES IN A MESSAGE LIST (2)  : 1741 PER CONFERENCE
  2921.           NUMBER OF TICKER TAPE AD Lines          : 10 (700 bytes)
  2922.           DISK SPACE REQUIREMENTS     (DOOR)      : 500K (5M OPERATIONAL)
  2923.           DISK SPACE REQUIREMENTS     (READER)    : 400K (1.2M OPERATIONAL)
  2924.           RAM SPACE REQUIREMENTS      (DOOR)      : 256K (400K OPERATIONAL)
  2925.           RAM SPACE REQUIREMENTS      (READER)    : 270K (420K OPERATIONAL)
  2926.  
  2927.           NOTES:
  2928.  
  2929.           1.Limited only by available memory on your PC.
  2930.  
  2931.           2.Silver Xpress can  load any  mail size.   The program  is only
  2932.             limited by available memory; i.e., 350K  is the average memory
  2933.             remaining after  Silver Xpress  is loaded,  therefore, 350,000
  2934.             divided by 201  yields the amount  of messages  per conference
  2935.             which can  be  viewed.    This  is  about  1741  messages  per
  2936.             conference.  A future version will make this unlimited using a
  2937.             virtual system.
  2938.  
  2939.  
  2940.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       54
  2941.  
  2942.  
  2943.  
  2944.  
  2945.           _________________________          APPENDIX B: EXEC SWAPPING          _________________________          APPENDIX B: EXEC SWAPPING          _________________________          APPENDIX B: EXEC SWAPPING
  2946.  
  2947.  
  2948.  
  2949.           Silver Xpress  now  uses  swapping technology  to  execute  large
  2950.           external programs.    With EXEC  SWAPPING,  as it  is  called  in
  2951.           Xpress, Xpress will leave only 5K in memory, and return the  rest
  2952.           to DOS to execute the external program.
  2953.  
  2954.           In XPMAIL.EXE, Xpress calls 3rd party utilities at the  following
  2955.           points:
  2956.  
  2957.            1.  Download/Upload of OPX/REP files.
  2958.  
  2959.            2.  Compression/Expansion of OPX/REP files.
  2960.  
  2961.            3.  Xpress Service Calls.
  2962.  
  2963.           If you run out of memory, Exec Swapping will fix the problem  for
  2964.           you.  Now, you can set up swapping 3 ways:
  2965.  
  2966.            1.  Use the -ES switch with XPMAIL.
  2967.  
  2968.            2.  Set the EXEC SWAP options in XPRESS SYSTEM OPTIONS in XPADM.
  2969.  
  2970.            3.  Use the $ or  # prefix for all  process commands defined  in
  2971.                XPPROT.CTL and  XPARCH.CTL.   By using  the special  $ or  #
  2972.                prefix,  you  can  set  up  exec  swapping  for   individual
  2973.                programs.  Some  programs require more  memory than  others.
  2974.                The $ must be used  for EXE and COM  programs, and the #  is
  2975.                used to call batch files.
  2976.  
  2977.  
  2978.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       55
  2979.  
  2980.  
  2981.  
  2982.  
  2983.           _____________________________          APPENDIX C: OPTIONAL SWITCHES          _____________________________          APPENDIX C: OPTIONAL SWITCHES          _____________________________          APPENDIX C: OPTIONAL SWITCHES
  2984.  
  2985.  
  2986.  
  2987.           The following  is the  complete list  of switches  available  for
  2988.           XPMAIL and XPADM.
  2989.  
  2990.           NOTE: The switches were totally revamped from  previous versions
  2991.                 of XPMAIL.    You  should  not use  old  switches  without
  2992.                 analyzing the changes.
  2993.  
  2994.           _______________________          XPMAIL Generic switches          _______________________          XPMAIL Generic switches          _______________________          XPMAIL Generic switches
  2995.  
  2996.  
  2997.           These switches are not  case sensitive, except  for how the  comm
  2998.           port switch is used under Maximus.
  2999.  
  3000.           -C<file>      Use compiled control parameter file.
  3001.  
  3002.           -LB<#>        Lock PORT baud rate for file transfer protocols.
  3003.  
  3004.           -B<#>         User  connect   baud   rate   for   download  time
  3005.                         calculation.
  3006.  
  3007.           -K            Force local /keyboard mode.
  3008.  
  3009.           -L            Force local /keyboard mode.
  3010.  
  3011.           -F            Enable fossil communications.
  3012.  
  3013.           -FSD          Disable fossil when shelling to DOS.
  3014.  
  3015.           -FTX          Enable transmit XON.
  3016.  
  3017.           -FRX          Enable receive XON.
  3018.  
  3019.           -FHW          Enable hardware flow control.
  3020.  
  3021.           -NT           Do not enforce download time limit.
  3022.  
  3023.           -NCM<str>     New user configuration macro.
  3024.  
  3025.           -SP           Sneak preview switch (sysops only).
  3026.  
  3027.           -LS           Enable Snoop (override configuration).
  3028.  
  3029.           -X            Makes current user a temporary Xpress sysop.
  3030.  
  3031.           -S            Check if user is a real sysop of the system.
  3032.  
  3033.           -A#           Force time limit (Defaults to 30).
  3034.  
  3035.  
  3036.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       56
  3037.  
  3038.  
  3039.           -NLW          Disables local console windowing system.
  3040.  
  3041.           -NH           Disables modem hang up when goodbye is available.
  3042.  
  3043.           -VS           Enables Vacation Saver  Event.  In  Local Mode, no
  3044.                         download will  take  place and  the  file  will be
  3045.                         placed in the user's bin.  The user bin is created
  3046.                         off         the          EXTRA          directory.
  3047.  
  3048.                         This should  only  be  used  DURING  YOUR  EVENTS!
  3049.  
  3050.                         Sysops can use this as well for their own personal
  3051.                         use.
  3052.  
  3053.           -NFS          Turns off file scanner for the session.
  3054.  
  3055.           -V or ?       Shows version number and compile date.
  3056.  
  3057.           -Mfilename    Define an alternate menu control file.
  3058.  
  3059.           -NMB          Allows creation of Xpress Packets  even if no mail
  3060.                         is available.  User  will get a  minimum number of
  3061.                         files.  The  reader will only  allow mail creation
  3062.                         because there is nothing to read.
  3063.  
  3064.           -XMfilename   Loads a different Xpress menu control file.
  3065.  
  3066.           -Jxxxxxx      User record number or user name.  LOCAL MODE ONLY.
  3067.  
  3068.  
  3069.                         PCBOARD    can     not     use     this    switch.
  3070.  
  3071.                         This -J switch  is useful  for the  vacation saver
  3072.                         option and  for the  sysop local  mode usage.   If
  3073.                         xxxxxxx is a number, it is  the record number read
  3074.                         from the BBS  user database   file.  If  it is the
  3075.                         user's name,  XPMAIL  will  search  for  the user.
  3076.  
  3077.                         Examples:
  3078.  
  3079.                         load  user  record  #3  from  BBS  user  database:
  3080.  
  3081.                         XPMAIL                                         -J3
  3082.  
  3083.                         Find Hector's  record  in the  BBS  user database:
  3084.  
  3085.                         XPMAIL -J"Hector Santos"
  3086.  
  3087.           -P<#>         (Upper P) Port (1 based port)
  3088.  
  3089.           -p<#>         (small p) Port  (0 based port.  Only For Maximus).
  3090.  
  3091.                         Maximus can pass -P or -p.  If you use the Maximus
  3092.                         macro %L (recommended), this  will expand to using
  3093.  
  3094.  
  3095.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       57
  3096.  
  3097.  
  3098.                         -p -b or  -k in  local mode.   For Maximus,  -p is
  3099.                         zero                                        based.
  3100.  
  3101.                         For OPUS 1.1x, and  OPUS 1.7x, the  PORT switch is
  3102.                         ignored.  The port value is read from the LASTUSER
  3103.                         file.
  3104.  
  3105.                         For PCBOARD, the PORT switch is ignored.  The port
  3106.                         value  is   read   from   the   PCBOARD.SYS  file.
  3107.  
  3108.                         For RBBS, the  PORT switch  is ignored.   The port
  3109.                         value  is   read  from   the   DORINFOx.DEF  file.
  3110.  
  3111.                         For RA/QBBS, PORT switch is not Required except as
  3112.                         an      override      from       the      default.
  3113.  
  3114.                         In local mode, the port defaults  to COM1.  A zero
  3115.                         passed will force local mode.
  3116.  
  3117.           ________________________________________________          Xpress Exec Swapping (For low memory situations)          ________________________________________________          Xpress Exec Swapping (For low memory situations)          ________________________________________________          Xpress Exec Swapping (For low memory situations)
  3118.  
  3119.  
  3120.           -ES           Use exec swapping logic.
  3121.  
  3122.           -ESE          Use exec swapping logic,  and use expanded memory,
  3123.                         if available.
  3124.  
  3125.           -ESX          Use exec swapping logic,  and use extended memory,
  3126.                         if available.
  3127.  
  3128.                         See XPS  "Xpress  Swap  Path"  environment  string
  3129.                         below.
  3130.  
  3131.  
  3132.           _________________________________________          Xpress Automatic Download/Upload Switches          _________________________________________          Xpress Automatic Download/Upload Switches          _________________________________________          Xpress Automatic Download/Upload Switches
  3133.  
  3134.  
  3135.           -DA           Automatic Download, get ALL mail.
  3136.  
  3137.           -DP           Automatic Download, get personal mail only.
  3138.  
  3139.           -DPA          Automatic Download, get personal  first, if 0 then
  3140.                         ALL.
  3141.  
  3142.           -U            Automatic Upload.
  3143.  
  3144.           -DF           Use the user's flex select command for bundling.
  3145.  
  3146.           -OW<path>     Override Work Path for session.
  3147.  
  3148.           -OD<path>     Override Download Path for session.
  3149.  
  3150.           -OU<path>     Override Upload Path for session.
  3151.  
  3152.  
  3153.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       58
  3154.  
  3155.  
  3156.           ____________________          Maintenance Switches          ____________________          Maintenance Switches          ____________________          Maintenance Switches
  3157.  
  3158.  
  3159.           -DEBUG        Display area security information as understood by
  3160.                         XPMAIL.
  3161.  
  3162.           -SE           Show Events  during  initialization  (DEBUG).   F1
  3163.                         Model only.
  3164.  
  3165.           _______          QBBS/RA          _______          QBBS/RA          _______          QBBS/RA
  3166.  
  3167.  
  3168.           -QOLD         Use old QBBS 2.04/RA 0.04 exitinfo files.
  3169.  
  3170.  
  3171.           -QTF          Use old QBBS time remaining calculation.
  3172.  
  3173.  
  3174.           OPUS/MAX/RA/QBBS          OPUS/MAX/RA/QBBS          OPUS/MAX/RA/QBBS
  3175.  
  3176.           -NC           Skip Adjust netmail cost.  (NO COSTING!)
  3177.  
  3178.           -NU           Disable  writing  to  USER.BBS  or  USER.DAT  file
  3179.                         during local mode usage.
  3180.  
  3181.           ___          MAX          ___          MAX          ___          MAX
  3182.  
  3183.  
  3184.           -RSE          Report any Squish Scanning errors.
  3185.  
  3186.  
  3187.           _____________________________________________________________          FIDO SYSTEMS: (TAG/OPUS/MAX and RBBS/PCBoard with FIDO areas)          _____________________________________________________________          FIDO SYSTEMS: (TAG/OPUS/MAX and RBBS/PCBoard with FIDO areas)          _____________________________________________________________          FIDO SYSTEMS: (TAG/OPUS/MAX and RBBS/PCBoard with FIDO areas)
  3188.  
  3189.  
  3190.           -KB           Kill Bad FIDO  messages.  (can't  read. i.e., ZERO
  3191.                         size).
  3192.  
  3193.           -FBD          Fix Bug Dates in FIDO messages during scan.
  3194.  
  3195.           -LRFxxx       Use Sysop  LASTREAD  file  for  lastread pointers.
  3196.  
  3197.                         TAG BBS, which supports FIDO  areas, must use this
  3198.                         switch to pass the TAG user record number.
  3199.  
  3200.           -YMS          Tells Xpress  not to  RETAIN the  file  time stamp
  3201.                         when updating a message for the receive bit.  Some
  3202.                         programs such  as  YMS  require  an  updated  file
  3203.                         stamp.
  3204.  
  3205.           __________________________________          MULTI-LINE (NETWORK) VERSIONS ONLY          __________________________________          MULTI-LINE (NETWORK) VERSIONS ONLY          __________________________________          MULTI-LINE (NETWORK) VERSIONS ONLY
  3206.  
  3207.  
  3208.           -NS           Do not  force detection  of  SHARE.COM/EXE (NOVELL
  3209.                         ONLY)
  3210.  
  3211.  
  3212.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       59
  3213.  
  3214.  
  3215.           -T#           Pass task  # to  Xpress Configuration  Files only.
  3216.                         The task number will substitute the # character in
  3217.                         the NODAL information statements.
  3218.  
  3219.           __________          Fax Xpress          __________          Fax Xpress          __________          Fax Xpress
  3220.  
  3221.  
  3222.           -XF#          Define which mail area # is used for faxing mail.
  3223.  
  3224.  
  3225.           Environment Variables:          Environment Variables:          Environment Variables:
  3226.  
  3227.           TZ            Time Zone for your system, optional (not used).
  3228.  
  3229.           XPA           Xpress Auto Command String, optional.
  3230.  
  3231.           XPS           Swap Path For Exec swapping, optional.
  3232.  
  3233.           PCBDIR        For PCBOARD 14.5 only.
  3234.  
  3235.           PCBNODE       For PCBOARD 14.5 only.
  3236.  
  3237.           ______________________          XPADM Generic switches          ______________________          XPADM Generic switches          ______________________          XPADM Generic switches
  3238.  
  3239.  
  3240.           -C<path>      Xpress control file.
  3241.  
  3242.           -A            Create a report.
  3243.  
  3244.           -U            Complete Xpress Update and complete report.
  3245.  
  3246.           -S            Update security access of each area.
  3247.  
  3248.           -T            Update titles of each area.
  3249.  
  3250.           -VM<memK>     Optional memory requirement for memory files.  The
  3251.                         only time you may need this  switch is if you have
  3252.                         a lot of message areas (1000 or more).
  3253.  
  3254.  
  3255.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       60
  3256.  
  3257.  
  3258.  
  3259.  
  3260.           __________________________________          APPENDIX D: USING THE DEBUG SWITCH          __________________________________          APPENDIX D: USING THE DEBUG SWITCH          __________________________________          APPENDIX D: USING THE DEBUG SWITCH
  3261.  
  3262.  
  3263.  
  3264.           The XPMAIL -debug switch was instituted for one reason:  To check
  3265.           if Xpress  is  reading  and  interpreting  your  areas,  security
  3266.           values, and the user's last read pointers.
  3267.  
  3268.           This switch is really an internal  switch used during the  design
  3269.           of XPRESS, and should not be used during normal operations.
  3270.  
  3271.           However, if you are having doubts about security and wish to make
  3272.           certain users  mail area  security is  not breached,  this  debug
  3273.           information will be most  useful.  Make  a printout, and  analyze
  3274.           the output against the expected security of your mail areas.   If
  3275.           you see a problem, contact Santronics Software.
  3276.  
  3277.           The first thing you should be sure of is that XPADM is  correctly
  3278.           reading and compiling the  BBS system files for  your setup.   If
  3279.           you cannot  get  passed  XPADM,  XPMAIL  will  not  operate.    A
  3280.           successful XPADM compilation is usually the precursor to a proper
  3281.           Xpress setup.
  3282.  
  3283.           When having mail area security problems,  one of the last  things
  3284.           to try is  to delete the  *.PRM and *.RAW  files and start  XPADM
  3285.           again.  If your mail area  security problem still persists,  call
  3286.           Santronics Software.
  3287.  
  3288.           The following  information will  help  you interpret  the  -debug
  3289.           output information displayed after the XPMAIL initialization:
  3290.  
  3291.           US:  User Security value.  For FIDO-based systems, this is a  hex
  3292.                number equivalent to the internal value used for  FIDO-based
  3293.                systems.   For PCBOARD,  and RBBS  Xpress which  allow  Fido
  3294.                areas, the number will be displayed in decimal format.   The
  3295.                HEX table below  corresponds to  the literal  interpretation
  3296.                used by OPUS (thus Maximus) internally in these programs.
  3297.  
  3298.  
  3299.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       61
  3300.  
  3301.  
  3302.                       Opus 1.03
  3303.  
  3304.                       ________                      Security                      ________                      Security                      ________                      Security___                                                               ___                                                               ___                                 ___                                 Hex                                 ___                                 Hex                                 ___                                 Hex____                                                                            ____                                                                            ____                                        ___                                        Dec                                        ___                                        Dec                                        ___                                        Dec
  3305.  
  3306.  
  3307.  
  3308.                       TWIT       FE     -1
  3309.                       DISGRACE   00      0
  3310.                       NORMAL     02      2
  3311.                       PRIVIL     04      4
  3312.                       EXTRA      06      6
  3313.                       ASSTSYSOP  08      8
  3314.                       SYSOP      0A     10
  3315.                       HIDDEN     0B     11
  3316.  
  3317.  
  3318.                       Opus 1.10, Opus 1.71, Max 1.02
  3319.  
  3320.                       ________                      Security                      ________                      Security                      ________                      Security___                                                               ___                                                               ___                                 ___                                 Hex                                 ___                                 Hex                                 ___                                 Hex____                                                                            ____                                                                            ____                                        ___                                        Dec                                        ___                                        Dec                                        ___                                        Dec
  3321.  
  3322.  
  3323.                       TWIT       10     16
  3324.                       DISGRACE   30     48
  3325.                       LIMITED    40     64
  3326.                       NORMAL     50     80
  3327.                       WORTHY     60     96
  3328.                       PRIVIL     70     112
  3329.                       FAVORED    80     128
  3330.                       EXTRA      90     144
  3331.                       CLERK      A0     160
  3332.                       ASSTSYSOP  B0     176
  3333.                       SYSOP      D0     192
  3334.                       HIDDEN     E0     208
  3335.  
  3336.  
  3337.           AS:  This is the minimum security value required for the user  to
  3338.                gain access in this area.  The format follows the same logic
  3339.                as in US.
  3340.  
  3341.           AA:  This is the area attribute.  This value is always  displayed
  3342.                in a HEX format.   It follows the FIDO-based  interpretation
  3343.                for conference attributes:
  3344.  
  3345.           SY:  This is a boolean value for determining whether the user  is
  3346.                considered a "SYSOP"  or "MODERATOR" for  this area.   As  a
  3347.                sysop of the  area, the user  will be able  to read  PRIVATE
  3348.                mail.
  3349.  
  3350.           PV:  This is a  boolean value  for determining  whether the  user
  3351.                will be  able  to use  the  unique Xpress  feature  "Message
  3352.                Preview".    Message  Previewing  will  allow  the  user  to
  3353.                download the message  without TAGGING the  message as  being
  3354.                already read.
  3355.  
  3356.  
  3357.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       62
  3358.  
  3359.  
  3360.           LR:  This is the current last read  message counter for the  user
  3361.                for the particular area.  Normally, this value will be zero,
  3362.                as the new XPMAIL version 4.00  will do a dynamic  retrieval
  3363.                of the last read pointer, when  it begins to scan for  mail.
  3364.                In the past, XPMAIL  would read all  the last read  pointers
  3365.                when it initialized itself.  This is no longer true.
  3366.  
  3367.           AC:  This is a boolean value  and final determination of  whether
  3368.                the user will be allowed access to the area.  Normally,  the
  3369.                US and AS  values are  enough to  gain access.   By  gaining
  3370.                access, we mean the user will be allowed to SELECT the area.
  3371.  
  3372.                Depending on the BBS type, it does not necessarily mean  the
  3373.                user will be allowed to READ  or ENTER mail.  Generally,  if
  3374.                the user has access, he will be  able to READ mail.  A  good
  3375.                rule of thumb is  if this value is  YES, the user will  have
  3376.                SELECT ability and READ ability.   (Note:  With PCBOARD  and
  3377.                RBBS Xpress, you  can further  control the  reading of  mail
  3378.                with the READ_PUB  and READ_PRI keywords.   OPUS, MAX,  QBBS
  3379.                and RA do not yet have this control).
  3380.  
  3381.  
  3382.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       63
  3383.  
  3384.  
  3385.  
  3386.  
  3387.           _______________________          APPENDIX E: ERROR CODES          _______________________          APPENDIX E: ERROR CODES          _______________________          APPENDIX E: ERROR CODES
  3388.  
  3389.  
  3390.  
  3391.           These are the error codes produced by Silver Xpress          These are the error codes produced by Silver Xpress          These are the error codes produced by Silver Xpress
  3392.  
  3393.           2    -    File not found.
  3394.           3    -    Path not found.
  3395.           4    -    Too many open files.  Increase FILES= in config.sys.
  3396.           5    -    File access denied.
  3397.           8    -    Out of memory.
  3398.           15   -    Invalid Drive.
  3399.           100  -    EOF of file reached.
  3400.           103  -    File not opened.
  3401.           105  -    File not open for output.
  3402.           159  -    Out of paper.
  3403.           161  -    File sharing violation.  Share not loaded?
  3404.  
  3405.  
  3406.           162  -    Hardware problem.  Share not loaded?
  3407.           163  -    File sharing violation.  Share not loaded?
  3408.           200  -    Divide by Zero.  Bad user baud rate passed?
  3409.           201  -    Out of range.  Variable is out of its value range.
  3410.           204  -    Pointer problem.
  3411.           208  -    Overlay problem.
  3412.           209  -    Problem loading overlay.  Try again.  Get new EXE copy.
  3413.  
  3414.  
  3415.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                  _____                                                                  Page                                                                  __                                                                       __                                                                       64
  3416.  
  3417.  
  3418.  
  3419.  
  3420.           ________________________________________          APPENDIX F: MAIL DOOR PRODUCT COMPARISON          ________________________________________          APPENDIX F: MAIL DOOR PRODUCT COMPARISON          ________________________________________          APPENDIX F: MAIL DOOR PRODUCT COMPARISON
  3421.  
  3422.  
  3423.  
  3424.           The following table reveals the  features of three mail  products
  3425.           in the mail door  market.  It shows  features which are  directly
  3426.           supported, not using conversion utilities.
  3427.  
  3428.  
  3429.           Feature Support          Feature Support          Feature Support                    Silver                                             Silver                                             Silver   QMAIL                                                      QMAIL                                                      QMAIL   Blue                                                              Blue                                                              Blue
  3430.                                              Xpress                                             Xpress                                             Xpress           Wave                                                              Wave                                                              Wave
  3431.  
  3432.  
  3433.           OPX SUPPORT                        YES                                             YES                                             YES      NO      NO
  3434.  
  3435.  
  3436.           QWK SUPPORT                        YES                                             YES                                             YES      YES     NO
  3437.  
  3438.  
  3439.           OPUS 1.03                          YES                                             YES                                             YES      NO      NO
  3440.  
  3441.  
  3442.           OPUS 1.10                          YES                                             YES                                             YES      NO      NO
  3443.  
  3444.  
  3445.           OPUS 1.7x                          YES                                             YES                                             YES      NO      YES
  3446.  
  3447.  
  3448.           FIDO                               YES                                             YES                                             YES      NO      NO
  3449.  
  3450.  
  3451.           RBBS                               YES                                             YES                                             YES      NO      NO
  3452.  
  3453.  
  3454.           MAX 1.02                           YES                                             YES                                             YES      NO      NO
  3455.  
  3456.  
  3457.           MAX 2.00                           YES                                             YES                                             YES      NO      YES
  3458.  
  3459.  
  3460.           QBBS                               YES                                             YES                                             YES      NO      YES
  3461.  
  3462.  
  3463.           REMOTE ACCESS                      YES                                             YES                                             YES      NO      YES
  3464.  
  3465.  
  3466.           SUPER BBS                          YES                                             YES                                             YES      NO      NO
  3467.  
  3468.  
  3469.           PROBOARD                           YES                                             YES                                             YES      NO      NO
  3470.  
  3471.  
  3472.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       65
  3473.  
  3474.  
  3475.  
  3476.           ROBO-BBS                           YES                                             YES                                             YES      NO      NO
  3477.  
  3478.  
  3479.           TAG                                YES                                             YES                                             YES      NO      NO
  3480.  
  3481.  
  3482.           PCBOARD                            YES                                             YES                                             YES      YES     NO
  3483.  
  3484.  
  3485.           Bundling Commands                  YES                                             YES                                             YES      NO      YES
  3486.  
  3487.  
  3488.           File Requesting                    YES                                             YES                                             YES      NO      YES
  3489.  
  3490.  
  3491.           File Uploading                     YES                                             YES                                             YES      NO      NO
  3492.  
  3493.  
  3494.           Fascimile Interface                YES                                             YES                                             YES      NO      NO
  3495.  
  3496.  
  3497.           Forms Data Entry System            YES                                             YES                                             YES      NO      NO
  3498.  
  3499.  
  3500.           Off-line Service System            YES                                             YES                                             YES      NO      NO
  3501.  
  3502.  
  3503.           File Transfer System               YES                                             YES                                             YES      NO      NO
  3504.  
  3505.  
  3506.           Optional Bulletins                 YES                                             YES                                             YES      YES     NO
  3507.  
  3508.  
  3509.           File Scanner                       YES                                             YES                                             YES      YES     NO
  3510.  
  3511.  
  3512.           Programmable script language       YES                                             YES                                             YES      NO      NO
  3513.  
  3514.  
  3515.           Door Menu Customization            YES                                             YES                                             YES      NO      NO
  3516.  
  3517.  
  3518.           Reader Menu Customization          YES                                             YES                                             YES      NO      NO
  3519.  
  3520.  
  3521.           Language File                      YES                                             YES                                             YES      YES     NO
  3522.  
  3523.  
  3524.           Mail Driven Events                 YES                                             YES                                             YES      NO      NO
  3525.  
  3526.  
  3527.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       66
  3528.  
  3529.  
  3530.  
  3531.           MHS Support                        YES                                             YES                                             YES      NO      NO
  3532.  
  3533.  
  3534.           Password System                    YES                                             YES                                             YES      NO      YES
  3535.  
  3536.  
  3537.           Vacation Saver                     YES                                             YES                                             YES      NO      NO
  3538.  
  3539.  
  3540.           Auto Download System               YES                                             YES                                             YES      YES     YES
  3541.  
  3542.  
  3543.           Auto Upload System                 YES                                             YES                                             YES      YES     YES
  3544.  
  3545.  
  3546.           GoodBye Option                     YES                                             YES                                             YES      YES     YES
  3547.  
  3548.  
  3549.           Interactive Help System            YES                                             YES                                             YES      NO      NO
  3550.  
  3551.  
  3552.           Answering Machine System           YES                                             YES                                             YES      NO      NO
  3553.  
  3554.  
  3555.           Group Mail System                  YES                                             YES                                             YES      YES     NO
  3556.  
  3557.  
  3558.           Support YMS                        YES                                             YES                                             YES      NO      NO
  3559.  
  3560.  
  3561.           Speech Friendly Configuration      YES                                             YES                                             YES      NO      NO
  3562.  
  3563.  
  3564.           Complete User Editor               YES                                             YES                                             YES      NO      NO
  3565.  
  3566.  
  3567.           Complete Default User Setup        YES                                             YES                                             YES      NO      NO
  3568.  
  3569.  
  3570.           SYSOP Controlled Areas             YES                                             YES                                             YES      NO      NO
  3571.  
  3572.  
  3573.           Compression Estimates              YES                                             YES                                             YES      NO      NO
  3574.  
  3575.  
  3576.           Pointer Resets By Number           YES                                             YES                                             YES      YES     YES
  3577.  
  3578.  
  3579.           Pointer Resets By Date             YES                                             YES                                             YES      NO      YES
  3580.  
  3581.  
  3582.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       67
  3583.  
  3584.  
  3585.  
  3586.           Keywords and Filters               YES                                             YES                                             YES      NO      YES
  3587.  
  3588.  
  3589.           Seen-by Stripping                  YES                                             YES                                             YES      NO      YES
  3590.  
  3591.  
  3592.           Complete offline Configuration     YES                                             YES                                             YES      SEMI    YES
  3593.  
  3594.  
  3595.           QWK Network Sysop Support          YES                                             YES                                             YES      YES     NO
  3596.  
  3597.  
  3598.           FidoNet Support                    YES                                             YES                                             YES      NO      YES
  3599.  
  3600.  
  3601.           Support for 48,000 Areas           YES                                             YES                                             YES      NO      NO
  3602.  
  3603.  
  3604.           Free to Sysop                      YES(1)                                             YES(1)                                             YES(1)   NO      NO
  3605.  
  3606.  
  3607.  
  3608.  
  3609.           Notes:
  3610.  
  3611.           1. Free to non-commercial sysops using the Xpress EDI Forms
  3612.              System or during the promotional period.
  3613.  
  3614.  
  3615.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       68
  3616.  
  3617.  
  3618.  
  3619.  
  3620.           _____________________________________          APPENDIX G: SECURITY AND SYSOP ACCESS          _____________________________________          APPENDIX G: SECURITY AND SYSOP ACCESS          _____________________________________          APPENDIX G: SECURITY AND SYSOP ACCESS
  3621.  
  3622.  
  3623.  
  3624.           Silver Xpress security access is very tightly coupled with  those
  3625.           of the BBS for mail and file areas.
  3626.  
  3627.           There are 2 main security issues with which Xpress is concerned:
  3628.  
  3629.            1.  User access to secured mail areas and private mail.
  3630.  
  3631.            2.  User access to the Xpress menus.
  3632.  
  3633.           For Xpress menus, Xpress has user securities and menu securities.
  3634.           The Xpress security value system is completely independent of the
  3635.           BBS security system.  The Xpress user security system is used  to
  3636.           determine access to the Xpress menus and menu items.
  3637.  
  3638.           The following logic is used to determine the special user  access
  3639.           in MAIL Areas only.
  3640.  
  3641.           Under normal  conditions, Xpress  will  follow the  BBS  security
  3642.           system 100%, to  gain access  into the  BBS mail  areas and  file
  3643.           system.
  3644.  
  3645.           However, Xpress  has some  conditions which  give it  power  over
  3646.           other systems  for special  user access,  such as  giving a  user
  3647.           moderator status into  an area.   Not all BBS  systems have  this
  3648.           feature, but Xpress gives you this power.
  3649.  
  3650.           The purpose of the moderator or AREA SYSOP security status is  to
  3651.           determine who can and cannot read private mail or toss mail  into
  3652.           a read-only area.
  3653.  
  3654.           If the BBS already has moderator logic, Silver Xpress will follow
  3655.           it 100%.  If the BBS does not have this logic, Silver Xpress will
  3656.           use the following logic:
  3657.  
  3658.           The default and normal  behavior for picking  up private mail  is
  3659.           that the user must have the access to read other people's private
  3660.           mail.  If not, the  mail is skipped.   The user will always  have
  3661.           his own direct and private mail.
  3662.  
  3663.           If a user is  designated as an AREA  SYSOP (sometimes called  the
  3664.           AREA MODERATOR) he has full access to all mail in that particular
  3665.           mail area.    Depending  on the  Xpress  model,  you  can  assign
  3666.           individual users as moderators of that area.
  3667.  
  3668.           The user designated as the TRUE  SYSOP has access to ALL mail  in
  3669.           all AREAS.
  3670.  
  3671.           To become a TRUE SYSOP, the following must happen:
  3672.  
  3673.  
  3674.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       69
  3675.  
  3676.  
  3677.           TRUE SYSOP for Silver Xpress
  3678.  
  3679.           OPUS 1.03       BBS tells Xpress user is a BBS SYSOP.
  3680.  
  3681.           OPUS 1.1x       BBS tells Xpress user is a BBS SYSOP.
  3682.  
  3683.           OPUS 1.70       BBS  tells  Xpress  user  is  a   BBS  SYSOP  or
  3684.                           ASSISTANT SYSOP.
  3685.  
  3686.           MAX  2.0x       BBS tells Xpress user is a BBS Sysop.
  3687.  
  3688.           RBBS            BBS tells Xpress user is a BBS SYSOP.
  3689.  
  3690.           PCBOARD         BBS tells Xpress user is a BBS SYSOP.
  3691.  
  3692.           RA/QBBS         User name matches sysop name.
  3693.  
  3694.           If the -S is used  or the XPADM option  USE TRUE SYSOP OPTION  is
  3695.           enabled, the only way the user can become the true sysop is if he
  3696.           is the real sysop of the system; the person whose name appears as
  3697.           the sysop or assistant  sysop in the  BBS INFORMATION section  of
  3698.           XPADM.
  3699.  
  3700.           In general, the -S  switch will prevent  BBS sysops from  reading
  3701.           other people's private mail except  for RBBS, PCBOARD, OPUS  1.7x
  3702.           and QBBS/RA which already have a private mail option.
  3703.  
  3704.           To complete the security logic, so  that the non-true sysop  user
  3705.           can gain access to private mail  between two other people, or  to
  3706.           toss mail into a read-only mail  area, he must be an AREA  SYSOP.
  3707.           This is outlined below:
  3708.  
  3709.           AREA SYSOP for Silver Xpress
  3710.  
  3711.           OPUS1.03        Must be a TRUE sysop.
  3712.  
  3713.           OPUS1.10        Must be a TRUE Sysop.
  3714.  
  3715.           OPUS1.70        BBS passes Area Peek Private Security to Xpress.
  3716.  
  3717.           MAX 2.0xx       Must be a TRUE SYSOP.
  3718.  
  3719.           RBBS            XPAREAS.CTL  passes  Private  Mail  Security  to
  3720.                           Xpress and the user is defined as the MODERATOR.
  3721.  
  3722.           PCBOARD         XPAREAS.CTL  passes  Private  Mail  Security  to
  3723.                           Xpress and the user is defined as the MODERATOR.
  3724.  
  3725.           RA/QBBS         BBS passes Conference Sysop security value.
  3726.  
  3727.  
  3728.           As you can see, Silver Xpress  will match the security levels  of
  3729.           the BBS to give you the security flexibility you need.
  3730.  
  3731.  
  3732.           ______________________________________          Silver Xpress Mail System Version 4.00______________                                                                                                                           ____                                                                 __                                                                                                                                     _____                                                                  Page __                                                                       70
  3733.  
  3734.  
  3735.  
  3736.  
  3737.           ___________________________          APPENDIX H: Acknowledgments          ___________________________          APPENDIX H: Acknowledgments          ___________________________          APPENDIX H: Acknowledgments
  3738.  
  3739.  
  3740.  
  3741.           Santronics Software  would like  to express  many thanks  to  the
  3742.           people making up "TEAM XPRESS," for their strong support and beta
  3743.           testing they have provided to the Silver Xpress Mail System:
  3744.  
  3745.           Rick Alfaro, Tom Batchelor Brian Benson, Geoff Block, John Bloom,
  3746.           John Boots Don  Breda, Dan  Brown, Phillip  Catt, Jim  Carabetta,
  3747.           Mike Copeland, Ron  Costa, Richard Couture,  Bob Donaldson,  Mark
  3748.           Evans, Todd Faulkner,  George Fliger, Karen  Fliger Tyronne  Foy,
  3749.           Doug Frank, John Hruszovsky, Ann Ioannides, Bob Juge, Rob  Lerman
  3750.           Jim Louvau,  Tony  Mace,  Larry  Mayhew,  Larry  McDermott,  Brad
  3751.           Meyers,  Michael  Mikelas,  Rick  Moen,  Jonathan  Murray,  Scott
  3752.           Nikont, Gary  Petersen,  Jason  Peterson,  Bill  Philip  and  his
  3753.           European crew, Steve Quarrella,  Frank Rachel, John Schnake,  Tom
  3754.           Schwarz, Greg Shaffer, Kelley  Smith Charlie Smith, Laurence  Tan
  3755.           and his Asian crew,  Stu Turk, Trevor  Ward Danny Williams  Bruce
  3756.           Wilson and William Wilson.
  3757.  
  3758.           Special thanks  to the  Xpress Moderators  and Technical  Support
  3759.           Team:  Charlie Smith, Scott Nikont, George Fliger, Bruce Wilson.
  3760.  
  3761.           Many thanks to  the countless  others who  provided input  during
  3762.           various beta test cycles, and in the Xpress support conferences.
  3763.  
  3764.           Many hugs and kisses to my lovely  wife, who has begun to take  a
  3765.           significant interest in Silver  Xpress, and to really  understand
  3766.           the system (and what I have been during the last six years)!