TOCPREVNEXTINDEX

Lund Performance Solutions


SOSLOGX Menus and Options

The SOSLOGX Main Screen Function Keys

The function keys, the search keys and the utility keys under the Log Trends function are described in the next tables.

Table 26.1 SOSLOGX Main Screen function keys

Key
Description
F1 - OPTIONS
Displays the SOSLOGX Main Option Menu.
F2 - PRINT REPORT
Prints selected dates and times for the displayed report to the line printer.
F3 - EXPORT REPORT
Exports data from selected dates and times to ASCII files.
F5 - UTILITY KEYS
Displays various utility keys (discussed in Table 26.2).
F6 - REPORT KEYS
Displays a menu of available reports.
F7 - SEARCH KEYS
Displays search keys (discussed in Table 26.3)
F8 - MAIN SCREEN
Returns to SOS/3000 main screen.



Table 26.2 UTILITY KEYS
Utility Key
Description
F1 - MPE/iX COMMAND
Allows you to execute commands via an MPE command interface.
F2 - CREATE REPORTS
Executes the editor of your choice, configured in the SOSEDIT.PUB.LPS file.
F5 - FORECAST ANALYSIS
Creates a data file for user with Forecast Capacity Planner. See the Forecast Capacity Planner quick start tutorial.
F6 - REPORT CARD
F7 - PERFORM GALLERY
Creates a data file for user with Performance Gallery Gold. See the Performance Gallery Gold manual.
F8 - MAIN KEYS
Returns to the Log Trends main function keys.
Table 26.3 SEARCH KEYS
Search Key
Description
F1 - SCROLL AHEAD
Displays the next page of data.
F2 - SCROLL BACK
Displays the previous page of data.
F3 - SKIP AHEAD
Produces a prompt for the number of samples to skip. After entering a valid number, that number of samples will be bypassed in a forward direction. The data displayed will be from that point forward.
F4 - SKIP BACK
Performs like the SKIP AHEAD. When a valid number is entered, that number of samples will be skipped backward. The data displayed will then be from that point.
F5 - SELECT TIME
Prompts for a time at which you want to begin examining data.
F6 - LIST LOGFILES
Displays all available SOS/3000 log files in the currently selected group and account.
F7 - REPORT KEYS
Displays the Report Selection menu.
F8 - MAIN KEYS
Returns to the main Log Trends (SOSLOGX) keys.

The SOSLOGX Report Format Selection Menu

A report is defined as a screen display format. It is also used to determine data for exportation, printing and graphing. There are a variety of reports available within the Log Trends function. There are two main types of reports: a Standard report and an Export report. The Standard report is used to perform regular reporting. It includes headings, text and data. The Export report is used to extract logged data into an ASCII format for exportation. The format of the Export report output is configurable via the SOSLOGX Main Options. In either case, the reports are used to present data on a terminal display. You can create your own report formats (see "Creating Custom Reports").
Reports are selected from the reports menu and are available via the REPORT KEYS. The Reports menu is similar to Figure 26.1.


Figure 26.1 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".

The SOSLOGX Main Option Menu

By pressing the OPTIONS function key you can alter various characteristics of the program and data. These options will allow you to tailor past performance data to your specifications. If you want to perform averaging, you can manipulate export data characteristics or date and time exclusions to do so.


Figure 26.2 SOSLOGX Main Option menu

Main Options

To enable an option:
  • Type the option command key from the SOSLOGX Main Option menu and press Enter.
  • 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 Enter 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.
    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 (option 1) for the Current log file location option. Press Enter.
  • At the secondary prompt, select the group and account in which the desired log file will reside by entering: GROUP.ACCOUNT. Press the Enter key.
  • Normal MPE security applies here. To remove a location, enter a caret ("^") or a blank.
    Display Process Information
    This option allows you to display processes that were logged via SOS/3000 batch collection. See "Using SOS/3000 in a Batch Job", to find how to enable batch collection. If you indicate to SOS/ 3000 that you want processes to be logged, those qualifying processes will appear at each time interval just under the current global data sample on the screen.
    To include/exclude Process Information in the global report:
  • From the SOSLOGX Main Option menu, type 2 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.
  • 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 3 for the Use function keys to select reports option. Press Enter.
  • At the secondary prompt, type Y (Yes) to enable the option, or N (No) to disable the option. Press Enter.
  • Process display option menu (SUBMENU)
    This option is only available if option 2 - Display Process Information is set to Y. To view the Process display option submenu, type 4 for the Process display option. Press Enter.
    This option will display the following submenu:


    Figure 26.3 SOSLOGX Process display option submenu
    The Process display options are listed and described in the next table.
    Table 26.4 SOSLOGX Process display options
    Option
    Default
    Description
    Display extended process line
    N
    By default, the extended process line is not displayed. To display extended process line, enter Y (Yes).
    Show wait state on first line
    N
    By default, the current wait state is not displayed on the first line of the process information. To show wait state on the first line, enter Y (Yes). The "Display Total I/O instead of Read/Write counts" option will be unavailable if wait states are displayed.
    Display "First" instead of "Prompt" response time
    N
    By default, you can view the Prompt response time of a process. To display First response time, enter Y (Yes).
    Display page faults instead of IO per transaction
    N
    This option is only available if "Display extended process line" is set to Y (Yes).
    By default, the page fault memory statistic is not displayed on the extended process display. In order to display page faults, enter Y (Yes).
    Display total and I/O percentage instead of read/write counts
    N
    By default, SOS/3000 will display the number of logical reads and writes to disc. To display total I/O and the percentage of all I/Os for which the processes are responsible, enter Y (Yes).
    Press Enter after making your selection to return to the SOSLOGX Main Options menu.
    Data break configuration menu (SUBMENU)
    To view the Data break configuration submenu, type 5 for the Data break configuration menu option. Press Enter.
    This option will display the following data break options:


    Figure 26.4 SOSLOGX Data break configuration submenu
    These options combine to provide you with the ability to determine groupings and granularity of data.
    The Data break configuration options are listed and described in Table 26.5.
    Table 26.5 SOSLOGX Data break configuration options
    Option
    Default
    Description
    Duration in minutes of each sample
    0
    This option allows you to report hourly averages of data collected in 10 minutes intervals. To do this, type "60" in this field.
    Number of log records in each sample
    0
    This option allows you to do the same things as the previous one, except it groups by interval instead of by time. The values returned from LOG TRENDS represent averages not time slices.
    Data break time in minutes
    30
    The data break will appear as a separating line between the last interval of the log file and the first interval of the next log file.
    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).
    Press Enter after making your selection to return to the SOSLOGX Main Options menu.
    Export file configuration menu (SUBMENU)
    To view the Export file configuration submenu, type the command key for the Export file configuration menu option from the SOSLOGX Main Option menu (option 6).
    This option will display the following export file configuration options:


    Figure 26.5 SOSLOGX Export file configuration submenu
    These combined items provide an extensive control over the format of data extracted into ASCII files.
    The Export file configuration options are listed and described in the next table.
    Table 26.6 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
    This option is only available if option 3 is set to Y. 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).
    Press Enter after making your selection to return to the SOSLOGX Main Options menu.
    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 Forecast Capacity Planner and Performance Gallery Gold applications. Ensure the default settings are enabled.

    To view the Log information exclusions submenu, type the command key for the Log information exclusions option (option 7) from the SOSLOGX Main Options menu (see Figure 26.6).


    Figure 26.6 SOSLOGX Log information exclusions submenu
    The Log information exclusions options are listed and described in the next table.
    Table 26.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.PUB.LPS file), type Y (Yes) and press Enter. For information about the HOLIDAYS.PUB.LPS file, see "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.

    Press Enter after making your selection to return to the SOSLOGX Main Options menu.
    Zone configuration (SUBMENU)
    One of the abilities provided by Log Trends is the ability to report performance information by zone. To access this submenu, choose option 8 from the SOSLOG Main Options menu. This feature is more thoroughly documented in "Report by zone (option 13)". The following is provided for completeness:


    Figure 26.7 SOSLOGX Zone configuration submenu
    Report card configuration (SUBMENU)
    To view the Report card configuration submenu, type the command key (option 9) for Report card configuration option. Press the Enter key. For detailed information on this submenu, see "SOSLOGX Report Card".


    Figure 26.8 SOSLOGX Report card configuration submenu

    NOTE Options 10 and 12 are available only for owners of Forecast Capacity Planner.

    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 Options menu. Use this menu to set parameters for the Forecast export file. Access this submenu by typing 10 and pressing Enter.


    Figure 26.9 SOSLOGX Forecast data reduction configuration submenu
    Each Forecast data reduction parameter is described in the next table.
    Table 26.8 SOSLOGX Forecast data reduction configuration options
    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.
    Press Enter after making your selection to return to the SOSLOGX Main Options menu.
    Performance Gallery configuration (SUBMENU)
    To view the Performance Gallery configuration submenu, type the command key (option 11) for the Performance Gallery configuration option from the SOSLOGX Main Options menu. This option is only available for owners of Performance Gallery Gold.


    Figure 26.10 SOSLOGX Performance Gallery configuration submenu
    The Performance Gallery configuration options are listed and described in Table 26.9.
    Table 26.9 SOSLOGX Performance Gallery configuration options
    Option
    Default
    Description
    Performance Gallery Version
    1-Original
    By default, the Performance Gallery version is 1 - Original.
    Your choices are:
  • 1 - Original
  • 2 - Gold
  • Global CPU Data
    Y
    By default, the global CPU data in the collection will be displayed. To eliminate CPU data from the report file, enter N (No).
    Global Memory Data
    Y
    By default, the global memory data will be displayed. To eliminate this data from the report file, enter N.
    Global Miscellaneous Data
    Y
    By default, the global miscellaneous data will be displayed. To eliminate this data from the report file, enter N.
    Disc Data
    Y
    By default, disc data will be displayed. To eliminate this data from the report file, enter N.
    File Space Data
    Y
    By default, file space data will be displayed. To eliminate this data from the report file, enter N.
    Process Data
    N
    By default, process data will not be displayed. To include this data from the report file, enter Y.
    Performance Gallery extract file limit
    1000000
    By default, the Performance Gallery extract file limit is 1,000,000 MB.
    Press Enter after making your selection to return to the SOSLOGX Main Options menu.
    Report output configuration menu (SUBMENU)
    This option allows you to control the number of lines per page that you wish to configure for the SOSLOGX printed output.
    To display the Report output configuration submenu, type the corresponding command key (12) from the SOSLOGX Main Options menu.


    Figure 26.11 SOSLOGX Report output configuration submenu
    The Report output configuration options are listed and described in the next table.
    Table 26.10
    Option
    Default
    Description
    Maximum lines per page
    60
    By default, SOSLOGX reports contain up to 60 lines of information per page. To increase or decrease the maximum threshold type a new maximum threshold. Press Enter.
    Company Name
     
    By default, the company name is not included in the SOSLOGX reports. Type a company name, system name, or another headline (up to 43 alpha-numeric characters). Press Enter.
    SOSLOGX Report output configuration options

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