aview man page on IRIX

Man page or keyword search:  
man Server   31559 pages
apropos Keyword Search (all sections)
Output format
IRIX logo
[printable version]



aview(1)							      aview(1)

NAME
     aview, ArrayView - array status monitor for the X Window System

SYNOPSIS
     ArrayView [options...]
     aview [options...]

DESCRIPTION
     The ArrayView command (also known by its synonym aview) is used to
     display status information about the various machines in an array.

     The ArrayView window is made up of two sections.  In the top section, a
     brief summary of the overall system utilization of each machine is
     displayed.	 In the bottom section, a separate pane for each machine is
     used to display more detail about some aspect of the system, such as
     logged-in users or the most active processes.  The relative size of the
     upper and lower sections can be controlled by dragging the "sash" button
     on the right hand side of the separator line between them.

     The type of information displayed in the lower section of the ArrayView
     window is controlled from the View menu.  There are several options:

     CPU Hogs
	    Displays information about the most active processes on each
	    machine, according to their CPU utilization sampled over a period
	    of several seconds.

     Processes
	    Displays information about all active processes on each machine.

     Users  Displays a list of all users logged in to each machine.

     In the CPU Hogs and Processes views, it is possible to select an
     individual array session by clicking on a process belonging to that array
     session with the left mouse button.  Once an array session has been
     selected, various actions can be performed on it from the Actions menu.
     These include:

     Kill Session
	    Kill the array session by sending a TERM signal to all of the
	    processes in the array session.

     Suspend Session
	    Temporarily suspend the array session by sending a TSTP signal to
	    all of the processes in the array session.

     Resume Session
	    Resume a suspended array session by sending a CONT signal to all
	    of the processes in the array session.

									Page 1

aview(1)							      aview(1)

     In addition, a popup menu containing these actions will be displayed when
     the right mouse button is clicked on a process.

     The Launch menu can be used to launch programs that use the MPI or PVM
     message passing libraries.	 The MPI Job... item will invoke the mpiview
     program if it has been installed.	If the MPIRUN_DIR environment variable
     was set when ArrayView was invoked, its value will be passed along to
     mpiview as well (note, however, that no other environment variables are
     passed along).  Similarly, the PVM Job... item will invoke the xpvm
     program if it has been installed.	If the PVM_ROOT environment variable
     was set when ArrayView was invoked, its value will be passed along to
     xpvm.  If mpiview or xpvm are not installed, selecting the corresponding
     menu item will cause an error dialog box to be displayed.

OPTION SETTINGS
     The Options menu is used to control some of the details of operating
     ArrayView.

   Array Selection
     The Array... item of the Options menu brings up the Array Selection
     dialog box, which consists mostly of a list of the arrays known to the
     currently selected array services daemon.	The array currently being
     displayed will be highlighted.  To switch to a different array, simply
     select it from the list and click OK.  Selecting <default> will cause the
     array services daemon's default array to be chosen.

   Refresh Settings
     The Refresh... item of the Options menu brings up the Refresh Settings
     dialog box.  This is used to control how the screen and data are
     refreshed.	 When the Auto refresh option is turned on, the screen will be
     refreshed periodically with the latest available information.  The
     interval (in seconds) between automatic refreshes is controlled by the
     Screen refresh field of the dialog box.  When Auto refresh is off, data
     can be refreshed manually by selecting the Refresh now item on the View
     menu.

     If the Freeze on select option of the Refresh Settings dialog is chosen,
     then automatic refresh will be suspended temporarily whenever an array
     session has been selected.	 Auto-refresh will resume ("thaw") when an
     action is performed on the array session or when the array session is
     deselected by clicking on it a second time.  If Freeze on select is not
     chosen, it is possible that a selection may be lost if the screen is
     refreshed before an action is performed.

     The Refresh on thaw option causes the screen to be refreshed immediately
     after resuming auto-refresh.  This can be useful if the screen refresh
     interval is large.

     The Collection sample length interval is used to specify the length in
     seconds of the sample interval used by the CPU Hogs view.	It has no
     effect on the other views.	 The Pause between samples interval controls
     the length (in seconds) of the pause between the time that one batch of

									Page 2

aview(1)							      aview(1)

     data is received from the array services daemon and the time that the
     next one is requested.  Notice that this is separate from the screen
     refresh interval, because screen refresh is asynchronous with data
     collection.  If the screen refresh interval is large, it may be useful to
     increase the pause interval as well to avoid unnecessary overhead.

   Server Information
     The Server... item of the Options menu brings up the Server Information
     dialog box.  Ordinarily, it is only necessary to change this information
     if you wish to use an alternate array services daemon.  The Hostname and
     Port number fields of this dialog box are used to select the location of
     the array services daemon to be contacted for status information.	The
     Forward requests via local server option is used to route all array
     services requests via the local array services daemon, even if they are
     destined for a different machine.	It is generally only necessary to do
     this when array services authentication is being used and you do not wish
     to manually set the authentication keys.  If you wish for array services
     requests to be sent directly to the target servers even though
     authentication is in use, it is necessary to specify the local and remote
     authentication keys in the appropriate fields of the Authentication
     section of the dialog box.	 Contact your system administrator for these
     keys, or see arrayd(1m) and arrayd.conf(4) for more information.

COMMAND LINE OPTIONS
     Valid options include:

     -array arrayname
	  Specifies the name of the array to be monitored.  If not specified,
	  the array services daemon's default destination will be used.

     -direct
	  Indicates that array services requests destined for remote servers
	  should be sent directly to those servers, rather than being
	  forwarded to them by the local array services daemon.	 This will
	  fail on systems that use array services authentication unless the
	  -Kl and -Kr options are also specified.  -direct is the default
	  behavior under normal circumstances (but see the description of the
	  ARRAYD_FORWARD variable, below).  Specifying -direct is equivalent
	  to turning off the Forward requests via local server option in the
	  Server Information dialog.

     -demo
	  Start ArrayView in "demo mode".  This causes the actions in Action
	  menu to be displayed in a dialog box, but not actually performed.
	  If demo mode has been enabled by default (see X Resources, below),
	  then -nodemo will disable it.

     -forward	(or -F)
	  Indicates that array services requests destined for remote servers
	  should be forwarded to those servers via the local array services
	  daemon, rather than being sent directly to them.  This is useful
	  when array services authentication is in use.	 -forward is the

									Page 3

aview(1)							      aview(1)

	  default unless the value of the ARRAYD_FORWARD environment variable
	  begins with the letter "N" (as in "no"; it may be in either upper or
	  lower case).

     -Kl key
	  Use key for the local authentication key when communicating directly
	  with a remote array services daemon.	key is an unsigned 64-bit
	  value.  The default local key is obtained from the environment
	  variable ARRAYD_LOCALKEY; if that does not exist, no key is used.
	  The actual role played by key depends on the authentication method
	  used by array services in a particular configuration.	 In general,
	  it is not used when communicating with an array services daemon on
	  the local machine.

     -Kr key
	  Use key for the remote authentication key when communicating
	  directly with a remote array services daemon.	 key is an unsigned
	  64-bit value.	 The default remote key is obtained from the
	  environment variable ARRAYD_REMOTEKEY; if that does not exist, no
	  key is used.	The actual role played by key depends on the
	  authentication method used by array services in a particular
	  configuration.  In general, it is not used when communicating with
	  an array services daemon on the local machine.

     -mode view
	  Starts ArrayView in view view, which may be "cpuhogs", "processes"
	  or "users" (case is not significant).

     -pause #secs
	  Specifies the Pause between samples interval (see "Refresh
	  Settings").

     -port port	  (or -p port)
	  Specifies the port address of the array services daemon.  Defaults
	  to the value of the "ARRAYD_PORT" environment variable if present,
	  or the standard port number of the "sgi-arrayd" service otherwise.

     -refresh #secs
	  Specifies the Screen refresh interval (see "Refresh Settings").

     -sample #secs
	  Specifies the Collection sample length interval (see "Refresh
	  Settings").  -server server Specifies the hostname or IP address of
	  the array services daemon.  Defaults to the value of the "ARRAYD"
	  environment variable if present, or "localhost" otherwise.

     -skip0
	  Indicates that any process belong to array session 0 (typically
	  system processes) should be omitted from the display.	 If this
	  option has been enabled by default (see "X Resources"), it can be
	  disabled with -noskip0.

									Page 4

aview(1)							      aview(1)

X RESOURCES
     Many of the options that can be set in dialog boxes or from the command
     line can also be set with X resources.  The class name for ArrayView is
     Aview.  Valid resources include:

     autoRefresh (boolean, default TRUE)
	       Specifies the initial setting of the Auto refresh option.

     demoMode (boolean, default FALSE)
	       Specifies the default setting of demo mode.

     forwardRequests (boolean)
	       Specifies a default setting for the Forward requests via local
	       server option.  If this resource is not specified, a default
	       setting is obtained from the environment variable
	       ARRAYD_FORWARD.

     freezeOnSelect (boolean, default TRUE)
	       Specifies the default setting of the Freeze on select option.

     localKey (string)
	       Specifies a default local authentication key.  If this resource
	       is not specified, a default key is obtained from the
	       environment variable ARRAYD_LOCALKEY.

     pauseInterval (integer)
	       Specifies the default Pause between samples interval.

     port (integer)
	       Specifies the default IP port number for the array services
	       daemon.	If this resource is not specified, a default port
	       number is obtained from the environment variable ARRAYD_PORT,
	       or the "sgi-arrayd" service.

     refreshInterval (integer)
	       Specifies the default Screen refresh interval.

     refreshOnThaw (boolean, default TRUE)
	       Specifies the default setting of the Refresh on thaw option.

     remoteKey (string)
	       Specifies a default remote authentication key.  If this
	       resource is not specified, a default key is obtained from the
	       environment variable ARRAYD_REMOTEKEY.

     sampleInterval (integer)
	       Specifies the default Collection sample length interval.

     server (string)
	       Specifies the default hostname for the array services daemon to
	       be used for most array services requests.  If this resource is
	       not specified, a default hostname is obtained from the

									Page 5

aview(1)							      aview(1)

	       environment variable ARRAYD.

     skipASHZero (boolean, default TRUE)
	       If true, indicates that any process belong to array session 0
	       (typically system processes) should be omitted from the
	       display.

     viewMode (string)
	       Specifies the default view mode.	 See the -mode command line
	       option for valid values.

NOTES
     The array services daemon (arrayd(1M)) should be running on all machines
     that are to be monitored.	It does not necessarily have to be running on
     the machine that executes ArrayView if an alternate server was specified
     in some way.

SEE ALSO
     arrayd(1M), mpiview(1), arrayd.conf(4).

									Page 6

[top]

List of man pages available for IRIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net