


     MAPMEM(U1)           LS-DOS 6 - Utilities 1            MAPMEM(U1)



     Name
          MAPMEM - Displays memory module information

     Syntax
          mapmem [ -demprst!?h ] [ >[>] file | device ]
          [ ; next command ]

     Description
          Mapmem displays one or more tables describing the drivers
          and other memory modules that are present in memory.  These
          modules are identified by function and are displayed in one
          of three categories: disk drivers, character drivers or
          filters, and other modules.

          By default, mapmem displays four sections of information.
          The first is a summary indicating how much low and high RAM
          is available and how much low RAM was available when the
          system booted.  The next section shows the drivers that are
          used for each enabled logical drive.  The third section
          displays the drivers and filters that are connected to each
          character device.

          The final section displays memory modules that are not
          directly accessed as a logical drive or character device.
          These modules may contain patches to the system, or contain
          code shared by one or more of the other drives.  There are
          other possible uses for these memory modules.

          When a memory module is displayed, the following information
          is displayed:
          1.    The starting address of the memory module in
                hexadecimal.
          2.    The ending address of the memory module in
                hexadecimal.
          3.    The length of the memory module (in hexadecimal or
                decimal).
          4.    The name of the memory module.
          5.    A short description of the purpose of the memory
                module.

          Mapmem accepts several options.  Options are specified by
          single characters, and they may be entered in upper or
          lowercase.  Options are always preceded by a hyphen (a "-").
          If you are specifying multiple options, you can specify the
          options in any of these formats:
                -a -b -c   or   -abc   or   -a -bc   or  -ab -c

          The options are:

          -d   The length of memory modules is displayed in decimal.
               By default the value is displayed in hexadecimal.




     Page 1                                             May 15th, 1993






     MAPMEM(U1)           LS-DOS 6 - Utilities 1            MAPMEM(U1)



          -e   Displays only the memory modules that are used with
               character devices.  This includes character drivers
               like *PR and *KI, as well as character filters.

          -m or -s
               Displays the memory summary only.

          -p   The output is routed through the more(U1) utility.  If
               the output of mapmem exceeds one screen, the screen
               will pause once every 23 lines.  See the more(U1)
               command for additional information on the options that
               more(U1) provides.  The -p option is ignored if the
               output is redirected.

          -r   Displays only the memory modules that are used for disk
               access.  This includes floppy, hard disk and RAM
               logical drives.  (Ignored if -l or -x is specified.)

          -t   The headers that are normally displayed are omitted
               from output.

          -!   Causes mapmem to ignore any default settings that are
               specified in the DEFAULTS/MAD file.  Mapmem will also
               ignore any options that are specified to the left of
               the -! option.  Note that the DEFAULTS/MAD file is
               accessed even if the -! option is specified.

          -? or -h
               Displays the help message.

          >[>] file | device
               By specifying a file or device, the output is sent to
               the specified file or device instead of the display.
               This is known as redirected output.  For example, the
               command mapmem > state:0 stores the output of mapmem in
               the file STATE:0.  If >> is used, mapmem will append
               the output of mapmem to the existing contents of the
               specified file or device.  Filespecs for redirection
               may not specify a password.

          ; next command
               After mapmem completes, the remainder of the command
               line is executed as a second command.  The command
               mapmem;time will display memory information, and then
               the time will be displayed.

          <SHIFT>@
               When pressed during output to the display, the output
               will pause.  Pressing any other key resumes output.
               Pressing this key is ignored when output is redirected.





     Page 2                                             May 15th, 1993






     MAPMEM(U1)           LS-DOS 6 - Utilities 1            MAPMEM(U1)



     Notes
          Memory modules that mapmem displays in the "other" category
          may actually be one of the parts of a disk or character
          driver.  This is often done to share code that is used in
          other drivers.  The DiskDisk product creates one small
          memory module for each logical drive and a single, larger
          memory module that contains code that is shared by all the
          DiskDisk logical drives.

          Mapmem relies on the headers of the various memory modules
          that are present on the system to be formatted correctly.
          If these are corrupted, mapmem may display warnings or
          display incorrect information.


     Files
          Mapmem reads the MAPMEM/INI file to provide the descriptions
          of the memory modules that are displayed.  The user may add
          additional descriptions to this file if needed.  A maximum
          of 50 entries may be placed in the MAPMEM/INI file.  The
          descriptions are limited to 35 characters. See the
          MAPMEM/INI file for formatting details.

          Mapmem also examines the DEFAULTS/MAD file and uses any
          default options that are specified there.  For example, if
          you wanted mapmem to omit the headers by default, the
          following entry in the DEFAULTS/MAD file would do this:
                      MAPMEM -T
          Options in the DEFAULTS/MAD file are ignored if the -!
          option is specified on the command line.

          You may make copies of mapmem with different names.  When
          examining the DEFAULTS/MAD file, the name used to invoke the
          program will be used to locate the default entries.  For
          example, if you made copies of MAPMEM/CMD and named them
          DRIVES/CMD and RAM/CMD, you could add the following lines to
          the DEFAULTS/MAD file:
                      DRIVES -R
                      RAM -S
          When drives is run, information on active logical drives
          would be displayed and nothing else.  When ram is run, the
          information on RAM availability would be displayed and
          nothing else.


          If you need more information on mapmem(U1) or if you want to
          obtain the LDOS 5.3 version, please write to M.A.D.
          Software, P.O. Box 331323, Ft. Worth Texas, 76163.  Please
          include a Self-Addressed-Stamped-Envelope when requesting
          information.
          ------
          305151



     Page 3                                             May 15th, 1993



