3dmon Command

The 3dmon program is an X Window System based program that displays statistics in a 3-dimensional graph where each of the two sides may have up to 24 statistics for a maximum of 576 statistics plotted in a single graph.

To avoid clashes with X Window System command line options, never leave a blank between a command line option and its argument. For example, do not specify

3dmon -i 1 -p 75 -n

Instead, use:

3dmon -i1 -p75 -n

Syntax

The 3dmon program takes the following command line arguments, all of which are optional:

3dmon [-vng] [-f config_file] [-i seconds_interval] [-h hostname] [-w weight_percent] [-s spacing] [-p filter_percent] [-c config] [-a "wildcard_match_list"] [-tresync_timeout] [-d invitation_delay] [-l left_side_tile] [-r right_side_tile] [-m top_tile]

Flags

v

Verbose. Causes the program to display warning messages about potential errors in the configuration file to stderr. Also causes 3dmon to print a line for each statset created and for each statistic added to the statset, including the results of resynchronizing.

n

Only has an effect if a filter percentage is specified with the -p argument. When specified, draws only a simple outline of the grid rectangles for statistics with values that are filtered out. If not specified, a full rectangle is outlined and the numerical value is displayed in the rectangle.

g

Normally, 3dmon will attempt to resynchronize for each statset it doesn't receive data-feeds for for resync-timeout seconds. If more than half of the statsets for any host are found to not supply data-feeds, resynchronizing is attempted for all the statsets of that host. By specifying the -g option, you can force resynchronization of all the statsets of a host if any one of them becomes inactive.

f

Allows you to specify a configuration file name other than the default. If not specified, 3dmon looks for the file $HOME/3dmon.cf . If that file does not exist the file is searched for as described in "Overview of File Placement".

i

Sampling interval. If specified, this argument is taken as the number of seconds between sampling of the statistics. If omitted, the sampling interval is 5 seconds. You can specify from 1 to 60 seconds sampling interval.

h

Used to specify which host to monitor. This argument is ignored if the specified wildcard is "hosts." If omitted, the local host is assumed.

Note: With the Performance Toolbox Local feature of Version 2.2 or later, this flag always uses the local host name.

w

Modifies the default weight percentage used to calculate a weighted average of statistics values before plotting them. The default value for the weight is 50%, meaning that the value plotted for statistics is composed of 50 percent of the previously plotted value for the same statistic and 50 percent of the latest observation. The percentage specified is taken as the percentage of the previous value to use. For example, if you specify 40 with this argument the value plotted is:

.4 * previous + (1 - .4) * latest

Weight can be specified as any percentage from 0 to 100.

s

Spacing (in pixels) between the pillars representing statistics. The default space is 4 pixels. You can specify from 0 to 20 pixels.

p

Filtering percentage, -p. If specified, only statistics with current values of at least -p percent of the expected maximum value for the statistic are drawn. The idea is to allow you to specify monitoring "by exception" so statistics that are approaching a limit stand out while others are not drawn. Filtering can be specified as any percentage from 0 to 100. Default is 0%.

c

Configuration set. When specified, overrides the default configuration set and causes 3dmon to configure its graph using the named configuration set. The argument specified after the -c must match one of the wildcard stanzas in the configuration file. If this argument is omitted, the configuration set used is the first one defined in the configuration file.

a

Wildcard match list. When specified, is assumed to be a list of host names. If the primary wildcard in the selected configuration set is hosts, then the list to display host names is suppressed as 3dmon automatically selects the supplied hosts from the list of active remote hosts. Depending on the configuration set definition, 3dmon then either goes directly on with displaying the monitoring screen or, when additional wildcards are present, displays the secondary selection list.

Note: With the Performance Toolbox Local feature of Version 2.2 or later, this flag always uses the local host name.

The list of host names must be enclosed in double quotes if it contains more than one host name. Individual host names must be separated by white space or commas.

The primary purpose of this option is to allow the invocation of 3dmon from other programs. For example, you could customize NetView to invoke 3dmon with a list of host names, corresponding to hosts selected in a NetView window.

t

Resynchronizing timeout. When specified, overrides the default time between checks for whether resynchronizing is required. The default is 30 seconds; any specified timeout value must be at least 30 seconds.

d

Invitation delay. Allows you to control the time 3dmon waits for remote hosts to respond to an invitation. The value must be given in seconds and defaults to 10 seconds. Use this flag if the default value results in the list of hosts being incomplete when you want to monitor remote hosts.

l

(Lowercase L). Specifies the number of the tile to use when painting the left side of the pillars. Specify a value in the range 0 to 8. The values correspond to the tile names:

• 0: foreground (100% foreground)
• 1: 75_foreground (75% foreground)
• 2: 50_foreground (50% foreground)
• 3: 25_foreground (25% foreground)
• 4: background (100% background)
• 5: vertical
• 6: horizontal
• 7: slant_right
• 8: slant_left

  The default tile number for the left side is 1 (75_foreground).

r

Specifies the number of the tile to use when painting the right side of the pillars. Specify a value in the range 0 to 8. The values correspond to the tile names specified above for option -l. The default tile number for the right side is 8 (slant_left).

m

Specifies the number of the tile to use when painting the top of the pillars. Specify a value in the range 0 to 8. The values correspond to the tile names specified above for option -l. The default tile number for the top is 0 (foreground).

Hardware Dependencies

On some graphics adapters in certain configurations, the 3dmon program might not give you proper tiling. If you notice this, use the following command line arguments to suppress tiling:

3dmon -l0 -r0 -m0

Use the flags shown in addition to any other flags you may require. You can substitute the digit 4 for any of the zeroes shown above. The digit 0 means to paint the pillar in the foreground color; the digit 4 means to paint it in the backgound color.