============================================================================
                GetUser Reader, v2.0 README! by Dotoran!
============================================================================

What Is It?
~~~~~~~~~~~
    This is a short utility that will give you a command you can use from ANY
prompt within CNet, in order to find what data is located IN that location.
With additional arguments, you also have the power of reading this location
as either the default DECIMAL value, a CHARACTER value, a HEXADECIMAL value,
or a BINARY value. The CHARACTER and BINARY displays can also include a 3rd
argument specifying the LENGTH of the value, as 8, 16, 24, or 32-bits.

How Do I Install It?
~~~~~~~~~~~~~~~~~~~~
1: Copy the "GetUserReader" file somewhere in your system. I suggest leaving
   it in the "GU40Pack/", then copying the directory somewhere. I placed mine
   in a TEXTS: path(which is what I caall my gfiles now). Also place this
   README file in the same location, so as not to lose it.

2: Add the following line to the bottom of Menu # 2, Available Everywhere,
   which is found in the text file "CNET:BBSMENU":

        GU, GS      `31 | {#0<path>GetUserReader}
                    |     |
                    |     `--> A Control-Q Character.
                    |
                    `--------> Who has Access to USE this file?

3: Now SAVE your BBSMENU file using the RAMIGA-T key combination WHILE you're
   Control Panel is selected, and you'll be ready to use this command!

How Do I Use It?
~~~~~~~~~~~~~~~~
    The "GU" command takes three optional arguments, as shown below:

GU value mode[<Decimal> Character Binary HeXadecimal] size[<8> 16 24 32]

    The "GS" command takes four optional arguments, as shown below:

GS id value mode[<D> C B H] size[<8> 16 24 32]

    If either command is followed using the argument "?", you will be shown
a usage line for each command.

    The "id" argument, used only with the "GS" command, specifies WHICH ID
Number to load into memory, BEFORE the GETSCRATCH value is read. This allows
you to select ANY account to "peek into". If this argument is NOT specified,
the program will ASK you which ID Number to load in.

    The "value" argument should be a valid GetUser Number:

          1 thru 102     - Predefined SHORT GetUser values.
    1x00000 thru 1x15490 - Long Offsets in the PortData structure.
    2x00000 thru 2x28220 - Long Offsets in the MainPort structure.
    3x00000 thru 3x00573 - Long Offsets in the PortDataExtension struct.
    4x00000 thru 4x00992 - Long Offsets in the MainPortExtension struct.

    If this argument is NOT given, you will be ASKED for a GetUser value once
the program has loaded.

    The "mode" can either be the FIRST LETTER of the keyword, or as much of
the keyword as you wish to type, as only the FIRST LETTER will be used in
determining the mode. In addition, the letter "X" may be used for Hexadecimal,
as well as "H". This argument determines HOW the GETUSER value will be READ
and DISPLAYED to you on screen. DECIMAL will be the default mode if not given
as an argument.

    The "size" argument is only valid if the MODE above is set to BINARY or
CHARACTER. This value should be one of the following: 8, 16, 24, or 32. Any
OTHER value specified will be converted to an "8". The value of "8" will
also be used as the default if this argument is NOT given.

Once all data has been entered, you will be shown a line similar to below:

[????] GetUser    "???" yields: [???]
  |    GetScratch   |             |
  |                 |             `--> The contents of this GetUser Location.
  |                 |
  |                 `----------------> The GetUser "value" you specified.
  |
  `----------------------------------> DEC - If "mode" set to: DECIMAL
                                       BIN - If "mode" set to: BINARY
                                       HEX - If "mode" set to: HEXADECIMAL
                                      CHAR - If "mode" set to: CHARACTER

Some Examples of GU's & GS's Usage:

    GU 38                         : The User's WHO Banner.
    GU 29                         : Ascii Code of User's Protocol.
    GU 29 H                       : Protocol HEX Value, used in "bbs.udata".
    GU 29 C                       : More Familiar LETTER of Protocol.
    GU 1400664                    : Download Bytes Allowed PER DAY.
    GU 1400648 B 32               : The User's Message Base Flags.
    GU 1100660 BIN 8              : The User's ABIT0 Bank of Priviledges.

    GS 2 38                       : Load ID # 2's Who Banner.
    GS 5 29 C                     : Show ID # 5's Protocol Letter.
    GS 17 1400648 Binary 32       : Show ID # 17's Message Base Flags.

And that's all there is to using the GetUser Reader. If you have any questions,
comments, or criticisims, I'd love to hear from you. Until then, Au Revoir!

                                                                  - Dotoran
============================================================================
      Feeling hot? Catch my Waves>  http://www.bluemoon.net/~dotoran
============================================================================