From:	CRDGW2::CRDGW2::MRGATE::"SMTP::CRVAX.SRI.COM::RELAY-INFO-VAX"  7-MAY-1991 23:09:14.18
To:	ARISIA::EVERHART
CC:	
Subj:	DECwindows Cookbook 4 of 8

From:	RELAY-INFO-VAX@CRVAX.SRI.COM@SMTP@CRDGW2
To:	Everhart@Arisia@MRGATE

Received:  by crdgw1.ge.com (5.57/GE 1.97)
	 id AA17721; Tue, 7 May 91 22:05:58 EDT
Received: From UCBVAX.BERKELEY.EDU by CRVAX.SRI.COM with TCP; Tue,  7 MAY 91 17:30:44 PDT
Received: by ucbvax.Berkeley.EDU (5.63/1.42)
	id AA11387; Tue, 7 May 91 17:18:08 -0700
Received: from USENET by ucbvax.Berkeley.EDU with netnews
	for info-vax@kl.sri.com (info-vax@kl.sri.com)
	(contact usenet@ucbvax.Berkeley.EDU if you have questions)
Date: 6 May 91 01:23:58 GMT
From: csus.edu!wuarchive!zaphod.mps.ohio-state.edu!pacific.mps.ohio-state.edu!linac!convex!mic!montagar!fallout!system@ucdavis.ucdavis.edu  (T-H-E John Wisniewski?!?)
Organization: DECUS DFWLug BBS - Dallas, TX
Subject: DECwindows Cookbook 4 of 8
Message-Id: <5120@fallout.uucp>
Sender: info-vax-request@kl.sri.com
To: info-vax@kl.sri.com

+-+-+-+ Beginning of part 4 +-+-+-+
X( ) h
X300 -58050 M
X300 -59250 M
X300 -60450 M
X300 -61650 M
X-7200 7200 T
XR
X
Xshowpage
X$P e
X
X%%Page: 11 11
X/$P a D
Xg N
X0 79200 T
XS
XR
XS
X7200 -7200 T
XN
X0 G
X300 -1200 M
X/NewCenturySchlbk-Roman-ISOLatin1 $
X/NewCenturySchlbk-Roman & P
X/NewCenturySchlbk-Roman-ISOLatin1 F 1200 o f
X( USER ACCOUNT  REQUIREMENTS) h
X300 -2600 M
X( ) h
X300 -4000 M
X(DECwindow user accounts should be adjusted  to compliment  the memory) h
X300 -5400 M
X(reclamation strategy that is created from the SYSGEN parameters set in the) h
X300 -6800 M
X(previous section.) h
X300 -8200 M
X300 -9600 M
V(WSDEFAULT should be set to a size large enough to create the window quickly,)
X h
X300 -11000 M
X(yet allow only enough memory to begin the process's image or task. ) h
X300 -12400 M
X300 -13800 M
V(WSQUOTA  should be  large enough to contain the idle Process's  image when it
X is ) h
X300 -15200 M
V(idle and inactive. This will allow maximum restart performance for a window.)
X h
X300 -16600 M
X300 -18000 M
X(WSEXTENT should be set to allow for the total number of ACTIVE DECWINDOW) h
X300 -19400 M
X(PROCESSES to divide the rest of the memory up evenly among themselves.) h
X300 -20800 M
V(If there is one main DECwindow application, make sure that it's process has al
Xl) h
X300 -22200 M
X(the memory required for it's best performance set here.) h
X300 -23600 M
X( ) h
X300 -25000 M
V(Note that this philosophy of memory management  is different from the traditio
Xnal) h
X300 -26400 M
V(time\255share methods.  We are not preallocating large slices of memory resour
Xces for) h
X300 -27800 M
V(each user to keep at all times, we are trying to give the maximum memory to la
Xtest) h
X300 -29200 M
V(application\(s\) a DECwindow's user activates and spreads the rest of memory)
X h
X300 -30600 M
X(resources among the remaining background processes and windows..  ) h
X300 -32000 M
X300 -33400 M
X(In a memory poor system, this method limits the overall performance, but) h
X300 -34800 M
V(heightens the active window  process performance by reallocating memory only )
X h
X300 -36200 M
X(to active processes. ) h
X300 -37600 M
X300 -39000 M
X(In a memory rich system,  the memory scavenging may seem inappropriate, but) h
X300 -40400 M
V(idle jobs should have pages put back to the free list so that if other tasks a
Xre ) h
X300 -41800 M
X(started, they too can have enough memory ready for quick activation.  ) h
X300 -43200 M
X300 -44600 M
V(The net gain is more memory for active or new jobs and the performance increas
Xe) h
X300 -46000 M
X(that only available memory can give.) h
X300 -47250 M
X300 -48600 M
X(In a workstation environment, we are only borrowing from ourselves, the) h
X300 -50000 M
X(resources should follow us where we are working and not remain trapped ) h
X300 -51400 M
X(in idle processes or iconed windows.) h
X300 -52650 M
X-7200 7200 T
XR
X
Xshowpage
X$P e
X
X%%Page: 12 12
X/$P a D
Xg N
X0 79200 T
XS
XR
XS
X7200 -7200 T
XN
X0 G
X300 -1200 M
X/NewCenturySchlbk-Roman-ISOLatin1 $
X/NewCenturySchlbk-Roman & P
X/NewCenturySchlbk-Roman-ISOLatin1 F 1200 o f
X(USER ACCOUNT  REQUIREMENTS \(cont\)) h
X300 -2600 M
X300 -4000 M
X(HOW TO DETERMINE IMAGE MEMORY REQUIREMENTS) h
X300 -5400 M
X300 -6800 M
X300 -8200 M
V(The show process command will show peak and peak virtual size for a process:)
X h
X300 -9600 M
X300 -11000 M
X300 -12400 M
X300 -13800 M
X($ show proc/acc) h
X300 -15200 M
X(15\255DEC\2551990 19:53:02.72 User: SYSTEM) h
X23340 -15200 M
X(  ) h
X29100 -15200 M
X(        Process ID: 000003A3) h
X300 -16600 M
X6060 -16600 M
X11820 -16600 M
X(         Node: ROVER) h
X23340 -16600 M
X(         ) h
X29100 -16600 M
X(        Process name: "_TWA48:") h
X300 -18000 M
X(Accounting information:  ) h
X300 -19400 M
X(Buffered I/O count:    404) h
X17580 -19400 M
X(Peak working set size:) h
X34860 -19400 M
X(823) h
X300 -20800 M
X( Direct I/O count:) h
X11820 -20800 M
X(  125 ) h
X17580 -20800 M
X(Peak virtual size:) h
X29100 -20800 M
X34860 -20800 M
X(5299) h
X300 -22200 M
X( Page faults:) h
X11820 -22200 M
X(1558         Mounted volumes:) h
X29100 -22200 M
X34860 -22200 M
X(0) h
X300 -23600 M
X( Images activated:) h
X11820 -23600 M
X(8) h
X300 -25000 M
X( Elapsed CPU time:) h
X11820 -25000 M
X(0 00:00:03.74) h
X300 -26400 M
X( Connect time:) h
X11820 -26400 M
X(0 06:38:50.50) h
X300 -27800 M
X300 -29200 M
X300 -30600 M
X300 -32000 M
X(After running the program within the current DECwindows. processes, the ) h
X300 -33400 M
X(Peak working set size is a very good starting point for WSQUOTA and about) h
X300 -34800 M
X(50\25575% of peak virtual size is a good starting point for WSEXTENT.) h
X300 -36200 M
X300 -37600 M
V(Additional monitoring as the process performs real work will reveal the amount
X ) h
X300 -39000 M
X(of memory actually required for WSEXTENT.  The VAX Performance Advisor is ) h
X300 -40400 M
V(an excellent tool for making this kind of determination as history is kept and
X) h
X300 -41800 M
X(correlated about an image's average memory requirements automatically.) h
X300 -43200 M
X300 -44450 M
X-7200 7200 T
XR
X
Xshowpage
X$P e
X
X%%Page: 13 13
X/$P a D
Xg N
X0 79200 T
XS
XR
XS
X7200 -7200 T
XN
X0 G
X300 -1200 M
X/NewCenturySchlbk-Roman-ISOLatin1 $
X/NewCenturySchlbk-Roman & P
X/NewCenturySchlbk-Roman-ISOLatin1 F 1200 o f
X(USER ACCOUNT  REQUIREMENTS \(cont\)) h
X300 -2600 M
X300 -4000 M
X(EXAMPLE DECWINDOW USER ACCOUNT) h
X300 -5400 M
X300 -6800 M
V(An example user authorization file entry shows the memory, pagefile quota, and
X) h
X300 -8200 M
X(Bytlm that will make the DECwindow user with multiple task concurrently) h
X300 -9600 M
X(executing feel a much more responsive. ) h
X300 -11000 M
X300 -12400 M
V(Make sure set Pgflquo: such as to leave about 5k\25510k pages in the pagefile
X or your) h
X300 -13800 M
X(system may periodically hang.) h
X300 -15200 M
X300 -16600 M
X($ RUN AUTHORIZE ) h
X300 -18000 M
X(UAF> SHOW DECWINDOW_USER1) h
X300 -19400 M
X(Username: DECWINDOW_USER1) h
X23340 -19400 M
X( Owner: Win Dos) h
X300 -20800 M
X(Account: WS122) h
X11820 -20800 M
X17580 -20800 M
X23340 -20800 M
X(     UIC: [124,4] \([BETTER,WINDOS]\)) h
X300 -22200 M
X(CLI: DCL                                          ) h
X23340 -22200 M
X(Tables: DCLTABLES) h
X300 -23600 M
X(Default: NON_SYSTEM_DISK:[WINDOS] ) h
X300 -25000 M
X(LGICMD: ) h
X300 -26400 M
X(Flags: \(Don't use Captive flag or DECwindows won't login!\)) h
X300 -27800 M
X(Primary days: Mon Tue Wed Thu Fri Secondary days:) h
X34860 -27800 M
X(Sat Sun) h
X300 -29200 M
X(No access restrictions ) h
X300 -30600 M
X(Expiration:) h
X11820 -30600 M
V(\(none\)                           Pwdminimum: 8     Login Fails:           0)
X h
X300 -32000 M
X(Pwdlifetime:) h
X11820 -32000 M
X(\(none\)        Pwdchange:   22\255SEP\2551990 21:48) h
X300 -33400 M
V(Last Login: 15\255DEC\2551990 11:02 \(interactive\), 15\255DEC\2551990 13:14 \
X(non\255interactive\) ) h
X300 -34800 M
V(Maxjobs:         0     Fillm:                  60       Bytlm:               1
X00000) h
X300 -36200 M
V(Maxacctjobs:  0 Shrfillm:                   0      Pbytlm:                `032
X        0) h
X300 -37600 M
X(Maxdetach:    0    BIOlm:) h
X17580 -37600 M
X(       36    JTquota:                   1024) h
X300 -39000 M
X(Prclm:      ) h
X6060 -39000 M
X(    40    DIOlm:                 36       WSdef:) h
X29100 -39000 M
X(                512) h
X300 -40400 M
X(Prio:  ) h
X6060 -40400 M
X(      4    ASTlm:                 96      WSquo:                   2049) h
X300 -41800 M
X(Queprio:) h
X6060 -41800 M
X(      0    TQElm:                40  WSextent:                 15000) h
X300 -43200 M
V(CPU:    \(none\)       Enqlm:            4400      Pgflquo:                 50
X000) h
X300 -44600 M
X(Authorized Privileges:) h
X300 -46000 M
X(TMPMBX NETMBX ) h
X300 -47400 M
X(Default Privileges:  ) h
X300 -48800 M
X(TMPMBX NETMBX ) h
X300 -50200 M
X(      Identifier) h
X11820 -50200 M
X(      Value) h
X17580 -50200 M
X23340 -50200 M
X(Attributes) h
X300 -51600 M
X( NICE_GUY) h
X11820 -51600 M
X(%X80010004) h
X300 -53000 M
X300 -54400 M
V(Note that these setting are for the user who is doing a variety of tasks, edit
Xing,) h
X300 -55800 M
X(compiling, and mail from their windows.  Be sure to follow the tuning) h
X300 -57200 M
V(requirements for specific applications \(like CAD/graphic intensive program\).
X) h
X300 -58600 M
X300 -60000 M
V(Just because the mail window pops right up, that might not be the reason you)
X h
X300 -61400 M
V(or your company bought the machine.  Tune the primary application first, then)
X h
X300 -62800 M
X(share the resources leftover with other DECwindow jobs!) h
X300 -64200 M
X-7200 7200 T
XR
X
Xshowpage
X$P e
X
X%%Page: 14 14
X/$P a D
Xg N
X0 79200 T
XS
XR
XS
X7200 -7200 T
XN
X0 G
X300 -1200 M
X300 -3650 M
X/NewCenturySchlbk-Roman-ISOLatin1 $
X/NewCenturySchlbk-Roman & P
X/NewCenturySchlbk-Roman-ISOLatin1 F 1800 o f
X(Chapter 2  DECWINDOWS SYSTEM MANAGEMENT) h
X300 -5200 M
X300 -6600 M
Xn 0.667 o f
X(DECwindows base applications are VMS processes, detached processes, and ) h
X300 -8000 M
X(application programs, no different from traditional VMS managed entities.) h
X300 -9400 M
X300 -10800 M
X(The goal of DECwindows is to implement the Xwindow Client /Server graphic) h
X300 -12200 M
X(protocol.  As a VMS application, DECwindows  can be tuned and managed for) h
X300 -13600 M
X(better performance.) h
X300 -15000 M
X300 -16400 M
X(SYS$MANAGER:DECW$STARTUP) h
X300 -17800 M
X300 -19200 M
X(Starting DECwindows under VMS is accomplished by executing the ) h
X300 -20600 M
X(command file) h
X300 -22000 M
X12834 -23400 M
X(@SYS$MANAGER:DECW$STARTUP) h
X300 -24800 M
X300 -26200 M
X(This command is usually executed as part of system startup to set the ) h
X300 -27600 M
X(DECwindows logicals, and startup the DECwindow server process.) h
X300 -29000 M
X300 -30400 M
X(Adding new fonts, or changing DECwindow logicals can be accomplished by ) h
X300 -31800 M
X(using:) h
X300 -33200 M
X9756 -34600 M
X(@SYS$MANAGER:DECW$STARTUP RESTART) h
X300 -36000 M
X300 -37400 M
X(This command shuts down the DECwindow processes and any window sessions) h
X300 -38800 M
X(that are logged in.  Without rebooting VMS, DECwindows restarts and may) h
X300 -40200 M
X(then be used normally.   Hung DECwindow sessions may be freed with this) h
X300 -41600 M
X(command \(if you have terminal access to the VAX\) without rebooting the) h
X300 -43000 M
X(VMS system.) h
X300 -44400 M
X300 -45800 M
X(                           @SYS$MANAGER:DECW$STARTAPPS.COM ) h
X300 -47200 M
X300 -48600 M
X(This command is executed from the DECW$STARTUP command invoked) h
X300 -50000 M
X(whenever  SYS$MANAGER:DECW$STARTUP is started.) h
X300 -51400 M
X300 -52800 M
V(This file allows you to change logicals,  create search lists for logicals and
X place) h
X300 -54200 M
X(new logicals in the  \(DECW$LOGICAL_NAMES\) logical table.  Changes to ) h
X300 -55600 M
X(this file are unsupported because during upgrades, VMS replaces this file) h
X300 -57000 M
X(with a standard startup.  Any special changes will have to be saved and ) h
X300 -58400 M
X(re\255edited into the file after any VMS upgrade.) h
X300 -59800 M
X300 -61200 M
X300 -62600 M
X300 -64000 M
X-7200 7200 T
XR
X
Xshowpage
X$P e
X
X%%Page: 15 15
X/$P a D
Xg N
X0 79200 T
XS
XR
XS
X7200 -7200 T
XN
X0 G
X300 -1200 M
X/NewCenturySchlbk-Roman-ISOLatin1 $
X/NewCenturySchlbk-Roman & P
X/NewCenturySchlbk-Roman-ISOLatin1 F 1200 o f
X(DECWINDOWS SYSTEM MANAGEMENT \(cont\)) h
X300 -2600 M
X300 -4000 M
V(One of  the limiting resource for the DECwindow processes is the workingset )
X h
X300 -5400 M
X(sizes and the process quotas for the  DECW$SERVER_x and DECW$TE_x) h
X300 -6800 M
X(VMS processes.) h
X300 -8200 M
X300 -9600 M
X(The command file SYS$STARTUP:DECW$STARTAPPS.COM establishes) h
X300 -11000 M
X(the defaults for these process, and for most users these defaults are ) h
X300 -12400 M
X(established very low.  The defaults allow these processes to function on ) h
X300 -13800 M
X(a very memory poor system, but for more memory available systems, ) h
X300 -15200 M
X(increasing these values could greatly improve performance and eliminate) h
X300 -16600 M
X(DECwindow processes paging.) h
X300 -18000 M
X300 -19400 M
X(With background  and new graphic intensive applications being charged ) h
X300 -20800 M
X(against the workingset of the DECW$SERVER_x process \(like the display) h
X300 -22200 M
X(postscript capablity of the CDA View in VMS 5.4\) additional memory is one ) h
X300 -23600 M
X(of the main improvements to performance we can give DECwindows.) h
X300 -25000 M
X( ) h
X300 -26400 M
X(Adjusting DEC$SERVER_x and DECW$TE_x processes are controlled) h
X300 -27800 M
X(from logical not documented in SYS$STARTUP:DECW$STARTUPAPPS.COM) h
X300 -29200 M
X(but can be added easily to this startup proceedure.) h
X300 -30600 M
X300 -32000 M
X(Logicals can be specified to define defaults for Workingset DEFAULT, ) h
X300 -33400 M
X(QUOTA, and EXTENT can be as well as page file quota and enquelimits. ) h
X300 -34800 M
X(These logicals must be specified before the body of DECW$STARTAPPS.COM) h
X300 -36200 M
X(or the processes created will not reflect their values.) h
X300 -37600 M
X300 -39000 M
X300 -40400 M
X(DECW$BOOK LOGICAL) h
X300 -41800 M
X300 -43200 M
X300 -44600 M
X(DECW$STARTAPPS.COM is the source of all DECW*  default logical definitions.) h
X300 -46000 M
X(The DECW$BOOK  logical is one of the more useful that is defined from this ) h
X300 -47400 M
X(proceedure.) h
X300 -48800 M
X300 -50200 M
X(Creating a search list of DECW$BOOK enables the DECwindows Bookreader) h
X300 -51600 M
X(to read libraries from multiple locations.) h
X300 -53000 M
X300 -54400 M
V(Multiple bookreader Library files  located in the search list appear appended)
X h
X300 -55800 M
V(to one another in order of the searchlist.  This makes it appear as if all of
X the) h
X300 -57200 M
X(library files are one library to bookreader.) h
X300 -58600 M
X300 -60000 M
X(\(The file DECW$BOOK:LIBRARY.DECW$BOOKSHELF controls what) h
X300 -61400 M
X(bookshelves and books are available from the Bookreader application\)) h
X300 -62800 M
X300 -64200 M
X-7200 7200 T
XR
X
Xshowpage
X$P e
X
X%%Page: 16 16
X/$P a D
Xg N
X0 79200 T
XS
XR
XS
X7200 -7200 T
XN
X0 G
X300 -1200 M
X/NewCenturySchlbk-Roman-ISOLatin1 $
X/NewCenturySchlbk-Roman & P
X/NewCenturySchlbk-Roman-ISOLatin1 F 1200 o f
X(DECWINDOWS SYSTEM MANAGEMENT \(cont\)) h
X300 -2600 M
X300 -4000 M
X(DECW$BOOK LOGICAL) h
X300 -5400 M
X300 -6800 M
X(This search list ability allows you to have several Libraries of books) h
X300 -8200 M
X(either on CDrom drives or Books created from DECwrite all available) h
X300 -9600 M
X(from one Bookreader session.) h
X300 -11000 M
X300 -12400 M
X(Using this technique, older versions of documentation could be kept on ) h
X300 -13800 M
-+-+-+-+-+ End of part 4 +-+-+-+-+-

