CEMN - CICS monitoring facility

Use the CEMN monitoring facility transaction to inquire on the settings for the CICS monitoring facility and to change some of the settings without needing to restart CICS.

CEMN gives you an alternative to the INQUIRE MONITOR and SET MONITOR system programming commands and the equivalent CEMT commands.

You can change these settings using CEMN:

Monitoring status: Whether monitoring is required.
Exception class: Whether exception class data is required.
Identity class: Whether identity class data is required.
Performance class: Whether performance class data is required.
Resource class: Whether resource class data is required.
DPL resource limit: The maximum number of distributed program link requests for which resource class data is collected.
File resource limit: The maximum number of files for which resource class data is collected.
Tsqueue resource limit: The maximum number of temporary storage queues for which resource class data is collected.
Compression status: Whether monitoring data is to be compressed. The default is for monitoring records to be compressed.
Converse status: Whether separate performance class records are produced for conversational tasks.
Syncpoint status: Whether separate performance class records are produced for sync point requests.
Frequency: The interval at which CICS produces performance class records for long-running tasks. CICS can produce a performance class monitoring record in this way only when the long-running transaction is running on the quasi-reentrant (QR) or concurrent (CO) mode TCBs.

Changing these settings affects the monitoring data that is recorded for tasks that are running at the time you make the change. The effects are the same as if you had changed the settings using the SET MONITOR system programming command or the CEMT SET MONITOR command. CEMT SET MONITOR explains how data for running tasks is accumulated, recorded, or lost when you change the settings for the CICS monitoring facility.

These settings are displayed but cannot be changed using CEMN:

Application naming status: Whether CICS application naming support is enabled.
RMI status: Whether additional performance monitoring is active for CICS resource managers.
Time option: Whether the time stamp fields are returned in GMT or local time.

You can change the distributed program link requests limit, file resource limit, temporary storage queue resource limit, application naming status, and RMI status using the DFHMCT TYPE=INITIAL macro in the monitoring control table (MCT). You can change the time option using the MNTIME system initialization parameter. A CICS restart is required to implement any of those changes.

Start the CEMN transaction by typing CEMN on the command line of your display and pressing Enter. You get a display of the primary CEMN panel, showing the current state of the CICS monitoring facility and the settings of the monitoring options in your own system. To see the second options panel, press F5.

You can overtype the input fields with the new values that you require. The Application Naming Status, RMI Status, and Time Option fields, are inquire-only fields. When you press Enter, CEMN issues the necessary commands to set the new values. If any errors occur, press F9 to display the error messages. If only one short error message occurs, it is shown near the bottom of the display.

CEMN is a Category 2 transaction.