Diagnostic aids

The GPM4CIM started task writes diagnostic information into a log and into a trace file. The log file is written unconditionally and contains information about the supplied options and the GPM4CIM started task's basic activity (see Figure 1). When the GPM4CIM started task is stopped, the log file entries are copied from file /var/gpm/logs/gpm4cim[A|X|Z|W].out to the file specified with the STDERR ddname. Specifying a DEBUG_LEVEL > 0 in the configuration file prints additional information about the requests served by GPM4CIM into the log file.

An example for log file entries is shown in Figure 1.

Figure 1. Log file entries during GPM4CIM processing

(01) 02/25 110544 DDSRV: RMF-DDS-Server GPM4CIM/ZOSV1R13 started.
(01) 02/25 110544 DDSRV: Functionality Level=3.000
(01) 02/25 110544 DDSRV: Reading CFG file /etc/gpm/gpm4X.cfg.
(01) 02/25 110544 DDSRV: Summary of options in effect:
(01) 02/25 110544    CACHESLOTS(6)
(01) 02/25 110544    SERVERHOST(*)
(01) 02/25 110544    DEBUG_LEVEL(3)
(01) 02/25 110544    HTTP_PORT(8806)
(01) 02/25 110544    MAXSESSIONS_HTTP(20)
(01) 02/25 110544    HTTP_ALLOW(*)
(01) 02/25 110544    HTTP_NOAUTH()
(01) 02/25 110544    LNX_COMPLEX(SAPPLEX)
(01) 02/25 110544    LNX_IMAGE(SAP1)
(01) 02/25 110544    LNX_IMAGE(SAP2)
(01) 02/25 110544    LNX_IMAGE(SAP3)
(01) 02/25 110544    INTERVAL(60)
(01) 02/25 110544    RECORD(NO)
(01) 02/25 110544 DDSRV: OS-Type='XLINUX' OS-Version='SP7.1.1'.
(01) 02/25 110544 DDSRV: User='GPM4CIM' Process/Jobname='GPM4CIM'
ProcessId=6711008.
(01) 02/25 110544 DDSRV: System Id='SAP1' Sysplex='SAPPLEX' GoalMode=1.
(01) 02/25 110544 DDSRV: TCP/IP local host name=sap1.us.ibm.com.
(01) 02/25 110544 DDSRV: TCP/IP IP Address=9.152.87.80.
(01) 02/25 110544 DDSRV: Size of first cache slot=0 (rounded to 65536) Bytes.
(01) 02/25 110544 DDSRV: Timezone='GMT-01:00:00'
(01) 02/25 110544 DDSRV: Result ctime_r()=Fri Feb 25 11:05:44 2011
(04) 02/25 110544 DDCON: GPM260I RMF Distributed Data Server for CIM ready for
commands

If you require more detailed information about GPM4CIM activity, you can activate a trace by means of the following directive:

ICLUI_TRACETO=STDERR

This directive can be specified within the environment file /etc/gpm/gpm4cim.env.

When you stop GPM4CIM, the trace file entries are copied from file /var/gpm/logs/gpm4cim[A|X|Z|W].trc to the file specified with the STDERR ddname.