home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR24 / BMR_110.ZIP / BMR.DOC next >
Text File  |  1993-07-14  |  20KB  |  612 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                         B M R
  16.  
  17.                               Broadcast Message Receiver
  18.  
  19.                                          for
  20.  
  21.                                    Netware and OS/2
  22.  
  23.  
  24.  
  25.  
  26.  
  27.           BMR - Broadcast Message Receiver for Netware and OS/2
  28.           User's Manual
  29.  
  30.           Introduction
  31.           ============
  32.  
  33.           BMR  is an  OS/2 PM  hosted utility for  use with  Novell Netware
  34.           LANs.   It's purpose is to intercept those often annoying "popup"
  35.           messages that result from other users and/or the network software
  36.           "sending"  you   messages.    Instead  of  a   VIO  popup  screen
  37.           interrupting your  work every  time a  message  is received,  BMR
  38.           collects these message and displays  them in a scrollable listbox
  39.           display.
  40.  
  41.           In addition, messages can be sent to one or more users using BMR.
  42.           Users are selected from a "drop down" or  a listbox (depending on
  43.           the  runtime mode selected).  Multiple users and/or groups may be
  44.           targeted  at one  time.   Outgoing messages  are recorded  in the
  45.           receive  listbox for later reference,  and may be  resent if need
  46.           be.
  47.  
  48.           Double clicking on a line in the receive listbox will attempt to
  49.           select the user attached  to that line.   This makes replying  to
  50.           multiple users easier.
  51.  
  52.           BMR has some useful configuration options, too.  First, there are
  53.           five different interfaces to choose from.  Each interface has the
  54.           same  basic functionality,  but varies  in the  size and  type of
  55.           controls.   You can change to the "next" interface mode simply by
  56.           pressing  the ">" button.   In addition, an  "Option" button lets
  57.           you control other  features.   You may control  the "beep"  alarm
  58.           that sounds when  new messages are  received.   You may turn  all
  59.           message reception off,  or simply accept messages but  notify the
  60.           sender  that you are  "away".  The  message that is  "returned to
  61.           sender" is also configurable, so  it's easy to say what  you want
  62.           (for example, "Nick is  away until 12:00".)  Finally,  the amount
  63.           of  information  given to  you when  group  messages are  sent is
  64.           configurable.
  65.  
  66.           Configurable  options are stored in a file called BMR.INI and are
  67.           restored the next time BMR is invoked.
  68.  
  69.           This  IS a shareware package, and does require a registration fee
  70.           if  you  choose  to continue  using  it  after  30  days.     The
  71.           registration fee is currently $15 US for individual users.  For a
  72.           server  license (aimed more at company purchases), the fee is $35
  73.           for any number  of users on a single server.   When you register,
  74.           you will  be sent the latest  "registered" version of BMR.   This
  75.           version  will no longer display the startup screen present in the
  76.           non-registered version.
  77.  
  78.  
  79.           ----------------------------------------------------------------
  80.           BMR User's Guide                                       Page  1
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.           ----------------------------------------------------------------
  89.           IMPORTANT:  READ THE READ.ME FILE FOR NEW FEATURES AND BUG FIXES
  90.           ----------------------------------------------------------------
  91.  
  92.  
  93.  
  94.           DISCLAIMER OF WARRANTY
  95.           ======================
  96.  
  97.           THIS SOFTWARE AND  MANUAL ARE  DISTRIBUTED AND SOLD  "AS IS"  AND
  98.           WITHOUT WARRANTIES  AS TO  PERFORMANCE OF MERCHANTABILITY  OR ANY
  99.           OTHER WARRANTIES  WHETHER EXPRESSED OR  IMPLIED.  BECAUSE  OF THE
  100.           VARIOUS  HARDWARE  AND  SOFTWARE  ENVIRONMENTS  INTO  WHICH  THIS
  101.           PROGRAM  MAY  BE PUT,  NO WARRANTY  OF  FITNESS FOR  A PARTICULAR
  102.           PURPOSE IS OFFERED.
  103.  
  104.           GOOD OPERATING PROCEDURE DICTATES  THAT ANY PROGRAM BE THOROUGHLY
  105.           TESTED WITH NON-CRITICAL  DATA BEFORE  RELYING ON IT.   THE  USER
  106.           MUST ASSUME THE ENTIRE RISK OF USING  THE PROGRAM.  ANY LIABILITY
  107.           OF THE SELLER WILL BE LIMITED  EXCLUSIVELY TO PRODUCT REPLACEMENT
  108.           OR REFUND OF PURCHASE PRICE. 
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.           ----------------------------------------------------------------
  139.           BMR User's Guide                                       Page  2
  140.  
  141.  
  142.  
  143.  
  144.  
  145.           Major Features
  146.           ==============
  147.  
  148.           o    OS/2 PM specific.   Other  platforms may be  supported if  a
  149.                need is present.
  150.  
  151.           o    Multithreaded design.
  152.  
  153.           o    Received messages  are captured into  a scrollable  listbox.
  154.                The listbox is cleared only by user command.
  155.  
  156.           o    Multiple modes - several dialog box front ends are available
  157.                to accommodate as many users as possible.  Pass BMR a simple
  158.                single digit number parameter  from 1 to 5 (e.g.,  "BMR 2").
  159.                Modes can be switched  from within BMR, also, and  your last
  160.                selected mode will  be remembered and  set as your  start-up
  161.                default.
  162.  
  163.           o    Focus-sensitive beeper  alerts you  to new messages  ONLY if
  164.                BMR does not have the "focus", if desired.  In addition, the
  165.                alarm can be made to always beep, or to never beep.
  166.  
  167.           o    Sends messages, too.  Target users/groups are selectable via
  168.                a  drop down  list  or  full listbox.    You may  also  send
  169.                messages to the console.
  170.  
  171.           o    Resend  any  previously  sent/received  message   simply  by
  172.                clicking on any message displayed in the received listbox.
  173.  
  174.           o    Double  click on  any receive  box line  to auto-select  the
  175.                associated user for replying.
  176.  
  177.           o    Clear  all  selected users  by  clicking  on the  user-count
  178.                button.
  179.  
  180.           o    A configurable "return to sender" message may be sent to any
  181.                user  trying  to send  you messages.    It's easy  to inform
  182.                people that you are away for some time or in a meeting.  You
  183.                may also simply "cast off" and choose to receive no messages
  184.                (sending is *always* possible).
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.           ----------------------------------------------------------------
  198.           BMR User's Guide                                       Page  3
  199.  
  200.  
  201.  
  202.  
  203.  
  204.           Installing BMR
  205.           ===============
  206.  
  207.           Unpack   the  BMR_110.ZIP  file  into  an  appropriate  directory
  208.           ("\BMR", for instance).  All BMR files should be kept together in
  209.           the same directory.
  210.  
  211.           Unpacking BMR_100.ZIP  is all that's involved  in installing BMR.
  212.           We suggest  creating an icon for BMR and placing it either on the
  213.           WPS desktop or in your startup folder.
  214.  
  215.           NOTE:    BMR v1.1  now requires  the  Netware requester  for OS/2
  216.           v2.01.  Please do  not use the NWCALLS.DLL file  distributed with
  217.           v1.0.    This is  now obsolete  and  only the  2.01  requester is
  218.           supported.
  219.  
  220.           BMR does  require a  PC  running OS/2  and attached  to a  Novell
  221.           Netware network.  At  this time, BMR is a  16-bit application and
  222.           thus,  it should  be  functional with  OS/2  1.3.   This  remains
  223.           untested.   The development and test system consisted of OS/2 2.0
  224.           and 2.1 betas attached to a Novell 3.11 network server.
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.           ----------------------------------------------------------------
  257.           BMR User's Guide                                       Page  4
  258.  
  259.  
  260.  
  261.  
  262.  
  263.           Using BMR for the First Time
  264.           =============================
  265.  
  266.           BMR's  user interface consists mainly of one screen.  This screen
  267.           contains a user selection list, the received message  listbox and
  268.           4 buttons.  This simplicity makes BMR easy to use, even without a
  269.           manual.
  270.  
  271.           User List
  272.           ---------
  273.           The User  List contains the  names of  all account  names on  the
  274.           server, as well as the console and any groups.  Any messages sent
  275.           from BMR  will be  received  by the  users  selected here.    The
  276.           behavior of this listbox  depends on the mode of BMR.  In mode 2,
  277.           the User  List is a  standard drop-down  combo box, in  which one
  278.           user name may be selected.   In modes 1 and 3 - 5,  the User List
  279.           is a multiple-selection  list box,  in which any  number of  user
  280.           names  may  be selected.   All  selected  users will  receive any
  281.           messages sent from BMR.
  282.  
  283.           Send Box
  284.           --------
  285.           This box is where you type messages to be sent.  A message may be
  286.           up  to  50  characters  long.   If  you  try  to  type  beyond 50
  287.           characters, BMR  will beep  and stop  accepting keystrokes.   The
  288.           Send Box keeps  the focus even when you click  other areas of BMR
  289.           with the mouse.
  290.  
  291.           Receive Box
  292.           -----------
  293.           This  list box  displays all  messages sent  or received  by BMR.
  294.           Messages that you sent will be displayed in the form:
  295.  
  296.                Message Text->YourAccountName
  297.  
  298.           while messages received by you will be displayed in the form:
  299.  
  300.                YourAccountName: Message Text
  301.  
  302.           In  addition  to  these messages,  you  will  also receive  error
  303.           reports.  If a user is  not logged on, not accepting messages, or
  304.           away, you will be notified in this list box.
  305.  
  306.           Selecting  any message in the  Receive Box with  the mouse causes
  307.           the text to be copied into the send box, so that you can resend a
  308.           message or forward one.  The User Name will be  stripped from the
  309.           message, and only the text copied.
  310.  
  311.           Double clicking on any received line will cause BMR to attempt to
  312.           select the user associated with that message for replying.  
  313.  
  314.  
  315.           ----------------------------------------------------------------
  316.           BMR User's Guide                                       Page  5
  317.  
  318.  
  319.  
  320.  
  321.  
  322.           User Count Button
  323.           -----------------
  324.       This    button is  always  filled  with  a  number.    This  number
  325.           represents the count of user names and/or groups currently marked
  326.           in  the "to" user  selection list.  Clicking  on this button will
  327.           clear all selections from the listbox and set the counter back to
  328.           zero.
  329.  
  330.           Move Window Button (Mode 5 Only)
  331.           --------------------------------
  332.           BMR Mode 5  has no title  bar to aid in  moving the display  to a
  333.           desired  position.   To allow  placement in  this mode,  a small,
  334.           unlabeled  "move"  button  has been  provided.    This button  is
  335.           located on the bottom  of the display between the two list boxes.
  336.           To move  the dialog  box, simply  click on  the button,  move the
  337.           outline frame to the desired position an click again.
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.           ----------------------------------------------------------------
  375.           BMR User's Guide                                       Page  6
  376.  
  377.  
  378.  
  379.  
  380.  
  381.           The OPTION Button
  382.           =================
  383.           Pressing this button will display the Configuration Options entry
  384.           screen.   There are three  switches and  one text entry  field on
  385.           this  screen.   These  fields provide  flexible control  over the
  386.           message  "beeper", your message receiving state and the amount of
  387.           detail BMR  displays back  to you  as  groups are  expanded.   In
  388.           addition, you may define a short  text string to send to any user
  389.           that attempts to contact you while you are marked as unavailable.
  390.           Each field on this screen is described below.
  391.  
  392.           Beeper
  393.           ------
  394.           This is a checkbox field that controls the "beeper" alarm that is
  395.           sounded  when any new message is received.  It initially defaults
  396.           to  "checked".  Clicking  on the button  or its  text will toggle
  397.           through the three possible states:  clear, checked or solid.   If
  398.           this  box is clear, beeping is totally disabled and you will hear
  399.           no  audible signal  as messages  are received.   If  checked, the
  400.           beeper is enabled in "no focus"  mode.  If a message is received,
  401.           BMR will sound  the alarm  if and only  if it  does not have  the
  402.           current  WPS focus  (you're  currently working  with a  different
  403.           application).    If marked  solid, BMR  will  always beep  upon a
  404.           message  reception, whether BMR is currently the active window or
  405.           not.
  406.  
  407.           Return to Sender
  408.           ----------------
  409.           This checkbox  allows for  three different  modes.   The  initial
  410.           default mode  is for  the checkbox to  be clear, which  is normal
  411.           receive  mode.    All  incoming  messages will  be  received  and
  412.           recorded in the  message listbox.   If this box  is checked,  BMR
  413.           goes  into  "user  is away"  mode.    All  incoming messages  are
  414.           accepted  and  displayed in  the  message listbox,  but  a return
  415.           message is automatically returned to  the user who originated the
  416.           message.  This message  identifies you by user name,  followed by
  417.           the text that you define in the next "text entry" field.  If this
  418.           checkbox is  marked as solid,  you are in  "cast off" mode.   The
  419.           result is  the same  as  if you  had used  the Netware  "Castoff"
  420.           command line utility.   All  users sending you  messages will  be
  421.           notified  that you  are  not accepting  messages.   Netware  will
  422.           reject the messages before they  get to BMR, so you will  not see
  423.           any messages appearing in the received message listbox.
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.           ----------------------------------------------------------------
  434.           BMR User's Guide                                       Page  7
  435.  
  436.  
  437.  
  438.  
  439.  
  440.           Return to Sender Notice
  441.           -----------------------
  442.           This  is a text entry field that  identifies the message you wish
  443.           to send when you are marked as unavailable.  BMR will append this
  444.           message to your user name, identifying you as  the "sender".  For
  445.           example, if you fill this field with "is unavailable until 3:30",
  446.           anyone  sending you  a line  message will  immediately be  sent a
  447.           message that states (using "Nick" as the login name):
  448.  
  449.                "Nick - is unavailable until 3:30".
  450.  
  451.           This message is send automatically if and only if the "Return  to
  452.           sender" checkbox is in checked mode.
  453.  
  454.  
  455.           Report Group Expansion
  456.           ----------------------
  457.           This checkbox is used  to indicate how much information  you wish
  458.           to  see reported to the receive listbox when groups are expanded.
  459.           If left clear (unchecked), no expansion information is displayed.
  460.           Group messages are sent  "blind" and you are not informed  of the
  461.           user names that were sent to, and all error reporting (e.g., "not
  462.           logged  in") is  suppressed.   If the  checkbox is  checked, then
  463.           groups are still not reported by individual names unless an error
  464.           occurs.   In  this case, users  that are  not logged  on, are not
  465.           accepting message, or are unable to see your message for whatever
  466.           reason  are listed in  the receive listbox.   If this checkbox is
  467.           solid, then complete  reporting is  enabled.  In  this mode,  the
  468.           "send" to each user  is reported to the receive  listbox, as well
  469.           as any error conditions that occur.
  470.  
  471.  
  472.           The CLEAR Button
  473.           ================
  474.           This button allows you to clear both the SEND message box and the
  475.           RECEIVED listbox.  When you press CLEAR, BMR checks to see if any
  476.           text is  currently present  in the  SEND message  entry box.   If
  477.           something is there, BMR clears only that text.  If no text exists
  478.           in the SEND message box, BMR clears the RECEIVED message listbox.
  479.           Simply double clicking on  the CLEAR button insures  a completely
  480.           clear state.
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.           ----------------------------------------------------------------
  493.           BMR User's Guide                                       Page  8
  494.  
  495.  
  496.  
  497.  
  498.  
  499.           The MODE Button [>]
  500.           ===================
  501.           This button may be pressed  to change the main BMR dialog  box to
  502.           the next "mode".  For example, if you load BMR  initially with no
  503.           parameters, MODE 1 is invoked.  You may press the MODE button one
  504.           time to see MODE  2, then press it again to see MODE 3.  When the
  505.           last MODE is reached, BMR will set the mode back to MODE 1.
  506.  
  507.           Each dialog mode works in basically the same way.  The difference
  508.           is mostly in the overall size of the dialog box and the fields it
  509.           contains.   Once you find  the mode  option that  suites you  the
  510.           best,  simply exit  BMR with  that  mode active.   BMR  saves the
  511.           current  mode and screen position  in the BMR.INI  file, and will
  512.           restore your previous state upon reentry.
  513.  
  514.           NOTE:  If a mode parameter is specified to BMR  on startup (e.g.,
  515.           "BMR 3"), then this mode overrides the mode saved in BMR.INI.
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.           ----------------------------------------------------------------
  552.           BMR User's Guide                                       Page  9
  553.  
  554.  
  555.  
  556.  
  557.  
  558.           CONTACTING THE AUTHORS
  559.           ======================
  560.  
  561.           Authors:  John Lathem and Nick Knight
  562.  
  563.           You    may contact  either  one  of us  in  a  number   of  ways.
  564.           Unfortunately, we can't provide a phone number at this time.
  565.  
  566.             US Mail:     John Lathem                   Nick Knight
  567.                          4278 W. 223rd Street          1823 David Ave.
  568.                          Cleveland, Ohio  44126        Parma, Ohio 44134
  569.  
  570.             Fax:              (216) 734-1836 (ZSpace - John Lathem)
  571.  
  572.             Fido netmail:     1:157/200 to "Nick Knight" or "John Lathem"
  573.  
  574.             Fido Echomail:    Echomail messages are discouraged.
  575.  
  576.             Direct BBS:       You can leave  a message to  either of us  on
  577.                               the  PC-Ohio  BBS  (216) 381-3320.    This is
  578.                               Fidonet system 1:157/200 and  Fidonet netmail
  579.                               can be sent to this address.
  580.  
  581.             Internet mail:    john.lathem@pcohio.com
  582.                               nick.knight@pcohio.com
  583.  
  584.             Compuserve:       You can contact Nick  Knight here.  Send mail
  585.                               to user ID - 76066,1240.
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.           ----------------------------------------------------------------
  611.           BMR User's Guide                                       Page  10
  612.