home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / BBS / NETMAIL / OMKRD201.ZIP / OMKREAD.DOC next >
Encoding:
Text File  |  1991-12-28  |  41.9 KB  |  1,255 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.         INTRODUCTION
  9.  
  10.          
  11.         WELCOME TO OPUS MESSAGE KIT!!  This program, OMKREAD.EXE, is an
  12.         off-line reader which will allow you to read, write and reply to
  13.         messages on any Opus Bulletin Board which carries Opus Message Kit
  14.         AND systems which carry the QWK message format.  
  15.  
  16.         The system is written and owned by Roland "Bud" Brown and is the 
  17.         product of several years of work.  However, unlike many systems
  18.         today Opus Message Kit is totally FREE.  There is no cost to you or
  19.         the BBS for using Opus Message Kit (OMK).  
  20.  
  21.         OMK is a gift to the BBS community by Roland and the PainFrame
  22.         Pointers.  The Pointers are a group of friends who went through the
  23.         trauma several years ago of setting up mail points off of the
  24.         PainFrame BBS (1:261/1004) here in Baltimore.  While it was rough
  25.         in the beginning, we have had a wonderful time sharing our
  26.         "hobby/passion" for computers. Opus Message Kit was born out of our
  27.         desire to allow folks the opportunity to become points "PainLessly"
  28.         off their favorite Opus Bulletin Boards.  The Pointers (named
  29.         individually at the end of this document) spent many hours debug-
  30.         ging, testing, and helping design OMK.  We hope that you will find
  31.         the system enjoyable. 
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.         1.    OPUS MESSAGE KIT OVERVIEW 
  77.          
  78.         OPUS Message Kit is an offline reader designed for use on OPUS and
  79.         other BBS systems which use Opus Message Kit or the QWK off-line
  80.         message format.  It enables you to: 
  81.          
  82.         -     Select message areas on a bulletin board.  
  83.         -     Archive messages from those areas.  
  84.         -     Download the messages. 
  85.         -     Read and reply to the messages offline on your own computer, 
  86.               and create new messages if you desire. 
  87.         -     Upload the replies and messages you have created to the       
  88.               bulletin board, where they are placed in the correct message  
  89.               areas. 
  90.  
  91.         When you log onto a BBS carrying Opus Message Kit, or QWK, the
  92.         sysop provides a way for you to select the message areas you would
  93.         like track and to "bundle" (pack up) messages in those  areas.  OMK
  94.         or the QWK format bundler, bundles your messages, and you download
  95.         the file containing the messages to your own computer.   
  96.  
  97.         The reader (OMKREAD.EXE), when installed on your computer, prepares
  98.         the bundle of messages for your use and provides you with a simple
  99.         environment for reading and responding to them at your own pace.  A
  100.         text editor of your choice (see Section 2) is used to create your
  101.         replies and new messages. When you are ready, OMK prepares your
  102.         replies and new messages for transmittal to the bulletin board. 
  103.         You use your normal communications program, call the bulletin
  104.         board, and follow instructions for uploading your messages.   
  105.          
  106.         It's that simple.  You no longer need to worry about running out of
  107.         time when you follow a large echo, or decide not to answer a
  108.         message because you need to look up a reference.  No more concerns
  109.         about tying up the board.  You do all that off-line on your own
  110.         system in your own time.  
  111.  
  112.         AND ALL FOR FREE! So what's the catch?  Well, we do ask that you
  113.         let us know that you are using OMK.  Don't worry; this isn't a way
  114.         to send you a bill. Because of the author's job he is not allowed
  115.         to charge for this kind of work . . . so you're safe.  It's just
  116.         that we've spent a long time getting this system ready, and we're
  117.         really interested in the folks who are using it. 
  118.           
  119.         So, to let us know all you have to do is send Net Mail to:  
  120.          
  121.                          Sysop 1:261/1055  
  122.  
  123.           1:261/1055 is The Keeping Room BBS the main beta test site of 
  124.         OMK, and the Sysop is Anne Madison (the documentation guru for 
  125.         Opus Message Kit).  Or, if you don't have access to Net Mail a
  126.         brief note via U.S. Mail would be appreciated.  Send to:  
  127.                        Roland M. Brown III  
  128.                        7538 Main Street  
  129.                        Sykesville, Md. 21784  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.           
  145.         PLEASE, NO PHONE CALLS! EVEN ON YOUR DIME ROLAND CANNOT AFFORD THE
  146.         TIME.  
  147.  
  148.         While you're writing, let us hear your comments, complaints, and
  149.         compliments.  If you find a bug, heaven forbid, WE WANT TO KNOW
  150.         ABOUT THAT AS WELL.   
  151.  
  152.         DISCLAIMER:  OMKREAD is provided free of charge.  The program is
  153.         provided "as is" with no guarantees or warranties of any kind. 
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.         2.    SYSTEM REQUIREMENTS:  WHAT YOU NEED TO USE OPUS MESSAGE KIT 
  214.          
  215.         -     An IBM personal computer or true compatible with hard disk. 
  216.          
  217.         -     A TEXT EDITOR.  There are two requirements for the text       
  218.               editor:  
  219.          
  220.              (a)  It must accept the name of the file to be edited as its   
  221.                   first command-line parameter (for example, "ED FILENAME"
  222.                   or "Q FILENAME." 
  223.          
  224.               (b)    It must be capable of creating PURE ASCII TEXT FILES.  
  225.                      You cannot use your regular word-processor with OMK 
  226.                      unless it is capable of creating an ASCII (or DOS      
  227.                      Text) file.  Word-processors include control and other 
  228.                      codes in the documents they create which are 
  229.                      incompatible with OMK.  
  230.            
  231.              We recommend PC-WRITE, or QEdit, both user supported programs
  232.              readily available on most bulletin boards. OMK has been tested
  233.              with both of these editors and we know that they work well     
  234.              with OMK.  However, the program should work with any editor    
  235.              meeting those two requirements.   
  236.           
  237.         -    The PKZIP and PKUNZIP file compression programs.  Beginning
  238.              with this version of OMK, the use of PKZIP/PKUNZIP is
  239.              mandatory.  If you plan to use your reader on bulletin boards
  240.              using an older version of OMK you must also have a a file
  241.              compression program which creates ARC format files.  Three
  242.              which are   readily available are ARCA/ARCE, PKARC/PKXARC, and
  243.              PKPAK/PKUNPAK. 
  244.          
  245.         -    And, of course a communications program!  A REALLY NICE free
  246.              communications program is \/\/term written by Walter Cox who
  247.              was instrumental in helping with OMK.  With its autoZmodem
  248.              uploading and downloading it makes and IDEAL choice for
  249.              OMK/BBS messaging.  
  250.          
  251.         Version 2.0x of the OMK Reader will handle messages for all previ-
  252.         ous versions of OPUS Message Kit as well as QWK.
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.         3.    INSTALLING OPUS MESSAGE KIT ON YOUR SYSTEM 
  282.          
  283.         This section provides complete instructions for installation of the
  284.         OPUS Message Kit Reader on your PC.  The installation will include
  285.         the following steps: 
  286.          
  287.         -    Decide on, and create, directories on your hard disk for the
  288.              OMK reader, the text editor you have selected, the file
  289.              compression utilities, and bundles of messages coming into and
  290.              out of the OMK reader. 
  291.         -    Add the OMK directory to your path.  Optionally, add the
  292.              directories housing your editor and compression utilities to 
  293.              the path. 
  294.         -    Run the OMKREAD program and answer some configuration ques-
  295.              tions. 
  296.          
  297.         3.1   PREPARING YOUR SYSTEM 
  298.          
  299.               3.1.1  Create the OMK Subdirectory 
  300.          
  301.              Create a subdirectory on your HARD DISK for the OPUS Message
  302.              Kit.  You may name the subdirectory anything you like. 
  303.              Unarchive the reader OMK_READ.ARC into the subdirectory.   
  304.                
  305.               3.1.2  Create the Upload/Download Subdirectory 
  306.          
  307.              Decide which subdirectory on your system you would like to
  308.              download your messages to and upload your messages from.  It
  309.              is probably easiest to choose the subdirectory or sub-
  310.              directories you have already specified for this purpose in
  311.              your communications program (for example, C:\new or
  312.              C:\download).  
  313.          
  314.               3.1.3  Create the Message Subdirectories If Desired 
  315.          
  316.              Decide where you would like to keep the messages from each BBS
  317.              you will be calling which uses OMK.  In most cases, it is
  318.              simplest just to keep the messages in your main OPUS Message 
  319.              Kit subdirectory; however, you may specify any subdirectory
  320.              you choose.  OMK will create the actual BBS subdirectories. 
  321.          
  322.               3.1.4  Create the Editor Subdirectory 
  323.          
  324.              Decide on a subdirectory for your EDITOR if you don't already
  325.              have one set up.  Again, if you prefer, the editor can reside
  326.              in the OMK reader subdirectory.  
  327.          
  328.               3.1.5  Create the PKZIP Subdirectory 
  329.          
  330.              If you don't have one already, create a subdirectory on your
  331.              hard disk for PKZIP/PKUNZIP and the other ARC utility you've
  332.              selected.  Place the PKZIP/PKUNZIP utilities in this sub-
  333.              directory.  IF YOU'RE A NOVICE AT USING THESE KINDS OF
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.              UTILITIES, FAMILIARIZE YOURSELF WITH THEIR DOCUMENTATION. 
  349.              Most of them require simple, but very specific, installation
  350.              procedures before you can use them.  Become familiar with
  351.              these instructions before you begin to use OMK.  If you don't
  352.              plan to use a BBS with an old version of OMK, you won't need
  353.              the ARC utility.  If you don't wish to create a special
  354.              subdirectory for these utilities, they can be placed in the
  355.              same subdirectory with OPUS Message Kit.   
  356.          
  357.               3.1.6  Modify your PATH Statement 
  358.          
  359.              Add the OMK subdirectory to your PATH. You may also add the
  360.              archive utility subdirectory (if it is different), and the
  361.              Editor subdirectory (if it is different) to your PATH. If you
  362.              do not choose to do this, a path may be included when you
  363.              install OMK.  Set up a path by adding the following statement-
  364.              (s) to your autoexec.bat: 
  365.          
  366.               path=C:\omkread;C:\arcutils;C:\qedit 
  367.               (or whatever drive and sub-directory names you've chosen) 
  368.          
  369.              Be sure to REBOOT your computer after adding this statement so
  370.              that the PATH is in effect when you begin to use OMKREAD.   
  371.          
  372.         This completes your system preparation.  Next, you will be running
  373.         and configuring the reader.   
  374.  
  375.         3.2   RUNNING OMKREAD FOR THE FIRST TIME 
  376.          
  377.         You should run OMKREAD once before you have a message bundle to
  378.         read.  The first time you run it, several configuration options
  379.         will be set.  Be certain you have available the names and locations
  380.         of the subdirectories you created in Step 3.1 above.  You may want
  381.         to jot them down. 
  382.          
  383.               3.2.1  Required Subdirectories 
  384.          
  385.              The reader will find the subdirectory where its own program is
  386.              located and verify that this is where you want it to reside. 
  387.              This is the subdirectory you created in Step 3.1.1, above.  It
  388.              will then ask you where the inbound messages are and where to
  389.              put its replies. The answer to this question will be the
  390.              subdirectory you decided on in Step 3.1.2.   You will then be
  391.              asked where you would like OMK to "create" the BBS's you'll be
  392.              getting messages from.  This will be the subdirectory you
  393.              decided on in Step 3.1.3.  You will be asked to specify your
  394.              editor.  This will be the subdirectory you decided on in Step
  395.              3.1.4. 
  396.          
  397.               3.2.2  Your Screen Colors 
  398.          
  399.              OMK will next provide you with the opportunity to select your
  400.              screen colors using windows OMK provides for this purpose. 
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.              3.2.4  Your File Compression Utilities 
  417.          
  418.              You will be asked to select an ARCHIVE PROGRAM from a list. 
  419.              PKZIP will always be the default, but if you plan to use this
  420.              reader with messages prepared on a BBS using an older version
  421.              of OMK you MUST also have an ARC type program.  If you don't
  422.              plan to use OMK on bulletin boards using an ARC utility, don't
  423.              worry about it.  Just pick one from the list, even if you
  424.              don't have it. If you're in doubt about which utility is being 
  425.              used on any BBS, just ask the sysop. 
  426.           
  427.         3.3  UPGRADING FROM AN OLDER VERSION OF OMK 
  428.          
  429.         IF you are already using OMK and wish to upgrade to version 2.0,
  430.         follow these two steps: 
  431.          
  432.               3.3.1  Get a Copy of PKZIP/PKUNZIP 
  433.          
  434.              Be certain you have a recent copy of PKZIP/PKUNZIP and that it
  435.              is in a subdirectory on your path. 
  436.          
  437.               3.3.2  Unarchive the New OMK Reader 
  438.                
  439.              Unarchive a copy of the new reader in your current OMKREAD
  440.              subdirectory. The new reader will automatically pick up your
  441.              parameters from your old version. 
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.         4.  USING OPUS MESSAGE KIT ON AN OMK BBS 
  486.          
  487.         THAT'S IT!  The OPUS Message Kit reader has been installed, and
  488.         you're ready to log into your favorite OPUS Message Kit BBS and
  489.         DOWNLOAD SOME MESSAGES.   
  490.          
  491.         4.1  The Net/Node Number 
  492.          
  493.         While you're there, be sure to take CAREFUL note of your sysop's
  494.         FIDONET Net/Node number.  The number is unique on every BBS.  It
  495.         usually consists of two or three digits, followed by a slash, then 
  496.         three or four digits.  There may be some extra numbers included. 
  497.         Example: 
  498.          
  499.                                    1:261/1055.0 
  500.          
  501.         The important digits here would be 261/1055.  The Net/Node number
  502.         is often displayed on the BBS's opening screen (what you see when
  503.         you first log in).  If you don't see it, make a point of asking the
  504.         sysop.  Your message and reply bundles will be named using this
  505.         net/node number, so for the above system the file names would be: 
  506.          
  507.                      02611055.REZ (for the reply bundles you upload) 
  508.                      02611055.OKZ (for message bundles you download) 
  509.          
  510.         4.2  The OPUS Message Kit Bundler 
  511.          
  512.         The following overview is divided into two parts.  Section 4.2.1
  513.         refers to bulletin board systems where the sysop has enabled 
  514.         message downloading and uploading from within OMK.  Section 4.2.2
  515.         provides instructions for those systems where this feature is not
  516.         enabled.  Ask your sysop which procedures you should follow.   
  517.          
  518.          
  519.               4.2.1  Boards Which Use OMK for Message Uploads/Downloads 
  520.          
  521.              Follow the sysop's instructions for getting into OPUS Message
  522.              Kit on the BBS.  You are presented with a list of message
  523.              areas; they're the same areas you normally see on the bulletin
  524.              board.  You may select any of these areas to receive in your
  525.              Reader.  Select the desired message areas by typing their
  526.              numbers in, one at a time, each followed by a space.  Press
  527.              <enter> when you have completed your selections. 
  528.          
  529.              You are next asked for a DATE from which to begin bundling. 
  530.              If this is your first time using the reader, you'll automatic-
  531.              ally be given the date on which the sysop last configured OPUS
  532.              Message Kit on the BBS. Your first OMK session will be easier
  533.              and more successful if you enter YESTERDAY'S DATE here. 
  534.              Popular message areas receive many new messages every day, and
  535.              you can quickly find yourself with a message bundle which is
  536.              too large to manage easily.  So be conservative on your first
  537.              visit.  You'll soon develop a feel for how often you need to
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.              download your messages.  On your second and subsequent calls,
  553.              your default date will be the last date you received messages. 
  554.              Occasionally (not on your first call) you may need to RESELECT
  555.              your message areas.  This simply means that the sysop  has
  556.              been doing some work on the configuration of OMK.  
  557.          
  558.              You are next asked if you wish to download your messages.  Two
  559.              file transfer protocols are provided:  Zmodem and CRC Xmodem. 
  560.              If you wish to download your messages from within OMK, answer
  561.              Y(es) and start the download on your system just as you would
  562.              for any other file transfer.  Check your communications prog-
  563.              ram for instructions on how to use it to download files. 
  564.  
  565.              After you have downloaded your new messages, you will be asked
  566.              if you wish to upload a bundle of messages to the board. 
  567.              Answer "Y" if you have messages to upload.  You will be asked
  568.              to select a file transfer protocol--Zmodem or CRC Xmodem. 
  569.              Type in the number of the protocol you wish to use.  Your
  570.              reply bundle (if you have one) is automatically named
  571.              NNNNNNNN.REZ, "N" being the Fidonet net/node number of the
  572.              bulletin board.  For net/node number 261/1055, the reply
  573.              bundle would be named 02611055.REZ. The reply bundle is
  574.              located in the directory of your hard disk which you specified
  575.              in Section 3.1.2, above.  Start the upload by following the
  576.              procedures in your communications program for uploading files.
  577.              It's IMPORTANT not to upload your messages to any area of the
  578.              board other than that specified by the sysop.  When you have
  579.              finished uploading your bundle, you are ready to exit the OMK
  580.              bundler.
  581.  
  582.              That's it.  Do whatever else it is you normally do when
  583.              "visiting" the BBS, then log off and you are ready to read and 
  584.              respond to your messages using the OMK Reader you've installed 
  585.              on your own system. 
  586.          
  587.                4.2.3  Boards Which Use a File Area for Message  
  588.                      Uploads/Downloads 
  589.          
  590.              Follow the sysop's instructions for getting into OPUS Message
  591.              Kit on the BBS. You are presented with a list of message
  592.              areas; they're the same areas you normally see on the bulletin
  593.              board.  You may select any of these areas to receive in your
  594.              Reader.  Select the desired message areas by typing their
  595.              numbers in, one at a time, each followed by a space.  Press
  596.              <enter> when you have completed your selections. 
  597.  
  598.              You are next asked for a DATE from which to begin bundling. 
  599.              If this is your first time using the reader, you'll
  600.              automatically be given the date on which the sysop last
  601.              configured OPUS Message Kit on the BBS. Your first OMK session
  602.              will be easier and more successful if you enter YESTERDAY'S
  603.              DATE here. Popular message areas receive many new messages
  604.              every day, and you can quickly find yourself with a message
  605.              bundle which is too large to manage easily.  So be
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.              conservative on your first visit.  You'll soon develop a feel
  621.              for how often you need to download your messages.  On your
  622.              second and subsequent calls, your default date will be the
  623.              last date you received messages. Occasionally (not on your
  624.              first call) you may need to RESELECT your message areas.  This
  625.              simply means that the sysop has been doing some work on the
  626.              configuration of OMK.  
  627.          
  628.              Next, exit OMK and return to the bulletin board. As you leave
  629.              OMK, you are directed to a file area (NOT A MESSAGE AREA) on
  630.              the board which the sysop has set up for OPUS Message Kit. You
  631.              see your message bundle waiting there for you, and you can
  632.              download it with any transfer protocol used on the board.
  633.              Check your communications programs for instructions on how to
  634.              use it to download a file.  Check with your sysop if you need
  635.              instructions for how to download a file from the file area. 
  636.  
  637.              After you have downloaded your new messages, you will be asked
  638.              if you wish to upload a bundle of messages to the board. 
  639.              Answer "Y" if you have messages to upload.  You may use any
  640.              transfer protocol offered by the bulletin board to upload your
  641.              reply bundle.  Your reply bundle (if you have one) is
  642.              automatically named NNNNNNNN.REZ, "N" being the Fidonet
  643.              net/node number of the bulletin board.  For net/node number
  644.              261/1055, the reply bundle would be named 02611055.REZ. The
  645.              reply bundle is located in the directory of your hard disk
  646.              which you specified in Section 3.1.2, above.  Start the upload
  647.              by following the procedures in your communications program for
  648.              uploading files. 
  649.          
  650.              IMPORTANT:  Don't upload your reply bundle to any other area
  651.              on the board.  Don't use the special OMK area to upload any
  652.              other files. 
  653.           
  654.              That's it.  Do whatever else it is you normally do when
  655.              "visiting" the BBS, then log off and you are ready to read and 
  656.              respond to your messages using the OMK Reader you've installed
  657.              on your own system. 
  658.  
  659.              BBSes with QWK provide similar facilities allowing you to
  660.              designate areas to bundle and to download messages and upload
  661.              replies.
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.         5.    USING YOUR OMK READER 
  690.          
  691.         5.1   Getting Into the OMK Reader 
  692.           
  693.         Users of DOS 2.x MUST always CD (change directory) to the OMK
  694.         directory BEFORE using the reader.  When using 3.x or greater OMK
  695.         can find its directory no matter where you call it from as long as
  696.         the directory is EITHER in your path statement or explicitly
  697.         specified (i.e. d:\omk\omkread).  
  698.          
  699.         When you run the reader it will check (messages you have just
  700.         downloaded) from the BBS. The messages will be unbundled and 
  701.         prepared for reading.  You can keep messages from many bulletin
  702.         board systems on your system; OMK will keep track of them within
  703.         the reader.  
  704.          
  705.               5.1.1  Command Line Options 
  706.          
  707.                                         -l 
  708.          
  709.              This command line switch tells OMK to bypass displaying the
  710.              BBS logo when you "logon" the BBS in the reader.  Normally, if
  711.              the BBS sends you a logo file, it is always displayed when you
  712.              select that BBS with your reader.  If you use the -l option
  713.              that file is not displayed.  The "Logo" command on the main
  714.              menu allows you to display the logo while you are reading
  715.              message.  This is useful since some bulletin boards send
  716.              useful information (such as a list of new uploads) in their
  717.              logo files. 
  718.          
  719.          
  720.                                         -b
  721.  
  722.              This option allows you to use the BIOS video routines rather
  723.              than OMK's normal direct memory video routines.  While this
  724.              option slows OMK's screen display CONSIDERABLY, it does allow
  725.              the reader to run as a "well-behaved" program under certain
  726.              multi-tasking systems such as DesqView. 
  727.          
  728.                                         -r
  729.          
  730.              This option allow you to RETAIN messages between unbundles. 
  731.              Prior to this version OMK_READ always deleted old messages on
  732.              the reader when there were new messages to unbundle.  With
  733.              this option the reader will add new messages to the end of
  734.              each area.  This works well when you only track small message
  735.              areas on a BBS.  Be warned that when you attempt this with a
  736.              large area like DR_DEBUG you will need LOTS of disk space! 
  737.              You can delete messages from the Main Reader Menu if disk
  738.              space becomes a problem.
  739.  
  740.  
  741.          
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.         5.2   THE MAIN MENU 
  757.          
  758.         The main menu provides you with the following options: 
  759.  
  760.         -    Log on:  OMK will show you a list of available BBSes and
  761.              permit you to select the BBS you want to work with. OMK does 
  762.              this by checking for existing message bundles you have
  763.              downloaded.   
  764.           
  765.         -    Reconfigure:  Allows you to reset your OMK system parameters
  766.              including: paths to inbound messages and outbound replies;
  767.              your text editor, your archive program, the location of the
  768.              BBS messages, and the screen color settings.  If you change
  769.              the location of your inbound messages (FROM THE BBS) you will
  770.              need to quit OMKREAD and call it again for that new directory
  771.              to take effect.  This is not necessary if you change the
  772.              directory for the outbound messages. That change takes effect
  773.              immediately. 
  774.          
  775.         -    Delete Msgs:  Allows you to delete ALL messages for any BBS.
  776.              You are stepped through each BBS which has messages and
  777.              allowed to select whether or not to delete messages for that
  778.              BBS.  A bundle of replies is forced before ANY messages are
  779.              deleted, as a safeguard.  
  780.  
  781.         -    Params:  Will show you your parameters that you have set for
  782.              OMKREAD.
  783.           
  784.         -    Quit:  Quits the OMK READER.  A scan of all BBS message areas
  785.              and a bundle of any replies is done prior to exiting the
  786.              program.  You are also given an opportunity to delete any OLD
  787.              reply bundles from your outbound reply area.  
  788.          
  789.          
  790.         5.3  Reading Messages for a BBS  
  791.          
  792.         Use "LOGON" from the main menu to select the BBS whose messages you
  793.         want to read and reply to.  If this is your first time out, you'll
  794.         probably only have one BBS to choose from.  Simply type in the
  795.         number of the BBS you've selected.  Once you have selected your
  796.         BBS, read the messages by following the steps in this section.
  797.          
  798.               5.3.1  Start with a Message Area 
  799.  
  800.              Once you've selected a BBS you'll be presented with a list of
  801.              message areas.  Each will have its own OMK message area
  802.              number, a descriptive title, and the number of messages to be
  803.              read.  Areas where there are new messages will be highlighted.
  804.              (CGA USERS NOTE: This highlighting does not show up well with
  805.              some color combinations.) 
  806.          
  807.               5.3.2  Message Options
  808.  
  809.              Once you have selected a message area, a blank message screen
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.              will appear. You will find that reading through the messages
  825.              is very similar to the process you use when reading them on a
  826.              BBS.  The following message options are provided at the bottom
  827.              of your screen: 
  828.          
  829.              -    NEXT: Read the next message 
  830.          
  831.              -    PRIOR: Read the previous message 
  832.          
  833.              -    REPLY: Reply to the message you are reading 
  834.          
  835.              -    WRITE:  Enter a new message 
  836.          
  837.              -    MSG#: Read a specific message (by number) 
  838.          
  839.              -    KILL: Kill a message or reply (by number) 
  840.          
  841.              -    AREA: Change to another message area 
  842.          
  843.              -    XPORT: Export (save) a message to a separate text file on
  844.                   your disk (useful for messages which contain information
  845.                   you might want save for future reference). OR Save a
  846.                   message to your printer by specifying PRN LPT1 LPT2 etc. 
  847.          
  848.                   If you specify an existing file OMK will append the
  849.                   message to that file (add it to the end).  You could
  850.                   specify a file name like CECHO.DAT and put any messages
  851.                   you want to track from the C_echo into that file. 
  852.          
  853.              -    LOGO:  Re-display the BBS logo for the current BBS. Note:
  854.                   you can use the command line parameter -l (lower case l)
  855.                   to bypass the logo display when you log onto the BBS
  856.                   using the reader. 
  857.          
  858.              -    INQUIRE:   Find a text string in a message header (TO,
  859.                   FROM, SUBJECT)
  860.          
  861.              -    SHELL:  Jump to DOS on your system.  Return to OMK by
  862.                   typing "EXIT"  
  863.  
  864.              -    BYE:  Quit reading messages and return to the main OMK
  865.                   menu. You can also do this by pressing ESCAPE. 
  866.          
  867.              All of these options are HOT KEYS. Just press the first
  868.              CAPITAL letter of the desired option.  All return to "Next"
  869.              after completion except Prior which is 'sticky' like Next. 
  870.  
  871.              WHEN you are reading messages and this menu is NOT visible you
  872.              can use the PGUP/PGDN and up and down ARROW keys to scroll
  873.              your messages on screen.
  874.          
  875.          
  876.         5.4   Writing or Replying to Messages 
  877.          
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.               5.4.1  Message Headers 
  893.          
  894.              When you decide to write or answer a message (by selecting the
  895.              WRITE or REPLY option), you'll be asked to enter the header
  896.              (TO, FROM, SUBJECT) if it's a new message.  If it's a reply,
  897.              you'll be asked to accept or change the SUBJECT.  You will
  898.              also be asked if the message is public or private.  Messages
  899.              are automatically public unless you specify private by
  900.              answering "No" to the prompt. 
  901.          
  902.               5.4.2  The Message Text 
  903.          
  904.              Your text editor will now come into play.  You'll be presented
  905.              with the main editing screen of the editor you selected when
  906.              you installed OMK. If you are creating a reply, you will see
  907.              the entire text of the original message displayed Edit out
  908.              portions of the original message you don't want to quote, and
  909.              type in your reply. If you are entering a new message, you can
  910.              simply begin typing the message. 
  911.          
  912.               5.4.1  Saving your Message 
  913.          
  914.              When you have completed the message or reply, USE WHATEVER
  915.              COMMAND YOU NORMALLY USE IN YOUR EDITOR TO QUIT AND SAVE A
  916.              FILE.  OPUS Message Kit will take the message you have just
  917.              created and save it to be bundled with other messages and
  918.              replies.    
  919.          
  920.         You can continue reading, writing, and replying to messages.  When
  921.         you're ready to change to a new message area, select AREA CHANGE
  922.         from the menu at the bottom of your screen.   
  923.          
  924.         5.5  FINISHING UP 
  925.          
  926.         When you are ready to stop reading and replying to messages, select
  927.         BYE (or press ESCAPE).  You can go on to read messages from another
  928.         BBS or exit the Reader.   
  929.          
  930.         When you exit the Reader, you will see the it packing up your
  931.         replies for each BBS and placing them in the upload subdirectory
  932.         you specified when you installed it. You'll be given the
  933.         opportunity to DELETE any old message packets that exist. IT IS
  934.         BEST TO GET INTO THE HABIT OF DOING THIS IF YOU HAVE ALREADY
  935.         UPLOADED THE REPLIES IN THE OLD PACKET. You do not have to delete
  936.         old replies if you are not sure whether or not you have uploaded 
  937.         them.   
  938.  
  939.         HOWEVER with QWK format BBS you SHOULD delete old replies since
  940.         MOST QWK systems we have encountered DO NOT have the sophisticated
  941.         date checking routines OMK uses to prevent DUPES to the BBS.  If
  942.         you keep uploading QWK.REP packets that you have uploaded before
  943.         you may get (understandably) NASTYGRAMS from the Sysop.
  944.  
  945.          
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.         OMK date stamps each  bundle within each outbound message archive.
  961.         The BBS unbundler will not create duplicate messages on the BBS. 
  962.         IT IS ALWAYS WISER to delete your old replies yourself.  If you
  963.         don't, you may eventually get a "nastygram" from the sysop because
  964.         OMK on the bulletin board takes extra time to process old messages. 
  965.         So make it a habit to DELETE YOUR REPLY BUNDLES after you have
  966.         uploaded them.       
  967.          
  968.         Opus Message Kit can handle multiple sessions of the reader.  Say,
  969.         for instance, that you've downloaded some messages from a BBS and
  970.         written replies and some new messages, and then said BYE.  You then
  971.         quit OMK and your replies/messages are bundled.  You decide it is
  972.         too late to log onto the BBS and go to bed, or you suddenly
  973.         remember that there is another message you need to write.  You call
  974.         the reader again, log onto the BBS and write more messages, say BYE
  975.         and quit again.  OMK bundles your messages and date/time stamps
  976.         them and ADDS then to the bundle that it created earlier.  No
  977.         messages are lost. 
  978.          
  979.  
  980.         5.6  A WORD OF WARNING: YOUR SYSTEM DATE 
  981.           
  982.         Opus Message Kit is DATE SENSITIVE.  Please be certain that you
  983.         enter the system date and time correctly, or that your system clock
  984.         is correct.  One OMK user didn't notice that his system clock had
  985.         somehow been set for the year 2074.  He created a bundle of
  986.         messages with that date and uploaded them.  The next time he
  987.         attempted to use OPUS Message Kit on that BBS (after he had
  988.         corrected his system clock), OMK refused any of his bundles because
  989.         they were all dated prior to 2074 (naturally).  If this should
  990.         happen to you ask the sysop to check and possibly reset your last
  991.         date bundle using the BBS program OMK_USRM.EXE.    
  992.  
  993.         5.7 USING OMKREAD WITH A QWK BBS
  994.  
  995.         QWK BBS messaging is very similar in concept to OMK.  There are a
  996.         few differences, however, which you should know about.  First, QWK
  997.         BBSes often let you choose between various archive methods.  When
  998.         using OMKREAD YOU MUST CHOOSE PKZIP!!  
  999.  
  1000.         The file name will NOT be the net/node numbers you use on an OMK
  1001.         BBS.  Instead, the sysop assigns a name.  For example, Anne
  1002.         Madision calls her QWK packets TKR.QWK and the replies for her BBS
  1003.         will always be TKR.REP.  You don't need to worry about this OMKREAD
  1004.         takes care of all of this automatically.  You will only need to
  1005.         remember that *.REP files are QWK replies, while *.QWK files are
  1006.         QWK messages from the BBS.  OMKREAD will keep them separate.  
  1007.  
  1008.         You'll only need to remember the name that goes with each BBS when
  1009.         time comes for you to upload your replies (*.REP) to the BBS. 
  1010.         Don't worry most sysops assign names that you will easily associate
  1011.         with their BBS -- like TKR for The Keeping Room, or AVITECH!.REP
  1012.         for Avitechnic BBS, or TNCBBS.REP for the Nerve Center BBS. 
  1013.         Simple!!
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.         6.   THAT'S IT!
  1029.  
  1030.         We hope you'll find OPUS Message Kit convenient and easy to use. 
  1031.         Please feel free to share it with other boards and users. We ask
  1032.         only that you distribute the archive in its original form. Don't
  1033.         forget to LET US KNOW ABOUT YOUR EXPERIENCES with it.
  1034.  
  1035.         6.1  BUG REPORTING INSTRUCTIONS
  1036.  
  1037.         Please help us with future releases of OPUS Message Kit by
  1038.         reporting bugs as follows:
  1039.  
  1040.         Send to: 261/1055 with the following information:
  1041.  
  1042.              BBS side and User:
  1043.  
  1044.              What where you trying to do?
  1045.              Describe the Bug or problem.
  1046.              What is your Operating system version?
  1047.              Were you running any TSR's?
  1048.              Hardware configuration?
  1049.              Any other programs running?
  1050.              Any other information which might be helpful.
  1051.              How we can contact you if need be?
  1052.              What error message, if any, did you get?
  1053.          
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.                                   SPECIAL THANKS
  1097.          
  1098.         To Walter Cox (a.k.a. \/\/ Cox).  
  1099.         If anyone is responsible for the creation of Opus Message Kit it is
  1100.         Walter.  He started the idea for this reader by noting that a
  1101.         couple of the utilities Roland had written had some of the features
  1102.         needed for an off-line message reader.  With \/\/'s constant
  1103.         encouragement/nagging :-) - Roland developed Opus Message Kit. 
  1104.         Walter is also responsible for hours of testing and debugging and
  1105.         developed the scripts included for use with your comms program. 
  1106.         \/\/ is the moderator for a local communications echo (\/\/'s
  1107.         CommPort) here on Net 261. 
  1108.          
  1109.         To Anne Madison.  
  1110.         Sysop of The Keeping Room. Anne graciously consented to allowing
  1111.         her BBS to be the Test Bed for OMK.  She allowed The Keeping Room
  1112.         to be hung-up, grunged, and over-used by beta testers so that we
  1113.         could present to the BBS community a solid package.  In spite of
  1114.         what we did to her BBS she kept her good humor and gracious manner. 
  1115.         She is also responsible for taking the burden of the documentation.
  1116.  
  1117.          
  1118.         To Marek Majewski.  
  1119.         Sysop of the PainFrame BBS.  Marek is responsible for getting all
  1120.         of us who call ourselves PainFrame Pointers together in the first
  1121.         place.  Without him none of this would have come about because none
  1122.         of us would have met. 
  1123.          
  1124.         To the following bulletin boards and sysops participating in
  1125.         testing OPUS Message Kit. 
  1126.  
  1127.         1:261/1000     The Nerve Center                   Alan Hess 
  1128.         1:261/1040     SarComm                            Sara Grace 
  1129.         1:261/1026     The Electronic Circuit Rider       Craig Duerling 
  1130.         1:261/1055     The Keeping Room                   Anne Madison  
  1131.         1:261/1082     Wit-Tech                           Doug Wittich
  1132.  
  1133.         OTHER NET 261 TESTERS
  1134.  
  1135.                        Outside the Wall                   Rob Novak
  1136.                        Dave's Doghouse                    Dave Maczis
  1137.                        The Breezeway                      Daryl Martin 
  1138.                        AviTechnic                         Tom Hendricks
  1139.                        GreyHawk (RBBS & RIME)             Walter Ames
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.         APPENDIX 1:  SOFTWARE AND PROGRAMS RECOMMENDED FOR USE WITH OPUS
  1165.         MESSAGE KIT
  1166.  
  1167.         THE OPUS COMPUTER BASED CONVERSATION SYSTEM: Copyright 1886, 1987
  1168.         by Wynn Wagner, III. All Rights Reserved.
  1169.  
  1170.         ARCE (c) Copyright 1986-1988 by Wayne Chin and Vernon D. Buerg
  1171.         ALL RIGHTS RESERVED.
  1172.  
  1173.         PKZIP/PKUNZIP, PKARC/PKXARC, PKPAK/PKUNPAK: Phil Katz, PKware,
  1174.         Inc., 7545 N. Port Washington Rd. Suite 205, Glendale, WI 
  1175.         53217-3422
  1176.  
  1177.         QEDIT (c) Copyright SemWare (tm) 730 Elk Grove Ct., Kennesaw, Ga.
  1178.         30144-4047.
  1179.  
  1180.         PC-WRITE (c) Copyright Quicksoft, 219 First N. #224, Seattle, Wa.
  1181.         98109.
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.         APPENDIX 2:  FOR THE TECHNICALLY MINDED!!
  1233.          
  1234.         ALL THOSE LITTLE FILES!!!!  ARE NOW GONE!!
  1235.          
  1236.  
  1237.         With version 2.0 you now do not have a file for each message, but
  1238.         rather one file per message area (two counting the index file).
  1239.  
  1240.  
  1241.         HARDCOPY (c) is one of those.  It is a utility written by the 
  1242.         author of OMK and allows the user to track messages by name, and/or
  1243.         date a produce a printed output of those messages.  It is used by
  1244.         many people to keep a record of messages in a particular ECHO that
  1245.         are directed to, or sent from, them.  You may find other useful
  1246.         utilities as well.  In addition, you can write programs you might
  1247.         want to operate on OMK messages simply by knowing the format is the
  1248.         same as OPUS messages (no proprietary files to figure out). 
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.