home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / rbbs_pc / pu173.arc / PU_HELP.TXT next >
Text File  |  1990-02-12  |  9KB  |  210 lines
  1.                   PU173 HELP File
  2.                      February 13, 1990
  3.  
  4. * This file can be viewed while using PU173 by pressing the F10 key! *
  5.  
  6.                       *** NOTICE ***
  7.  
  8.   PU173 is hereby released FREE to any/all Sysops who wish to use it.
  9.   No warranty or guarantee is given and the author will NOT be held
  10.   responsible for any damage or loss of information caused by the use
  11.   of this program. Every attempt has been made to ensure this program
  12.   is free of defects and bugs and works as intended by the author.
  13.  
  14.                  *** END OF DISCLAIMER ***
  15.  
  16.  
  17.  - Be sure you KNOW the name of your USER file and the SUBDIRECTORY
  18.     and PATH where it is LOCATED.
  19.     When entering information at the prompts,  leading and trailing
  20.     "\"s should NOT be entered. Also do NOT enter the USER file name
  21.     in the PATH. It will be requested after the subdirectory has been
  22.     verified. If you press RETURN without entering anything else at
  23.     the PATH prompt, a single "\" will be used for the PATH. That
  24.     means the USER file will HAVE to be in the ROOT directory for
  25.     PU173 to find it!
  26.  
  27.    Example: C:\RBBS\MAIN\USER.DEF is your complete path and user file
  28.  
  29.         "C:" is entered from the Vertical Menu for Drive Selection.
  30.  
  31.     Then the PATH prompt box appears. You should enter:
  32.  
  33.     rbbs\main         [capitalization is not necessary anywhere!]
  34.  
  35.     Then you will be prompted for your USER file name, enter:
  36.  
  37.     USER.DEF          [capitalization is not necessary anywhere!]
  38.  
  39.     PU will save the string "C:\RBBS\MAIN\USER.DEF" in a file named
  40.     PU.CFG for all subsequent use. If at any prompt, the information
  41.     is entered incorrectly or the subdirectory or file does not exist,
  42.     an ERROR message will be shown describing the problem.
  43.  
  44. -  The F1 Key will pop up the "Quick Help" screen. This screen shows
  45.    most of the information necessary to operate the program. 
  46.             [ESC will return you to where you were.]
  47.  
  48. -  The F3 Key will swap the users first and last name (IE: JOHN SMITH
  49.    becomes SMITH, JOHN - This is for both screen and printer output)
  50.    This is shown in a couple of places as the Left/Right Arrow.
  51.    The Right Arrow means the name will be displayed in normal FIRST
  52.    then LAST name order.
  53.    The Left Arrow means the name will be display "backwards" as LAST,
  54.    then FIRST name order.
  55.  
  56. -  The F4 Key will swap between NORMAL [or NOT SORTED] and SORTED. An
  57.   "N" will be shown for Normal [NOT SORTED] and an 'S' will be shown
  58.    for SORTED.
  59.  
  60. -  The F5 Key will swap between A to Z order (Down Arrow displayed)
  61.    and Z to A order (Up Arrow displayed) - You WILL NOT be able to
  62.    select A to Z or Z to A UNLESS the SORT option is selected. (The
  63.    "S" must be selected using the F4 Key!) 
  64.  
  65. -  The F10 Key will pop up a window "reader" that will display the
  66.    PU_HELP.TXT file. (This file!) You can alter/add/change/delete or
  67.    modify this file in any way you wish. That means you can add your
  68.    own help notes or whatever you wish. The width of the window is
  69.    set to 70 columns so you should try to follow that format to make
  70.    things readable without moving to the right. The file length may
  71.    be up to 16834 bytes long.
  72.  
  73. -  Here is a sample command line call for PU173:
  74.  
  75.     C>PU173 1 OFF OFF /B
  76.  
  77.    The 1   = LPT1 for Printer Output (Default if NOT selected)
  78.    1st OFF = Sound Off
  79.    2nd OFF = Sound Off
  80.    /B      = FORCE Monochrome display
  81.  
  82.    NOTE: If the LPT port and the NOISE OFF parameters are used
  83.          they MUST be in the order SHOWN!
  84.  
  85.        C>PU173 /b
  86.  
  87.    Will start the program with the default of LPT1, all sound on and
  88.    will force Mono display.
  89.                  
  90.    Of course just C>PU173 will start the program in color with all the
  91.    noise included and send output to LPT1.
  92.  
  93.     Special Information for CREATE DELIMITED FILE
  94.  
  95.  * Please note the information in the file produced by PU173 is NOT in
  96.    the same order as the info is located in the user file! The USERS
  97.    ARE listed in the same order as in the USER file.
  98.  
  99.    Each users record is written on a single line in this form:
  100.  
  101.    "UserName","CityState","PassWord","LastDateTimeOn","UserDnlds" _
  102.  
  103.    If the actual users file contains a "deleted" user or a "NewUser"
  104.    record, that record is NOT written to the delimited file.
  105.  
  106.    Shown here for ease of creating your twenty-four fields for a
  107.    database with the MAXIMUM width the field COULD have.
  108.    The ON/OFF switches for many of the users options have been
  109.    converted to .T. and .F. for use as logical fields in your
  110.    database. (Those with a WIDTH of '1')
  111.  
  112.     FIELD                  WIDTH
  113.  
  114. 1    UserName            -    31
  115. 2    CityState        -    24
  116. 3    PassWord        -    15
  117. 4    LastDateTimeOn      -   14
  118. 5    UserDnlds           -     4
  119. 6    UserUplds           -    4
  120. 7    SubDateStart        -    8
  121. 8    SecLevel            -    6
  122. 9    Graphics            -    5
  123. 10    Protocol            -    8
  124. 11    NumOfLogOns         -    6
  125. 12    RightMargin         -    3
  126. 13    Echo                -    1
  127. 14    PromptBell          -    1
  128. 15    ExpertUser          -    1
  129. 16    Nulls               -    1
  130. 17    UpperCase           -    5
  131. 18    LineFeeds           -    1
  132. 19    CheckBulletLogon    -    1
  133. 20    AutoDownDesired     -    1
  134. 21    ReqQuesAnswered     -    1
  135. 22    MailWaiting         -    1
  136. 23    Hilite              -    1
  137. 24    TurboKeyUser        -    1
  138.  
  139.   Here is one line written by PU173 in delimited format:
  140.   (No "wrapping" is done! The line ends in column 167 -
  141.   You will have to use the Right Arrow to move to the
  142.   end of the line if you are viewing this file with the
  143.   F10 key selection - Ctrl + Left Arrow will move you
  144.   quickly back to the start of the line!)
  145.  
  146. "GARY PETERSON","MAHTOWA, MN.","XXXXXX","02-10-90 17:26"," 1"," 290","05-30-89"," 10","COLOR","Zmodem"," 741"," 72","T","F","T","F","BOTH","T","F","F","T","F","T","F"
  147.  
  148.   The same line broken down as to it's designation in the user file:
  149.   (Note: The '*' means the NUMBER was converted to a string using the
  150.   STR$(Value) function. [Easy to tell because of the leading blank!]
  151.   You may need to know this if you wish to convert them when placed
  152.   into your database.)
  153.  
  154.   "GARY PETERSON",  -    Users Name
  155.   "MAHTOWA, MN.",   -    City and State
  156.   "XXXXXXX",        -    PassWord
  157.   "02-10-90 17:26", -    Last Date and Time On the system
  158.   " 1",            -    *Number of Downloads (Ever)
  159.   " 290",        -      *Number of Uploads (Ever)
  160.   "05-30-89",        -    Beginning of Subscription period
  161.   " 10",        -    *Security Level
  162.   "COLOR",        -    Users Choice (Color, ASCII or None)
  163.   "Zmodem",         -    Protocol Choice (Xmodem, CRC, etc. OR (Unk)
  164.   " 741",           -    *Number of Calls to system
  165.   " 72",        -    *Page Width for Messages
  166.   "T",            -    Echo
  167.   "F",            -    Prompt Bell
  168.   "T",            -    Expert User
  169.   "F",            -    Nulls
  170.   "BOTH",        -    Upper/Lower Case (otherwise UPPER is shown)
  171.   "T",            -    Linefeeds
  172.   "F",            -    Read New Bulletins at Log On
  173.   "F",            -    Automatic Downloading
  174.   "T",            -    Required Questionnaire Answered
  175.   "F",            -    Mail Waiting
  176.   "T",            -    HiLite
  177.   "F"            -    Turbo Key
  178.  
  179.   Not ALL information is written in this file or shown by the main
  180.   program. IF the sysop has chosen to RESTRICT downloads there are
  181.   fields that contain that information. Personally, I use that option
  182.   for new users until they subscribe to my system but I did not have
  183.   any use for the information and that is why it is not included in
  184.   this program. Also the COLOR choices (by number) are in the users
  185.   file. Again, I don't care what colors a user selects...
  186.  
  187.   I used dBase IV and made all fields CHARACTER fields. I then
  188.   "imported" the data. Then went back and modified the fields to
  189.   NUMERIC and DATE for the fields that contained info that I may want
  190.   to do MATH on... like User Downloads (Ever) etc.
  191.   I also changed the Begin Subscription Date to a DATE field and it
  192.   worked fine.
  193.   I may alter the program to allow you to split the First Name and
  194.   Last Name into two seperate fields... the same for the users City
  195.   and State. Also thinking I should allow the program user to select
  196.   the name for his delimited file....
  197.  
  198.    All comments regarding this program may be left as public messages
  199.    to the Sysop on:
  200.  
  201.                           ***BIGTOP*** RBBS
  202.               Mahtowa, MN. 55762
  203.                             (218)389-6009
  204.                             12/24/96 HST
  205.                            24 Hours a day                            
  206.                          Gary Peterson, Sysop
  207.  
  208.                               Thank you!
  209.  
  210.