home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / DESQVIEW / DVSI2_00.ZIP / MANPAGES.DOC < prev    next >
Text File  |  1992-02-22  |  109KB  |  2,469 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                 DV System Information
  25.  
  26.                                      Version 2.00
  27.  
  28.  
  29.                         The DVSI utilities and this manual are
  30.                                copyright 1991, 1992 by
  31.                                    Daniel J. Bodoh
  32.  
  33.                 The DVSI Manual was last updated on February 22, 1992
  34.  
  35.  
  36.  
  37.  
  38.  
  39.         OVERVIEW
  40.              As described in the file README.1ST, this package has been
  41.         designed with Unix in mind.  For people familiar with Unix, that
  42.         should be no problem.  However, users who don't know a grep from an
  43.         egrep may be confused at the Unix conventions.
  44.              This manual is designed to look similar to a Unix manual.  A Unix
  45.         manual has eight separate ``sections''.  Each section contains
  46.         ``manual pages'' (or ``man pages'' for short).  Each manual page
  47.         describes one command or system call or subroutine.
  48.              Each manual page is given the name which is constructed from the
  49.         item it describes and the section number.  For example, if the command
  50.         dir is described in section 1, the title at the top of its man page is
  51.         DIR(1).
  52.              The DVSI man page is made of several sections.  First, the
  53.         ``NAME'' section gives the program name and a one-line description. 
  54.         Following it is a ``SYNOPSIS''  which gives the syntax of the command
  55.         and the command-line options.  The behavior of the command is
  56.         described in, oddly enough, ``DESCRIPTION''.  The command line options
  57.         are described more completely in ``OPTIONS''.  Other sections may
  58.         follow, such as ``FILES'' which list the files that are created or
  59.         used, and ``SEE ALSO'' for cross references.
  60.              Three separate sections are included here: 1dvsi, 2dvsi and
  61.         5dvsi.  By far the most important section is 1dvsi, for it describes
  62.         each of the DVSI utilities in detail.  Section 2dvsi is for
  63.         programmers - it explains how a programmer can use the functions of
  64.         DVSIXDI.COM.  Section 5 describes file formats; in 2.00 the only two
  65.         files described are PRINTCAP and DVP files.
  66.              The installation procedure is described in the file README.1ST. 
  67.         You should take a look at that file before attempting to use DVSI. 
  68.  
  69.         WHAT UTILITIES ARE AVAILABLE?
  70.              There are 15 separate DESQview-specific utilities in this
  71.         package.  Each utility can be run from the DOS command line or
  72.         included in a batch file just like any other DOS utility.  You can
  73.         redirect the output of the utilities to a file or pipe the output to
  74.         other programs.  The ability to use the output in other programs can
  75.         be useful if you have a particular problem to solve and you don't want
  76.         to write a big program to solve it.
  77.              The oldest and probably most useful utility is PS.  The PS
  78.         command will displays information about each window that is currently
  79.         open in DESQview.  PS will tell you how much memory each window uses,
  80.         the window handle, the Switch Windows number and much more.  The
  81.         feature that many users really find informative is the CPU Time and
  82.         CPU Utilization fields of PS.  These numbers tell you which programs
  83.         are making your system run slow.  You can use these numbers to tweak
  84.         your system for best performance.
  85.              PERF is a close relative of PS.  It displays overall system
  86.         performance numbers, rather than performance on a window-to-window
  87.         basis.
  88.              The MEMSTAT program displays the same information as DESQview's
  89.         Memory Status program, and also computes the percentages of used
  90.         memory.  It takes up less screen space and CPU Time than Memory
  91.         Status.
  92.              Did you ever want to watch your disk space decrease as you
  93.         downloaded a big file?  With DF you can do just that.  DF displays
  94.         free and used space and other information for each logical drive in
  95.         your system (including network drives).  DF can even be run outside of
  96.         DESQview.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.              A small but sometimes useful utility is UPTIME.  It will tell you
  103.         how long DESQview has been running.
  104.              Resizing, raising, lowering, hiding, etc. windows from a batch
  105.         file or command line is possible with the window manipulator WN.  WN
  106.         has many subcommands for doing many of the things that your Rearrange
  107.         menu does.  You tell WN which window to act on by using the window's
  108.         handle (given by PS), Switch Window number, or Open Window keys.  This
  109.         ability gives the DVSI utilities many advantages over other utility
  110.         packages (notably DV Commander).
  111.              One of the subcommands of WN, KILL, was given its own program for
  112.         the sake of Unix types.  KILL will simply close any window given its
  113.         handle, Switch Window number or Open Window keys.
  114.              A relatively new but very useful utility is RUN.  The RUN utility
  115.         allows you to open windows right from the DOS command line.  And it
  116.         doesn't require you to make a DVP with Change A Program - you can RUN
  117.         plain old EXE, COM and BAT files.  The DVP memory usage, directories
  118.         and much more can be changed on the fly.
  119.              Five separate utilities make up the print spooler package.  These
  120.         are LPD, LPR, LPRM, LPQ and PRCC.  Background printing is described in
  121.         detail in BACKGROUND PRINTING(1dvsi).  (Did you understand that?  The
  122.         name is ``Background Printing'' and it's in section 1dvsi).
  123.              The DVSTUFF program will allow you to ``stuff'' keystrokes into
  124.         any other window or into the DESQview menu, just as if they had been
  125.         typed directly into the window.  Used from batch files, this can be a
  126.         good replacement for DESQview scripts.
  127.              And finally, the DVSIHELP program is a menu-style help program
  128.         for each of the utilities.  It is opened automatically whenever you
  129.         use a ``-?'' or invalid option on the command line.
  130.          
  131.         CONTACTING THE AUTHOR
  132.              I am very interested in hearing any suggestions, criticisms or
  133.         bug reports that you may have. For the fastest reply, use electronic
  134.         mail.  I respond almost immediately to all email; if you do not
  135.         receive a reply within a few days your message or my reply may have
  136.         gotten lost.  If nothing else works, try the good old-fashioned paper
  137.         and envelope.  You can reach me via email from many networks:
  138.              From the Internet: write to ``bodoh@xraylith.wisc.edu''.
  139.              From Compuserve: write to ``>INTERNET:bodoh@xraylith.wisc.edu''.
  140.              From Envoy: write to
  141.                   ``[RFC822=\"bodoh(a)xraylith.wisc.edu\"]INTERNET/TELEMAIL/US
  142.                   ''.
  143.              From Fidonet: send mail to the user ``uucp'' at the nearest UUCP
  144.              or Internet gateway; use
  145.                   ``To: bodoh@xraylith.wisc.edu'' as the first line of the
  146.                   message.
  147.              From Applelink: write to ``bodoh@xraylith.wisc.edu@internet#''.
  148.              From DECnet: write to ``cxrl::bodoh''
  149.              From Bitnet: write to ``bodoh@xraylith.BITNET''
  150.              It is currently not possible to send mail to the Internet from
  151.              Genie or Prodigy. 
  152.                   I also participate in the Usenet newsgroup
  153.              COMP.OS.MSDOS.DESQVIEW and I occasionally scan the DESQview Echo
  154.              on Fidonet.
  155.                   Please include a return address if sending email, as not all
  156.              mailers generate correct reply addresses.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.         My old-fashioned address is
  163.              Daniel Bodoh
  164.              1402 Regent St. #417
  165.              Madison, WI USA 53711
  166.         After June 1, 1992, do not contact me at the above address.  Use
  167.              Daniel Bodoh
  168.              3731 Schneider Drive
  169.              Stoughton, WI USA 53589
  170.  
  171.  
  172.  
  173.  
  174.  
  175.         INTRO(1dvsi)                                              INTRO(1dvsi)
  176.                                      DVSI Manual
  177.  
  178.         NAME
  179.              Introduction to DVSI commands
  180.  
  181.         DESCRIPTION
  182.                   Section 1 of the DVSI manual describes each of the commands
  183.              provided in the DVSI package.  This manual page explains some of
  184.              the conventions used as well as information common to most or all
  185.              of the utilities.
  186.                   The utilities accept one-character options which modify the
  187.              behavior of the command.  Except in the case of DVSIHELP(1dvsi)
  188.              and DVSIXDI(1dvsi), the options can be introduced with the ``/''
  189.              or the ``-'' characters.  
  190.                   Some options require an argument.  For example, a common
  191.              option is ``-c'' which puts the utility in a continuous-update
  192.              mode.  The ``-c'' option requires a numeric argument which
  193.              specifies the number of seconds between updates.  The argument
  194.              can either immediately follow ``-c'' with no intervening white
  195.              space, or you can separate ``-c'' and the numerical argument with
  196.              white space.
  197.                   Options can be strung together, but an option that requires
  198.              an argument must be the last in a strung-together list.  For
  199.              example, if the command ``foo'' has options ``-c5'', ``-p'' and
  200.              ``-j'', each of the following are legal:
  201.                   foo -c5 -p -j
  202.                   foo -c 5 -pj
  203.                   foo -pjc5
  204.                   foo /c5 /p /j
  205.                   foo /pjc5
  206.                   All options are case sensitive.  You can use the ``\'' or
  207.              the ``/'' character in filenames. Unfortunately, the first
  208.              character of a filename cannot be a ``/'', because the utilities
  209.              will then interpret it as an option.
  210.                   Some programs require a process id which determines which
  211.              window the utility acts on.  The process id can either be a
  212.              window handle, a Switch Windows number, or the Open Window keys.
  213.                   In order for the utilities to figure out which type of
  214.              process id you used, you must follow some simple rules.  If the
  215.              window handle is used, it must be exactly 4 hexadecimal digits
  216.              long (just as you see in PS(1dvsi)).
  217.                   If you use the Switch Window number, it can optionally be
  218.              preceded with a ``%'' character.  Although the Switch Windows
  219.              menu uses alphabetic characters when the number of windows is
  220.              more than 9, the DVSI utilities use numbers.  If Switch Window
  221.              says ``A'', use 10.
  222.                   One- or two-character Open Window keys are recognized. 
  223.              However, if the first Open Window key is actually a digit, you
  224.              should precede it with an ``o''.  For example, if your Open
  225.              Window menu has the entry ``WordPerfect 5.1        51'', you must
  226.              use ``o51''.  If a numeric Open Window key is not preceded with
  227.              ``o'', it will be interpreted as a Switch Window number.  If two
  228.              or more windows have the same Open Window keys, the one with the
  229.              smallest Switch Window number is used.
  230.  
  231.         NOTATIONS
  232.                   Text that should be typed literally is enclosed in ``'' or
  233.              is in plain text (in Courier for those with a printed manual).
  234.  
  235.  
  236.  
  237.  
  238.  
  239.         INTRO(1dvsi)                                              INTRO(1dvsi)
  240.                                      DVSI Manual
  241.  
  242.                   Option or argument descriptions appear <like this>.
  243.                   [Brackets] indicate optional items.
  244.  
  245.         KEY BINDINGS
  246.                   Some of the utilities can be run continuously in a dedicated
  247.              window.  These programs can be controlled from the keyboard.
  248.                   To                  type
  249.                   redraw the window:  ``r'' or control-L
  250.                   hide the window:    ``b'', ``h'', or the spacebar
  251.                   get help:           ``?''
  252.                   quit:               Escape, ``q'', or ``e''
  253.  
  254.         REGISTERED VS. UNREGISTERED
  255.                   There are only two differences between same-version
  256.              registered and unregistered copies of the DVSI utilities:
  257.                        The ``-q'' option is disabled in the unregistered
  258.                        copies.  This forces you to see the ``UNREGISTERED
  259.                        COPY'' message, but it doesn't beep or require any
  260.                        annoying keystrokes.
  261.  
  262.                        A registered copy displays the serial number in place
  263.                        of ``UNREGISTERED COPY''.
  264.                   If you find the DVSI utilities useful, please pay for them
  265.              and receive a registered copy.  For more information, see the
  266.              files README.1ST and ORDER.TXT.
  267.  
  268.         DIAGNOSTICS
  269.              If any of the utilities encounters an invalid option or can't
  270.              figure out its command line tail, it will launch DVSIHELP and
  271.              exit with DOS error level 1.
  272.  
  273.              If a process is specified and it does not exist, the utilities
  274.              exit with error level 1.  This can be useful in batch files; for
  275.              example:
  276.                   rem check if a window with Open Keys ``BB'' is open
  277.                   :CHECK_EXISTENCE
  278.                   ps -q bb
  279.                   if ERRORLEVEL 1 GOTO PROCESS_GONE
  280.  
  281.              Most programs can generate the following errors:
  282.  
  283.              ``This program requires DESQview 2.26 or higher''
  284.              You need to either run DESQview or get a newer version.
  285.  
  286.              ``This program requires DVSIXDI version 2.00''
  287.              You need to either run DVSIXDI.COM before starting DESQview or
  288.              you need a newer version of DVSIXDI.
  289.  
  290.              ``DVSIXDI not installed or not enough Common Memory''
  291.              Either install DVSIXDI.COM before running DESQview or increase
  292.              the amount of Common Memory in the DESQview setup program.
  293.  
  294.              ``Allocate more system memory to this window''
  295.              Use Change A Program to increase the amount of System Memory
  296.              available to the window.  After doing so, you must close the
  297.              window and restart it.
  298.  
  299.  
  300.  
  301.  
  302.  
  303.         INTRO(1dvsi)                                              INTRO(1dvsi)
  304.                                      DVSI Manual
  305.  
  306.              ``Process not found''
  307.              The specified process does not exist.
  308.  
  309.              ``Cannot open DVSIHELP.DVP''
  310.              In order for DVSIHELP to be spawned, the file DVSIHELP.DVP must
  311.              exist in the same directory as the program spawning it.
  312.  
  313.              ``Cannot spawn DVSIHELP''
  314.              DESQview reported an error when the program attempted to launch
  315.              DVSIHELP.
  316.              Check the values in DVSIHELP.DVP.
  317.  
  318.              ``UNREGISTERED COPY: -q not available''
  319.              Register DVSI and ``-q'' will work.
  320.  
  321.         FILES
  322.              DVSIHELP.DVP
  323.              This file must exist in the same directory as the program that
  324.              launches DVSIHELP.  The ``Directory'' field must also contain the
  325.              DVSI directory name.
  326.  
  327.  
  328.  
  329.  
  330.  
  331.         BACKGROUND PRINTING(1dvsi)                  BACKGROUND PRINTING(1dvsi)
  332.                                      DVSI Manual
  333.  
  334.         NAME
  335.              Background printing utilities
  336.         DESCRIPTION
  337.                   This manual page gives an overview of the DVSI utilities
  338.              provided for background printing.  More information is available
  339.              in LPD(1dvsi), LPR(1dvsi),  LPRM(1dvsi), LPQ(1dvsi), PRCC(1dvsi)
  340.              and PRINTCAP(5dvsi).
  341.                   The utilities for background printing are very similar to
  342.              their Unix counterparts.  Each one of the utilities requires that
  343.              one LPD window is open.
  344.                   LPD is not a memory-resident program.  It must be run in its
  345.              own dedicated window.  This window will not accept any keyboard
  346.              input so it will look as if the window is ``locked up''. 
  347.              However, LPD is waiting for a request from the other utilities. 
  348.              As LPD receives and processes requests, it will print the date
  349.              and time as well as a description of the request in the window. 
  350.              LPD is the main workhorse:  it does all the printing, but does
  351.              not directly interact with the user.
  352.                   You should probably start LPD from your Startup script so
  353.              you don't have to open the window by hand.
  354.                   LPR sends files to LPD for printing.   Even though you can
  355.              specify multiple files or print multiple copies from LPR, each
  356.              run of LPR only submits one print ``job'' to LPD.  In other
  357.              words, a job can consist of one or more copies of one or more
  358.              files submitted by one LPR command.  Each job is assigned a
  359.              unique number.
  360.                   LPQ lists the jobs that are currently in the LPD queue. 
  361.              Since LPD can only be printing one job at a time, other jobs must
  362.              wait in line for their turn at the printer.  Each row of the LPQ
  363.              display lists information on one file, including the job to which
  364.              the file belongs.  The file which is currently printing is
  365.              labelled ``active''.
  366.                   LPRM removes a job from the queue, whether or not the job
  367.              contains an ``active'' file.
  368.                   The job of PRCC is to read the PRINTCAP file, process it,
  369.              and send the results to LPD (see below).  You can use PRCC when
  370.              you make a change to PRINTCAP.  However, PRCC is automatically
  371.              run when LPD starts up.
  372.  
  373.                   Printers are defined in the text file named PRINTCAP.  This
  374.              file maps ``logical'' printers onto ``physical'' printers.  A
  375.              physical printer is how you know the printer on a day-to-day
  376.              basis: LPT1, COM1, print-to-file, etc.  A logical printer is just
  377.              a name given to a physical printer and formatting
  378.              characteristics.  More than one logical printer may use the same
  379.              physical printer.
  380.                   You must edit the PRINTCAP file with any text editor to
  381.              define the printers available on your system.  The format of this
  382.              file is described in PRINTCAP(5dvsi).  A sample PRINTCAP is
  383.              provided.
  384.                   For example, the simplest PRINTCAP entry simply assigns the
  385.              name ``lp'' to ``LPT1''.  That means that when you type
  386.                   LPR -Plp autoexec.bat
  387.              your AUTOEXEC.BAT file is sent to LPT1.  LPD can print to 4 types
  388.              of physical printers: LPT, COM, FILE and DVP.
  389.                   The LPT and COM physical printers are simply printers
  390.  
  391.  
  392.  
  393.  
  394.  
  395.         BACKGROUND PRINTING(1dvsi)                  BACKGROUND PRINTING(1dvsi)
  396.                                      DVSI Manual
  397.  
  398.              connected to your LPT and COM ports.  The FILE physical printer
  399.              type is just like the ``print-to-file'' option available in
  400.              applications.  A logical printer mapped onto a physical printer
  401.              of type FILE copies the file to a DOS device driver or file.
  402.                   The DVP physical printer type is a different concept.  Let's
  403.              say you have a special program for printing to your network
  404.              printer, called NETPRINT.  You can create a DVP (DESQview Program
  405.              information File) with Change A Program that runs NETPRINT.  Then
  406.              you can create a logical printer in PRINTCAP called, say, ``net''
  407.              which is a DVP-type printer.  Whenever you print to the logical
  408.              printer ``net'', a window will be opened to run NETPRINT.  The
  409.              background printing utilities will easily replace NETPRINT.
  410.         SEE ALSO
  411.              LPD(1dvsi), LPR(1dvsi), LPRM(1dvsi), LPQ(1dvsi), PRCC(1dvsi),
  412.              PRINTCAP(5dvsi)
  413.  
  414.  
  415.  
  416.  
  417.  
  418.         DF(1dvsi)                                                    DF(1dvsi)
  419.                                      DVSI Manual
  420.  
  421.         NAME
  422.              df - display free and used disk space
  423.  
  424.         SYNOPSIS
  425.              df [<options>] [<drive list>]
  426.  
  427.         DESCRIPTION
  428.                   The DF utility will report the current free and used disk
  429.              space for each of the logical drives in the system.  It
  430.              identifies networked, JOINed and SUBSTituted drives.  Without a
  431.              <drive list> DF finds and displays information on all drives ``C:''
  432.              and higher.
  433.                   If <drive list> is specified, DF report only on the drives the
  434.              list.  The list must contain 1 or more drive names with no
  435.              separating blanks.  Case is not important.  For example, to
  436.              report only on drives A:, E: and F:, <drive list> would be ``AEF''
  437.              or ``A:E:F:''.
  438.                   DF can be used outside of DESQview.  However, only the ``-
  439.              q'', ``-t'', ``-w'' and <drive list> options are available.
  440.                   DF is known to work with 
  441.                   ■ Digital Equipment Corporation's PathWorks 3.0 and 4.0,
  442.                   ■ IBM PC Lan, and
  443.                   ■ Novell Netware.
  444.              If you successfully or unsuccessfully run DF on another network,
  445.              please let me know.
  446.  
  447.         FIELDS
  448.              There are several columns of information presented for each
  449.              drive:
  450.  
  451.              DR
  452.              The logical name of the drive, such as C:.
  453.  
  454.              FLGS
  455.              Flags, indicating the drive type.  The flags are
  456.                   l         Local drive
  457.                   n         Network drive
  458.                   j         JOINed drive
  459.                   s         SUBSTituted drive
  460.  
  461.              TOTAL KBYTES
  462.              The total capacity of the drive in kilobytes.
  463.  
  464.              KBYTES USED
  465.              The amount of space that is in use on the drive, in kilobytes.
  466.  
  467.              KBYTES FREE
  468.              The available space on the drive, in kilobytes.
  469.  
  470.              % USED
  471.              Percentage of total space on the drive that is in use.
  472.  
  473.              VOLUME LABEL
  474.              The label given to the drive.  If no label exists, ``(none)'' is
  475.              printed.
  476.  
  477.  
  478.  
  479.  
  480.  
  481.         DF(1dvsi)                                                    DF(1dvsi)
  482.                                      DVSI Manual
  483.  
  484.              MOUNTED ON
  485.              If drive is JOINed, this is the directory that the drive is
  486.              JOINed under.  If the drive is a SUBST drive, this is the
  487.              directory that the drive letter refers to.  If the drive is a
  488.              network drive, this field is the network drive name.  Otherwise,
  489.              this field is the root directory name (like ``C:\'').  The
  490.              ``MOUNTED ON'' field can be replaced  with ``CURRENT DIR'' if the
  491.              ``-w'' option is used.
  492.  
  493.              CURRENT DIR
  494.              The current directory field replaces the mounted on field if ``-
  495.              w'' is used.  This column contains the current working directory
  496.              on each drive.
  497.  
  498.         OPTIONS
  499.              -c<n>
  500.              Continuously update the list every <n> seconds.  Normally, DF lists
  501.              the disk space and exits.  This option is most useful when DF is
  502.              used in its own window.  The value of <n> must be an integer
  503.              between 0 and 65535.  See ``KEY BINDINGS'' in INTRO(1dvsi).
  504.  
  505.              -r
  506.              Resize the window to fit exactly the number of drives in the
  507.              system.  Useful with ``-c''.
  508.  
  509.              -p
  510.              Print ``Press any key to continue...'' and wait for keystroke
  511.              before exiting.
  512.  
  513.              -w
  514.              Replace the ``Mounted On'' field with ``Current Dir''.
  515.  
  516.              -q
  517.              Quiet - does not print banner.
  518.  
  519.              -t
  520.              Terse - does not print column headings.
  521.  
  522.              -?
  523.              Launches DVSIHELP(1dvsi).  The help program is also launched if
  524.              any invalid option is used.
  525.  
  526.         CAVEATS
  527.                   Using ``-w'' if DF is run continuously in its own window
  528.              with ``-c'' will only report on the current directories for that
  529.              window.  DESQview maintains separate current directories for each
  530.              window.
  531.  
  532.         BUGS
  533.                   If using ``-c'' and ``-r'', the maximum size of the window
  534.              must be as large as the (max number of drives+1) or strange
  535.              things will happen.
  536.                   The volume label on a JOINed drive is reported as "(none)". 
  537.              This is a DOS bug.
  538.  
  539.  
  540.  
  541.  
  542.  
  543.         DF(1dvsi)                                                    DF(1dvsi)
  544.                                      DVSI Manual
  545.  
  546.         DIAGNOSTICS
  547.              See INTRO(1dvsi)
  548.  
  549.              ``Bad command line; help not available outside of DESQview''
  550.              An invalid option was found on the command line.
  551.         FILES
  552.              DF-PIF.DVP
  553.              DVP to use for opening DF from the Open Window menu.
  554.  
  555.         SEE ALSO
  556.              INTRO(1dvsi), DVSIHELP(1dvsi)
  557.  
  558.  
  559.  
  560.  
  561.  
  562.         DVSIHELP(1dvsi)                                        DVSIHELP(1dvsi)
  563.                                      DVSI Manual
  564.  
  565.         NAME
  566.              dvsihelp - Help for DVSI utilities
  567.  
  568.         SYNOPSIS
  569.              dvsihelp [/s]
  570.  
  571.         DESCRIPTION
  572.                   DVSIHELP is a quick way to find the command line arguments
  573.              for a DVSI utility.   The DVSIHELP utility displays a menu
  574.              containing the name and description of each ofthe DVSI programs. 
  575.              Pressing ENTER will display the command line options to use for
  576.              the highlighted program. Use the arrow keys to navigate through
  577.              the menu.
  578.                   DVSIHELP was compiled with Dave's Readme Compiler (DRC) by
  579.              David Harris, Dunedin, New Zealand.
  580.                   The DVSI utilities launch DVSIHELP through DVSIHELP.DVP if
  581.              ``-?'' is used or an invalid option is found.
  582.         OPTIONS
  583.              /s
  584.              Do not clear the screen or change the background.
  585.         BUGS
  586.                   Unfortunately, DVSIHELP is not very nice to DESQview.  It is
  587.              completely DESQview-oblivious, and writes directly to the screen.
  588.              Therefore, you must run it from the provided DVSIHELP.DVP or make
  589.              sure the window you run it in is set to ``Writes Directly to
  590.              Screen'' and ``Virtualize Text''.  Non-386 users will have to
  591.              deal with it in full-screen mode.  I'm working with the author of
  592.              the compiler to make it DESQview-aware.
  593.                   DVSIHELP does not know about window sizes that are larger
  594.              than 25 lines, so it may put the cursor in the wrong place when
  595.              it terminates.
  596.         FILES
  597.              DH-PIF.DVP
  598.              DVP used to open DVSIHELP from the Open Window menu.
  599.  
  600.              DVSIHELP.DVP
  601.              This file must exist in the same directory as the program that
  602.              launches DVSIHELP.  To edit DVSIHELP.DVP, type ``INSTLAC
  603.              DVSIHELP.DVP'' at the command line or get DvpEdit (see
  604.              README.1ST).  INSTALL.EXE will automatically put the proper
  605.              ``Directory'' name into this file.
  606.  
  607.  
  608.  
  609.  
  610.  
  611.         DVSIXDI(1dvsi)                                          DVSIXDI(1dvsi)
  612.                                      DVSI Manual
  613.  
  614.         NAME
  615.              dvsixdi - External Device Interface for DVSI
  616.  
  617.         SYNOPSIS
  618.              In autoexec.bat:
  619.              [loadhi or loadhigh] dvsixdi.com [-p<n>] [-t]
  620.  
  621.         DESCRIPTION
  622.                   DVSIXDI is the heart of DVSI.  It keeps track of the
  623.              processes that DESQview starts and stops, as well as the CPU time
  624.              of each process and other information.  Basically, whenever
  625.              DESQview does something important, it calls DVSIXDI to record
  626.              what is happening.
  627.                   DVSIXDI should be installed before DESQview is run.  It is
  628.              best to put it in AUTOEXEC.BAT.  Without the ``-t'' option, it
  629.              will take up about 1.4K of memory after it terminates.  To
  630.              minimize the memory it requires, load it (and any other TSRs)
  631.              before you set your PATH and other environment variables. 
  632.              Preferably, it should be loaded in high memory, but this is not
  633.              required.
  634.                   DVSIXDI requires at least version 2.26 of DESQview.  If you
  635.              have an earlier version, some of the DVSI programs will not work
  636.              because DESQview will not communicate with DVSIXDI.
  637.                   If it loads successfully, the amount of Common Memory that
  638.              DVSIXDI will require is displayed.  You must go into DESQview's
  639.              setup and set the Common Memory field to at least this many
  640.              kilobytes above the minimum value that SETUP will allow.  If
  641.              there is not enough Common Memory, running any of the programs
  642.              that use DVSIXDI will display an error message and exit.
  643.                   Since Common Memory is allocated in conventional memory, too
  644.              much of it will reduce your maximum window size.  The ``-p''
  645.              option is provided to tailor DVSIXDI to your DESQview load.
  646.                   Users of Mike Weaver's DVTree and DV Task Manager can use
  647.              DVSIXIDI.COM to replace Mike Weaver's DVTXDI.COM by using the ``-
  648.              t'' option.  This causes DVSIXDI.COM to also act as DVTXDI.COM. 
  649.              The code that emulates DVTXDI.COM is directly from Mike Weaver
  650.              and he tested the ``-t'' option.  Using ``-t'' instead of
  651.              DVSIXDI.COM will save you about 1.9K over loading both
  652.              DVSIXDI.COM and DVTXDI.COM.   With the ``-t'' option DVSIXDI.COM
  653.              will require 1.6K resident.
  654.  
  655.         OPTIONS
  656.              -p<n>
  657.              Set the number of processes that DVSIXDI keeps track of to <n>.  If
  658.              ``-p'' is not specified, <n> defaults to 15.  The value of <n> should
  659.              be a decimal number between 0 and 64.  Processes started after <n>
  660.              processes exist (counting the DV System Task) will never be seen
  661.              by DVSIXDI.  Once the number of processes drops below <n>, DVSIXDI
  662.              will start seeing new processes.
  663.                   DVSIXDI will use 39*<n> bytes of Common Memory.  The number
  664.              displayed on the DVSIXDI startup screen is rounded up to the next
  665.              integer kilobyte value.
  666.  
  667.              -t
  668.              Act like Mike Weaver's DVTXDI.COM in addition providing support
  669.              for DVSI utilities.
  670.  
  671.  
  672.  
  673.  
  674.  
  675.         DVSIXDI(1dvsi)                                          DVSIXDI(1dvsi)
  676.                                      DVSI Manual
  677.  
  678.         CAVEATS
  679.                   Mike Weaver's DVTXDI will track up to 64 simultaneously-open
  680.              DESQview windows, but DVSIXDI -t will only track the amount
  681.              specified with ``-p'' (or 15 if not ``-p'' not used).
  682.                   Loading DVTXDI.COM after DVSIXDI.COM will nullify ``-t''. 
  683.              However, if DVSIXDI.COM with ``-t'' is loaded after DVTXDI.COM,
  684.              DVTXDI.COM will be ignored.
  685.  
  686.         DIAGNOSTICS
  687.              DVSIXDI may display an error message and not load.  If it does
  688.              not load, it sets the error level to 1.  If DVSIXDI load
  689.              successfully, the DOS error level is set to 0.  The possible
  690.              error messages are:
  691.  
  692.              ``Error: Already Installed''
  693.              You can only load DVSIXDI once.
  694.  
  695.              ``Error: No available slots''
  696.              You have too many TSRs loaded that use the Multiplex interrupt
  697.              2F.  DVSIXDI cannot be loaded until an interrupt 2F slot is
  698.              available.
  699.  
  700.         SEE ALSO
  701.              DVSTUFF(1dvsi), KILL(1dvsi), MEMSTAT(1dvsi), PERF(1dvsi),
  702.              PS(1dvsi), RUN(1dvsi), UPTIME(1dvsi), WN(1dvsi), DVSIXDI(2dvsi),
  703.              documentation provided with Mike Weaver's DV Tree and DV Task
  704.              Manager
  705.  
  706.  
  707.  
  708.  
  709.  
  710.         DVSTUFF(1dvsi)                                          DVSTUFF(1dvsi)
  711.                                      DVSI Manual
  712.  
  713.         NAME
  714.              dvstuff - Stuff keystrokes into any window
  715.  
  716.         SYNOPSIS
  717.              dvstuff [-d] [-e] <process id> [<key ...>]
  718.  
  719.         DESCRIPTION
  720.                   DVSTUFF will stuff keystrokes into any window as if they had
  721.              been typed by the user; if ``-d'' is used the keystrokes will be
  722.              sent to the DESQview menu.  The <process id> argument must not be
  723.              present if ``-d'' is used.  Any scripts that are attached to the
  724.              key are ignored.
  725.                   The <process id> argument is a window handle, Switch Window
  726.              number, or Open Window keys.  See INTRO(1dvsi).  Using the handle
  727.              of the DV System Task is equivalent to ``-d''.
  728.                   The <keys> argument is a list of the keystrokes to send to the
  729.              window.  Most keys are sent as-is.  That means that an ``A'' is
  730.              sent as an ``A'' and an ``a'' is sent as an ``a''.  However some
  731.              keystrokes, like the function keys, cannot be inserted on the
  732.              command line.
  733.                   To solve this problem DVSTUFF accepts ``metacharacters''. 
  734.              Metacharacters are two- or three-character sequences that
  735.              represent another non-printable character.  Using metacharacters
  736.              you can send function keys, cursor movement keys, alt-keys and
  737.              control keys to another window.
  738.                   Spaces may be inserted on the command line for readability. 
  739.              Since the space character is not sent as-is, it has its own
  740.              metacharacter: ``$s''.
  741.                   If you don't specify any <key> argument, DVSTUFF reads
  742.              keystrokes from the standard input.  You may pipe input to
  743.              DVSTUFF or get input from a file with the usual ``|'' and ``<''
  744.              characters.  Input is terminated by pressing Control-Z and
  745.              hitting RETURN.
  746.                   DVSIXDI 2.00 must be installed to use DVSTUFF.
  747.         METACHARACTERS
  748.              $S       Shift the next key, ignored if key is not a function key
  749.              $A       Alt the next key, ignored if key is not a function or
  750.         alpha key
  751.              $^       Control the next key
  752.              $F01 to
  753.              $F12     Function keys 1 through 12.  The leading 0 must be
  754.         present.
  755.              $K0 to
  756.              $K9      Keypad 0 through 9.
  757.              $K.      Keypad dot
  758.              $K*      Keypad *
  759.              $K-      Keypad -
  760.              $K/      Keypad /
  761.              $KE      Keypad enter
  762.              $K+      Keypad +
  763.              $~<aass>   Two-digit hex ASCII code in <aa> and two-digit scan code
  764.         in <ss>
  765.              $u       Page up
  766.              $d       Page down
  767.              $h       Home
  768.              $i       Insert
  769.  
  770.  
  771.  
  772.  
  773.  
  774.         DVSTUFF(1dvsi)                                          DVSTUFF(1dvsi)
  775.                                      DVSI Manual
  776.  
  777.              $l       Delete
  778.              $e       End
  779.              $U       up arrow
  780.              $D       down arrow
  781.              $L       left arrow
  782.              $R       right arrow
  783.              $r       ENTER or RETURN
  784.              $s       space bar
  785.              $E       Escape
  786.              $T       tab
  787.              $B       backspace 
  788.              $$       Dollar sign
  789.         OPTIONS
  790.              -d
  791.              Send keystrokes to DESQview menu.  If ``-d'' is used, the <process>
  792.         <id> must not be present.
  793.  
  794.              -e
  795.              Simulate enhanced keyboard with $u, $d, $i, $l, $h and $e.
  796.  
  797.         EXAMPLES
  798.              Use DVSTUFF to run PS in a Big Dos window with Open Window keys
  799.         ``BD''
  800.                   dvstuff bd PS $r
  801.  
  802.              Use DVSTUFF to do a Rearrange-Hide
  803.                   dvstuff -d R H
  804.         CAVEATS
  805.                   If the process specified by <process id> is set to ``Runs In
  806.              Background=N'', the window will not act on the keys until you
  807.              switch to it.
  808.                   Applications that read the keyboard directly or monitor the
  809.              shift states will not work properly with DVSTUFF.
  810.         SEE ALSO
  811.              INTRO(1dvsi), DVSIXDI(1dvsi), PS(1dvsi)
  812.  
  813.  
  814.  
  815.  
  816.  
  817.         INSTALL(1dvsi)                                          INSTALL(1dvsi)
  818.                                      DVSI Manual
  819.  
  820.         NAME
  821.              install - Installation program for DVSI
  822.  
  823.         SYNOPSIS
  824.              While running DESQview:
  825.              install
  826.  
  827.         DESCRIPTION
  828.                   INSTALL is the optional (but recommended) installation
  829.              program for DVSI.  It is intended to be as flexible as possible. 
  830.              Each of the installation steps may be skipped.  INSTALL explains
  831.              the consequences of skipping each step.
  832.                   The file README.1ST describes the manual installation
  833.              process.  This process is essentially what INSTALL does
  834.              automatically.
  835.         FILES
  836.              INSTALL copies each file in the DVSI package to a user-specified
  837.              destination directory.
  838.  
  839.              AUTOEXEC.DVS
  840.              Created by INSTALL as a template for the user to edit
  841.              AUTOEXEC.BAT.
  842.  
  843.              DVSIHELP.DVP and PRCC.DVP
  844.              INSTALL changes the ``Directory'' field to the DVSI destination
  845.              directory.
  846.         SEE ALSO
  847.              The file README.1ST
  848.  
  849.  
  850.  
  851.  
  852.  
  853.         KILL(1dvsi)                                                KILL(1dvsi)
  854.                                      DVSI Manual
  855.  
  856.         NAME
  857.              kill - Kill a DESQview process
  858.  
  859.         SYNOPSIS
  860.              kill [-p] [-?] <process id>
  861.  
  862.         DESCRIPTION
  863.                   KILL ``kills'' a DESQview process.  It works just like
  864.              ``Close Window'' except that it will kill the process even if the
  865.              ``Allow Close Window Command=N'' in the DVP file.  This command
  866.              is dangerous, because you could easily lose data if you don't
  867.              save before using kill.  It is much better to exit a program
  868.              (especially non-DESQview programs) from the program itself.
  869.                   The process to be killed is unswapped, brought to the top,
  870.              and killed.  Kill then displays the handle of the killed process.
  871.                   KILL requires DVSIXDI 2.00 to be installed.
  872.                   The <process id> argument identifies the window to be killed. 
  873.              It can either be a window handle, a Switch Window number, or the
  874.              Open Window keys.  See INTRO(1dvsi) for more information.
  875.         OPTIONS
  876.              -p
  877.              When the process is killed, print ``Press any key to
  878.              continue...'' and wait for a keystroke.
  879.  
  880.              -?
  881.              Opens a DVSIHELP window.
  882.         SEE ALSO
  883.              INTRO(1dvsi), DVSIXDI(1dvsi), WN(1dvsi)
  884.  
  885.  
  886.  
  887.  
  888.  
  889.         LPD(1dvsi)                                                  LPD(1dvsi)
  890.                                      DVSI Manual
  891.  
  892.         NAME
  893.              lpd - line printer daemon
  894.  
  895.         SYNOPSIS
  896.              lpd [-e<file>] [-l<file>] [-p<file>] [-c<file>] [-s]
  897.  
  898.         DESCRIPTION
  899.                   You should read BACKGROUND PRINTING(1dvsi) before reading
  900.              this man page if to get an overview of the printing suite.
  901.                   The line printer daemon is the heart of the background
  902.              printing suite.  Each of the LP-utilities communicate with LPD,
  903.              so they require that an LPD window be running.
  904.                   For those of you not familiar with Unix, a ``daemon'' is a
  905.              program that runs in the background.  It's kind of like a genie
  906.              in a bottle, just sitting there content to do nothing.  However,
  907.              at any time you can ``make a wish'' and the genie-daemon will
  908.              fulfill that wish.
  909.                   The LPD utility is a genie that can only fulfill wishes that
  910.              involve printing.  In fact, its powers are pretty limited:  it
  911.              maintains a list of files for printing, to which you can add a
  912.              file, delete a file, or view the list.  The LPD-genie chugs away
  913.              in the background printing the top file on the list.
  914.                   Unfortunately, this LPD-genie doesn't understand English, so
  915.              you can't type commands to it.  Your translators are the
  916.              utilities LPR, LPRM, LPQ and PRCC.
  917.                   Enough with the genie analogy.  The sole purpose of LPD is
  918.              to print files.  It does not accept keyboard commands.  It only
  919.              accepts requests from the four other LP utilities.
  920.                   LPD accepts requests to print to ``logical'' printers, and
  921.              maps these requests onto ``physical'' printers as discussed in
  922.              BACKGROUND PRINTING(1dvsi).  The logical-to-physical printer
  923.              mapping is contained in the PRINTCAP file.  You must edit the
  924.              PRINTCAP file with a standard text editor to define the printers
  925.              on your system.
  926.                   In order to reduce memory overhead, LPD does not directly
  927.              read PRINTCAP.  Instead, it opens a PRCC(1dvsi) window to compile
  928.              and send it the data in PRINTCAP.  If PRINTCAP is updated, LPD
  929.              will not see the changes until PRCC is next run.  See
  930.              PRINTCAP(5dvsi) for the PRINTCAP file format.
  931.                   LPD is different that its Unix equivalent.  In Unix, each
  932.              printer has its own list (commonly called a queue).  With DVSI's
  933.              LPD, there is only one queue; but each job in that queue can go
  934.              to a different printer.
  935.                   Only one copy of LPD can be running at a time.  A running
  936.              LPD does not let another LPD start.  A running LPD can be shut
  937.              down by typing ``lpd -s''.
  938.                   LPD can be opened from a startup script, so it is always
  939.              active.
  940.         PHYSICAL PRINTERS
  941.              LPD knows about 4 types of physical printers:
  942.  
  943.              LPT
  944.              A printer connected to LPT1 or LPT2.
  945.  
  946.              COM
  947.              A printer connected to COM1 or COM2.
  948.  
  949.  
  950.  
  951.  
  952.  
  953.         LPD(1dvsi)                                                  LPD(1dvsi)
  954.                                      DVSI Manual
  955.  
  956.  
  957.              FILE
  958.              This physical printer is actually not a printer.  If you use the
  959.              FILE printer type, you also specify the name of a file or device
  960.              in PRINTCAP.  Then, a file submitted with LPR is copied to this
  961.              file.  The FILE printer is just like a ``print-to-file'' option
  962.              in an application.
  963.  
  964.              DVP
  965.              The DVP printer type is again not actually a printer.  In the
  966.              PRINTCAP file, you must specify the name of a DESQview Program
  967.              information File (DVP) created by Change a Program or another DVP
  968.              editor.  When LPR submits a file, the filename is copied into the
  969.              ``Program Parameters'' field and a window is opened to run the
  970.              program specified in the DVP.  This physical printer can be used
  971.              to start network printer programs, etc.  The launched program
  972.              must not print to a logical printer that maps onto the same DVP,
  973.              or infinite recursion will result.
  974.  
  975.              For examples, see PRINTCAP(5dvsi).
  976.         OPTIONS
  977.              -e<file>
  978.              Change the error log file to <file>.  The default is CON, which
  979.              means errors are printed in the LPD window.
  980.  
  981.              -l<file>
  982.              Change the log file to <file>.  The default is CON, which means
  983.              that messages are printed in the LPD window.
  984.  
  985.              -p<file>
  986.              Read printer capabilities from <file>.  The default is PRINTCAP.
  987.  
  988.              -c<file>
  989.              Defines the printcap compiler's DVP, default is PRCC.DVP in the
  990.              current directory.
  991.  
  992.              -s
  993.              Shut down another LPD window that is currently running.
  994.         DIAGNOSTICS
  995.              See INTRO(1dvsi)
  996.  
  997.              The following errors are written to the error log file.
  998.  
  999.              ``Cannot start PRCC''
  1000.              The printcap compiler could not be launched.  Check the values in
  1001.              PRCC.DVP.
  1002.  
  1003.              ``Printer <pr> doesn't exist''
  1004.              An operation was attempted on printer <pr> which is not in
  1005.              PRINTCAP.
  1006.  
  1007.              ``Cannot open <file>''
  1008.              The specified file could not be opened by LPD.
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.         LPD(1dvsi)                                                  LPD(1dvsi)
  1015.                                      DVSI Manual
  1016.  
  1017.              ``Printer <pr> is out of paper''
  1018.              The out-of-paper signal was seen on the LPT port onto which <pr>
  1019.              maps.
  1020.  
  1021.              ``Printer <pr> is offline''
  1022.              The offline signal was seen on the LPT port onto which <pr> maps.
  1023.  
  1024.              ``Printer <pr> I/O error''
  1025.              An unidentified error was detected on the LPT port onto which <pr>
  1026.              maps.
  1027.  
  1028.              ``Printer <pr> timed out''
  1029.              The printer <pr> is not accepting characters.
  1030.  
  1031.              ``Error writing to device or file''
  1032.              An error occurred while LPD was writing to a file or device.
  1033.  
  1034.              ``Cannot open DVP file''
  1035.              LPD could not open the DVP for reading.
  1036.  
  1037.              ``Cannot start DVP''
  1038.              DESQview returned an error when the DVP was launched.
  1039.  
  1040.              ``Cannot initialize printer <pr>, deleting''
  1041.              A printer error occurred during initialization.
  1042.  
  1043.              ``Cannot open output device or file''
  1044.              The output device or file could not be opened by LPD.
  1045.  
  1046.              ``Cannot delete <file>''
  1047.              LPD could not delete the file <file>.
  1048.  
  1049.              ``Not enough system memory''
  1050.              Allocate more system memory to the LPD window.
  1051.  
  1052.              ``Attempt to use R_RM, not supported''
  1053.              You cannot specify ``lpr -r'' if the physical printer is type
  1054.              DVP.
  1055.  
  1056.              ``PRCC exited with error''
  1057.              PRCC found a syntax error in the PRINTCAP file.  The current list
  1058.              of printers that LPD knows about may be incomplete.
  1059.          
  1060.         FILES
  1061.              CON
  1062.              Default device for log and error log.
  1063.  
  1064.              LP-PIF.DVP
  1065.              DVP used to open the LPD window from Open Window.
  1066.  
  1067.              PRINTCAP
  1068.              Default printer capabilities file.
  1069.  
  1070.              PRCC.DVP
  1071.              Default DVP for launching PRCC.
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.         LPD(1dvsi)                                                  LPD(1dvsi)
  1078.                                      DVSI Manual
  1079.  
  1080.              DVSIHELP.DVP
  1081.              Used to launch DVSIHELP if a bad option is given.
  1082.  
  1083.         SEE ALSO
  1084.              BACKGROUND PRINTING(1dvsi), DVSIHELP(1dvsi), LPR(1dvsi),
  1085.              LPRM(1dvsi), LPQ(1dvsi), PRCC(1dvsi), PRINTCAP(5dvsi)
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.         LPR(1dvsi)                                                  LPR(1dvsi)
  1092.                                      DVSI Manual
  1093.  
  1094.         NAME
  1095.              lpr - Submit files to LPD for printing
  1096.  
  1097.         SYNOPSIS
  1098.              lpr [-P<printer>] [-n] [-z<n>] [-#<c>] [-r] [-f] [<file ...>]
  1099.  
  1100.         DESCRIPTION
  1101.                   LPR submits the files to LPD for printing on the logical
  1102.              printer <printer> defined in PRINTCAP.  If ``-P'' is not specified,
  1103.              the PRINTER environment variable is read.  If it is not set, the
  1104.              files are submitted to the logical printer ``lp''.  There must
  1105.              always be an ``lp'' printer in PRINTCAP.
  1106.                   The <file> argument can contain the wildcards ``*'' and ``?'',
  1107.              and can contain the Unix-style directory delimiter ``/'';
  1108.              however, the filename must not start with ``/'' or it will be
  1109.              interpreted as an option.
  1110.                   Up to 20 files (after wildcard expansion) can be specified. 
  1111.              If no files are specified LPR reads from the standard input.
  1112.                   An invalid argument causes a DVSIHELP window to be opened.
  1113.         OPTIONS
  1114.              -P<printer>
  1115.              Submit the file to logical printer <printer>.  Defaults to the
  1116.              value of the PRINTER environment variable or to ``lp''.
  1117.  
  1118.              -n
  1119.              Notify when the print job is completed.  LPD pops up a small
  1120.              window and beeps.
  1121.  
  1122.              -z<n>
  1123.              Set the pagelength to <n> lines.  Overrides the value of ``pl'' in
  1124.              PRINTCAP, but has no effect if ``sf'' is set.
  1125.  
  1126.              -#<c>
  1127.              Print <c >copies of each file.
  1128.  
  1129.              -r
  1130.              Delete (remove) the files when done printing.  This option cannot
  1131.              be used with logical printers that map onto the DVP physical
  1132.              printer type.
  1133.  
  1134.              -f
  1135.              Tell LPD to print the file as fast as it can.  Normally, LPD
  1136.              tries to be nice to DESQview and not degrade system performance. 
  1137.              However, if another window is taking a lot of CPU time, the
  1138.              printing may go very slow.  The ``-f'' option speeds up printing
  1139.              at the expense of system performance.
  1140.  
  1141.         DIAGNOSTICS
  1142.              See INTRO(1dvsi) and LPD(1dvsi)
  1143.  
  1144.              ``LPD daemon not present''
  1145.              The LPD program must be running.
  1146.  
  1147.              ``Cannot access file <file>''
  1148.              The specified file could not be opened and will not be submitted.
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.         LPR(1dvsi)                                                  LPR(1dvsi)
  1155.                                      DVSI Manual
  1156.  
  1157.              ``-r not supported on requested printer''
  1158.              The printer is of type DVP.
  1159.  
  1160.         FILES
  1161.              PRINTCAP
  1162.              Contains descriptions of the logical printers.
  1163.  
  1164.         SEE ALSO
  1165.              BACKGROUND PRINTING(1dvsi), LPD(1dvsi), LPRM(1dvsi), LPQ(1dvsi),
  1166.              PRINTCAP(5dvsi)
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.         LPRM(1dvsi)                                                LPRM(1dvsi)
  1173.                                      DVSI Manual
  1174.  
  1175.         NAME
  1176.              lprm - Remove jobs from the printer queue
  1177.  
  1178.         SYNOPSIS
  1179.              lprm [-P<printer>] [<job ...>]
  1180.  
  1181.         DESCRIPTION
  1182.                   LPRM removed jobs from the printer queue that were
  1183.              previously submitted by LPR.  The job id's can be displayed with
  1184.              LPQ and are printed when LPR submits the job.
  1185.                   The ``-P'' argument is ignored; it is provided for Unix
  1186.              compatibility.
  1187.         DIAGNOSTICS
  1188.              See INTRO(1dvsi)
  1189.  
  1190.              ``LPD daemon not present''
  1191.              The line printer daemon must be running.
  1192.  
  1193.         SEE ALSO
  1194.              INTRO(1dvsi), BACKGROUND PRINTING(1dvsi), LPD(1dvsi), LPR(1dvsi),
  1195.              LPQ(1dvsi)
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.         LPQ(1dvsi)                                                  LPQ(1dvsi)
  1202.                                      DVSI Manual
  1203.  
  1204.         NAME
  1205.              lpq - List the jobs in the printer queue
  1206.  
  1207.         SYNOPSIS
  1208.              lpq [-P<printer>] [+[<n>]] [-c<n>] [-q] [<job ...>]
  1209.  
  1210.         DESCRIPTION
  1211.                   The LPQ command displays a list of the current print jobs
  1212.              that are queued to LPD.  The list is somewhat similar to its Unix
  1213.              equivalent.  If there are no jobs in the queue, ``no entries'' is
  1214.              printed.
  1215.                   The list contains one line for each file in the queue; a job
  1216.              containing multiple files spans more that one line.
  1217.                   The ``-P'' argument is ignored; the entire queue is
  1218.              displayed.  If one or more jobs is specified, only those jobs are
  1219.              displayed.
  1220.         FIELDS
  1221.              The columns displayed include
  1222.  
  1223.              RANK
  1224.              The number of jobs ahead of this job.  The currently-printing job
  1225.              is labelled ``active''.
  1226.  
  1227.              PRINTER
  1228.              The logical printer to which this job will be sent.
  1229.  
  1230.              JOB
  1231.              The job to which this file belongs.  Use this number with LPRM.
  1232.  
  1233.              FILE
  1234.              The file name of the file to be printed.
  1235.  
  1236.              SIZE
  1237.              Number of bytes in the file multiplied by the number of copies
  1238.              that will be printed.
  1239.  
  1240.              %DONE
  1241.              The percentage of the file that has been sent to the printer.
  1242.  
  1243.         OPTIONS
  1244.              -P<printer>
  1245.              Ignored; provided for Unix compatibility.
  1246.  
  1247.              +[<n>]
  1248.              Clear the screen and continuously display the queue, updating the
  1249.              list every <n> seconds.  If <n> is not given, the queue is re-
  1250.              displayed every 30 seconds.  If the queue is emptied, LPQ will
  1251.              terminate.
  1252.  
  1253.              -c<n>
  1254.              Almost a synonym for +<n>; <n> must be specified.  Also, LPQ will not
  1255.              terminate when the queue is emptied.
  1256.  
  1257.              -q
  1258.              Quiet - don't print the banner
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.         LPQ(1dvsi)                                                  LPQ(1dvsi)
  1265.                                      DVSI Manual
  1266.  
  1267.         DIAGNOSTICS
  1268.              See INTRO(1dvsi)
  1269.  
  1270.              ``LPD daemon not running''
  1271.              LPD must be running.
  1272.  
  1273.              ``no entries''
  1274.              There are currently no jobs in the queue.
  1275.  
  1276.         FILES
  1277.              LQ-PIF.DVP
  1278.              DVP used to launch LPQ from the Open Window menu.
  1279.  
  1280.         SEE ALSO
  1281.              INTRO(1dvsi), BACKGROUND PRINTING(1dvsi), LPD(1dvsi), LPR(1dvsi),
  1282.              LPRM(1dvsi)
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.         MEMSTAT(1dvsi)                                          MEMSTAT(1dvsi)
  1289.                                      DVSI Manual
  1290.  
  1291.         NAME
  1292.              memstat - DESQview memory status
  1293.         SYNOPSIS
  1294.              memstat [-c<n>] [-p] [-q] [-t] [-?]
  1295.         DESCRIPTION
  1296.                   MEMSTAT is an alternative to DESQview's Memory Status
  1297.              program.  It takes up much less CPU time and screen space,
  1298.              although it requires more memory than Memory Status.  It can also
  1299.              be used at the DOS command line,  while Memory Status cannot.
  1300.                   MEMSTAT displays the same information as memory status, and
  1301.              adds another column.  The output looks like this:
  1302.  
  1303.              TYPE  TOTAL LARGEST AVAILABLE USED
  1304.              Conv   590K    345K      375K  36%
  1305.              Exp   2912K    576K     1184K  59%
  1306.              Com  25600   10668     10804   58%
  1307.  
  1308.              The columns include
  1309.  
  1310.              TYPE
  1311.              The type of memory described in this row.  ``Conv'' is
  1312.              conventional memory, or memory between 0 and 640K.  ``Exp'' is
  1313.              expanded (EMS or EEMS) memory.  ``Com'' is DESQview's common
  1314.              memory area.
  1315.  
  1316.              TOTAL
  1317.              The total amount of memory in the system.
  1318.  
  1319.              LARGEST
  1320.              The largest block of available memory.
  1321.  
  1322.              AVAILABLE
  1323.              The total amount of memory currently available.
  1324.  
  1325.              USED
  1326.              The percentage of memory that is currently being used.
  1327.  
  1328.         OPTIONS
  1329.              -c<n>
  1330.              Continuously update the statistics every <n> seconds.  Normally,
  1331.              MEMSTAT lists the statistics and exits.  This option is most
  1332.              useful when MEMSTAT is used in its own window.  The value of <n>
  1333.              must be an integer between 0 and 65535.  See ``KEY BINDINGS'' in
  1334.              INTRO(DVSI1) for a list of the valid keystrokes in ``-c'' mode.
  1335.  
  1336.              -p
  1337.              When the listing is complete, print ``Press any key to
  1338.              continue...'' and wait for a keystroke.  Helpful if you are not
  1339.              using ``-c'' and you want to use MEMSTAT in its own window.
  1340.  
  1341.              -q
  1342.              Quiet - does not print banner.
  1343.  
  1344.              -t
  1345.              Terse - does not print column headings.
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.         MEMSTAT(1dvsi)                                          MEMSTAT(1dvsi)
  1352.                                      DVSI Manual
  1353.  
  1354.              -?
  1355.              Launches DVSIHELP.
  1356.  
  1357.         FILES
  1358.              MT-PIF.DVP
  1359.              DVP used to open MEMSTAT from the Open Window menu.
  1360.  
  1361.         SEE ALSO
  1362.              INTRO(1dvsi), DVSIHELP(1dvsi)
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.         PERF(1dvsi)                                                PERF(1dvsi)
  1369.                                      DVSI Manual
  1370.  
  1371.         NAME
  1372.              perf - DESQview CPU performance statistics
  1373.  
  1374.         SYNOPSIS
  1375.              perf [-c<n>] [-p] [-q] [-t] [-?]
  1376.  
  1377.         DESCRIPTION
  1378.                   PERF displays DESQview performance statistics.  It requires
  1379.              DVSIXDI 2.00 to be installed.
  1380.                   The PERF statistics are system-wide statistics and represent
  1381.              a summary of some of the information presented by PS(1dvsi).  Two
  1382.              columns of information are presented.  The first column, labelled
  1383.              INSTANT, gives you a picture of the current system performance. 
  1384.              The second column, labelled TOTAL represents the long term system
  1385.              performance.
  1386.                   Here's a sample PERF display:
  1387.                                 INSTANT      TOTAL
  1388.              CPU Utilization          5%        36%
  1389.              Task Switches           10        500
  1390.              Task Switches/s        1.0        1.5
  1391.              Time (1/100 s)       10.11    2:23:45
  1392.                   The INSTANT column statistics are measured and averaged over
  1393.              the last 10 seconds, while the TOTAL column is measured and
  1394.              averaged over the entire time DESQview has been running.  Each
  1395.              row of the display is explained below.
  1396.         FIELDS
  1397.              CPU Utilization
  1398.              The percentage of time spent running programs other than the DV
  1399.              System Task.
  1400.  
  1401.              Task Switches
  1402.              Number of times that DESQview has switched to a different task. 
  1403.              This number can be increased or decreased with the Tune
  1404.              Performance-Set Foreground/Background ticks menu.
  1405.  
  1406.              Task Switches/s
  1407.              Number of task switches per second during the measurement period.
  1408.  
  1409.              Time
  1410.              The amount of time in seconds of the measurement period.  The
  1411.              TOTAL column is expressed in hh:mm:ss notation.
  1412.         OPTIONS
  1413.              -c<n>
  1414.              Continuously update the statistics every <n> seconds.  Normally,
  1415.              PERF lists the statistics and exits.  This option is most useful
  1416.              when PERF is used in its own window.  The value of <n> must be an
  1417.              integer between 0 and 65535.  See INTRO(1dvsi) for a description
  1418.              of the keystrokes available in ``-c'' mode.  A good value for <n>
  1419.              is 10 seconds, since DVSIXDI updates the INSTANT information
  1420.              every 10 seconds.
  1421.  
  1422.              -p
  1423.              When the listing is complete, print ``Press any key to
  1424.              continue...'' and wait for a keystroke.  Helpful if you are not
  1425.              using ``-c'' and you want to use perf in its own window.  Will
  1426.              work with the ``-c'' option.
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.         PERF(1dvsi)                                                PERF(1dvsi)
  1433.                                      DVSI Manual
  1434.  
  1435.              -q
  1436.              Quiet - does not print banner.
  1437.  
  1438.              -t
  1439.              Terse - does not print column headings.
  1440.  
  1441.              -?
  1442.              Launches DVSIHELP.
  1443.         BUGS
  1444.                   Integer math is used for the calculations; truncation rather
  1445.              than rounding occurs in the least significant digit.
  1446.                   The INSTANT column gives strange numbers during the first 10
  1447.              seconds after DESQview is started, and can be up to 10 seconds
  1448.              old.
  1449.         FILES
  1450.              PF-PIF.DVP
  1451.              DVP used to launch MEMSTAT from the Open Window menu.
  1452.         SEE ALSO
  1453.              DVSIHELP(1dvsi), DVSIXDI(1dvsi), PS(1dvsi)
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.         PRCC(1dvsi)                                                PRCC(1dvsi)
  1460.                                      DVSI Manual
  1461.  
  1462.         NAME
  1463.              prcc - PRINTCAP compiler
  1464.  
  1465.         SYNOPSIS
  1466.              prcc <infile>
  1467.  
  1468.         DESCRIPTION
  1469.                   PRCC compiles <infile> as a printer capabilities file and
  1470.              sends the results to a currently-running LPD.  The file <infile> is
  1471.              usually PRINTCAP.  PRCC is launched automatically when LPD starts
  1472.              through the PRCC.DVP file.
  1473.                   When LPD receives the compiled <infile>, it removes any
  1474.              previously defined printers before adding the new printers.  If a
  1475.              change is made to PRINTCAP, PRCC must be run to update the active
  1476.              LPD.
  1477.                   See PRINTCAP(5dvsi) for a description of the PRINTCAP file.
  1478.  
  1479.         DIAGNOSTICS
  1480.                   If PRCC encounters an error in <infile>, it prints an error
  1481.              message and line number,and exits with DOS error level set to 1. 
  1482.              If PRCC fails, the printer list sent to LPD will be incomplete.
  1483.  
  1484.              ``LPD Daemon not present''
  1485.              The LPD program must be running.
  1486.  
  1487.         FILES
  1488.              PRINTCAP
  1489.              The usual printer capabilities file
  1490.  
  1491.              PRCC.DVP
  1492.              The DVP used to launch PRCC from LPD.  From the command line,
  1493.              type INSTLAC PRCC.DVP to edit it, or get DvpEdit (see
  1494.              README.1ST).  The INSTALL program automatically fills in the
  1495.              ``Directory'' field.
  1496.  
  1497.         SEE ALSO
  1498.              BACKGROUND PRINTING(1dvsi), LPD(1dvsi), PRINTCAP(5dvsi)
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.         PS(1dvsi)                                                    PS(1dvsi)
  1505.                                      DVSI Manual
  1506.  
  1507.         NAME
  1508.              ps - DESQview process status
  1509.         SYNOPSIS
  1510.              ps [<options>] [<process id>]
  1511.         DESCRIPTION
  1512.                   PS provides information on the current DESQview windows. It
  1513.              requires DVSIXDI 2.00 to be installed.  Without the ``-l''
  1514.              option, PS's output looks like this:
  1515.         HNDL SW TK MAP  TTLMEM SYSMEM  L SYS  CPU TIME CPU UT KY NAME
  1516.         d662 ?   0 95f6 641680 278512  276144 02:23:42 89.2%     DV System Task
  1517.         cf9b 1   1 0fe8  16464   1632    1088 00:00.05  0.0%  CC Clock
  1518.         d027 2   1 1c34 ?????? Swappds ?????? 01:07.64  5.1%  WP WordPerfect 5
  1519.         cfe1 3   1 1b52 Swappd    592    1088 00:03.44  6.7%  MF QOS Manifest
  1520.         ???? ?   0 0c5d ?????? ??????  ?????? 00:00.00  0.0%  KT (starting)
  1521.                   Question marks in a column represent unknown information. 
  1522.              In the ``WordPerfect 5'' line, the memory information is not
  1523.              available because the process is swapped to disk.  In the
  1524.              ``(starting)'' line, most of the information is unknown because
  1525.              that process has not completed its initialization.
  1526.                   If <process id> is specified, PS only displays information on
  1527.              that processes.  If the process does not exist, PS terminates
  1528.              with DOS ERRORLEVEL set to 1.  The <process id> can be the window
  1529.              handle, the Switch Window number or the Open Window keys.
  1530.  
  1531.         FIELDS
  1532.              The columns in the PS display include:
  1533.  
  1534.              HNDL
  1535.              The hexadecimal segment of the process's handle, similar to
  1536.              UNIX's PID.
  1537.  
  1538.              SW
  1539.              The number appearing on the Switch Windows menu for this task. 
  1540.              Applications which are "orphaned" and do not appear on the Switch
  1541.              Windows menu, as well as the DV system task, will contain a ``?''
  1542.              in this column.  If more than 9 windows are open, the windows
  1543.              above 9 are labelled ``10'', ``11''... rather than ``A'',
  1544.              ``B''...
  1545.  
  1546.              TK
  1547.              The number of separate tasks, including itself, that the
  1548.              application has started.  For most programs, this will show 1,
  1549.              but some DESQview-specific programs may use more than one
  1550.              task.
  1551.  
  1552.              MAP
  1553.              The hexadecimal mapping context of the application.  This number
  1554.              is used with a DESQview API call to guarantee that the program is
  1555.              in conventional memory.
  1556.  
  1557.              TTLMEM
  1558.              The total memory, in bytes, used by the application.  If
  1559.              ``Swappd'' appears in this column, the process's memory is
  1560.              swapped out.  If system memory is swapped out, a ``??????'' will
  1561.              appear in the field because the real value cannot be determined. 
  1562.              The TTLMEM value is constant and represents the amount of
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.         PS(1dvsi)                                                    PS(1dvsi)
  1569.                                      DVSI Manual
  1570.  
  1571.              conventional memory required by the process.  See ``MEMORY''
  1572.              below.
  1573.  
  1574.              SYSMEM
  1575.              The remaining system memory, in bytes, available to application.
  1576.              If ``Swappd'' appears in this column, the process's system memory
  1577.              is swapped out.  If an ``s'' is appended to the value, the system
  1578.              memory resides in shared memory (see ``Wordperfect 5'', above). 
  1579.              See also ``MEMORY'' below.
  1580.  
  1581.              L SYS
  1582.              The largest block of system memory, in bytes, available to the
  1583.              application. A "??????" implies that the value cannot be
  1584.              determined.  See ``MEMORY'' below.
  1585.  
  1586.              CPU TIME
  1587.              Approximate amount CPU Time accumulated by the process.  If less
  1588.              than an hour, it is expressed in minutes:seconds.hundredths
  1589.              format.  If more than an hour, it is expressed in
  1590.              hours:minutes:seconds format.  The time is actually only accurate
  1591.              to about 6/100 of a second.
  1592.  
  1593.              CPU UT
  1594.              The number represents how much load the window is putting on the
  1595.              system at the current moment.  It is calculated by counting the
  1596.              amount of CPU time the window receives in a 10-second interval. 
  1597.              This number is the fraction of that 10 second interval that the
  1598.              process actually had the CPU.
  1599.                   Example:  if a process accumulated 6 seconds of CPU time in
  1600.              the last 10 seconds of real time, its CPU UT column will read
  1601.              ``60%''.
  1602.                   The CPU UTilization number for the DV System Task is unused
  1603.              CPU time.
  1604.  
  1605.              KY
  1606.              The keys used to open the application.
  1607.  
  1608.              NAME
  1609.              The name of the application, as shown on the window's frame.  If
  1610.              ``(starting)'' is displayed here, the process has not completed
  1611.              its initialization.  Display of ``(starting)'' processes can be
  1612.              suppressed with the ``-s'' option.
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.         PS(1dvsi)                                                    PS(1dvsi)
  1619.                                      DVSI Manual
  1620.  
  1621.              If the ``-l'' option is used, the output looks a little messier:
  1622.  
  1623.         HNDL SW TK MAP  TTLMEM SYSMEM  L SYS  CPU TIME CPU UT KY NAME
  1624.         kbd  mbx  obq  cursor  positn  visible logcl dispd
  1625.  
  1626.         d3e2  ?  0 0249 654016 384752  354128 01:12:30 97.2%    DV System Task
  1627.         014d d3e2 0197 ( 1,17) ( 0,56) ( 0, 0) 17x24 17x24
  1628.  
  1629.         ce55  ?  1 1044  16448   1632    1088 00:00.06  0.0%  CC Clock
  1630.         014d ce55 0197 ( 0,33) (58,15) ( 0, 0)  1x45  1x35
  1631.  
  1632.         cefe  2  1 1aca 589808    480     432 00:12.45  0.0%  BD Big DOS
  1633.         014d cefe 0197 (39, 6) ( 0, 0) ( 0, 0) 60x80 60x80
  1634.  
  1635.         cf4f  3  1 1fe0  32736    208     208 00:03.14  2.8%  PS DVSI ps
  1636.         014d cf4f 0197 (16,15) (11, 0) ( 0, 0) 50x80 28x80
  1637.  
  1638.              The additional columns in the second line for each process are:
  1639.  
  1640.              KBD MBX OBQ
  1641.              The hex offsets for the process's default keyboard, mailbox and
  1642.              objectq.  The segments are the same as the process's handle.
  1643.  
  1644.              CURSOR
  1645.              The position of the cursor relative to the window's origin, (row,
  1646.              column).
  1647.  
  1648.              POSITN
  1649.              The upper left corner of the window on the screen, (row, column).
  1650.  
  1651.              VISIBLE
  1652.              The coordinate of the upper left corner of the displayed window,
  1653.              (row, column).  This number can be changed by using ``Rearrange -
  1654.              Scroll''.
  1655.  
  1656.              LOGCL
  1657.              Logical, or maximum, size of the window, in rows by columns.
  1658.  
  1659.              DISPD
  1660.              Displayed size of the window, in rows by columns.
  1661.         MEMORY
  1662.                   Using the values listed in the TTLMEM and SYSMEM columns, a
  1663.              program's memory usage can be optimized.  The TTLMEM column
  1664.              represents the total number of bytes of conventional memory that
  1665.              the program requires.  This includes explicit memory declared in
  1666.              the Change A Program ``Memory'' field, explicit System memory
  1667.              declared in the ``System Memory'' Change A Program field, and
  1668.              System Memory allocated by DESQview to store the text screen,
  1669.              controlled by the ``Maximum Width'' and ``Maximum Height''
  1670.              fields.
  1671.                   The SYSMEM column represents the number of bytes of System
  1672.              Memory REMAINING.  If this number stays high while running the
  1673.              program, you can safely decrease the ``System Memory'' field in
  1674.              Change A Program.  To trim it down even more, decrease the
  1675.              maximum height and width of the window.  Every byte you take away
  1676.              subtracts one byte from the TTLMEM column, unless you are using
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.         PS(1dvsi)                                                    PS(1dvsi)
  1683.                                      DVSI Manual
  1684.  
  1685.              the ``Maximum Memory'' field in Change A Program.  In that case,
  1686.              you maximum window memory size increases.
  1687.         OPTIONS
  1688.              -c<n>
  1689.              Continuously update the list every <n> seconds.  Normally, PS lists
  1690.              the status and exits.  This option is most useful when PS is used
  1691.              in its own window.  The value of <n> must be an integer between 0
  1692.              and 65535 (I don't know why you'd want to wait 18 hours, but you
  1693.              can!).  While in the ``-c'' mode, certain keystrokes have special
  1694.              meanings.  See ``KEY BINDINGS'' in INTRO(1dvsi) for more
  1695.              information.
  1696.  
  1697.              -p
  1698.              When the listing is complete, print ``Press any key to
  1699.              continue...'' and wait for a keystroke.  Helpful if you are not
  1700.              using ``-c'' and you want to use PS in its own window.  ``-p''
  1701.              will work with the ``-c'' option.
  1702.  
  1703.              -d<path>
  1704.              Ignored.  Provided for compatibility with previous version of
  1705.              DVSI.  PS no longer uses DESQVIEW.DVO; it gets window names
  1706.              directly from the window.
  1707.  
  1708.              -r
  1709.              Resize the window according to the number of processes in the
  1710.              list. The window is made 80 columns wide and high enough for all
  1711.              the processes to be displayed, and is moved left to column 0.
  1712.              If using ``-c'' and the number of processes changes, the window
  1713.              size is changed also.
  1714.  
  1715.              -l
  1716.              Long listing: more information than you really wanted to know
  1717.              about each process.
  1718.  
  1719.              -s
  1720.              Do not print processes that would display ``(starting)''.
  1721.  
  1722.              -q
  1723.              Quiet - does not print banner.
  1724.  
  1725.              -t
  1726.              Terse - does not print column headings.
  1727.  
  1728.              -?
  1729.              Launches DVSIHELP.
  1730.         SEE ALSO
  1731.              INTRO(1dvsi), DVSIHELP(1dvsi), DVSIXDI(1dvsi)
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.         RUN(1dvsi)                                                  RUN(1dvsi)
  1738.                                      DVSI Manual
  1739.  
  1740.         NAME
  1741.              run - Open one or more windows from the command line
  1742.         SYNOPSIS
  1743.              run [-v] <program> [<program options>] [; [<launch options>]
  1744.                                                                [<program...>]]
  1745.         DESCRIPTION
  1746.                   RUN will one or more programs in one or more windows.  It is
  1747.              capable of running DVP, COM, EXE, and BAT files.
  1748.                   The <program> is searched for in the current directory or in
  1749.              the drive and directory specified in <program> first, according to
  1750.              the search strategy explained below.  If <program> is not found AND
  1751.              a drive or directory was not specified, each directory in the
  1752.              environment variable ``PATH'' is searched using the search
  1753.              strategy outlined below.  If <program> is still not found, RUN
  1754.              fails with DOS error level 1.
  1755.                   The search strategy is very similar to COMMAND.COM's search
  1756.              strategy.  If <program> contains an extension (e.g. ``.DVP''), then
  1757.              the filename must match exactly.  However, if no extension is
  1758.              specified, RUN looks first for <program>.DVP, then <program>-PIF.DVP,
  1759.              then <program>_-PIF.DVP, then <program>.BAT, then <program>.COM and
  1760.              finally <program>.EXE. If no match was found, RUN continues with
  1761.              the next directory as described above.
  1762.                   With the ``-v'' option, RUN ignores ``.BAT'', ``.COM'' and
  1763.              ``.EXE'' in the search.
  1764.                   To run non-DVP type programs, RUN uses ``RUN_DEF.DVP'' which
  1765.              must exist in the same directory as RUN.COM.  Users can edit this
  1766.              DVP to suit their needs; it makes very conservative assumptions
  1767.              about the program.  Note that RUN overrides the ``Memory Size''
  1768.              and ``Maximum Program Memory Size'' fields so changing these will
  1769.              have no effect.  See ``NON-DVP PROGRAMS'' below for more
  1770.              information.
  1771.                   Any <program options> override any options in the DVP. 
  1772.              Otherwise, the options in the DVP are used.
  1773.                   RUN can launch more than one program.  Programs are
  1774.              separated by the ``;'' character, which must be completely
  1775.              separated from anything else by white space.  If a ``;'' must be
  1776.              passed as a program option, use ``;;'' instead.
  1777.                   Immediately following the white space after the ``;'', zero
  1778.              or more launch options may be specified.  These options modify
  1779.              how the program is run.
  1780.                   Following the launch options another <program>, <program>
  1781.              <options> and <launch options> can be specified.  There is no limit
  1782.              to the number of programs that can be started with one RUN
  1783.              command.
  1784.         NON-DVP PROGRAMS
  1785.                   RUN has the ability to launch COM, EXE and BAT programs, but
  1786.              it must make conservative assumptions about the program's
  1787.              operation. Most of the assumptions can be overridden by modifying
  1788.              RUN_DEF.DVP or by using launch options.
  1789.                   The filename (without the path) becomes the title on the
  1790.              window.
  1791.                   COM programs are run with 64K of memory.  BAT programs are
  1792.              run with a minimum of 128K memory and a maximum of 640K memory. 
  1793.              Memory requirements for an EXE program are calculated from the
  1794.              EXE header. However, you may want to use the ``-m'' launch
  1795.              options to guarantee that enough memory will be available to run
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801.         RUN(1dvsi)                                                  RUN(1dvsi)
  1802.                                      DVSI Manual
  1803.  
  1804.              the program.
  1805.                   COM and EXE windows have ``Close on Exit'' set to ``Y''; BAT
  1806.              files are run with the same field set to ``N''.
  1807.                   The ``Directory'' field is set to the directory where the
  1808.              program is found and only the filename (without the path) is
  1809.              placed in the ``Program Path'' field..  However, if ``-d'' is
  1810.              specified, ``-d''-specified directory is placed in the
  1811.              ``Directory'' field and the full program pathname is copied into
  1812.              ``Program Path''.
  1813.                   All other DVP fields are read from the RUN_DEF.DVP file. 
  1814.              Any launch options override any value that RUN or RUN_DEF.DVP
  1815.              uses.
  1816.  
  1817.         OPTIONS
  1818.              -v
  1819.              Only search for DVPs and ignore COM, EXE and BAT files.
  1820.  
  1821.         LAUNCH OPTIONS
  1822.              -e
  1823.              Signals the end of launch options.  Not required unless the next
  1824.              <program> starts the with character ``-'' or ``/''.
  1825.  
  1826.              -1o
  1827.              Do not launch the program if a window with same Open Window keys
  1828.              is running.
  1829.  
  1830.              -1n
  1831.              Do not launch the program if a window with same Program Name is
  1832.              running.
  1833.  
  1834.              -n<name>
  1835.              Assign <name> to the program after it is launched.  The value of
  1836.              <name> is used with ``-1n''.
  1837.  
  1838.              -w<n>
  1839.              Wait <n> seconds before launching the next program.  The wait
  1840.              occurs before the window is hidden with ``-h''.
  1841.  
  1842.              -h
  1843.              Hide the window.
  1844.  
  1845.              -m[<min>[:<max>]]
  1846.              Set the minimum memory value to <min> and the maximum memory value
  1847.              to <max>.  The values of <min> and <max> must be in kilobytes.
  1848.  
  1849.              -b
  1850.              Block RUN until the new program exits.  With ``-b'', RUN will not
  1851.              launch the next program or return to DOS until the new window is
  1852.              closed.   RUN may not respond for up to 5 seconds after the
  1853.              program terminates.
  1854.  
  1855.              -=<offset>=<value>
  1856.              Sets the byte at the hexadecimal offset <offset> to the hexadecimal
  1857.              value <value> in the DVP.
  1858.              See DVP(5dvsi) for the format of the DVP file.
  1859.  
  1860.  
  1861.  
  1862.  
  1863.  
  1864.         RUN(1dvsi)                                                  RUN(1dvsi)
  1865.                                      DVSI Manual
  1866.  
  1867.              "-|<offset>=<value>"
  1868.              Logically OR the byte at the hexadecimal offset <offset> with the
  1869.              hexadecimal value <value> in the DVP.  See DVP(5dvsi) for the
  1870.              format of the DVP file.  You must enclose at least the ``|''
  1871.              character in quotes so COMMAND.COM doesn't think it is a pipe
  1872.              character.
  1873.  
  1874.              -&<offset>=<value>
  1875.              Logically AND the byte at the hexadecimal offset <offset> with the
  1876.              hexadecimal value <value> in the DVP.  See DVP(5dvsi) for the
  1877.              format of the DVP file.
  1878.         EXAMPLES
  1879.              Assume KT.DVP exists in the current directory, WP-PIF.DVP exists
  1880.              in C:\DV which is in the PATH, and KT-PIF.DVP also exists in the
  1881.              current directory.
  1882.              C:\> run kt              (launches KT.DVP)
  1883.              C:\> run kt-pif          (launches KT-PIF.DVP)
  1884.              C:\> run wp              (launches C:\DV\WP-PIF.DVP)
  1885.              C:\> run kt ; -h wp      (launches and hides KT.DVP, launches WP-
  1886.                                       PIF.DVP)
  1887.              C:\> run kt ; -w4 wp     (launches and hides KT, waits 4 seconds,
  1888.                                       launches WP)
  1889.              C:\> run kt ; -w10 -h wp (launches and hides KT, waits 10
  1890.                                       seconds, hides KT, launches WP)
  1891.              Assume KT.DVP and KT.EXE both exist in the current directory.
  1892.              C:\> run kt              (launches KT.DVP)
  1893.              C:|> run kt.exe          (launches KT.EXE)
  1894.         DIAGNOSTICS
  1895.              ``Cannot open <file>''
  1896.              <File> could not be opened for reading.
  1897.  
  1898.              ``Cannot launch <file>''
  1899.              DESQview returned an error when the program was launched.
  1900.         FILES
  1901.              RUN_DEF.DVP
  1902.              The template DVP used to launch EXE, COM and BAT programs.
  1903.  
  1904.              *.DVP
  1905.              DESQview Program information File, which describes a program to
  1906.              DESQview.
  1907.  
  1908.              *.COM, *.EXE, *.BAT
  1909.              DOS program files that RUN can launch.
  1910.         SEE ALSO
  1911.              DVP(5dvsi)
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.         UPTIME(1dvsi)                                            UPTIME(1dvsi)
  1918.                                      DVSI Manual
  1919.  
  1920.         NAME
  1921.              uptime - Print amount of time DESQview has been running
  1922.         SYNOPSIS
  1923.              uptime [-p] [-q] [-t] [-?]
  1924.         DESCRIPTION
  1925.                   UPTIME reports the amount of time that DESQview has been
  1926.              running and the time DESQview was started.
  1927.                   UPTIME requires DVSIXDI 2.00 to be installed.
  1928.         OPTIONS
  1929.              -p
  1930.              After the time is displayed, print ``Press any key to
  1931.              continue...'' and wait for a keystroke.
  1932.  
  1933.              -q
  1934.              Quiet - does not print banner.
  1935.  
  1936.              -t
  1937.              Terse - does not print extra text, and prints run time as
  1938.              hh:mm:ss.hh.
  1939.  
  1940.              -?
  1941.              Launches DVSIHELP
  1942.         SEE ALSO
  1943.              INTRO(1dvsi), DVSIHELP(1dvsi), DVSIXDI(1dvsi)
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.         WN(1dvsi)                                                    WN(1dvsi)
  1950.                                      DVSI Manual
  1951.  
  1952.         NAME
  1953.              wn - Manipulate DESQview windows
  1954.         SYNOPSIS
  1955.              wn [-?] <command> <command-options> [<process id>]
  1956.         DESCRIPTION
  1957.                   WN contains a set of commands for manipulating DESQview
  1958.              windows.  It gives much of the functionality of the DESQview
  1959.              menus at the command line.  WN, unlike other command-line
  1960.              DESQview window manipulators, can work with ANY window, not just
  1961.              the current window.
  1962.                   Commands are case-insensitive and may be abbreviated to one
  1963.              or two characters.  Some commands require arguments; these follow
  1964.              the command.
  1965.                   The <process id> specifies the window to operate on.  If
  1966.              <process id> is omitted, the window in which WN is run is used. 
  1967.              The ``KILL'' command requires <process id>.  The <process id> can be
  1968.              a window handle, a Switch Windows number, or the Open Window
  1969.              keys.  For more information, see INTRO(1dvsi).
  1970.                   A suspended or hidden window may be seen again by using
  1971.              ``RAISE'' or ``TOP''.
  1972.         OPTIONS
  1973.              -?
  1974.              Launches DVSIHELP
  1975.         COMMANDS
  1976.              Command abbreviations are listed in parenthesis following the
  1977.              command.
  1978.  
  1979.              KILL      (K)
  1980.              Kill the window.  Operates exactly like KILL(1dvsi).  The <process>
  1981.              <id> must be specified; the current window cannot be killed unless
  1982.              its <process id> is explicitly used.
  1983.  
  1984.              RAISE     (R)
  1985.              Bring the window to the top of the window stack and give it the
  1986.              keyboard.
  1987.  
  1988.              LOWER     (L)
  1989.              Put window at the bottom of the window stack.
  1990.  
  1991.              TOP       (T)
  1992.              Bring window to the top of the window stack but do not give it
  1993.              the keyboard.  The window may not be entirely uncovered because
  1994.              DESQview requires that the window with the keyboard must be
  1995.              entirely uncovered.
  1996.  
  1997.              HIDE      (H)
  1998.              Hide the window just like ``Rearrange - Hide''.
  1999.  
  2000.              SUSPEND   (SU)
  2001.              Hide the window and don't give it any CPU time.
  2002.  
  2003.              FRAME     (FR)
  2004.              Turns the window's frame on or off.  Requires an argument:
  2005.                   FRAME Y   Turn frame on
  2006.                   FRAME N   Turn frame off
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.         WN(1dvsi)                                                    WN(1dvsi)
  2013.                                      DVSI Manual
  2014.  
  2015.              FOREONLY  (FO)
  2016.              Does or doesn't allow window to run in the background.  Requires
  2017.              an argument:
  2018.                   FOREONLY Y     Don't run in background
  2019.                   FOREONLY N     Allow running in background
  2020.  
  2021.              MBOX <name> (M)
  2022.              Give the window's default mailbox the name <name>.  The <name>
  2023.              argument is required.
  2024.  
  2025.              SIZE  <r c> (SI)
  2026.              Make the window <r> rows high and <c> columns wide.  If a ``-'' is
  2027.              used in place of <r> or <c>,the size in that direction is unchanged. 
  2028.              Both arguments are required.  Setting the window size to the
  2029.              current screen size will ``zoom'' the window.
  2030.  
  2031.              NAME <name> (N)
  2032.              Change the window's title to <name>.  The argument is required. 
  2033.              The maximum name length is 30 characters. Additional characters
  2034.              are ignored.
  2035.         SEE ALSO
  2036.              INTRO(1dvsi), DVSIHELP(1dvsi), DVSIXDI(1dvsi), KILL(1dvsi)
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.         DVSIXDI(2dvsi)                                          DVSIXDI(2dvsi)
  2043.                                      DVSI Manual
  2044.  
  2045.         NAME
  2046.              DVSIXDI - Get info on DESQview processes
  2047.         SYNTAX
  2048.              mov AX, 0DE01h
  2049.              mov BX, 7575h
  2050.              mov CX, <function>
  2051.              int 2Fh
  2052.         DESCRIPTION
  2053.                   DESQview does not provide any API call to get a list of the
  2054.              current processes.  Fortunately, it does provide a hook by which
  2055.              a TSR like DVSIXDI can keep track of the current open windows.
  2056.                   The purpose of DVSIXDI is to allow programs to easily get a
  2057.              list of the processes and information on each process that is not
  2058.              otherwise available.  I decided to publish the programmer
  2059.              interface so that other programmers wouldn't have to go through
  2060.              all the work to create an XDI of their own.
  2061.                   You can use the interface in any way you choose.  However,
  2062.              you cannot include DVSIXDI.COM as part of any package you
  2063.              distribute, and you cannot include any programs you write in the
  2064.              DVSI package.  See README.1ST for more information. 
  2065.                   Make your program DVSIXDI-version-aware, because I may make
  2066.              changes in the future that could break your program.  Every
  2067.              attempt will be made to maintain compatibility with earlier
  2068.              versions (I don't want to rewrite all my code either!), but I
  2069.              can't guarantee that I won't make significant changes.  However,
  2070.              I do guarantee that functions 0000h and 0004h will always be
  2071.              compatible.
  2072.         FUNCTIONS
  2073.              The value of <function> can be
  2074.              0000h 
  2075.              Installation check.
  2076.                   ENTRY:
  2077.                   nothing
  2078.  
  2079.                   EXIT:
  2080.                   AX=00FFh if DVSIXDI is installed
  2081.              0003h
  2082.              Get application records
  2083.                   ENTRY: 
  2084.                   (v1.10+) Should be in a DESQview critical section on entry
  2085.                   if the application records will be read (see below).
  2086.  
  2087.                   EXIT:
  2088.                   AX=0 if error occurred
  2089.  
  2090.                   AX=1 if OK
  2091.                   BX=Last instantaneous time length (v1.10+)
  2092.                   CX=number of records with valid window handles
  2093.                   DX=number of ``(starting)'' records (v2.00+)
  2094.                   ES:DI pointer to array of all application records (see
  2095.                   ``APPLICATION RECORDS'')
  2096.                   SI=value of DVSIXDI's ``-p'' argument (v2.00+)
  2097.  
  2098.                   (v1.10+)  ES:DI points to the actual DVSIXDI data structure
  2099.                   in use.  The application should enter a DESQview critical
  2100.                   section before making this call, make the call, copy the
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.         DVSIXDI(2dvsi)                                          DVSIXDI(2dvsi)
  2107.                                      DVSI Manual
  2108.  
  2109.                   records, and end the DESQview critical section. In (v1.x),
  2110.                   there are 15 total records; (v2.00+) has the number of
  2111.                   records reported in SI.
  2112.  
  2113.                   (v1.00) ES:DI points to a copy of the records in allocated
  2114.                   Common Memory which the caller should deallocate when done. 
  2115.                   Only the currently valid records are placed in this buffer. 
  2116.                   The number of records in the buffer is reported in CX.
  2117.  
  2118.                   (v1.11+)  BX is in units of 1/18.206 seconds
  2119.                   (v1.10)   BX is in units of 1/100 seconds
  2120.              0004h
  2121.              Get version
  2122.                   ENTRY:
  2123.                   nothing
  2124.  
  2125.                   EXIT:
  2126.                   AH=Major version
  2127.                   AL=Minor version  (0Ah=.10, etc.)
  2128.              0005h (v1.10+)
  2129.              Get time since DV start
  2130.                   ENTRY:
  2131.                   nothing
  2132.  
  2133.                   EXIT:
  2134.                   DX:AX 1/100s since DV start (v1.10)
  2135.                   DX:AX 1/18.206s since DV start (v1.11+)
  2136.              0006h (v1.10+)
  2137.              Get task switches
  2138.                   ENTRY:
  2139.                   nothing
  2140.  
  2141.                   EXIT:
  2142.                   CX=number of task switches during last instantaneous time
  2143.                   DX:AX=total number of task switches since DV start
  2144.  
  2145.         APPLICATION RECORDS
  2146.              Function 0003h returns a pointer to an array of application
  2147.              records.  These records contain information on each currently-
  2148.              running process.  The format of these records are
  2149.  
  2150.              (v1.00)
  2151.              Offset    Size      Description
  2152.              00h  BYTE      Flags
  2153.              01h  WORD Offset into DESQVIEW.DVO of programs's record if
  2154.                        program started from Open Windows menu; else undefined
  2155.                        (this was a bug).
  2156.              03h  WORD Switch windows number
  2157.              05h  WORD Segment of handle
  2158.              07h  WORD Number of tasks owned by process
  2159.              09h  WORD Mapping context of process
  2160.              0Bh  DWORD     Hook for other programs
  2161.  
  2162.              (v1.10-v2.00)
  2163.              Offset    Size      Description
  2164.              00h  BYTE      Flags
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.         DVSIXDI(2dvsi)                                          DVSIXDI(2dvsi)
  2171.                                      DVSI Manual
  2172.  
  2173.              01h  WORD Open Window keys
  2174.              03h  WORD Switch window number
  2175.              05h  WORD Segment of handle
  2176.              07h  WORD Number of tasks owned by process
  2177.              09h  WORD Mapping context
  2178.              0Bh  DWORD     Time of process start relative to DV start
  2179.              0Fh  DWORD     Time that process last got CPU relative to DV
  2180.                             start
  2181.              13h  DWORD     Time that process last gave up CPU relative to DV
  2182.                             start
  2183.              17h  DWORD     Accumulated CPU time
  2184.              1Bh  DWORD     Accumulated CPU time instantaneous number of
  2185.                             seconds ago
  2186.              1Fh  DWORD     Accumulated CPU time over last instantaneous time
  2187.                             slice
  2188.              23h  DWORD     Hook for other programs
  2189.  
  2190.              The Flags byte:
  2191.              bit 7     Record contains a valid process id
  2192.              bit 6     Record is allocated: if bit 7 not set, is
  2193.                        ``(starting)'' and only offsets 01h and 09h are valid
  2194.                        (v2.00+)
  2195.                   Reserved, 0 (v1.x)
  2196.              bit 5     This application is currently owns the CPU (v2.00+)
  2197.                   Reserved, 0 (v1.x)
  2198.              bit 4     Reserved, 0
  2199.              bit 3     This process is the DV System Task
  2200.              bit 2     Reserved, 0
  2201.              bit 1     Reserved, 0
  2202.              bit 0     Reserved, 0
  2203.  
  2204.              (v1.10) The times at offsets 0Bh through 23h are in 1/100s
  2205.              (v1.11+) The times at offsets 0Bh through 23h are in 1/18.206s
  2206.  
  2207.         SEE ALSO
  2208.              DVSIXDI(1dvsi), PS(1dvsi), the file README.1ST
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.         DVP(5dvsi)                                                  DVP(5dvsi)
  2215.                                      DVSI Manual
  2216.  
  2217.         NAME
  2218.              DVP - DESQview Program information File
  2219.  
  2220.         DESCRIPTION
  2221.                   The DVP file is used by RUN to launch programs, similar to
  2222.              Open Window.  With the ``-='', ``-|'' and ``-&'' individual bytes
  2223.              can be changed on the fly.
  2224.                   This description is reprinted with permission from Release
  2225.              28 of Ralf Brown's Interrupt list, copyright 1989, 1990, 1991 by
  2226.              Ralf Brown.
  2227.  
  2228.              Offset  Size    Description
  2229.               00h    BYTE    reserved (0)
  2230.               01h    BYTE    checksum of bytes 02h through 170h
  2231.               02h 30 BYTEs   blank-padded program title
  2232.               20h    WORD    maximum memory to allocate to partition in K
  2233.               22h    WORD    minimum memory required in K
  2234.               24h 64 BYTEs   ASCIZ program pathname
  2235.               64h    BYTE    default drive letter ('A',...)
  2236.               65h 64 BYTEs   ASCIZ default directory name
  2237.               A5h 64 BYTEs   ASCIZ program parameters
  2238.               E5h    BYTE    initial screen mode (0-7) (see also offset 189h)
  2239.               E6h    BYTE    number of text pages used
  2240.               E7h    BYTE    number of first interrupt to save
  2241.               E8h    BYTE    number of last interrupt to save
  2242.               E9h    BYTE    rows in virtual screen buffer
  2243.               EAh    BYTE    columns in virtual screen buffer
  2244.               EBh    BYTE    initial window position, row
  2245.               ECh    BYTE    initial window position, column
  2246.               EDh    WORD    system memory in K
  2247.               EFh 64 BYTEs   ASCIZ shared program name
  2248.              12Fh 64 BYTEs   ASCIZ shared program data file
  2249.              16Fh    BYTE    flags1
  2250.                              bit 7: writes text directly to screen
  2251.                              bit 6: runs in foreground only
  2252.                              bit 5: uses math coprocessor
  2253.                              bit 4: accesses system keyboard buffer directly
  2254.                              bits 3-1: reserved (0)
  2255.                              bit 0: swappable
  2256.              170h    BYTE    flags2
  2257.                              bit 6: uses command-line parameters in field at
  2258.                                  A5h
  2259.                              bit 5: swaps interrupt vectors
  2260.              ---information unique to .DVP files---
  2261.              171h  2 BYTEs   keys to use on open menu
  2262.              173h    WORD    size of script buffer in bytes
  2263.              175h    WORD    automatically give up CPU after this many tests
  2264.                             for keyboard input in one clock tick (default 0 =
  2265.                             never)
  2266.              177h    BYTE    nonzero = "uses own colors"
  2267.              178h    BYTE    nonzero if application swappable
  2268.              179h  3 BYTEs   reserved (0) according to Quarterdeck
  2269.                             documentation in actual .DVP files, frequently 01h
  2270.              17Ch    BYTE    nonzero to automatically close on exit
  2271.              17Dh    BYTE    nonzero if copy-protect floppy is required
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.         DVP(5dvsi)                                                  DVP(5dvsi)
  2278.                                      DVSI Manual
  2279.  
  2280.              ---information unique to DESQview 2.0+---
  2281.              17Eh    BYTE    .DVP version number
  2282.                              00h DESQview 1.2+
  2283.                              01h DESQview 2.0+
  2284.                              02h DESQview 2.2+
  2285.              17Fh    BYTE    reserved (0)
  2286.              180h    BYTE    initial number of rows in physical window
  2287.              181h    BYTE    initial number of columns in physical window
  2288.              182h    WORD    maximum expanded memory to allow, in K
  2289.              184h    BYTE    flags3
  2290.                              bit 7: automatically assign window position
  2291.                              bit 5: maximum memory value has been specified
  2292.                              bit 4: disallow "Close" command
  2293.                              bit 3: foreground-only when doing graphics
  2294.                              bit 2: don't virtualize
  2295.                              bit 1: ??? set by DV 2.31 when "Runs in
  2296.                             Background" = "D"
  2297.              185h    BYTE    keyboard conflict level (0-4 for DV<2.26, 00h-0Fh
  2298.                             for DV2.26+)
  2299.              186h    BYTE    number of graphics pages used
  2300.              187h    WORD    extra system memory size
  2301.              189h    BYTE    initial screen mode (FFh = default) (overrides
  2302.                                                 offset E5h)
  2303.              ---information unique to DESQview 2.2+---
  2304.              18Ah    BYTE    serial port usage
  2305.                              FFh uses all serial ports
  2306.                              00h no serial ports
  2307.                              01h only COM1
  2308.                              02h only COM2
  2309.              18Bh    BYTE    flags4
  2310.                              bit 7: automatically close application on exit if
  2311.                             .COM or .EXE specified
  2312.                              bit 6: swappable if not using serial ports
  2313.                              bit 5: start program with window hidden (v2.26+)
  2314.                              bit 4: start program in background (v2.26+)
  2315.                              bit 3: virtualize text
  2316.                              bit 2: virtualize graphics
  2317.                              bit 1: share CPU when foreground
  2318.                              bit 0: share EGA when foreground and zoomed
  2319.              18Ch    BYTE    protection level for 386 machines
  2320.              18Dh 19 BYTEs   reserved (0)
  2321.  
  2322.         SEE ALSO
  2323.              RUN(1dvsi)
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.         PRINTCAP(5dvsi)                                        PRINTCAP(5dvsi)
  2330.                                      DVSI Manual
  2331.  
  2332.         NAME
  2333.              PRINTCAP - printer capabilities file
  2334.         DESCRIPTION
  2335.                   The PRINTCAP file contains entries that describe each
  2336.              logical printer available to LPD.  It is read by PRCC(1dvsi) and
  2337.              sent to LPD.
  2338.                   The format of PRINTCAP is very similar to the Unix
  2339.              equivalent.  Each entry contains tokens delimited by the ``:''
  2340.              character.  The null token is ``::''.
  2341.                   Each line in the PRINTCAP file is either blank, a comment
  2342.              line a printcap entry, or a continuation of a printcap entry. 
  2343.              The comment character is ``#'' and must be in the first column. 
  2344.              A printcap entry is continued by terminating the previous line
  2345.              with ``\''.
  2346.                   The first token in an entry is the logical printer name.  At
  2347.              least one entry must be named ``lp''.  Multiple printer names for
  2348.              one entry is NOT currently supported.
  2349.                   The remaining tokens are described in ``TOKENS'', below. 
  2350.              Tokens can be of three types: boolean, string, or number. 
  2351.              Boolean tokens do not need an argument; the presence of the token
  2352.              implies TRUE and the absence implies FALSE.  String tokens must
  2353.              be concatenated with ``=<str>:'' where <str> is the string argument. 
  2354.              Number tokens must be concatenated with ``#<num>'' where <num> is the
  2355.              value to assign to the token.
  2356.                   The string tokens ``hr'' and ``tr'' can have metacharacters
  2357.              embedded.  The following metacharacters are recognized:
  2358.                   Metacharacter       Translates to
  2359.                   ^<c>                  Control-<c>
  2360.                   \E                  Escape
  2361.                   \f                  Form feed
  2362.                   \n                  Line feed
  2363.                   \r                  Carriage return
  2364.                   \t                  Tab
  2365.                   \b                  Backspace
  2366.                   \0x<nn>               Hexadecimal number <nn> is sent.  Leading
  2367.                                       0 must be present.
  2368.                   \\                  \
  2369.                   \^                  ^
  2370.                   The best way to learn what the PRINTCAP file is all about is
  2371.              to look at examples.  Some are provided here, and more in the
  2372.              sample PRINTCAP file packaged with DVSI.
  2373.                   For a description of the four physical printer types, see
  2374.              BACKGROUND PRINTING(1dvsi) and LPD(1dvsi).
  2375.         TOKENS
  2376.              Token     Type Default value       Description
  2377.              br   num  110            Baud rate if ``lp=COMx''
  2378.              pp   str  (none)              Filter program, not currently
  2379.         supported
  2380.              pb   num  132            Max number of bytes printed at once
  2381.              tr   str  (none)              String to send when job completes
  2382.              hr   str  (none)              String to send at start of job
  2383.              pl   num  66             Pagelength if ``sf'' not specified
  2384.              sf   boo  FALSE          Suppress form feed at end of page
  2385.              lp   str  LPT1           Physical printer type: can be one of
  2386.                                       LPT1      printer is connected to LPT1
  2387.                                       LPT2      printer is connected to LPT2
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.         PRINTCAP(5dvsi)                                        PRINTCAP(5dvsi)
  2394.                                      DVSI Manual
  2395.  
  2396.                                       COM1      printer is connected to COM1 
  2397.                                       COM2      printer is connected to COM2 
  2398.                                       DVP       printer is a program launched
  2399.                                                 by LPD
  2400.                                       FILE      printer is a file or DOS
  2401.                                                 device driver
  2402.              fi   str  nul            If ``lp=DVP'', filename of DVP to
  2403.                                       launch.  The to-be-printed file is
  2404.                                       passed as the only argument.
  2405.                                       If ``lp=FILE'', filename or device to
  2406.                                       print to. SEE NOTE BELOW ON DRIVE NAME.
  2407.              se   str  (none)              Serial port setup parameters:
  2408.                                       1st character:
  2409.                                            8    8 bits
  2410.                                            7    7 bits
  2411.                                       2nd character:
  2412.                                            N    No parity
  2413.                                            O    Odd parity
  2414.                                            E    Even parity
  2415.                                       3rd character:
  2416.                                            1    1 stop bit
  2417.                                            2    2 stop bits
  2418.                                       4th character:
  2419.                                            X    XON/XOFF handshaking (not
  2420.                                                 currently supported)
  2421.                                            N    No handshaking
  2422.                                            D    DSR handshaking
  2423.                                            C    CTS handshaking
  2424.                                            H    DSR or CTS handshaking
  2425.              Here's what's important:
  2426.                   The ``lp'' token must be present in every entry.  It defines
  2427.              the type of physical printer maps onto the logical printer for
  2428.              this entry.
  2429.                   If you are using an LPT-type printer, no other tokens are
  2430.              required.
  2431.                   A COM-type printer requires the ``br'' token to define the
  2432.              baud rate, and the ``se'' token to define the port settings.
  2433.                   A FILE-type printer only requires the ``fi'' which must
  2434.              contain the filename to copy the print job to.
  2435.                   A DVP-type printer also requires ``fi'' which must contain
  2436.              the DVP filename.
  2437.                   All the other tokens are used for formatting or printer
  2438.              control.  You must use ``sf'' if you don't want LPD to format the
  2439.              output to a certain number of lines per page.
  2440.                   If you want to specify a drive name in the ``fi'' argument,
  2441.              you must use a semicolon rather than a colon, because the colon
  2442.              is used for separating tokens.  For example, instead of
  2443.              ``fi=C:\PRINT.OUT'', use ``fi=C;\PRINT.OUT''.
  2444.         EXAMPLES
  2445.              The basic printer with no formatting on LPT1 is defined as
  2446.                   dumb:pr=LPT1:sf:
  2447.              To print unformatted to the file ``C:\PRINT.OUT'',
  2448.                   fileprint:pr=FILE:fi=C;\PRINT.OUT:sf:
  2449.              Initialize printer at beginning of job and print form feed at
  2450.              end, assuming printer is Epson-compatible.  Also format page to
  2451.              60 lines per page:
  2452.  
  2453.  
  2454.  
  2455.  
  2456.  
  2457.         PRINTCAP(5dvsi)                                        PRINTCAP(5dvsi)
  2458.                                      DVSI Manual
  2459.  
  2460.                   epson:pr=LPT1: \
  2461.                        :hr=\E@: \
  2462.                        :tr=\f: \
  2463.                        :pl#60:
  2464.              Launch the program in C:\DV\PRINT.DVP to print the file.
  2465.                   launch:pr=DVP:fi=C;\DV\PRINT.DVP:
  2466.         SEE ALSO
  2467.              BACKGROUND PRINTING(1dvsi), LPD(1dvsi), PRCC(1dvsi)
  2468.  
  2469.