NonStop SPAM User Guide

NonStop SPAM – Version 1.2 – T0814
Page 42 of 44
Use this parameter to specify the time of day, in 24-hour clock format (HH:MM), at which the first
timeline interval is to begin. This time of day is assumed to be on the day on which the measurement
was started.
NOTE: Values range from 00:00 to 23:59; the default value is 00:00, which causes these reports to align
the first interval with the start of the report window.
Example: BEGIN 13:30, INTERVAL 5
 EXCLUDE <activity exclusion threshold>
Several charts and reports exclude "low-activity" entities from their output, in order to minimize the
amount of data presented; this parameter lets the user set the exclusion threshold. The "unit of
measure" varies from report to report, but it is typically a percentage utilization (e.g. Cpu Busy), a
percentage of some global total (e.g. of total logical disc file I/O's), or a rate of events per second (e.g.
logical I/O's per second). Reports exclude entities whose activity is below (less than) the threshold. Each
report shows its EXCLUDE value and "unit of measure" at the bottom of every page.
NOTE: Values range from 0.00 to 99.99; the default is 0.1.
Example: EXCLUDE 0.01
 FILE <partial name>
At some stage during review the user may want to examine the activity against a particular file, or set of
files. Some reports (e.g. "Logical File Open(er)s") lets the user do this. They require that a <partial name>
of the file(s) in which the user is interested; be specified. This <partial name> is any contiguous string of
8 characters (possibly including spaces) that can occur anywhere within the fully-qualified file name; if
less than 8 characters is specified, the <partial name> is padded to the right with spaces.
NOTE: The default is spaces, equivalent to all files.
Examples: FILE $prod1 (same as "$PROD1") FILE "PRODDB"
 FLAG <transient duration percentage>
Some reports flag "transient" entities with an asterisk. Examples of transient entities include: processes
that lived for less than the report "window", and files that were open for less than the opening process's
life. This parameter allows the user to specify the percentage of the window or life for which the entity
must have existed before it is considered “transient” the entity is flagged if it lived for less than this
percentage of the window or opening process's life.
NOTE: Values range from 1 to 99 percent; the default value is 90 percent.
Example: FLAG 95