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 31.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 31.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 31.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 31.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 31.4 SOSLOGX data export command keys
Key(s)
Command
c
Compile the report
R
Export Performance Gallery Gold data

Other Commands

Table 31.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 31.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. Each screen is described briefly in Table 31.6. The reports are described in detail in "SOSLOGX Reports".

NOTE All command keys are case-sensitive.

Table 31.6 SOSLOGX Report Format Selection Menu command keys
Key
Report Format
Description
1
CPU Summary Chart
Reports the general state of one or more CPUs. For more information, see "SOSLOGX CPU Summary Chart".
2
Global Summary
Contains a basic, overall picture of your system’s performance. For more information, see "SOSLOGX Global Summary".
3
Memory Summary Chart
Displays memory performance data in graphical format. For more information, see "SOSLOGX Memory Summary Chart".
4
Memory Summary
Provides a detailed look at memory performance data in tabular format. For more information, "SOSLOGX Memory Summary".
5
Disk Summary
Contains a table of performance data for all disks on the system. For more information, see "SOSLOGX Disk Summary".
6
Disk Summary Chart
Displays a summary of disk activities in graphical format. For more information, see "SOSLOGX Disk Summary Chart".
7
Network Summary
Displays network performance information, including protocol data and network interface information. For more information, see "SOSLOGX Network Summary".
8
Net If Summary
Contains information about the network interface. For more information, see "SOSLOGX Net If (Network Interface) Summary".
9
NFS Client Summary
Provides information about the Network File System (NFS). For more information, see "SOSLOGX NFS Client Summary".
10
Workload Summary
Provides general workload information. For more information, see "SOSLOGX Workload Summary".
11
Workload Detail (INTERACT)
Provides detailed information about the INTERACT workload. For more information, see "SOSLOGX Workload Detail".
12
Response Time Chart
Displays system response times in graphical format. For more information, see "SOSLOGX Response Time Chart".
13
FS Space Summary
Contains general information about the block and fragment size, space usage, and inode usage for each file system. For more information, see "SOSLOGX FS Space Summary".
14
DNLC Summary
Reports statistics regarding file name lookups satisfied in the dynamic name lookup cache (DNLC). For more information, see "SOSLOGX DNLC Summary".
15
System Configuration
Shows the current system configuration parameters. For more information, see "SOSLOGX System Configuration".

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 31.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 31.4 SOSLOGX Data break configuration submenu
    The Data break configuration options are listed and described in the next table.
    Table 31.7 SOSLOGX Data break configuration options
    Option
    Default
    Description
    Force data break at end of logfile
    N
    By default, the boundary between data files is transparent, or "invisible", to the user. To force a break between data files 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 31.5).


    Figure 31.5 SOSLOGX Log information exclusions submenu
    The Log information exclusions options are listed and described in the next table.
    Table 31.8 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 31.6 SOSLOGX Export file configuration submenu
    The Export file configuration options are listed and described in the next table.
    Table 31.9 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 hour
    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).
    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 31.7 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 31.8 SOSLOGX Export Data configuration submenu
    The Export Data configuration options are listed and described in the next table.
    Table 31.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 (No).
    DNLC Cache Data
    Y
    By default, DNLC (dynamic name lookup cache) will be exported. To eliminate this data from the export file, enter N (No).
    Inode Cache Data
    Y
    By default, inode cache data will be exported. To eliminate this data from the export file, enter N (No).
    VM Data
    Y
    By default, VM (virtual memory) data will be exported. To eliminate this data from the export file, enter N (No).
    Misc Data
    Y
    By default, miscellaneous data will be exported. To eliminate this data from the export file, enter N (No).
    Disk Data
    Y
    By default, disk data will be exported. To eliminate this data from the export file, enter N (No).
    Network Protocol Data
    Y
    By default, network protocol data will be exported. To eliminate this data from the export file, enter N (No).
    Network Interface Data
    Y
    By default, network interface data will be exported. To eliminate this data from the export file, enter N (No).
    NFS Data
    Y
    By default, NFS (network file system) will be exported. To eliminate this data from the export file, enter N (No).
    NFS Global Data
    Y
    By default, global (system-wide) NFS data will be exported. To eliminate this data from the export file, enter N (No).
    RPC Data
    Y
    By default, RPC (remote procedure call) data will be exported. To eliminate this data from the export file, enter N (No).
    Workload Data
    Y
    By default, workload data will be exported. To eliminate this data from the export file, enter N (No).
    Process Data
    N
    By default, process data will be exported. To eliminate this data from the export file, enter N (No).
    Swap Data
    N
    By default, swap data will be exported. To eliminate this data from the export file, enter N (No).
    File Systems Space Data
    N
    By default, file systems space data will be exported. To eliminate this data from the export file, enter N (No).
    Export Thresholds configuration Submenu
    To display the Export Thresholds configuration submenu, type the corresponding command key from the SOSLOGX Performance Gallery configuration submenu.


    Figure 31.9 SOSLOGX Export Thresholds configuration submenu
    The Export Thresholds configuration options are listed in Table 31.11. Their meanings are self- explanatory.
    Table 31.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

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