Performance information available
To monitor the performance of your IBM® z/OS® Connect servers and to diagnose performance issues, z/OS provides a wealth of tools such as monitors, SMF, and RMF.
You can monitor the performance of an active IBM z/OS Connect server by using various products such as IBM Z® Omegamon for JVM, and the Java™ Health Center. RMF can be used for both real-time and historical data, while SMF records are used for recording system usage over a period.
Omegamon for JVM
- API provider workloads are supported in Omegamon for JVM V5.4 and later.
- API requester workloads are supported in Omegamon for JVM V5.5 Fix Pack 2 and later.
Java Health Center
You can also monitor the JVM that your active IBM z/OS Connect is running in through the Java Health Center (part of IBM Monitoring and Diagnostic Tools). This monitor provides real-time data for the JVM including Java heap usage, data on garbage collections, and thread usage, with minimal processor usage (less than 3% CPU).
The Java Health Center is discussed further in the topic Threads, Java heap, MEMLIMIT, REGION.
For more information, see Health Center in the IBM Monitoring and Diagnostic Tools documentation.
SMF (System Management Facilities) is a component of z/OS that collects and records system and job-related information. SMF records are useful for recording system usage over a period with minimal overhead.
For IBM z/OS Connect , SMF 72 and SMF 123 version 2 records are especially useful. You can use the SMF 72 records to review the CPU usage of the IBM z/OS Connect address space. If the workload is classified in z/OS WLM, you can also use SMF 72 records to view the CPU time that is used for one or more APIs, services, or API requesters. As IBM z/OS Connect is primarily written in Java, up to 99% of the CPU is potentially off-loadable to zIIP processors. The GCP and zIIP usage for the server can be monitored by using SMF 72 records.
SMF 123 version 2 records provide details of each API, service, API requester, and administration request, and include HTTP status codes and timestamps as requests enter and leave the IBM z/OS Connect server. These provide invaluable information that you can use to see how much elapsed time is spent processing requests inside the server, the time spent waiting for responses from the SOR or API endpoint, or how much time is spent obtaining an access token from an authorization server with API requester.
- SMF type 30 CPU and other information for each address space
- SMF type 70 CPU usage information for z/OS
- SMF type 72 z/OS WLM (workload management) information
- SMF type 102 Db2® information
- SMF type 110 CICS® information
- SMF type 115 IBM MQ information
- SMF type 119 TCP/IP information
- SMF type 120 Subtype 11 Liberty information
- Provides CPU data for a request (WLM classification must be configured)
- Enable by configuring
zosRequestLoggingfeature in server.xml
RMF (Resource Measurement Facility) is an optional z/OS feature that can be used to record and monitor z/OS performance, both historically and in real-time. RMF includes an ISPF application to view this information in real-time. RMF also writes SMF 70-79 records for the generation of reports for historical data containing valuable performance information including CPU usage of your IBM z/OS Connect servers and optionally the CPU usage of one or more APIs, services, or API requesters. For more information, see RMF monitors and post-processor.