home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / DMSPPE1B.ZIP / INSTALL.DOC < prev    next >
Text File  |  1995-01-11  |  14KB  |  417 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                             Data Management Systems
  8.  
  9.                                     Presents
  10.  
  11.                    Custom Prompts for PCBoard v.15.1 & 15.2x
  12.  
  13.                           Collection #1 - DMSPPE1B.ZIP
  14.  
  15.                                v.1.0b - 01/11/95
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27. INTRODUCTION
  28.  
  29. Thanks for taking the time to download DMSPPE1B.ZIP. This collection of lite-bar
  30. and multi-level scrolling prompts will add a new level of sophistication to your
  31. PCBoard system.
  32.  
  33. The following files should be contained in DMSPPE1B.ZIP:
  34.  
  35.    FILE_ID.DIZ       - file description
  36.    INSTALL.DOC       - installation instructions and information
  37.    DMSPPE1B.NEW      - what's new w/this version
  38.    ORDER.FRM         - registration information
  39.    EOM.PPE           - end of message prompt
  40.    EOM.HLP           - help file for EOM.PPE
  41.    EOMATTCH.DIS      - attached file message display
  42.    MORE.PPE          - replacement MORE prompt
  43.    MORE.HLP          - help file for MORE.PPE
  44.    SCANMAIL.PPE      - scan mail prompt
  45.    SCANMAIL.HLP      - help file for SCANMAIL.PPE
  46.    NEWMAIL.PPE       - new mail prompt
  47.    NEWMAIL.HLP       - help file for NEWMAIL.PPE
  48.    NEWMAIL.SCR       - display screen for NEWMAIL.PPE
  49.    CMDLINE.PPE       - replacement command line
  50.    MENUS.PPE         - replacement menu command line
  51.    XON.PPE           - expert on / menus off
  52.  
  53. If any of these files are missing, please call The File Bank BBS (619-728-7307)
  54. and download a fresh copy of DMSPPE1B.ZIP. This and other DMS products for
  55. PCBoard can be found in conference #258 (DMS Shareware Products - Unregistered),
  56. directory #1. Although The File Bank BBS is a subscription board, all DMS
  57. products are available for downloading by any caller.
  58.  
  59. All of these replacement prompts and commands support GRAPH, ANSI, and CTTY
  60. display modes, although the lite-bar and context-sensitive help features are
  61. available only in GRAPH and ANSI modes.
  62.  
  63. Navigation through the lite-bar options can be accomplished in many ways:
  64.  
  65.    Cursor Right   move hilite / cursor to the right
  66.    Space          move hilite / cursor to the right
  67.    Cursor Left    move hilite / cursor to the left
  68.    BackSpace      move hilite / cursor to the left
  69.    Home           move hilite / cursor to left-most option
  70.    End            move hilite / cursor to right-most option
  71.  
  72.    trigger keys   move hilite / cursor to desired option
  73.  
  74.    Enter          execute hilited / underlined option
  75.  
  76. Navigation keys for the multi-level menus on scrolling prompts (ie.. EOM.PPE)
  77. include the following keys:
  78.  
  79.    >              move hilite / cursor to 'next menu' option
  80.    .              move hilite / cursor to 'next menu' option
  81.    <              move hilite / cursor to 'previous menu' option
  82.    ,              move hilite / cursor to 'previous menu' option
  83.  
  84.    1 ... 9        hot-key directly to menu #1 .... #9 (as applicable)
  85.  
  86. Most of the PPE files have an associated .HLP file detailing any specific
  87. actions and other useful tips. Please review these files for more information
  88. regarding a specific prompt.
  89.  
  90.  
  91.  
  92. LEGAL STUFF
  93.  
  94. This software is presented as is, with no warranties expressed nor implied.
  95. DMSPPE1B and its constituent components are copyright 1994 - 1995, Data
  96. Management Systems, All Rights Reserved.
  97.  
  98. PCBoard is a trademark of Clark Development Company, Inc.
  99. The File Bank is a trademark of Data Management Systems
  100.  
  101.  
  102.  
  103. SHAREWARE EVALUATION PERIOD
  104.  
  105. This software is distributed as Shareware. The user is allowed a thirty-day
  106. evaluation period. At the end of the thirty-day evaluation period, the user
  107. must either register the software or discontinue using it.
  108.  
  109.  
  110.  
  111. REGISTRATION
  112.  
  113. The on-line help option for all prompts is disabled for unregistered versions of
  114. DMSPPE1B. Instead of displaying a help file, a copyright and registration
  115. reminder is displayed. Other than this limitation, all features of the prompts
  116. are active. Should you decide to register, you will receive a full copy of the
  117. PPS source code and a new set of .PPEs with the help feature enabled.
  118.  
  119. Registrations can be mailed or faxed in, or handled on-line on The File Bank
  120. BBS. You have the option of receiving the registered software via mail or it can
  121. be downloaded directly from The File Bank. Please see ORDER.FRM for more
  122. information on registering DMSPPE1B.
  123.  
  124.  
  125.  
  126. GENERIC INSTALLATION INFORMATION
  127.  
  128. The enclosed .PPE and support files can be placed anywhere on your system. There
  129. are no hard-coded paths to worry about. Support files should be copied into the
  130. same directory as the .PPE file (ie.. NEWMAIL.PPE & NEWMAIL.SCR should be in the
  131. same directory). For purposes of this document, C:\PCB\PPL\PROMPTS will be the
  132. directory used in the examples below.
  133.  
  134. Most of the .PPEs in DMSPPE1B.ZIP require modification of the file PCBTEXT. The
  135. record number(s) for each .PPE are detailed in the description of each .PPE
  136. later in this document. The steps required to modify PCBTEXT include:
  137.  
  138.    1. Run MKPCBTXT                  (MKPCBTXT C:\PCB\GEN\PCBTEXT)
  139.    2. Goto the desired record #     (F3 key)
  140.    3. Type in the changes           (see detail for each .PPE below)
  141.    4. Save changes and quit         (ESC key)
  142.  
  143. Please see the PCBoard Technical Reference Manual for more detailed instructions
  144. on changing PCBTEXT information.
  145.  
  146. END OF MESSAGE PROMPT - EOM.PPE
  147.  
  148. The end of message prompt appears as the user finishes reading a message.
  149. EOM.PPE is a multi-level, scrolling prompt with seven different sets of
  150. options. The first level is shown below; see EOM.HLP for examples of the
  151. remaining sets.
  152.  
  153.    (xxx min. left) [ conference name / number ] End of message command:
  154.    ┌─────────────────────────────────────────────────────────────────────────┐
  155.    │ Cont  Next  Prev  Reply  Kill  reDisp  nonStop  +  -  Adv  Quit  Help ->│
  156.    │ -> read next message in current direction (+/-)                         │
  157.    └─────────────────────────────────────────────────────────────────────────┘
  158.  
  159.  
  160. The options Cont, Next, Prev, ... appear as a horizontal lite-bar menu. Help for
  161. each option is displayed on the line below the menu as the user moves the lite
  162. bar from option to option.
  163.  
  164. Two options allow free-form entry by the user: Adv (advanced) allows the user
  165. to type in any valid combination of PCBoard commands. # (message #, found on set
  166. #5) allows the user to type in the message number to read next. The ESC key
  167. allows the user to clear any characters typed for these two options.
  168.  
  169. Installation notes:
  170.  
  171.    PCBTEXT record # .. 197
  172.                     .. 612
  173.    Support files ..... EOM.HLP (help file, displayed w/registered version)
  174.                        EOMATTCH.DIS  (display file, optional, see below)
  175.  
  176. Example PCBTEXT line:
  177.  
  178.    !c:\pcb\ppl\prompts\eom.ppe
  179.  
  180.  
  181. An additional option for EOM.PPE is the display of a customized notification to
  182. the user that a message has an attached file. The file EOMATTCH.DIS has been
  183. included with DMSPPE1B for this purpose:
  184.  
  185. Installation notes:
  186.  
  187.    PCBTEXT record # .. 624
  188.  
  189. Example PCBTEXT line:
  190.  
  191.    %c:\pcb\ppl\prompts\eomattch.dis
  192.  
  193. MORE PROMPT - MORE.PPE
  194.  
  195. The more prompt is displayed by PCBoard whenever more than a screen-full of
  196. information will be presented to the user. MORE.PPE replaces PCBoard's standard
  197. prompt with a lite-bar:
  198.  
  199.    More ->  Yes  No  nonStop  Help
  200.  
  201.  
  202. Installation notes:
  203.  
  204.    PCBTEXT record # .. 196
  205.    Support files ..... MORE.HLP (help file, displayed w/registered version)
  206.  
  207.  
  208. Example PCBTEXT line:
  209.  
  210.    !c:\pcb\ppl\prompts\more.ppe
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218. SCAN MAIL PROMPT - SCANMAIL.PPE
  219.  
  220. The user is asked if they would like to scan mail as part of the PCBoard login
  221. process. SCANMAIL.PPE replaces PCBoard's default prompt with a lite-bar:
  222.  
  223.    Scan mail since last read ->  Current  Selected  All  No  Help
  224.  
  225.  
  226. Installation notes:
  227.  
  228.    PCBTEXT record # .. 296
  229.    Support files ..... SCANMAIL.HLP (help file, displayed w/registered version)
  230.  
  231.    To allow this prompt to work correctly, fire up PCBSETUP and review the
  232.    following setting:
  233.  
  234.       1. 'G' (Configuration Options), 'A' (Messages)
  235.       2. Ensure that 'Default to Scan ALL Conferences at Login' is set to 'N'o
  236.       3. This change must be made on each node if you are running a
  237.          multi-node system and each node has its own setup file.
  238.  
  239.  
  240. Example PCBTEXT line:
  241.  
  242.    !c:\pcb\ppl\prompts\scanmail.ppe
  243.  
  244. NEW MAIL PROMPT - NEWMAIL.PPE
  245.  
  246. If the option is turned on via PCBSETUP, the user is shown a list of conferences
  247. in which they have mail waiting as part of the login sequence. NEWMAIL.PPE
  248. replaces PCBoard's default prompt with a display file and a lite-bar prompt:
  249.  
  250.    ┌──────────────────────────────────┐
  251.    │       ▄▄┐                        │
  252.    │         │                        └─────────┐
  253.    │ ███████████                                │
  254.    │ ███████████                                └─────────┐
  255.    │    ║║         You have new mail waiting in the       └─────────┐
  256.    │    ║║         following conferences:                           │
  257.    │    ║║                                                          └─────────┐
  258.    └──────────────────────────────────────────────────────────────────────────┘
  259.  
  260.    Read new mail now ->  No  Yours  All  Help
  261.  
  262.  
  263. Installation notes:
  264.  
  265.    PCBTEXT record # .. 662
  266.    Support files ..... NEWMAIL.HLP (help file, displayed w/registered version)
  267.                        NEWMAIL.SCR (display file, optional, see below)
  268.  
  269.    To turn on this feature for your system, fire up PCBSETUP and make
  270.    the following change:
  271.  
  272.       1. 'G' (Configuration Options), 'A' (Messages)
  273.       2. Change 'Prompt to Read Mail when Mail Waiting' to 'Y'es
  274.       3. This change must be made on each node if you are running a
  275.          multi-node system and each node has its own setup file.
  276.  
  277.  
  278. Example PCBTEXT lines:
  279.  
  280.    !c:\pcb\ppl\prompts\newmail.ppe
  281.  
  282.  
  283. An additional option for NEWMAIL.PPE is the display of a customized new mail
  284. screen. The file NEWMAIL.SCR has been included with DMSPPE1B for this purpose:
  285.  
  286. Installation notes:
  287.  
  288.    PCBTEXT record # .. 566
  289.  
  290. Example PCBTEXT lines:
  291.  
  292.    %c:\pcb\ppl\prompts\newmail.scr
  293.  
  294. COMMAND LINE PROMPT - CMDLINE.PPE
  295.  
  296. The command line is presented to the user whenever they are in the expert mode
  297. (no menus). CMDLINE.PPE provides for a two-line prompt, allowing for a cleaner
  298. display of the extra long conference names allowed in PCBoard v.15.2x:
  299.  
  300.    (xxx min. left) [ conference name / number ]
  301.    Command (? = Help ) ->
  302.  
  303.  
  304. Installation notes:
  305.  
  306.    PCBTEXT record # .. 396
  307.    Support files ..... none
  308.  
  309.  
  310. Example PCBTEXT line:
  311.  
  312.    !c:\pcb\ppl\prompts\cmdline.ppe
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320. MENU PROMPT - MENUS.PPE
  321.  
  322. The menu prompt is shown whenever the expert mode is toggled off and you
  323. are using some type of menuing system (.MNU files). MENUS.PPE provides for a
  324. two-line prompt, allowing for a cleaner display of the extra long conference
  325. names allowed in PCBoard v.15.2:
  326.  
  327.    (xxx min. left) [ conference name / number ]
  328.    xxxx Menu Command (? = Help ) ->
  329.  
  330.  
  331. Installation notes:
  332.  
  333.    PCBTEXT record # .. 682
  334.    Support files ..... none
  335.  
  336.  
  337. Example PCBTEXT line:
  338.  
  339.    !c:\pcb\ppl\prompts\menus.ppe
  340.  
  341. EXPERT MODE ON / MENUS OFF - XON.PPE
  342.  
  343. If you are using a menu system (.MNU files) for displaying menu files to a user
  344. when in the non-expert mode, you may have found that turning the expert mode on
  345. is a bit messy. Included in DMSPPE1B is our solution for this problem - XON.PPE.
  346. Mapped to the 'X' command in all appropriate .MNU files, XON.PPE forces the
  347. expert mode on and stops displaying the menus to the user and clears the
  348. currently displayed menu off of the screen. Although PCBoard allows for a
  349. 'XPRT'-type keyword in .MNU files, their option leaves the menus in place and
  350. does not allow the user to switch expert modes again.
  351.  
  352. An unwanted side-affect to using menus for the non-expert mode is the trapping
  353. of the Quick Scan (Q) command by PCBoard. When in a menu mode, PCBoard
  354. translates the 'Q' command into Quit Menu. The top-level menu is displayed, but
  355. any keywords defined in the .MNU file are no longer recognized. Our solution for
  356. this is to include a 'Q' keyword in the .MNU file, stuffing the keyboard with a
  357. 'Q'.
  358.  
  359. Use the MKPCBMNU.EXE utility (included with PCBoard) to install either of these
  360. options for your system. Please see the PCBoard Technical Reference Manual for
  361. more detailed instructions on using the MKPCBMNU.EXE utility. The keyword
  362. definitions should be modified to add these new keywords:
  363.  
  364.    Keyword  Sec   Type  Parameters
  365.    -------  ---   ----  ----------------------------------------------
  366.    X        20    PPEX  c:\pcb\ppl\prompts\xon.ppe
  367.    Q        20    STFS  Q @PARAMS@
  368.  
  369. The security level is up to you - we allow all users to access these commands
  370. (20 is the lowest security level on The File Bank BBS).
  371.  
  372. The path for XON.PPE should reflect the drive and directory where you copied
  373. XON.PPE to. To keep things clean, we put it in the same directory as our
  374. prompts.
  375.  
  376. That's about it - for this collection anyway. If you like what you see, please
  377. register. The cost is modest, the users enjoy some advanced features, and we'll
  378. be encouraged to bring out additional collections of custom prompts, commands,
  379. and utilities for PCBoard.
  380.  
  381.  
  382.  
  383. THE FILE BANK BBS
  384.  
  385. Started in 1987 as a single node XT-based BBS, we're currently running 25 nodes
  386. of PCBoard v.15.2x in Sunny Southern California. Highlights include:
  387.  
  388.    - incoming and outgoing Internet connectivity w/115.2K bandwidth
  389.      (telnet bbs.tfb.com  or  telnet 198.68.171.210)
  390.  
  391.    - toll free call in the San Diego (619) area (540-2409)
  392.  
  393.    - low or no-toll call if you have an Internet account
  394.  
  395.    - choice of WWW, PCBoard, or plain old Unix interfaces on incoming Internet *
  396.  
  397.    - 40,000+ files
  398.  
  399.    - 500+ conferences including RIME and Internet newsgroups
  400.  
  401.    - USR v.Everything (including v.34, 28,8K, v.FC, v.Fast) modems
  402.  
  403.    - Planet Connect satellite feed
  404.  
  405.    - special discount subscription rates for SysOps
  406.  
  407.      * these features in beta as of this writing.
  408.  
  409.  
  410.  
  411. DATA MANAGEMENT SYSTEMS
  412.  
  413. Parent company for The File Bank BBS and a VAR in the San Diego County area.
  414. Specialists in Novell Netware, Artisoft LANtastic, SCO Unix, IBM OS/2 and
  415. Windows NT platforms (we had to be - The File Bank runs on a combination of most
  416. of these systems).
  417.