Basis Errors and Solutions

Symptom

You use the CCMS agent SAPCCMSR to transfer data about the system status from a server to a central monitoring system. This note describes how you can install the CCMS agent for the operating system IBM i if there is no full SAP kernel on the server or in the partition.

Other terms

AS/400, OS/400, OS400, iSeries, i5/OS, legacy monitoring

Reason and Prerequisites

As of Release 6.40, the CCMS agent runs in the PASE runtime environment. PASE stands for “Portable Application Solution Environment” and is provided as option 33 of the operating system. Parts of the agent access other PASE components and the service program O4PRTLIB, so you must set the environment variables and the library list correctly in order for the CCMS agent to function.
To unpack the CCMS agent, you require the tool SAPCAR that is described in SAP Note 863821. To set up the runtime environment correctly, you require the package SAPHOSTAGENT (that is described in SAP Note 10310960) and the enhancements from SAP Note 1299618 (Release 7.10: SAPHOSTAGENT.SAR level 32 or higher, Release 7.11: SAPHOSTAGENT.SAR level 9 or higher). The CCMS agent must be from the same release as the package SAPHOSTAGENT. However, the release is independent of the central monitoring system release.

Solution
1. Install the package SAPHOSTAGENT in accordance with the instructions attached to Note 1031096. The PASE version of SAPCAR is installed in accordance with Note 863821 as part of these instructions.2. Download the package SAPCCMSR<...>.SAR from SAP Service Marketplace into the directory /tmp/hostctrl, which you created when you installed the package SAPHOSTAGENT. If you have chosen a different directory name, change it according to the following commands.3. Log on as QSECOFR or a user with equivalent authorization.4. Start an interactive PASE terminal session with the command:
CALL PGM(QP2TERM)5. Switch to the directory that contains the package SAPCCMSR and the program SAPCAR:
cd /tmp/hostctrl6. Unpack the archive SAPCCMSR<...>.SAR with the command
./SAPCAR -xvf SAPCCMSR<...>.SAR7. Exit the interactive PASE terminal session by choosing F3.8. Copy the program SAPCCMSR into the run directory of SAPHOSTAGENT with the command:
CPY OBJ(’/tmp/hostctrl/SAPCCMSR’)
TOOBJ(’/usr/sap/hostctrl/exe/SAPCCMSR’)9. Create an executable program for the operating system IBM i by copying the program SAPOSCOL:
CRTDUPOBJ OBJ(SAPOSCOL) FROMLIB(R3SAP400)
OBJTYPE(*PGM) NEWOBJ(SAPCCMSR)

If you want to execute the agent in an interactive session (to register it with the central monitoring system, for example), you must enter the following commands (after logging on) to set up the runtime environment:
CALL PGM(R3SAP400/R3INLPGM)
ADDLIBLE LIB(R3SAP400)
The agent is called by the parameters that are described in the official documentation, for example, to display the version:
CALL PGM(SAPCCMSR) PARM(’-v’).
To register using a configuration file, use the following command syntax:
CALL PGM(SAPCCMSR)
PARM(’-R’ ‘-f’ ‘/usr/sap/tmp/sapccmsr/csmconf’)