ultrix man page for dxpresto

dxpresto(8X)															      dxpresto(8X)

Name
       dxpresto - graphically display Prestoserve state and statistics

Syntax
       /usr/etc/dxpresto  [options]  [hostname]

Description
       The  command  is an X Window System application that graphically displays a machine's Prestoserve state and statistics.	The command uses a
       Remote Procedure Call (RPC) protocol to communicate with the machine being monitored.  You use the command to provide  general  information
       about Prestoserve and to help manage Prestoserve.  Also, you can use the command to demonstrate the efficacy of the Prestoserve software.

       Use  the hostname variable to specify the machine that you want to monitor; the machine must be running the Prestoserve software.  If host-
       name is not specified, the window opens but it is not functional until you enter the name of a host running the Prestoserve software in the
       Host  field.   The  machine  that  you  want  to  monitor  must	be  running the daemon.  Also, if you want to be able to enable or disable
       Prestoserve on the machine, it must be running the daemon with the option.

       Because is an X Window System application, your DISPLAY environmental variable must be set to a machine that is	an  X  Server.	 For  more
       information, see

Options
       -bd color	   Specifies the color of the window's border (color displays only).  The default is black.

       -bg color	   Specifies the color of the window's background (color displays only).  The default is white.

       -d dispname	   Specifies  the  display  screen on which displays its window.  If the display option is not specified, uses the display
			   screen specified by your DISPLAY environment variable.  The display option has the format hostname:number.	Using  two
			   colons  (::) instead of one (:) indicates that DECnet is to be used for transport.  The default is :0.  For more infor-
			   mation, see

       -display dispname   This option is the same as the -d option.

       -fg color	   Specifies the color of the text (color displays only).  The default is black.

       -geometry	   Specifies the width, length, and location of the window.  If the geometry option is not specified, uses default values.
			   The	geometry  option has the format =[width][xlength][x][y].  For more information about the screen coordinate system,
			   see

dxpresto Window
       The window contains the following information:

       Host field
	      Shows the name of the host that you are monitoring.  You type a host name in the field and hit the Return key to monitor that host.

       Presto State buttons
	      Show the Prestoserve state, either Enabled (UP), Disabled (DOWN), or Error (ERROR).  If the machine being monitored is  running  the
	      daemon  with the option, you can change the machine's Prestoserve state to either Enabled (UP) or Disabled (DOWN) by clicking on the
	      appropriate button.  You cannot click on the Error button; contact the server administrator or the  server  hardware  Field  Service
	      representative if the Error button is enabled.

       Sample Interval slider
	      Displays	the interval of time between Prestoserve queries and allows you to change that interval.  When you invoke the command, the
	      default sample interval is 5; therefore Prestoserve  information	is  gathered  every  five  seconds.   For  example,  if  you  want
	      Prestoserve  queried more often, move the slider to the left and click on MB1 until 2 appears; Prestoserve is then queried every two
	      seconds.

       Time since last Enable field
	      Shows the time since Prestoserve was last enabled. The time is displayed in hours, minutes, and seconds.	The total number  of  sec-
	      onds is also shown.

       Size field
	      Displays the number of Kbytes of nonvolatile memory that the Prestoserve cache is utilizing.  Note that Prestoserve can utilize less
	      than the default maximum size of its Prestoserve cache if you changed the cache size with the command.

       Battery icons
	      Show the state of the Prestoserve backup battery system.	An intact battery icon with the word ok indicates  that  the  battery  has
	      sufficient  power.  An intact battery icon with the word low indicates that the battery's power is low.  A broken battery icon indi-
	      cates that the battery is disabled.  Prestoserve goes into the ERROR state when the backup  battery  power  falls  below	a  minimum
	      amount.  Contact the server administrator or the server hardware Field Service representative if a battery is low or disabled.

       Display Cache Utilization buttons
	      Allow you to display or to not display graphs that demonstrate how the Prestoserve cache is being utilized.

       Display Cache Statistics buttons
	      Allow you to display or to not display the Prestoserve cache statistics table.

       Exit button
	      Allows you to exit from

       Message bar
	      Displays error messages and informational messages for both Prestoserve and the command.	For example, if the daemon with the option
	      is not running on the machine you are monitoring, then a message is displayed indicating that changes to Prestoserve  operation  are
	      not allowed.

	      Some  error  messages,  such as those indicating RPC communication failure, are displayed on the terminal from which you invoked the
	      command.

Cache Utilization Graphs
       If you enable the Display Cache Utilization graphs, the following is displayed:

       Presto buffers bar graph
	      Shows how the Prestoserve cache operations are distributed among the four Prestoserve  buffer  states:   dirty,  clean,  inval,  and
	      active.	The  vertical  axis shows the maximum number of objects or disk blocks that the entire Prestoserve cache can contain.  The
	      sum of the four bars is the total number of buffers used in the Prestoserve cache.  Note that the size of the Prestoserve cache  can
	      be changed by using the command.

       Writes per second trend line graph
	      Shows  a	recent history of the average number of writes per second over the time intervals that are determined by the sample inter-
	      val.

	      Each point in the horizontal axis represents a sample time interval as determined by the sample interval; the maximum number of sam-
	      ples  that  can be shown is 210.	When you reach the maximum number of samples, the graph shifts to the left so you can see at least
	      the last 105 samples, which is half the maximum number of samples.  If you choose 5 as the sample interval, Prestoserve  is  queried
	      every five seconds; therefore it takes 1050 (5 x 210) seconds to obtain the maximum of 210 samples.

	      The  vertical axis shows the average number of writes performed per second within the sample time interval as determined by the sam-
	      ple interval.

	      For example, if you choose 2 as the sample interval, Prestoserve is queried every two seconds, and each point in the graph shows the
	      average  number  of  writes performed within the interval of two seconds.  If the graph shows that an average of 5 writes per second
	      were performed within two seconds, Prestoserve actually performed 10 writes within those two seconds.  The calculation is:
	       5 writes
	      ---------- x 2 sec = 10 writes
		 sec

	      If you change hosts, the Writes per second graph displays a vertical line of dashes to distinguish the new host's  information  from
	      the previous host's information.

       Hits per second trend line graph
	      Shows a recent history of the average number of Prestoserve cache hits per second over the time intervals that are determined by the
	      sample interval.	The Prestoserve cache hits represent the total number of clean and dirty read and write hits  (blocks  that  match
	      blocks already in the cache).

	      Each point in the horizontal axis represents a sample time interval as determined by the sample interval; the maximum number of sam-
	      ples that can be shown is 210.  When you reach the maximum number of samples, the graph shifts to the left so you can see  at  least
	      the  last  105 samples, which is half the maximum number of samples.  If you choose 2 as the sample interval, Prestoserve is queried
	      every two seconds; therefore it takes 420 (2 x 210) seconds to obtain the maximum of 210 samples.

	      The vertical axis shows the average number of hits performed per second within the sample time interval as determined by the  sample
	      interval.

	      For example, if you choose 10 as the sample interval, Prestoserve is queried every 10 seconds, and each point in the graph shows the
	      average number of hits performed within the interval of 10 seconds.  If the graph shows that an average of 2 hits  per  second  were
	      performed within 10 seconds, Prestoserve actually performed 20 writes within those 10 seconds.  The calculation is:
		2 hits
	      ---------- x 10 sec = 20 hits
		 sec

	      If you change hosts, the Hits per second graph displays a vertical line of dashes to distinguish the new host's information from the
	      previous host's information.

Cache Statistics Table
       If you enable the Display Cache Statistics table, the following is displayed:

       Prestoserve statistics table
	      Shows information similar to the information that is displayed when you use the command.	For each Prestoserve cache read  or  write
	      operation, Prestoserve increments an appropriate counter.  The table shows:

	      The clean hits counter, which is the number of hits on the clean buffers

	      The  dirty  hits counter, which is the number of hits on the dirty buffers (each dirty hit represents a physical disk write that was
	      avoided entirely)

	      The passes counter, which is the number of I/O operations that Prestoserve passed directly to the actual device driver

	      The count, which is the sum of the three previous counters

	      The hit rate percentage, which is the ratio of clean hits and dirty hits to the total count

       Since last Enable button
	      Allows you to display Prestoserve statistics since Prestoserve was last enabled.	This is useful when  you  want	to  determine  how
	      Prestoserve performs over a long period of time.

       Since last Sample button
	      Allows  you  to display the Prestoserve statistics for each sample time interval as determined by the Sample Interval slider.  If no
	      Prestoserve activity occurs during the time interval, the numbers in the statistics table are zero.   For  example,  if  the  Sample
	      Interval	slider	is set to 5 and the Since last Sample button is enabled, the statistics table shows the Prestoserve statistics for
	      each interval of five seconds.

       Since last Zero button
	      Allows you to display Prestoserve statistics since you clicked on  the  Zero  button.  This  button  allows  you	to  determine  how
	      Prestoserve performs over a specific period of time that you can set by using the Zero button.

       Zero button
	      Allows  you  to  set  a  time reference for the Prestoserve statistics table.  If you click on the Zero button and, at a later time,
	      click on the Since last Zero button, the table displays the Prestoserve statistics since you clicked on the Zero button.

X Defaults
       The application uses the values in the .Xdefaults file when you logged in and uses the appropriate resource specification to customize  the
       appearance or characteristics of its displayed window.  The format for a resource specification in the .Xdefaults file is:

		      [name*]resource:	value

       name	 Specifies the application name or the name string that restricts the resource assignment to that application or to a component of
		 an application.  If this argument is not specified, the resource assignment is globally available to all X applications.

       resource  Specifies the resource.

       value	 Specifies the value that is to be assigned to the resource.

       For more information, see

       Because each toolkit-based application can consist of a combination of widgets (for example, push buttons and a scroll bar), you  can  form
       the  name  string  by  adding widget class and name identifiers to the string.  For further information about adding class and name identi-
       fiers, see

       For the available name identifiers are:

       graph_parent	   The dialog box containing all of the graphs

       dirty_graph	   The graph displaying dirty buffers

       clean_graph	   The graph displaying clean buffers

       inval_graph	   The graph displaying inval buffers

       active_graph	   The graph displaying active buffers

       write_graph	   The graph displaying cache write history

       hit_graph	   The graph displaying cache hit history

Examples
       If you want to change the foreground and background colors of the window and to customize the window's graphs, you can  add  the  following
       entries to your .Xdefaults file:
       DXpresto*background:		       darkslategray
       DXpresto*foreground:		       wheat
       DXpresto*borderColor:		       gold
       DXpresto*highlight:		       yellow
       DXpresto*graph_parent*borderColor:      firebrick
       DXpresto*dirty_graph*highlight:	       gold
       DXpresto*dirty_graph*background:        black
       DXpresto*clean_graph*highlight:	       gold
       DXpresto*clean_graph*background:        black
       DXpresto*inval_graph*highlight:	       gold
       DXpresto*inval_graph*background:        black
       DXpresto*active_graph*highlight:        gold
       DXpresto*active_graph*background:       black
       DXpresto*write_graph*highlight:	       gold
       DXpresto*write_graph*background:        black
       DXpresto*hit_graph*highlight:	       gold
       DXpresto*hit_graph*background:	       black

Files
See Also
       presto(4), presto(8), prestoctl_svc(8), X(1X), dxsession(1X)
       Guide to Prestoserve

																      dxpresto(8X)