Controlling CCMS Agents

The following commands are available to you to control the CCMS agents directly from the operating system input prompt:

You can display the list of available commands at any time by entering the name of the agent without commands and options at the operating system input prompt (such as sapccmsr).

Deregistering CCMS Agents

To deregister an agent, enter the parameter -U. If you specified a profile path during registration, specify this path during deregistration too:

The start file CSMCONF is deleted during the deregistration. The logon data for CEN is also requested during the deinstallation, to automatically delete the following entries for the agent in the system:

• Entry in the topology display of the monitoring architecture (you can start the topology display using transaction RZ21; in the Topology group box there, choose one of the radio buttons that display the CCMS agents registered with this system)
• RFC connections to the agent (Check using transaction SM59)
• Entry in the System Component Repository (SCR); you can display the SCR by choosing Technical Infrastructure → System Repository → Display in transaction RZ21.
  Note

  In the case of a release status below SAP Web AS 6.20, these entries are not deleted. You should set the agent to Offline in the topology display to avoid problems in the system.

Starting and Stopping CCMS Agents

Always stop and restart a CCMS agent if you have made changes to its configuration file SAPCCMSR.INI, as this file is only read when the agent is started. Follow the procedure below for your operating system platform:

• Under UNIX, you can stop the CCMS agent using the option -stop, therefore, for example, for agent SAPCCMSR, you would use the command sapccmsr -stop [pf=<profile path>]. To restart the agent later, use the option -DCCMS.
• Under Microsoft Windows, we recommend that you stop and restart the agent by stopping and restarting the service of the same name.

Register and deregister without installing or uninstalling a service (Microsoft Windows only)

Under Microsoft Windows, you can use the option -noservice in connection with the commands -R (register agent) and -U (deregister agent) to prevent the associated service being installed during registration, or uninstalled during deregistration.

This option is available to you as of Patch Collection 2005/5. It is especially useful if you need to register or deregister an agent using a user that does not have administrator authorization on the relevant host.

Displaying the Status of a CCMS Agent

The status of a CCMS agent displays its working directory and the configuration directory; if the agent is running, you receive additional information about the release of the central monitoring system in which the agent is registered. To do this, call the agent with the option -status (for example, with the SAPCCMSR agent):

>sapccmsr -status

INFO: CCMS agent sapccmsr working directory is /usr/sap/tmp/sapccmsrINFO: CCMS agent sapccmsr config file is       /usr/sap/tmp/sapccmsr/csmconfINFO: Checking shared memory status of sapccmsr******** CCMS agent running on this machine: **********      sapccmsr without profile **      registered at central system BCE **      CCMS version  20010925, 32 bit*      Process Id    28807 *      relno         6200*      patchno       45*      intno         20020600*****************************************************EXITING with code 0

Displaying the Version of a CCMS Agent

Call the agent with the option -V (for example, with the SAPCCMSR agent):

>sapccmsr -v

CCMS version20010925, 32 bit, multithreaded, Non-Unicodecompiled at  Sep 17,2002systemid  560 (PC with Windows NT)relno  6200Patch text patch collection 2003/2, SAP note 584136patchno 344intno  20023800running on P57373 Windows NT 5.0 2195 Service Pack 2 Intel 80686

You can read the version from the release number (relno) and the patch number (patchno). The line running on also contains the operating system on which the agent is currently running. Patch text specifies the Patch Collection. For information about which collection contains which changes, see SAP Note 202591.

 CCMS Agents start page