MR v1.01 * System Memory Report

Copyrighted (C) 1989 by Tom Kashuba, All Rights Reserved

1411 Fort St, Suite #2001, Montreal, Quebec H3H 2N7 * (514) 932-1515

________________________________________________________________________
Description

MR is small, efficient, and unobtrusive program that quickly reports the
utilization of your PC's resources such as hardware devices, conventional
memory (BASE), expanded memory (EMS or EEMS), and disk storage with a
display similar to the following example which was edited to fit here.


Vers Total Used FreeDiskettes 2 MR System Memory Report v1.01
DOS 3.30 640k 308k 332kSer Ports 1 Copyright (C)1989 Tom Kashuba
EMS 3.2 1408k 512k 896kPar Ports 1 Run as "MR -h" for more info!
All Mem 2048k 820k 1228kGame=n NCP=YDate 89-07-03 Mon at 21:02:23

Drv Total-k Used-k Free-k Used% Free% 0Utilization100
C: 23,116 22,036 1,080 95.3% 4.7%
D: 23,124 20,600 2,524 89.1% 10.9%
E: 23,124 20,226 2,898 87.5% 12.5%
G: 32,544 21,144 11,400 65.0% 35.0%
X: 32,544 29,636 2,908 91.1% 8.9%

ALL 134,452 113,642 20,810 84.5% 15.5%



Without any command line arguments, it reports all of those items and
scans all available disk drives, from C: to Z:. For BASE and EMS forms of
memory and for each drive, it reports the total, used, and free kilobytes
as well as the pecentage used and free in both numeric and graphics forms.
If more than one disk drive is found to report on, then a cumulative total
of all drives is displayed on the last line.

The DOS free memory figure uses a few tricks to subtract the space that
MR, itself, occupies so that the free memory figure should match most
other memory reports +/- 1k and properly indicate the amount of memory
that will be available before or after MR executes.

________________________________________________________________________
Requirements

This program should work on all IBM compatible systems using MSDOS or
PCDOS with a version of 2.0 or higher. It should run in less than 64k
of user memory and uses only very standard video and keyboard routines.
It makes use of the standard IBM Extended ASCII character set and should
work with MDA, CGA, EGA, VGA, and MCGA video adapters.

________________________________________________________________________
Program Operation

There are four forms of program invocation allowed:


"MR" No command line arguments gives a full report which
includes all valid drives from C through Z.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
"MR -h" Display a brief summary of options without running.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
"MR drives" Limits the disk report to ONLY those drive letters in
the string shown as "drives". Only the letters A-Z are
allowed, without any spaces.

Eg, "MR AB" will report on floppies A and B, only.
"MR D" will report on drive D:, only.
"MR CF" will report on drives C: and F:, only.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
"MR ." This form, where any character other than a letter
is given, skips the drive report entirely.

________________________________________________________________________
Rights and Pricing

The license to use this program is quite simple. This program is a
commerical and copyrighted product of Tom Kashuba and is neither "public
domain" nor free. If, after a few tries, it seems to work for you and
you keep it, then you are requested, but not expected, to send $7 to the
address at the top of this document. Conversely, if you find that it is
not of value to you then you should delete it.

________________________________________________________________________
Distribution Rights

Anyone may freely distribute this program providing that no fees are
charged for that distribution other than to cover the cost of the media
that contins it.

Amateur or commercial groups and information systems may carry this
program in any program libraries that they may offer to users,
subscribers, or employees. Such provision must not include a charge or
fee for the access or downloading of this specific program other than
access charges, dues, or subscriptions that apply to the overall system.

________________________________________________________________________
Revisions

1.00 89/07/01 First released version

1.01 89/07/03 Minor revisions.

.... Expanded this document file, a little.

.... All display output converted to low-level, unbuffered calls so
that the output is both faster and more suitable to redirection.
For complex or unattended systems, this allows you to place MR in
a batch file and redirect the output as in "MR >> MR.LOG" so you
can have a running log of disk use to trouble shoot problems.

.... Squeezed Game Port and Coprocessor indicators into the space that
was occupied by the 'Game Port=YES/No' field using the brieer
format of "Game=? NDP=?".

.... Added display of current TIME and DATE to header to check your
clock or to time stamp the report when redirected to a disk log.

.... Now return an errorlevel (0-200) that represents the number of
megabytes that are free on the drive with the least space of the
drives that were reported on, round DOWN to the nearest megabyte
so that 700k free would set the DOS errorlevel to 0.

Eg, if drives C, D, and E had 10, 3, and 5 megabtyes free,
respectively, the DOS errorlevel will be set to 3. If you have
one or more specific drives that you want to check, you could run
MR on only those drives and check the errorlevel in your batch file
to trigger certain procedures like ringing the bell with an
"ECHO ^G^G^G^G" batch command or to executing a special maintenance
procedure. This can be useful for unattended information systems.

________________________________________________________________________
Tom Kashuba