HP 3000 Manuals

HP SPT/XL User's Manual: Collection Software

Collection Options 

The collection options allow you to control various aspects of monitoring
a program.

> Select the  Show Options function key to see a list of the current
option values.  You can also use the SHOW command.  Type SHOW at the
Program to Monitor prompt.


          Figure 1-5.  Collection Menu With Options 

The options are defined as follows:

LOGNAME -- With this option you can specify the name of the file in which
collected data will be stored (for example:  TESTLOG). The default is
SPTLOG in the group and account where you are logged on.

TRACEDATASIZE -- This option allows you to control the maximum amount of
data collected.  The value is specified in megabytes.  The default is
2000 (2 gigabytes).

For example, if TRACEDATASIZE is set to two, collection would terminate
after two megabytes of data were collected.

This option does not control the maximum size of the file because
additional space is needed in the logfile when the data is analyzed.
Therefore there is no correlation between this value and the end-of-file
of the logfile.

SYSPROCNAMES -- This option also allows you to control the amount of disk
space indirectly consumed by the logfile (either ON or OFF). This is done
by specifying whether procedure names associated with the system
libraries are to be logged or not.  If the option is set to ON then the
system procedure names will be logged.  The actual amount of disk space
required if this option is activated is variable but can be measured in
megabytes.  You can save disk space by disabling SYSPROCNAMES (set it to
OFF). The default is OFF.

The reason for enabling this option is to provide the ability to get a
sampling profile of system code during the analysis phase.  For example:
if you install part of your application in XL.PUB.SYS the only way to see
a code file sample profile of your procedures is with this option
enabled.

LOGDESC -- This option allows you to enter a description of the logfile.
For example, you might enter a description of the purpose of the
collection.  The description is displayed during the analysis step.  The
default is no description.

TIME -- This option allows you to specify how long to monitor the
program, in minutes (for example:  5).  You can specify for the program
to be monitored until it terminates by setting this option to @ which is
the default value for this option.

> Select the  Set Options function key to modify an option:

You'll be prompted for an option name followed by a prompt for the new
option value.  The current option value is shown in parentheses ( ).  The
new option values will be displayed after you've completed your changes.

You can also use the SET command to set options.  At the Program to
Monitor prompt enter the SET command and the option name followed by the
option value (for example, SET LOGNAME TESTLOG).

MPE/iX 5.0 Documentation