TOCPREVNEXTINDEX

Lund Performance Solutions


SOSLOGX Menus and Options

The SOSLOGX Main Commands Screen

The MAIN COMMANDS screen in soslogx contains a list of single-key shortcut commands that can be invoked from any soslogx display screen.
To display the MAIN COMMANDS menu, type ? from any soslogx screen.




Figure 45.1 SOSLOGX MAIN COMMANDS screen
Each command is described in the next section of this chapter.

Main Commands

The Curses library enables SOS Performance Advisor to run with non-HP terminals. Host systems using non-HP terminals will not have function keys available to them, therefore, the soslogx key commands have been modified to be more intuitive. However, because the function keys could be removed from the application altogether in the future, use of the command keys is recommended.

Navigation Commands

Table 45.1 SOSLOGX navigation command keys
Key(s)
Command
+
Scroll ahead
-
Scroll back
<
Skip backward
>
Skip forward
s
Display the report selection menu
t
Select the time prompt

Logfile Commands

Table 45.2 SOSLOGX logfile command keys
Key(s)
Command
i
Display the file index
l
Display the logfile list
p
Print the report
r
Reload the report definitions
u
Update the report

Configuration Commands

Table 45.3 SOSLOGX configuration command keys
Key(s)
Command
d
Toggle the process display
o
Display the Options menu
y
Toggle the extended process display

Data Export Commands

Table 45.4 SOSLOGX data export command keys
Key(s)
Command
c
Compile the report
R
Export Performance Gallery Gold data

Other Commands

Table 45.5 SOSLOGX other command keys
Key(s)
Command
?
Display the Main Commands screen
Ctrl+l
Refresh the screen
e
Exit the program
m
Cycle through the function keys

The SOSLOGX Report Format Selection Menu

The Report Format Selection Menu contains a list of system performance data reports that can be compiled by soslogx.
To display the Report Format Selection Menu, type a lowercase s from any soslogx screen.




Figure 45.2 SOSLOGX Report Format Selection Menu screen
To view one of the reports listed in the Report Format Selection Menu, type the report’s corresponding command key at the command prompt. The reports are described in detail in "SOSLOGX Reports".


 
NOTE All command keys are case-sensitive.


The SOSLOGX Main Option Menu

The SOSLOGX MAIN OPTION MENU screen contains a set (and several subsets) of options that enable the user to configure the soslogx program.
To access the SOSLOGX MAIN OPTION MENU, type o from any soslogx screen.




Figure 45.3 SOSLOGX MAIN OPTION MENU

Main Options

To enable an option:
  • Type the option command key from the SOSLOGX MAIN OPTION MENU and press the Enter key.
  • Enter a new parameter at the secondary command prompt. Press Enter.
  • Press Enter again to exit the SOSLOGX MAIN OPTION MENU.
  • At the Should these options be saved permanently? prompt:
  • Press the Enter key to return to the soslogx program without saving the options permanently.
  • Type Y (Yes) to save the changes permanently and then press the Enter key.
  • Information about each option is described to assist you.


     
    NOTE All command keys are case-sensitive.


    Current log file location
    The current location of the SL log file is shown in parentheses. To load a different log file:
  • From the SOSLOGX MAIN OPTION MENU, type the command key for the Current file location option. Press the Enter key.
  • At the secondary prompt, type the location of the new SL file. Press the Enter key.
  • Company name
    By default, the company name is not included in the soslogx reports. To add the name of your company or another brief headline for your soslogx reports:
  • From the SOSLOGX MAIN OPTION MENU, type the command key for the Company name option. Press the Enter key.
  • At the secondary prompt, type a company name, system name, or another headline (up to 43 alpha-numeric characters). Press the Enter key.
  • The headline is inserted into the banner line of the soslogx report.
    Use function keys to select reports
    The function keys, when available, are displayed in the bottom portion of the soslogx screens. By default, they are not used to select soslogx reports. To enable/disable the function keys to select reports:
  • From the SOSLOGX MAIN OPTION MENU, type the command key for the Use function keys to select reports option. Press the Enter key.
  • At the secondary prompt, type Y (Yes) to enable the option, or N (No) to disable the option. Press Enter.
  • Maximum lines per report page
    By default, soslogx reports contain up to 60 lines of information per page. To increase or decrease the maximum threshold:
  • From the SOSLOGX MAIN OPTION MENU, type the command key for the Maximum lines per report page option. Press the Enter key.
  • At the secondary prompt, type a new maximum threshold. Press Enter.
  • Display process information
    To include/exclude PROCESS STATISTICS in the Global Summary report:
  • From the SOSLOGX MAIN OPTION MENU, type the command key for the Display process information option. Press the Enter key.
  • At the secondary prompt, type Y (Yes) to enable the option, or N (No) to disable the option. Press Enter.
  • Display extended process line
    To include/exclude PROCESS STATISTICS in the Global Summary report:
  • From the SOSLOGX MAIN OPTION MENU, type the command key for the Display process information option. Press the Enter key.
  • At the secondary prompt, type Y (Yes) to enable the option, or N (No) to disable the option. Press Enter.
  • Data break configuration (SUBMENU)
    The Data break configuration submenu lists options that average the data into larger units of time, so the system performance is shown for a day, a week, or a month.
    To view the Data break configuration submenu, type the command key for the data break configuration option. Press the Enter key.




    Figure 45.4 SOSLOGX Data break configuration submenu
    The Data break configuration options are listed and described in the next table.
    Table 45.6 SOSLOGX Data break configuration options
    Option
    Default
    Description
    Force data break at end of logfile
    N
    By default, the boundary between datafiles is transparent, or "invisible", to the user. To force a break between datafiles on the report screen, enter Y (Yes).
    Force data break at end of day
    Y
    By default, there is a break after the last data record for each day. To remove this break, enter N (No).
    Log information exclusions (SUBMENU)
    The Log information exclusions submenu contains options that can be set to exclude specific day and time ranges from the data display. The excluded data will not actually be removed from the SL file, but it will not appear in the soslogx reports.
    The Log information exclusions options enable the user to exclude performance data collected during days or periods of low and or unusual activity that could skew analysis of the system’s general performance.


     
    NOTE Do not exclude log information when preparing data for export to the Performance Gallery Gold application. Ensure the default settings are enabled.


    To view the Log information exclusions submenu, type the command key for the Log information exclusions option from the SOSLOGX MAIN OPTION MENU (see Figure 45.5).




    Figure 45.5 SOSLOGX Log information exclusions submenu
    The Log information exclusions options are listed and described in the next table.
    Table 45.7 SOSLOGX Log information exclusion options
    Option
    Default
    Description
    Exclusions enabled
    N
    By default, exclusions are disabled. To set and enable one or more exclusions, type Y (Yes) and press Enter—the subsequent options will be activated.
    Exclude holidays
    N
    To exclude holidays (as defined in the holidays.dat file), type Y (Yes) and press Enter. For information about the holiday.dat file, see "SOS holidays File".
    Exclude day range
    0=None
    To exclude a range of days, type the corresponding number of the first day in the range of days. For example:
    0=None (exclude no days)
    1=Sunday
    2=Monday
    3=Tuesday
    4=Wednesday
    5=Thursday
    6=Friday
    7=Saturday
    to
    0=None
    Type the corresponding number of the last day in the excluded day range.
    Exclude time range
    00:00
    To exclude a specific range of time, type the start of this range in hours and minutes (hh:mm).
    to
    00:00
    Type the end of the excluded time range (hh:mm).
    Additional time ranges can be excluded. The progression of options allows up to four different time ranges to be excluded from each day or day range. For example, to report data for normal business hours only (Monday through Friday, 8:00 AM to 5:00 PM, no holidays), you would exclude data from weekends, holidays, the early morning hours, and the night-time hours.
    Export file configuration menu (SUBMENU)
    The options in the Export file configuration submenu will format the file that receives the logged data to be exported to a third-party application for analysis. The purpose of these options is to make the file format compatible with the import functions of popular spreadsheet, database, and graphics applications.


     
    NOTE Do not employ these options when preparing data for export to the Performance Gallery Gold application. Ensure the default settings are enabled.


    To view the Export file configuration submenu, type the command key for the Export file configuration menu option from the SOSLOGX MAIN OPTION MENU.




    Figure 45.6 SOSLOGX Export file configuration submenu
    The Export file configuration options are listed and described in the next table.
    Table 45.8 SOSLOGX Export file configuration options
    Option
    Default
    Description
    Generate item label heading line
    Y
    The item label heading line is provided by default. To eliminate the heading line, choose N (No).
    Enclose item labels in quotes
    Y
    The data item labels are enclosed in quotation marks (" "). To eliminate the quotation marks, choose N (No).
    Include log date in data line
    N
    To include the log date in the data line, enter Y (Yes). The two subsequent options will be activated.
    Date format option
    1-mm/dd/yy
    To change the format of the log date, enter the corresponding number:
    1=mm/dd/yy
    2=mmddyy
    3=dd mmm yy
    4=dd.mm.yy
    Enclose date in quotes
    Y
    The log date will be enclosed in quotation marks, by default. To remove the quotation marks, enter N (No).
    Include log time in data line
    Y
    The log time will be included in the data line. To eliminate this information from the data line, enter N (No).
    Time format option
    1=24 hr
    The time format options are:
    1=24 hr
    2=AM/PM
    Enclose time in quotes
    Y
    The log time will be enclosed in quotation marks, by default. To remove the quotation marks, enter N (No).
    Separate items with commas
    Y
    By default, the data items in the export file are comma-delimited. To send the data without commas, enter N (No).
    Forecast data reduction configuration (SUBMENU)
    If you are licensed to use Forecast Capacity Planner, the Forecast data reduction configuration option is available from the SOSLOGX MAIN OPTION MENU. Use this menu to set parameters for the Forecast export file.




    Figure 45.7 SOSLOGX Forecast data reduction configuration submenu
    Each Forecast data reduction parameter is described in the next table.
    Table 45.9
    Option
    Default
    Description
    Workload analysis period minimum time
    10
    Enter the minimum workload analysis period in minutes. These are periods when a specific workload is the primary if not only active workload that are used
    to calibrate workload physical disc I/O and overhead CPU utilization.
    Workload analysis period decay percentage
    95
    Enter a decay percentage to be used to determine the workload analysis period.
    These are periods when a specific workload is the primary if not only active workload that are used to calibrate workload physical disc I/O and CPU overhead utilization. The decay percentage is a measure of how far the workload's percentage of total logical disc I/O requests must decay from it's maximum value before marking the boundaries of the analysis period.
    Workload analysis start buffer time
    10
    Buffer time in minutes which must be retained between the time a workload activity starts up and the beginning of the workload analysis period. This time buffer protects the workload calibration process from atypical workload demands involved in starting up the workload application.
    Workload analysis end buffer time
    10
    Buffer time in minutes which must be retained between the end of a workload analysis period and the time all activity in that workload ceases. This time buffer protects the workload calibration process from atypical workload demands involved in shutting down the workload application.
    Load sample analysis period minimum time
    60
    Enter the minimum sample load analysis period in minutes. These are periods of high system load that will be used to define the a computer model representing the current system load.
    Load sample analysis period decay percentage
    95
    Enter a decay percentage to be used to determine the sample load analysis period. These are periods of high system load that will be used to define the a computer model representing the current system load. The decay percentage is a measure of how far the CPU utilization must decay from its maximum value before marking the boundaries of the analysis period.
    Suspicious delay time warning threshold percentage
    30
    If a workload spends a significant percentage of time waiting for resources other than disc I/O or the CPU, it may not be possible to forecast the effects of changes on it. Enter a percentage of "suspicious" delay time to allow without giving a warning message.
    Memory wait warning threshold percentage
    30
    If a workload spends a significant percentage of time waiting for resources other than disc I/O or the CPU, it may not be possible to forecast the effects of changes on it. Enter a percentage of "suspicious" delay time to allow without giving a warning message.
    SOSLOGX Forecast data reduction configuration options
    Performance Gallery configuration (SUBMENU)
    To view the Performance Gallery configuration submenu, type the command key for the Performance Gallery configuration option from the SOSLOGX MAIN OPTION MENU.




    Figure 45.8 SOSLOGX Performance Gallery configuration submenu
    From the Performance Gallery configuration submenu, you can access the following configuration menus:
  • Export Data configuration submenu (see "Export Data configuration Submenu").
  • Export Thresholds configuration submenu (see "Export Thresholds configuration Submenu").
  • Export Data configuration Submenu
    To display the Export Data configuration submenu, type the corresponding command key from the SOSLOGX Performance Gallery configuration submenu.




    Figure 45.9 SOSLOGX Export Data configuration submenu
    The Export Data configuration options are listed and described in the next table.
    Table 45.10 SOSLOGX Export Data configuration options
    Option
    Default
    Description
    CPU Data
    Y
    By default, any CPU data in the collection will be exported. To eliminate CPU data from the export file, enter N (No).
    Buffer Cache Data
    Y
    By default, buffer cache data will be exported. To eliminate this data from the export file, enter N.
    VM Data
    Y
    By default, VM (virtual memory) data will be exported. To eliminate this data from the export file, enter N.
    Misc Data
    Y
    By default, miscellaneous data will be exported. To eliminate this data from the export file, enter N.
    Disk Data
    Y
    By default, disk data will be exported. To eliminate this data from the export file, enter N.
    Network Protocol Data
    Y
    By default, network protocol data will be exported. To eliminate this data from the export file, enter N.
    Network Interface Data
    Y
    By default, network interface data will be exported. To eliminate this data from the export file, enter N.
    NFS Data
    N
    By default, NFS (network file system) will not be exported. To include this data in the export file, enter Y (Yes).
    Workload Data
    Y
    By default, workload data will be exported. To eliminate this data from the export file, enter N.
    Process Data
    N
    By default, process data will not be exported. To include this data from the export file, enter Y.
    Swap Data
    N
    By default, swap data will not be exported. To include this data in the export file, enter Y.
    File Systems Space Data
    N
    By default, file systems space data will not be exported. To include this data in the export file, enter Y.
    Volume Data
    N
    By default, volume data will not be exported. To include this data in the export file, enter Y.
    Export Thresholds configuration Submenu
    To display the Export Thresholds configuration submenu, type the corresponding command key from the SOSLOGX Performance Gallery configuration submenu.




    Figure 45.10 SOSLOGX Export Thresholds configuration submenu
    The meanings of the Export Thresholds configuration options are self-explanatory.
    Table 45.11 SOSLOGX Export Thresholds configuration options
    Option
    Default Setting
    Max number of Discs Exported
    100
    Max number of Network Ifs (interfaces) Exported
    10
    Max Number of NFS Systems Exported
    50
    Max Number of Workloads Exported
    50
    Max Number of Processes Exported
    20
    Max Number of Swaps Exported
    20
    Max Number of File System Space Exported
    100
    Max Number of Volumes Exported
    100
    Performance Gallery File Size Limit
    10,000

    Lund Performance Solutions
    www.lund.com
    Voice: (541) 812-7600
    Fax: (541) 81207611
    info@lund.com
    TOCPREVNEXTINDEX