Stopping SAPOSCOL  

Purpose

Stop saposcol only if you want to restart the host or if you want to swap to a different version of saposcol itself.

Because saposcol collects data constantly, even when no R/3 components are running, you should not normally stop saposcol .

Process Flow

  1. Stop saposcol with the command saposcol -k.
  2. A new saposcol is started which stops the active saposcol . The process that is collecting data should then stop working after one second.

  3. The new saposcol connects to the shared memory.
  4. From the shared memory, it determines the PID of the saposcol that is collecting data, and the status of the active flag.
  5. If the new saposcol finds a valid PID, then a stop flag is set in the shared memory. When the old saposcol finds this flag, it resets the active flag, and deletes the PID from the shared memory. If this does not happen within one second, the new saposcol sends a signal to the background process to stop working.
  6. The new saposcol checks this several times against the active flag in the shared memory.
  7. If necessary, the process clears the data in the shared memory itself.

  8. Before the old saposcol stops, it writes the data in the shared memory to the file coll.put in the home directory of saposcol .

The file coll.put is imported when the host is restarted, so that the summarized data in the shared memory is available to R/3. For example, if saposcol is stopped at 12:03 and restarted at 14:49, then the data from hours before 12 is still available to the R/3 System. To avoid confusion, invalid data for hours 12 to 14 is not displayed in the recent hours overview in the operating system monitor.

The time for which a shared memory segment exists depends on the operating system. On a UNIX operating system, it is retained until saposcol deletes it. On Windows NT, the shared memory is deleted by the operating system if there is no process connected to it.

Do not stop saposcol with other operating system commands. Doing so corrupts the data in the shared memory segment. You would also not be able to start a new saposcol and would be notified that another saposcol is already running.

 

See also:

Starting SAPOSCOL

Controlling SAPOSCOL from the R/3 System

Displaying Collector Data