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
See "SOSLOGX 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 Pl