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