Show TOC

Controlling SAPOSCOL from the Operating SystemLocate this document in the navigation structure

Use

You can also control SAPOSCOL directly from the operating system input prompt.

Caution

If you want to start and/or stop SAPOSCOL, start or stop the corresponding host agent.

Features

Control SAPOSCOL from the operating system input prompt using the command:

saposcol <Option> [pf=<complete SAPOSCOL profile path>] [-t[Level] [-z]

  • You usually call SAPOSCOL without a profile path. Specify a profile if you want to use a different working directory for SAPOSCOL (more information: SAPOSCOL: Working Directory and Profile Parameters).

  • You can use -t[Level] to set a trace level for each option. Possible values are 1, 2, or 3. You can use the value -z to force SAPOSCOL to write a cyclical trace to avoid large quantities of trace data (more information: SAPOSCOL Log Files).

You can use the following options:

Option

Meaning

Note

-l

Starts SAPOSCOL

These options are only included here for reasons of completeness. We recommend that you start and stop SAPOSCOL using the host agent and not using the operating system command prompt (more information: Starting and Stopping SAP NetWeaver Management Agents).

-k

Stops the current collector

-r

Stops the current collector and displays the results

-d

Starts the dialog mode of the operating system collector SAPOSCOL

 

-h

Displays the possible SAPOSCOL options

 

-s

Displays the status of the collector

 

-v

Displays the version of the collector

 

-c

Deletes the data in shared memory

 

-o

Displays all collected data from the shared memory

 

-m

Displays all current data from the shared memory

 

-i <number>

Sets a new interval for the collection of data in the normal mode (every <number> seconds; the default value is 10 seconds)

We recommend that you set these options using the Profile File of the Host Agent, which controls SAPOSCOL. To do this, use profile parameter hostexec/oscol/arguments and restart the host agent (more information: Retarting SAP NetWeaver Management Agents).

Example

To increase the collection interval of SAPOSCOL to 30 seconds, add the line hostexec/oscol/arguments = -i30 to the profile file of the host agent.

-t <Level>

Sets the trace level for debugging

-z

Activates cyclical trace

-b

Displays hardware information in XML format

SAPOSCOL always displays the name of the physical host; the name of the virtual host is not taken into account.. This can lead to problems if you are working in a virtualized environment and want to transfer this hardware information to an SLD with the program sldreg.

-xml

Displays all collected data from the shared memory in XML format