Show TOC

Dialog Mode of the Operating System Collector SAPOSCOLLocate this document in the navigation structure

Use

Dialog Mode of the Operating System Collector SAPOSCOL Use SAPOSCOL has a dialog interface, Collector>, that you can start from the operating system input prompt with the command saposcol -d. You can enter various dialog commands here. Use the command help to obtain a list of the possible commands.

Features

Displaying the Data in Shared Memory Collected by SAPOSCOL

You can use the dialog mode to call up the data that SAPOSCOL wrote to the shared memory. The most important command is dump, which is used to display various data collected by SAPOSCOL and stored in the shared memory, depending on parameters and options.

dump <Parameter> <option>

The following parameters are possible:

Parameter

Meaning

cpu

CPU

memory

Memory

top

Largest CPU user

disk

Hard disk

Filesystem

File system

lan

LAN

proc

Monitoring of selected processes

The following options are possible:

Option

Meaning

single

Current value of a single selected parameter

all

Current value of all parameters available in shared memory

sum

Hourly averages for the last 24 hours of all parameters available in shared memory

Note

Note that not all of the parameters can be combined with all of the options.

There are also the following uses of the dump command:

Command

Meaning

dump config defined

Configured operating system parameters

dump config used

Currently used operating system parameters

dump hour

dump hour Displays a list of the last 24 hours; each of the 24 entries has the format hour: <0-23> of day <Number>, where <Number> specifies whether SAPOSCOL has consistent data for that hour:

0: No data available

1: Current hour

2: Inconsistent data

<date (YYYYMMDD)>: Data available

Example

To display the memory-related operating system data in the shared memory, enter the following command at the Collector> command line:

dump memory all

The following information is displayed:

Collector> dump memory all

Pages paged in / sec 1

Pages paged out / sec 0

KB paged in / sec 4

KB paged out / sec 0

freemem [KB] 13312

physmem [KB] 65536

swap configured [KB] 76348

swap total size [KB] 76348

swap free inside [KB] 72556

Controlling SAPOSCOL in Dialog Mode

You can control SAPOSCOL in dialog mode using the following commands at the Collector> input prompt:

Command

Meaning

detailson

Sets the details flag

detailsoff

Cancels the details flag

interval <n>

Changes the collection interval to <n> seconds (Default = 10)

leave

Deletes the shared memory

kill

Stops the background process

launch

Starts a new collector

force

Forces a new collector to start (only in emergencies)

status stat

Displays the status of the SAPOSCOL process that is collecting data in the background

The changed values are written to shared memory. SAPOSCOL reads these values directly before collecting data. The changes then take effect.

Note

If you change the collection interval, the collector switches to the new interval only after the expiration of the old interval.

Ending Dialog Mode

To leave the dialog mode of SAPOSCOL, use the command quit or the command exit.