home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / i / ifplv155.zip / IFPLV155.EXE / INFOPLUS.DOC < prev    next >
Text File  |  1992-04-21  |  13KB  |  289 lines
  1. INFOPLUS
  2.  
  3. Version 1.55 Released to the public domain.
  4.  
  5. By Andrew Rossmann, 4/21/1992
  6.  
  7. Originally based on Steve Grant's Public Domain SYSID 4.44.
  8.  
  9.   Syntax:
  10.     [d:][path]INFOPLUS [B][D][M][C][NV][AP][H][?]
  11.  
  12.   Where:
  13.     B  = Write to screen using BIOS (default under Desqview)
  14.     D  = Write directly to screen memory (default)
  15.     M  = Use monochrome colors (default under MODE BWxx or MONO)
  16.     C  = Use normal colors (default)
  17.     NV = Do not perform VGA chipset detection
  18.     AP = AutoPrint all screens
  19.     H or ? = This help screen
  20.  
  21.   A system description for DOS-based PC/XT/AT- and PS/2-class machines.
  22. INFOPLUS generates 18 screens of information about the host system and runs
  23. under DOS versions 3.0 and later.
  24.  
  25.   My primary sources of ideas in INFOPLUS were Ray Duncans "Advanced MS-DOS"
  26. and Terry Dettman's "DOS Programmer's Reference."  The ideas of Prakash
  27. Chandra,Terje Mathisen,Bob Smith, and others appear in various places.  Also
  28. James Howard, John Levine, Mark Aitchison, Jay Caplan, David Tay, Heribert
  29. Eisele, Matthias Heidbrink.
  30.  
  31.   Some of the techniques INFOPLUS uses are not documented or officially
  32. supported by either IBM or Microsoft.  Where possible I have followed the
  33. undocumented routine with a comment describing my source for the technique.
  34.  
  35.   The following files are included with the runtime program:
  36.  
  37.         INFOPLUS.EXE       - The main program
  38.         INFOPLUS.HIS       - Changes in each version
  39.         INFOPLUS.HLP       - The help screens
  40.         INFOPLUS.DOC       - This file
  41.         INFOPLUS.PIF       - Windows 3 Program Information File
  42.         IP-PIF.DVP         - Desqview Program Information File
  43.         INFOPLUS.ICO       - Icon for Windows 3 Program Manager
  44.         PRINTHLP.EXE       - Program to print some or all .HLP pages
  45.  
  46.   The following files are included with the source code:
  47.  
  48.         INFOPLUS.PAS       - Main file
  49.         IFPGLOBL.PAS       - Global variables, constants, and types
  50.         IFPCOMON.PAS       - Routines common to many of the pages
  51.         IFPRUN.PAS         - General runtime manager
  52.         IFPINIT.PAS        - Initialization routines
  53.         PAGE_xx.PAS        - Each of the pages
  54.         IFPEXTRN.PAS       - Unit for external routines
  55.         IFPSCRPT.PAS       - Unit for screen printing
  56.         IFPHELP.PAS        - Unit for help screens
  57.         INFOPLUS.ASM       - Assembly language procedures
  58.         INFOPLUS.OBJ       - Assembly routines for linking
  59.         PRINTHLP.PAS       - For printing out the help pages
  60.         MAKEHELP.PAS       - Compiles PAGE_xx.INF files into INFOPLUS.HLP
  61.         PAGE_xx.INF        - Help screen for each page
  62.  
  63.    Using INFOPLUS is easy.  Just use the PGUP and PGDN keys to move from
  64. page to page.  HOME and END will move to the first and last pages,
  65. respectively.  If you hit ENTER, you can then type in the page you want to
  66. go to.  If you hit ENTER without typing a new page number, it will re-run
  67. the current page.  Hit ESC to end the program.  Some pages won't fit all on
  68. one screen, for that you hit the DOWN ARROW key to get more information.
  69. Some pages let you hit UP ARROW to review already displayed information.
  70.  
  71.   If you want to save a copy of the information on a screen, hit ALT-P.  A
  72. window will pop up.  You can send your output to a File or the Printer.  If a
  73. File already exists, you can Overwrite it, or Append to it.
  74.  
  75.   If your printer does not support the IBM 'graphics' characters (such as line
  76. drawing), then choose Normal ASCII.
  77.  
  78.   Lastly, you can optionally add an extra header line to the output.  You can
  79. put anything you want there (up to 255 characters.)  The most logical is to
  80. put a little information on what computer your using. ie:  Betty's Office
  81.  
  82.   If you want a full record, start INFOPLUS using the AP option. This will
  83. send a copy of every screen to a file or the printer. Before the first
  84. page, you will be asked the same questions as for a single page, plus one
  85. new one: Number of screens per page. Infoplus will place that many screens
  86. on a page before issuing a form-feed. If you want everything all together,
  87. use 0 to suppress form-feeds.
  88.  
  89.   You can hit F1 during screen displays to get a help screen explaining
  90. what's being displayed. INFOPLUS looks for the environment variable
  91. INFOPLUS, and if found, uses a path given on it to look for INFOPLUS.HLP
  92. (INFOPLUS=C:\UTIL). If no environment variable is found, INFOPLUS will look
  93. in the current directory, then the same directory as the program was found,
  94. then your PATH.
  95.  
  96.   If you have trouble with bad colors on the screen, try setting your computer
  97. to MODE MONO or MODE BW80 before starting INFOPLUS.  INFOPLUS will use a black
  98. and white palette if either of these modes are detected. You can also use
  99. the M command line switch. (INFOPLUS M)
  100.  
  101.   If you are in a 40 column mode, INFOPLUS will run in 80 column, but return
  102. you back to 40 columns upon completion. 132 column modes are not supported
  103. because Turbo Pascal's CRT unit only works with standard modes, and I don't
  104. want to give up all the nice features.
  105.  
  106.   INFOPLUS does support more than 25 lines, although most of the pages are set
  107. up to look best at 25 lines.  Some display modes do not properly return the
  108. correct number of lines.
  109.  
  110.   For ease of use, a utility named PRINTHLP comes with INFOPLUS.  When you
  111. run it, you can have one or all of the help pages sent to your printer (or
  112. any DOS device or file.)  Each information page will be paginated any way
  113. you like.  Each new page will have a small header giving the Infoplus
  114. version it refers to, the page number, and what is on the page.
  115.  
  116. WINDOWS 3.0 NOTES!!!
  117.      You can add INFOPLUS to the Program Manager. Open the group that you
  118.      want to put INFOPLUS in. Select File, New, Program item. Use whatever
  119.      you want for the Description. For Command line, enter INFOPLUS.EXE,
  120.      preceed with a drive and directory if not on your PATH. If you hit
  121.      ENTER, and end up at the screen, select File, Properties. Hit Change
  122.      Icon, and for the file name, use INFOPLUS.ICO. Then OK everything.
  123.      Note that when you minimize Infoplus, you will see a standard DOS
  124.      icon. This can't be changed.
  125.  
  126. Desqview NOTES:
  127.      Infoplus runs safely under Desqview, and is 'Desqview Aware.' If DV is
  128.      detected, Infoplus will write to the screen using BIOS calls unless
  129.      you use the D command line switch. This allows windowed screens even
  130.      on non-386/486's.
  131.  
  132.      IP-PIF.DVP is a sample setup for Infoplus. The settings should be:
  133.  
  134.                                Change a Program
  135.  
  136.  Program Name............: Infoplus
  137.  
  138.  Keys to Use on Open Menu: IP                         Memory Size (in K): 200
  139. ------------------------------------------------------------------------------
  140.  Program...: C:\UTIL\INFOPLUS.EXE     <---Change this for your own setup
  141.  
  142.  Parameters:
  143.  
  144.  Directory.: C:\UTIL   <---Not needed if you use the environment variable
  145. ------------------------------------------------------------------------------
  146.  Options:
  147.                   Writes text directly to screen.......: [N]
  148.                   Displays graphics information........: [N]
  149.                   Virtualize text/graphics (Y,N,T).....: [N]
  150.                   Uses serial ports (Y,N,1,2)..........: [Y]
  151.                   Requires floppy diskette.............: [N]
  152.  
  153.                       Change a Program Advanced Options
  154.  
  155.  System Memory (in K).......:   0   Maximum Program Memory Size (in K)..:
  156.  
  157.  Script Buffer Size.......:  1000   Maximum Expanded Memory Size (in K):   16
  158.  
  159.  Text Pages: 2  Graphics Pages: 0   Initial Mode:        Interrupts: 00 to FF
  160. ------------------------------------------------------------------------------
  161.  Window Position:
  162.     Maximum Height:  25       Starting Height:  25       Starting Row...:   0
  163.     Maximum Width.:  80       Starting Width.:  80       Starting Column:   0
  164. ------------------------------------------------------------------------------
  165.                                 Shared Program
  166.  Pathname..:
  167.  Data......:
  168. ------------------------------------------------------------------------------
  169.  Close on exit (Y,N,blank)......: [ ]  Uses its own colors..............: [Y]
  170.  Allow Close Window command.....: [N]  Runs in background (Y,N,blank)...: [N]
  171.  Uses math coprocessor..........: [Y]  Keyboard conflict (0-F)..........: [0]
  172.  Share CPU when foreground......: [Y]  Share EGA when foreground/zoomed.: [Y]
  173.  Can be swapped out (Y,N,blank).: [Y]  Protection level (0-3)...........: [0]
  174.  
  175.   The Maximum Expanded Memory setting of 16 allows the VCPI detection to
  176. work. You can set this to 0 if you need to, or 9999 if you want Infoplus to
  177. detect it all (Infoplus does not actually use EMS at present.) The Maximum
  178. Program Size can also be varied if you wish.
  179.  
  180.   This version of INFOPLUS was compiled using the following equipment:
  181.  
  182.   Hardware:
  183.     Gateway 2000 386/25 (Micronics ASIC motherboard w/ 64K cache)
  184.     4 Meg RAM
  185.     Microscience 110M ESDI, 3.5" HH
  186.     Ultrastor 12F ESDI controller w/ 32K cache
  187.     ATI VGA Wonder XL w/ 1M RAM
  188.     Soundblaster (older version with CMS chips)
  189.  
  190.   Software:
  191.     MS-DOS 5.00
  192.     QEMM 6.00
  193.     4DOS 4.0
  194.     HyperDisk 4.31
  195.     Turbo Pascal 6.0
  196.     Turbo Assembler 2.0
  197.     Turbo Debugger 2.0
  198.     KEDIT 4.00D2
  199.     Windows 3.00
  200.     Desqview 2.40
  201.  
  202.   My primary sources of ideas in INFOPLUS were Ray Duncans "Advanced MS-DOS"
  203. and Terry Dettman's "DOS Programmer's Reference."  The ideas of Prakash
  204. Chandra,Terje Mathisen,Bob Smith, and others appear in various places.  Also
  205. James Howard, John Levine, Mark Aitchison, Jay Caplan, David Tay, Heribert
  206. Eisele, Matthias Heidbrink.
  207.  
  208.   Some of the techniques INFOPLUS uses are not documented or officially
  209. supported by either IBM or Microsoft.  Where possible I have followed the
  210. undocumented routine with a comment describing my source for the technique.
  211.  
  212.   Much of the additional info came from Ray Duncan's "Advanced MSDOS
  213. Programming" second edition (a must get book for anyone interested in
  214. low-level stuff.)  Also, additional information on the DOS 4 boot sector
  215. format came from "The Norton Troubleshooter."  A book that comes with The
  216. Norton Utilities 4.5.
  217.  
  218.   Even more information comes from Ralf Brown's interrupt list, which lists
  219. hundreds of goodies.  It's available via BBS's, and resides on SIMTEL20 and
  220. many other public access UNIX sites.  It's also available on the Infoplus
  221. BBS.  The name is INTERxxy.ZIP, where xx is the version, and y is the part
  222. letter. (This version of INFOPLUS used INTER29.)
  223.  
  224.   Additional information on XMS and DPMI came from the book 'Extending DOS'
  225. by Ray Duncan (and others.)
  226.  
  227.   Information on additional partition values came from numerous people of
  228. which I never wrote down their names!!
  229.  
  230.   Information on detecting VGA chipsets came from "Advanced Programmer's
  231. Guide to Super VGAs" by George Sutty and Steve Blair.  Published by Brady.
  232. (NOTE!  Beware of bugs in the detection routines in the above book!!)
  233.  
  234.   Some extra VGA chipset detection help came for the source code for
  235. Fractint 16.11.
  236.  
  237.   Information on reading the CMOS came from a program posted by Mark
  238. Aitchison on USENET.
  239.  
  240.   Information on detecting UART types came from David Tay and David Nugent
  241. (david@csource.oz.au)
  242.  
  243.   More information on VGA chipsets came from "Programmer's Guide to the EGA
  244. and VGA Cards, Second Edition" by Richard F. Ferraro.  Published by
  245. Addison-Wesley.
  246.  
  247.   Information about how dangerous it is to pass too many flags, and info
  248. about OS/2 came from Heribert Eisele (heribert@caen.engin.umich.edu)
  249.  
  250.   How to detect the Tandy 1000, and some models digital sound, came from
  251. Frank Durda IV (uhclem@nemesis.lonestar.org)
  252.  
  253.   Information about a bug in the LONGCALL routine came from Michael Holin
  254. (HIMH%DCZTU1.BITNET@cunyvm.cuny.edu).
  255.  
  256.   Information about problems with Trident VGA chipsets came from MANY
  257. people.
  258.  
  259.   If you have any questions, bug reports, or suggestions, I can be
  260. reached at the following places:
  261.  
  262. Internet       : andyross@infopls.chi.il.us
  263. Unix           : uunet!infopls!andyross
  264. CompuServe     : >INTERNET:andyross@infopls.chi.il.us
  265.  
  266. Infoplus BBS   : (708)537-0247 (14400/9600/2400/1200 v32bis/v42bis/MNP)
  267.   This is my own BBS. You can always get the latest version here. Just log
  268. in as INFOPLUS, and follow the instructions on screen.
  269.  
  270. RCS Defender   : (708)390-6603 (2400/1200, 2 lines)
  271.                : (708)390-9662 (14400/9600/2400/1200 v32bis/v42bis/MNP)
  272. Beacon         : (708)615-0845 (2400/1200)
  273.  
  274.      Andrew Rossmann
  275.      Wheeling, IL
  276.  
  277. From Steve Grant:
  278.      Both the source and object code of SYSID are hereby released into the
  279.      public domain.  Neither version carries any warranty, expressed or
  280.      implied, of merchantability or fitness for a particular purpose.
  281.  
  282.      Comments, suggestions, and questions may be addressed to:
  283.              BIXMail: sjgrant
  284.              CompuServe: 71101,706
  285.  
  286.      Steve Grant
  287.      Long Beach, CA
  288.      January 13, 1989
  289.