ProfitPress Mega CDROM2 Shareware Freeware (MSDOS)(1992)(Eng)

home *** CD-ROM | disk | FTP | other *** search

/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / DESQVIEW / MISC / DVSI1_21.ZIP / MANPAGES.DOC < prev next >

Wrap

Text File | 1991-10-08 | 25.0 KB | 729 lines

General Information Even though options are listed with the "/" character, the "-" character can be substituted. Options can be string together: /c4/p/t. They may appear in any order: /p/c4/t, but are case sensitive. ---------------------------------------------------------------------------- NAME df - free and used disk space SYNOPSIS df [/cn /r /p /q /t /?] [<drive list>] DESCRIPTION DF reports the current free and used disk space on the drives in the system. Without any options, only drives C: and higher are listed. The optional <drive list> is a list of drives to report on. For example, to report on drives A:, B: and D:, <drive list> would be ``abd'' or ``ABD''. With the ``/c'' option, DF will run continously in its own window. Every n seconds, it will check the current drive list for new network, SUBSTituted or JOINed drives, as well as the kbytes... fields. DF can be used outside of DESQview. However, only the /q, /t, and [<drive list>] options are available outside of DESQview. The output of DF looks very similar to Unix's DF. For a description of each of the columns, see the ``FIELDS'' section below: DR Flgs Total kbytes kbytes % Volume Mounted on kbytes used free used label C: l 4864 2764 2100 57% SYSTEM C:\ D: l 20810 10672 10138 51% IOTA-SIGMA D:\ E: l 16576 15134 1442 91% APPLICATNS E:\ F: lj 20190 8986 11204 45% (none) E:\DRIVEF X: n 30230 10280 19950 34% NETWORK \\REMOTE\REM_DRIVE Y: l s 1024 350 674 34% SUBSTDRIVE C:\DRIVEY FIELDS DR The logical name of the drive. FLGS Flags, indicating type of drive. The flags are l - Local drive n - Network drive j - JOINed drive s - SUBSTituted drive If both ``l'' and ``n'' are displayed, the drive is a DOS Installable File System (IFS). TOTAL KBYTES The total capacity of the drive in kilobytes. KBYTES USED The amount of space that is in use on the drive, in kilobytes. KBYTES FREE The available space on the drive, in kilobytes. % USED Percentage of total space on drive that is in use. VOLUME LABEL The label given to the volume. If no label exists, ``(none)'' is printed. MOUNTED ON If drive is JOINed, this is the directory that the drive is JOINed under. If the drive is a SUBST drive, this is the directory that the drive letter refers to. If the drive is a network drive, this field is the network drive name (at least in Digital Equip. Corp's PCSA, I haven't tested other networks). Otherwise, this field is the root directory name. OPTIONS /cn Continuously update the list every n seconds. Normally, df lists the disk space and exits. This option is most useful when df is used in its own window. n must be an integer between 0 and 65535. Hitting any key will stop the listing and cause DF to exit. /r Resize the window to fit exactly the number of drives in the system. Useful with /c option. /p Print "Press any key to continue..." and wait for keystroke before exiting. /q Quiet - does not print banner. /t Terse - does not print column headings. /? Display a help screen. <drive list> If specified, report only on the drives the list. The list is 1 or more drive names with no separating blanks. Case is not important. For example, to report only on drives A: and E: and F:, <drive list> would be ``AEF''. If no drive list is specifed, all drives higher than C: are reported. BUGS If using /c and /r, the maximum size of the window must be as large as the (max # of drives+1) or strange things will happen. The volume label on a JOINed drive is reported as "(none)". This is a DOS bug. Last Updated: September 20, 1991 ---------------------------------------------------------------------------- NAME dvsixdi - External Device Interface for DVSI SYNOPSIS In autoexec.bat: [loadhi] dvsixdi.com DESCRIPTION DVSIXDI is the heart of DVSI. It keeps track of the processes that DESQview starts and stops, as well as the CPU time of each process and other information. Basically, whenever DESQview does something important, it calls DVSIXDI to record what is happening. DVSIXDI should be installed before DESQview is run. It is best to put it in AUTOEXEC.BAT. It will take up about 1.2K of memory after it exits. To minimize the memory it requires, load it (and any other TSRs) before you set your PATH and other environment variables. Preferrably, it should be loaded in high memory, but this is not required. DVSIXDI may error out and not load. The possible error messages are: Error: Already Installed You can only load DVSIXDI once. Error: No available slots You have too many TSRs loaded that use the Multiplex interrupt 2F. DVSIXDI cannot be loaded until an interrupt 2F slot is available. DVSIXDI requires at least version 2.26 of DESQview. Other programs can communicate with DVSIXDI. Please read the distribution information in README.1ST; I retain the copyright for this material and I do not allow modification of the DVSI package. I do not guarantee anything about the future of the DVSIXDI interface except for the installation check and the version check. The interface for version 1.21 is INT 2Fh AX=0de01h BX=7575h CX=function Function 00h - Installation check Returns AL=ffh if installed 01h - Notification on: not currently used 02h - Notification off: not currently used 03h - Get application records Return CX = number of application records ES:DI pointer to array of application records AX = 1 if OK, 0 if not OK BX = last instantaneous time slice in 1/100 secs ES:DI points to the data structure in use. I recommend that you start a critical section, make this call, make a copy of the records, and end the critical section. Only those records that have (flags & 0x80) true are valid, but there are 15 records total. Application record: app_rec_t struc flags db ? ;See below openkeys dw ? ;Keys on Open Window menu appnum dw ? ;Switch windows # handle dw ? ;Segment of handle of process numtasks dw ? ;Number of tasks including self mapcntx dw ? ;Mapping context of process t_start dd ? ;DVSI clock value at process's start t_getcpu dd ? ;DVSI clock when last got CPU t_giveupcpu dd ? ;DVSI clock when last gave up CPU t_cpu dd ? ;CPU time since start t_cpu_last dd ? ;CPU time at instant. time start ago t_cpu_inst dd ? ;CPU time in last instant. time secs hook dd ? ;Hook for other programs app_rec_t ends The flags field can be an ORing of: 04h ;This is DV system task 80h ;Valid record (used internally by DVSIXDI) These flags are not currently used: 01h ;This task swapped out 02h ;This task has keyboard DVSI clock value of 0 is the time DESQview is started. Clock values are in ticks (approx 1/18.206 seconds). The Instantaneous Time is approximately 10 seconds. The t_cpu_last field is the value of the t_cpu field before the current Instantaneous Time period started. The t_cpu_inst field is the amount of cpu time in the last Instantaneous Time period (t_cpu - t_cpu_last). 04h - Get Version Return AH=Major, AL=Minor 05h - Get Time since DV started Return DX:AX = ticks since DV started 06h - Get Task Switches Return DX:AX = # of task switches since DV start CX = # of task switches in last instantaneous time BUGS DVSIXDI only keeps track of 15 processes at a time. Anything started after 15 is ignored completely, and never seen again by DVSIXDI except in the calculation of number of task switches. Last updated: October 7, 1991 ---------------------------------------------------------------------------- NAME kill - Kill a DESQview process SYNOPSIS kill [/p /?] <process_id> DESCRIPTION KILL "kills" a DESQview process. It works just like "Close Window" except that it will kill the process even if the "Allow Close Window Command" is "N" in the DVP file. This command is dangerous, because you could easily lose data if you don't save before using kill. It is much better to exit a program (especially non-DESQview programs) from the program itself. The process to be killed is unswapped, brought to the top, and killed. Kill then displays the handle of the killed process. KILL requires DVSIXDI 1.21 to be installed. OPTIONS /p When the process is killed, print "Press any key to continue..." and wait for a keystroke. /? Print a help message summarizing the options. <process_id> The process to be killed. If <process_id> is 4 digits, it is interpreted as a hex DESQview process handle from PS. If it is less than 4 digits, it is interpreted as a Switch Windows number. A leading "%" is ignored for you Unix junkies. BUGS Some programs are determined not to die. They may require a keystroke to make them go. Last Updated: August 18, 1991 ---------------------------------------------------------------------------- NAME perf - DESQview CPU performance statistics SYNOPSIS perf [/cn /p /q /t /?] DESCRIPTION PERF displays DESQview's performance. It requires DVSIXDI 1.21 to be installed. The PERF display is described below: INSTANT TOTAL CPU Utilization 5% 36% Task Switches 10 500 Task Switches/s 1.0 1.5 Time (1/100 s) 10.11 2:23:45 Two columns of information are presented. The statistics in the INSTANT column represent the performance averaged over approximately the last 10 seconds, while the TOTAL column represents the performance averaged over the entire time DESQview has been running. FIELDS CPU Utilization The percentage of time spent running programs other than the DV System Task. Task Switches Number of times that DESQview has switched to a different task. Task Switches/s Number of task switches per second during the time period. Time The amount of time in seconds that was used to calculate the statistics. The INSTANT column may be at up to 10 seconds old. The TOTAL column is expressed in hh:mm:ss notation. OPTIONS /cn Continuously update the statistics every n seconds. Normally, perf lists the statistics and exits. This option is most useful when perf is used in its own window. n must be an integer between 0 and 65535. Hitting any key will stop the listing and cause perf to exit. A good value for n is 10 seconds, since DVSIXDI updates the INSTANT information every 10 seconds. /p When the listing is complete, print "Press any key to continue..." and wait for a keystroke. Helpful if you are not using /c and you want to use perf in its own window. Will work with the /c option. /q Quiet - does not print banner. /t Terse - does not print column headings. /? Prints a help screen. If any bad options are given, this screen will automatically be printed. BUGS Integer math is used for the calculations; truncation rather than rounding occurs in the least significant digit. The INSTANT column gives strange numbers during the first 10 seconds after DESQview is started. Last Updated: September 20, 1991 ---------------------------------------------------------------------------- NAME ps - DESQview process status SYNOPSIS ps [/cn /dpath /p /r /l /q /t /?] [<process_id>] DESCRIPTION PS provides information on the current DESQview processes. It requires DVSIXDI 1.21 to be installed. Without the /l option, PS's output looks like this: HNDL SW TK MAP TTLMEM SYSMEM L SYS CPU TIME CPU UT KY NAME d662 ? 0 95f6 641680 278512 276144 02:23:42 89.2% DV System Task cf9b 1 1 0fe8 16464 1632 1088 00:00.05 0.0% CC Clock & Calendar d027 2 1 1c34 ?????? Swappds ?????? 01:07.64 5.1% WP WordPerfect 5 cfe1 3 1 1b52 Swappd 592 1088 00:03.44 6.7% MF Quarterdeck Manifest The columns are described below: HNDL The hexadecimal segment of the process's handle, similar to UNIX's PID. SW The number appearing on the Switch Windows menu for this task. Applications which are "orphaned" and do not appear on the Switch Windows menu, as well as the DV system task, will contain a "?" in this column. TK The number of separate tasks, including itself, that the application has started. For most programs, this will show 1, but some DESQview specific programs may use more than one task. MAP The hexadecimal mapping context of the application. This number is used with a DESQview API call to guarantee that the program is in conventional memory. TTLMEM The total memory, in bytes, used by the application. If "Swappd" appears in this column, the process's memory is swapped out. If system memory is swapped out, a "??????" will appear in the field because the real value cannot be determined. The TTLMEM value is constant and represents the amount of conventional memory required by the process. It can be trimmed down if the SYSMEM field is large - simply reduce the amount of System Memory available to the application with Change A Program. SYSMEM The remaining system memory, in bytes, available to application. If "Swappd" appears in this column, the process's system memory is swapped out. If an "s" is appended to the value, the system memory resides in shared memory (see Wordperfect, above). L SYS The largest block of system memory, in bytes, available to the application. A "??????" implies that the value cannot be determined. CPU TIME Approximate amount CPU Time for the process. If less than an hour, it is expressed in minutes:seconds.hundredths format. If more than an hour, it is expressed in hours:minutes:seconds format. The time is actually only accurate to about 6/100 of a second. CPU UT Approximate percentage of CPU time that the process has used in the last approximately 10 seconds. This column may be at most 10 seconds old. The percentage for the DV System Task is basically unused CPU time. KY The keys used to open the application. NAME The name of the application, as shown on the Open Window menu. If the /l option is used, the output looks a little messier: HNDL SW TK MAP TTLMEM SYSMEM L SYS CPU TIME CPU UT KY NAME kbd mbx obq cursor positn visible logcl dispd d3e2 ? 0 0249 654016 384752 354128 01:12:30 97.2% DV System Task 014d d3e2 0197 ( 1,17) ( 0,56) ( 0, 0) 17x24 17x24 ce55 ? 1 1044 16448 1632 1088 00:00.06 0.0% CC Clock & Calendar 014d ce55 0197 ( 0,33) (58,15) ( 0, 0) 1x45 1x35 cefe 2 1 1aca 589808 480 432 00:12.45 0.0% BD Big DOS 014d cefe 0197 (39, 6) ( 0, 0) ( 0, 0) 60x80 60x80 cf4f 3 1 1fe0 32736 208 208 00:03.14 2.8% PS DVSI ps 014d cf4f 0197 (16,15) (11, 0) ( 0, 0) 50x80 28x80 The additional columns in the second line for each process are: KBD MBX OBQ The hex offsets for the process's default keyboard, mailbox and objectq. The segments are the same as the process's handle. CURSOR The position of the cursor relative to the window's origin, (row, column). POSITN The upper left corner of the window on the screen, (row, column). VISIBLE The coordinate of the upper left corner of the displayed window, (row, column). This number can be changed by using "Rearrange - Scroll". LOGCL Logical, or maximum, size of the window, in rows x columns. DISPD Displayed size of the window, in rows x columns. OPTIONS All options are case sensitive. Options may be strung together: /c4/p/d\dv /cn Continuously update the list every n seconds. Normally, ps lists the status and exits. This option is most useful when ps is used in its own window. n must be an integer between 0 and 65535 (I don't know why you'd want to wait 18 hours, but you can!). Hitting any key will stop the listing and cause ps to exit. /p When the listing is complete, print "Press any key to continue..." and wait for a keystroke. Helpful if you are not using /c and you want to use ps in its own window. Will work with the /c option. /dpath Find DESQVIEW.DVO in the directory specified by path. DESQVIEW.DVO is the file that the Open Window menu gets its info from, and where ps finds the NAME and KEY fields. If this option is not specified, ps will first look in C:\DV, then search the PATH environment variable for the directory. This will usually work because the DESQview system directory name should be in the PATH. However, I have noticed that the environment does not get passed if ps is started from its own window, so I provided this option. /r Resize the window according to the number of processes in the list. The window is made 80 columns wide and high enough for all the processes to be displayed, and is moved left to column 0. If using /c and the number of processes changes, the window size is changed also. /l Long listing: more info than you really wanted to know about each process. /q Quiet - does not print banner. /t Terse - does not print column headings. /? Prints a help screen. If any bad options are given, this screen will automatically be printed. <process_id> If <process_id> is specified, only display info for that process. Normally, PS displays all processes. <process_id> is interpreted as a hexadecimal handle if it is 4 digits. Otherwise, it is considered a switch windows number. A leading "%" is ignored for you Unix junkies. BUGS Any processes started after 15 have been started will be ignored. Running Add A Program or Delete A Program no longer confuses PS. However, if you are using /c and you add or delete programs, and run them, PS may display "(not available)" in the NAME field. This is because PS does not close and reopen DESQVIEW.DVO each iteration. If the "(not available)" bothers you, exit PS and restart. Programs launched with some of the subcommands of DV Commander may not get the proper name in the NAME field. I will have to change the algorithm for getting the name, and actually grab the text on the window border. Strange numbers will show in the first few seconds if PS is launched from a start up script. Last Updated: October 8, 1991 ---------------------------------------------------------------------------- NAME memstat - DESQview memory status SYNOPSIS memstat [/cn /p /q /t /?] DESCRIPTION MEMSTAT is an alternative to DESQview's Memory Status program. It takes up much less CPU time, although it is larger than Memory Status. It can also be used at the DOS command line, while Memory Status cannot. MEMSTAT displays the same information as memory status, and adds another column. The output looks like this: TYPE TOTAL LARGEST AVAILABLE USED Conv 590K 345K 375K 36% Exp 2912K 576K 1184K 59% Com 25600 10668 10804 58% The columns are: TYPE The type of memory described in this row. "Conv" is conventional memory, or memory between 0 and 640K. "Exp" is expanded (EMS or EEMS) memory. "Com" is DESQview's common memory area. TOTAL The total amount of memory in the system. LARGEST The largest block of available memory. AVAILABLE The total amount of memory currently available. USED The percentage of memory that is currently being used. OPTIONS All options are case sensitive. Options may be strung together: /c4/p /cn Continuously update the statistics every n seconds. Normally, memstat lists the statistics and exits. This option is most useful when memstat is used in its own window. n must be an integer between 0 and 65535. Hitting any key will stop the listing and cause memstat to exit. /p When the listing is complete, print "Press any key to continue..." and wait for a keystroke. Helpful if you are not using /c and you want to use perf in its own window. Will work with the /c option. /q Quiet - does not print banner. /t Terse - does not print column headings. /? Prints a help screen. If any bad options are given, this screen will automatically be printed. Last Updated: September 2, 1991 -------------------------------------------------------------------------- NAME uptime - Print amount of time DESQview has been running SYNOPSIS uptime [/p /q /t /?] DESCRIPTION UPTIME reports the amount of time that DESQview has been running in the following format: DESQview has been running for 2 days 1 hour 5 minutes and 21.34 seconds Since Fri Aug 02 18:23:45 1991 UPTIME requires DVSIXDI 1.21 to be installed. OPTIONS All options are case sensitive. /p After the time is displayed, print "Press any key to continue..." and wait for a keystroke. /q Quiet - does not print banner. /t Terse - does not print extra text, and prints run time as hh:mm:ss.hh. /? Print a help message summarizing the options. Last Updated: September 2, 1991 -------------------------------------------------------------------------- NAME wn - Manipulate DESQview windows SYNOPSIS wn [/?] <command> [<process_id>] DESCRIPTION WN contains a set of commands for manipulating DESQview windows. Windows may be killed, raised, lowered, topped, hidden or suspended. Killing a window is just like the DVSI's KILL command. Read KILL's man page for more information. Raising a window gives it the keyboard. It is equivalent to using the "Switch Windows" menu. Lowering a window puts it at the bottom of the window stack, and takes away the keyboard. Topping a window brings it to the top of the window stack, but does not give it the keyboard. Hiding a window is works just like "Rearrange - Hide". Suspending a window hides it and doesn't give it any CPU time while hidden. A suspended or hidden window may be unhidden by raising or topping it. OPTIONS /? Print a help message <command> may be one of the following. The first letter of the command may be used as an abbreviation. The command is case-insensitive. KILL RAISE LOWER TOP HIDE SUSPEND If <process_id> is specified, that process's window is manipulated. Otherwise, the current process's window is used. If <process_id> is 4 hex digits, it is interpreted as a handle. Otherwise, it is considered a Switch Windows number. A leading "%" is ignored for you Unix junkies. If <process_id> is not specified, the current process is used. However, WN KILL requires a process id. Last Updated: September 2, 1991