home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / DESQVIEW / DVSI2_00.ZIP / README.1ST < prev    next >
Text File  |  1992-02-22  |  19KB  |  390 lines
  1.                       DV System Information
  2.                         DVSI Version 2.00
  3.                         February 22, 1992
  4.                        by Daniel J. Bodoh
  5.  
  6.  
  7. INTRODUCTION
  8.      DESQview System Information has almost become a misnomer.  The first
  9.      version of DVSI contained only a very basic PS command, which gave
  10.      information about DESQview.  Hence, the name.
  11.  
  12.      The purpose of the project was to provide useful Unix-ish information
  13.      utilities.  But it has grown beyond that into utilities that don't
  14.      necessarily have a Unix counterpart and into utilities that don't
  15.      necessarily give information.
  16.  
  17.      However, DVSI still retains the Unix flavor.  Documentation format,
  18.      command-line switches, display formats and command names have been
  19.      inherited from Unix.  And the new LPR suite is essentially a subset of
  20.      its Unix counterpart.
  21.  
  22.      All the DVSI programs may be run from the DOS command line. All may be
  23.      run in their own window, and some can be run continously for
  24.      monitoring.
  25.  
  26.      DVSI is now shareware.  Please pay for it and get a registered version
  27.      if you find it useful.  See ``REGISTRATION'' below for more
  28.      information.
  29.  
  30.      NOTE: There have been some reported problems with DVSI and beta versions
  31.      of DESQview/X.  If you have DESQview/X beta or the real thing, please
  32.      let me know if or how the utilities crash.  As soon as I purchase a
  33.      copy of DV/X I will release an DVSI update.
  34.  
  35. DISCLAIMER
  36.      The DVSI package is distributed as is.  The author will not be
  37.      responsible for any loss or damages resulting from the use of any of
  38.      the DVSI utilities.  The maximum remedy available in case of dispute
  39.      is the purchase price of the license.
  40.  
  41.      Every effort has been made to make sure that DVSI is bug-free, and I
  42.      will make every effort to make sure that it stays error-free. However,
  43.      improper use of some of the utilities could cause loss of data
  44.      (notably KILL and WN KILL).
  45.  
  46. THE DVSI PACKAGE
  47.      The files in this package include
  48.           README.1ST   - This file
  49.           MANPAGES.DOC - A formal description of each command
  50.           MANPAGES.PS  - Postscript manual for registered users who order it
  51.           WHATSNEW.DOC - Changes made in each version
  52.           ORDER.TXT    - Order form for registered version of DVSI
  53.           LICENSE.DOC  - The license agreement for this copy of DVSI
  54.           INSTALL.EXE  - Install program
  55.           DVSIXDI.COM  - DVSI's external device interface
  56.           PS.COM       - Process status: Handle, switch windows #,
  57.                          memory info, cpu time and utilization, etc.
  58.           DF.COM       - Free and used disk space
  59.           PERF.COM     - DESQview performance: CPU Utilization, task switches
  60.           KILL.COM     - Kills processes
  61.           WN.COM       - Contains many subcommands for manipulating windows
  62.           UPTIME.COM   - Displays amount of time DESQview has been running
  63.           MEMSTAT.COM  - An alternative to DESQview's Memory Status
  64.           LPD.COM      - Line printer daemon which actually prints files
  65.           LPR.COM      - Submits files to LPD for printing
  66.           LPRM.COM     - Removes jobs from the queue
  67.           LPQ.COM      - Lists the jobs in the queue
  68.           PRCC.COM     - Compiles and sends PRINTCAP to LPD
  69.           PRINTCAP     - A sample PRINTCAP file
  70.           DVSTUFF.COM  - Stuffs keystrokes into any window
  71.           RUN.COM      - Launches windows from the command line
  72.           DVSIHELP.EXE - Menued help for DVSI utilities
  73.           PS-PIF.DVP   - DVP for PS.COM
  74.           PF-PIF.DVP   - DVP for PERF.COM
  75.           DF-PIF.DVP   - DVP for DF.COM
  76.           UP-PIF.DVP   - DVP for UPTIME.COM
  77.           MT-PIF.DVP   - DVP for MEMSTAT.COM
  78.           LQ-PIF.DVP   - DVP for LPQ.COM
  79.           LP-PIF.DVP   - DVP for LPD.COM
  80.           DH-PIF.DVP   - DVP for DVSIHELP.EXE for Open Window
  81.           RUN_DEF.DVP  - DVP for RUNning COM, EXE and BAT files
  82.           PRCC.DVP     - DVP for PRCC.COM
  83.           DVSIHELP.DVP - DVP for DVSIHELP.EXE for auto-launch
  84.  
  85.  
  86. SYSTEM REQUIREMENTS
  87.      - DESQview 2.26 or newer
  88.      - DOS 3.0 or newer
  89.           (the programs may work with older versions of DOS; I haven't
  90.            tested)
  91.  
  92. REGISTRATION
  93.      If you find DVSI useful, please pay for it and get a registered copy.
  94.      I have put countless hours into this project and could use a little
  95.      incentive to keep going.
  96.  
  97.      Registered users will receive the latest release of DVSI as well as a
  98.      nicely formatted and printed manual.  Registered users will receive
  99.      maintenance versions for basically the cost of the media and postage;
  100.      minor versions for half the price; and major versions for
  101.      three-quarters the price that a new registered user would get it at.
  102.  
  103.      Registered users will also get postal or electronic mail when new
  104.      releases are announced.
  105.  
  106.      The cost for a single-user license for 2.00 is US $15.00.  That's only
  107.      $1 per utility!  A site license may be purchased for $60.00.  A site
  108.      license is required if any utility in the package may be used at the
  109.      same time that any other utility might.  The site license allows you
  110.      to make unlimited copies for use by the person or company that
  111.      purchased the license.
  112.  
  113.      Print out and complete the order form in ORDER.TXT and send it and the
  114.      fee to the address listed in that file.
  115.  
  116. DISTRIBUTION
  117.      The DVSI package is copyright 1991, 1992 by Daniel J. Bodoh.  See
  118.      the file LICENSE.DOC for distribution restrictions.
  119.  
  120.      In MANPAGES.DOC, I provide the programming interface for DVSIXDI.COM.
  121.      If you write a program to communicate with DVSIXDI, you may not
  122.      include it as part of the package.  You must distribute it separately,
  123.      and provide pointers to the unregistered version of the DVSI package.
  124.      You can upload an unregistered DVSI to the same place as your program,
  125.      but they must be 2 distinct entities.  Basically, I don't want to
  126.      claim your credit, or conversely, be associated with your bad
  127.      programming.  If you write it, you are responsible for it! You can
  128.      make as much or as little money you want on your program without
  129.      paying me a cent.
  130.  
  131. HOW IT WORKS
  132.      The heart of DVSI is DVSIXDI.COM.  This is a Terminate-and-Stay-
  133.      Resident (TSR) program which is required by most of the programs.
  134.      DVSIXDI should be placed in your AUTOEXEC.BAT and run before DESQview
  135.      is started.
  136.  
  137.      Unfortunately, the DESQview API provides no way to get a list of the
  138.      current processes.  However, DESQview 2.26 introduced a way to "hook"
  139.      into DESQview and collect this information. This "hook" is called an
  140.      eXternal Device Interface (XDI).  Every time DESQview starts a
  141.      process, kills a process, swaps a process out, switches to a new
  142.      process, etc, it calls all the XDIs that have been loaded.  DVSIXDI
  143.      keeps track of the current processes in a list, and adds other
  144.      information to this list such as Open Keys and CPU Time.
  145.  
  146.      The utilities that I provide communicate with DVSIXDI and get their
  147.      information from it.  Some programs, such as DF.COM and MEMSTAT.COM,
  148.      don't require DVSIXDI loaded because they don't use any of this
  149.      information.
  150.  
  151.      In order to save precious memory, load your TSRs (including DVSIXDI)
  152.      before you set a PATH or any other environment variables. That will
  153.      keep the environment which is loaded with the program at about 0.1K or
  154.      less.
  155.  
  156. INSTALLATION
  157.      The easy way to install DVSI is to start DESQview and type INSTALL.
  158.      The INSTALL program does not edit your AUTOEXEC.BAT or CONFIG.SYS, but
  159.      it will modify your Open Window menu.  Before doing anything, the
  160.      INSTALL program checks with you first.  However, if you don't trust
  161.      it, you can install DVSI manually:
  162.  
  163.      I am going to assume you know what AUTOEXEC.BAT is, and how to use Add
  164.      A Program.  If you don't, take a look at the manuals or find a guru.
  165.  
  166.      (1)  If you have an older version of DVSI, delete the old files and
  167.           remove all old DVSI entries from the Open Window menu.
  168.  
  169.      (2)  Make a directory for DVSI.  A good name is C:\DVSI.  Put all the
  170.           files in this directory.  If you'd like to split the files among
  171.           multiple directories, see ``DIRECTORIES'' below.
  172.  
  173.      (2)  Install DVSIXDI.COM into your AUTOEXEC.BAT.  It is a memory
  174.           resident program and requires about 1.4K resident.  You can use
  175.           QEMM's LOADHI or DOS 5.0's LOADHIGH.  The only command-line
  176.           options that DVSIXDI can use  are ``-p'' and ``-t''; see
  177.           DVSIXDI(1dvsi) in MANPAGES.DOC for more information.  You can
  178.           ignore them for now... If you want to run the DVSI programs from
  179.           the command line, put the DVSI directory (C:\DVSI or whatever) in
  180.           your PATH statement.
  181.  
  182.      (3)  Reboot the system so DVSIXDI gets installed.  Take note of the
  183.           number of "Common Memory" kilobytes that DVSIXDI will require.
  184.           This number is printed with the DVSIXDI installation logo.
  185.  
  186.      (4)  CD to the DESQview directory.  Type SETUP to run DESQview's
  187.           setup.  Hit RETURN for advanced setup, and choose Performance.
  188.           You have to set the Common Memory field to AT LEAST the minimum
  189.           allowed value plus the amount required by DVSIXDI.  In most
  190.           versions of DESQview, the minimum value is 13K.
  191.  
  192.      (5)  Start DESQview and run Add A Program.  Choose ``OTHER (Add
  193.           Program Not On List)'' and enter the name of the DVSI directory
  194.           in the PATH field.
  195.  
  196.      (6)  Select the programs you want to install on the Open Window menu
  197.           and hit ENTER.  You don't have to install all the programs, for
  198.           they can be run from the command line.  The most useful to
  199.           install are PS, MEMSTAT, DF, and LPQ because they can be run
  200.           continuously to show status.  However, they can also be run from
  201.           the command line in continuous mode.  You may have to change some
  202.           of the Open Window keys if they conflict.
  203.  
  204.      (7)  If you do not have DvpEdit or another command-line DVP editor,
  205.           run Change A Program from the command line by typing
  206.                INSTLAC DVSIHELP.DVP
  207.           and
  208.                INSTLAC PRCC.DVP
  209.           The DESQview system directory must be in your PATH.  Change the
  210.           "Directory" fields in each of these DVPs to the DVSI directory.
  211.           These DVPs are used for launching DVSIHELP and PRCC
  212.           automatically.
  213.  
  214.      (8)  Read the rest of this file.  Read MANPAGES.DOC to learn about
  215.           each of the DVSI utilities.  And if you used an earlier version
  216.           of DVSI, you may be interested in looking at WHATSNEW.DOC for a
  217.           list of bug fixes and new features.
  218.  
  219.      (9)  If you find the DVSI utilities useful, please pay for them and
  220.           get a registered version.  I have put countless hours into this
  221.           project and could use the money since I'm a poor grad student.
  222.           See ``REGISTRATION'' above for more information.
  223.  
  224.      (10) Send me comments, gripes, suggestions, etc.  I want to hear from
  225.           you!  My E-mail and USPS addresses are listed in MANPAGES.DOC.
  226.  
  227. DIRECTORIES
  228.      Some users prefer to use one directory for all executables, and other
  229.      directories for help, etc. files.  You can split DVSI up, but you must
  230.      follow these rules:
  231.  
  232.           (1) DVSIHELP.DVP must be in the same directory as each of the
  233.               utility programs (i.e. *.COM and *.EXE with the exception of
  234.               DVSIXDI.COM and INSTALL.EXE).
  235.  
  236.           (2) PRCC.DVP can be anywhere.  If it is not in the directory
  237.               specified by the DIRECTORY field in LP-PIF.DVP, you must use
  238.               LPD's ``-c'' option.
  239.  
  240.      I suggest you keep everything in one place.  It will make updates,
  241.      etc. easier.
  242.  
  243. ADVERTISEMENTS
  244.      DvpEdit 1.0  (freeware)
  245.      Richard Reiner and I have developed a replacement for "Change A
  246.      Program" called DvpEdit.  It
  247.           ■ provides superior field editing and context-sensitive help
  248.           ■ provides access to DVP fields which Change a Program conceals
  249.           ■ can edit DVP files which are not on DESQview's Open Window menu
  250.           ■ can edit DVP files which are not named something of the
  251.             form ``xx-PIF.DVP''
  252.           ■ can be run from the command line.
  253.      DvpEdit has two modes of running.  The default allows the user to
  254.      choose any DVP file from a list.  With "dvpedit -o", a psuedo- Open
  255.      Window menu is provided.
  256.  
  257.      Clock & Calendar  (freeware)
  258.      An early attempt at using the DVGLUE package, Clock and Calendar is a
  259.      small clock for DESQview that runs in its own window and does not
  260.      appear on the Open Window menu.
  261.  
  262.      Comp.Os.Msdos.Desqview Frequently Asked Questions  (compilation)
  263.      This is a regularly posted DESQview Q&A file that I edit for the
  264.      DESQview Usenet newsgroup.  It's a good source of information for the
  265.      new and old DESQview user alike.
  266.  
  267.      Each has been distributed on DVNet and the anonymous FTP site
  268.      WSMR-SIMTEL20.ARMY.MIL.  The files on SIMTEL are
  269.           DvpEdit 1.0           PD1:<MSDOS.DESQVIEW>DVPED1_0.ZIP
  270.           Clock & Calendar      PD1:<MSDOS.DESQVIEW>CLOCKCAL.ZIP
  271.           Freq. Asked Questions PD1:<MSDOS.INFO>FQ012992.ZIP
  272.               (filename may change due to updates)
  273. FUTURE WORK
  274.      I had planned asyncronous pipes for this version, but I'm still having
  275.      problems making it stable.  Pipes will probably exist in 2.1 or 2.2 or
  276.      so.  I am trying to emulate Unix's pipe(2) and popen(3) system calls.
  277.      RUN will be expanded to be able to pipe the output of one DV window to
  278.      the input of another.  Eventually, this could lead to a DV-specific
  279.      Unix-like shell...
  280.  
  281.      Another idea that has been suggested is an interactive PS which
  282.      would replace Switch Window.  I'm also trying to get a device
  283.      driver working so that applications could print directly to the
  284.      LPD print spooler.
  285.  
  286. HOW DVSI IS MADE
  287.      DVSIXDI.COM was assembled with TASM 1.0 by Borland
  288.      DVSIHELP.EXE was compiled with Dave's Readme Compiler by Dave Harris
  289.      All the other utilities are compiled with Turbo C Professional 2.0 by
  290.           Borland
  291.      The DVGLUE library by Ralf Brown is used to communicate with DESQview
  292.      Other information on the DESQview API was gleaned from the Interrupt
  293.           List, compiled by Ralf Brown
  294.      The DVP files are created with DvpEdit 1.0 by Richard Reiner & Dan Bodoh
  295.      README.1ST, WHATSNEW.DOC & ORDER.TXT created by Qedit
  296.      MANPAGES.DOC and the printed manual created by WordPerfect 5.1 and
  297.           printed on an HP-Laserjet IIISI Postscript printer
  298. THANKS
  299.      Thanks to...
  300.  
  301. Ralf Brown
  302.      For the DVGLUE package, the Interrupt List and use of the extract of
  303.      the DVP spec from release 28 of the Interrupt List.
  304. Dave Harris
  305.      For the compiler that created DVSIHELP.EXE
  306. The Center for X-Ray Lithography
  307.      My place of employment, for straining the computers with the Email load
  308. Mike Weaver
  309.      For the DVTXDI emulation code and help to jump onto shareware bandwagon
  310. The 2.00 Beta Testers (also sent me many small suggestions that I used)
  311.      Syon Bhattacharya
  312.      Richard Reiner
  313.      Ralph Sims
  314.      Jerod Tufte
  315.      Chris Webster
  316.      Bernard Johnson
  317.      John Stockard
  318.      Tim Russell
  319.      Jeff Racine
  320.      David Hobbs
  321.      Kenneth R. van Wyk
  322.      S. Mikael Jansson
  323.      Harold Pritchett
  324.      Jim Reisert
  325.      Foster Shucker
  326.      Carl Scott
  327.      Shannon D. Appel
  328.      Andrew Reilly
  329.      Tom Hanson
  330.      Dwight Gordon
  331.      Doug Dougherty
  332.      Bill Yow
  333.      Frank Muennemann
  334.      Jan-Pieter Cornet
  335.      Gary Hildebrand
  336. People who sent bug reports in previous DVSI versions
  337. (Those with asterisks were especially helpful)
  338.   *  Doug Dougherty
  339.      Erik Fichtner
  340.      Jerod Tufte
  341.   *  Shannon D. Appel
  342.   *  Richard J. Reiner
  343.   *  Jim Reisert
  344.      Greg Alheid
  345.      Ward Engle
  346.      Jake Coleman
  347.      Derek Carr
  348.      Jim Knepley
  349.      James Mankin
  350.      Rupa Shomaker
  351.      Alan Gilbertson
  352.      Stephen Lee
  353.      Rene Ertzinger
  354.      Jan-Pieter Cornet
  355. People who sent suggestions that I implemented
  356.      Shannon D. Appel    hh:mm:ss.hh format for CPU times, more Unix-like DF,
  357.                          ``?'' in PS for orphans, KILL command
  358.      Richard Reiner      Lots of suggestions, A: & B: in DF, ``-'' switch char
  359.                          optional ``%'' preceding switch window #, -q switch,
  360.                          smaller DVSIXDI
  361.      Chia-Chi Chao       PS search C:\DV if no -d
  362.      Chris Webster       Pointed out memory usages
  363.      Mike Pawka          Do not erase windows in -c mode
  364.      Doug Dougherty      Kestrokes in -c mode, help with DF & Novell, DF -w,
  365.                          smarter DF width, RUN launch options
  366.      Davin Church        Original suggestion for DVTXDI emulation
  367.      George Wiley        idea for DVP physical printer type
  368.      Jan-Pieter Cornet   Keystrokes in -c mode
  369.      Foster Shucker      DVTXDi emulation
  370.      Andrew Reilly       DVTXDi emulation
  371.      Rene Ertzinger      DVSIXDI -p option
  372. People who sent suggestions that I may implement
  373.      Shannon D. Appel    Window manager suggestions, show TSRs in PS
  374.      JC Pollman          Original idea for window manager
  375.      Nikolaus R. Haus    Suggested routing output from one window to input
  376.                          of another.  This first set me to thinking about
  377.                          async pipes
  378.      Yehiel Greenbaum    Remote call in utility for DV
  379.      Wayne Mery          PS: unused bytes in each window
  380.      Doug Dougherty      DVSIXDI auto-loadhi, PS as Switch window replacement
  381.      Jake Coleman        DV-specific shell discussion
  382.      Richard Reiner, Paul Gomme, Justin Seiferth
  383.                          Shell discussion
  384.      Richard Reiner      printf-style UPTIME format str
  385.      Alan Gilbertson     Watchdog utility
  386.      Wayne Young         WN & DV screen blanker
  387.      Serge Plotkin       WN SWAP, WN FREEZE, brief PS output
  388.      Jan-Pieter Cornet, Steve Resnick, Hank Oredson, Jeff Sicherman
  389.                          Suggestions for async pipes
  390.