Complete the configuration for the OMEGAMON subsystem

Edit online

Tasks described in this section are required to complete the configuration of the OMEGAMON® subsystem. This component is not used by all OMEGAMON monitoring agents.

Before you begin

Check whether the OMEGAMON subsystem has already been defined to z/OS®.

For example, issue the following DISPLAY MVS™ system command to list subsystems:

D SSI

The default name of the OMEGAMON subsystem is CNDL.

About this task

This subsystem is required if you have configured any of the following OMEGAMON monitoring agents in the runtime environment:

IBM Z® OMEGAMON AI for CICS® (optional)
IBM® OMEGAMON for IMS on z/OS
IBM Z OMEGAMON AI for Storage
IBM Z OMEGAMON AI for z/OS

You must define the OMEGAMON subsystem on each LPAR where you plan to start runtime environments that contain any of these monitoring agents.

When you create a runtime environment that contains one of these monitoring agents, the generated runtime members include a started task that starts the OMEGAMON subsystem.

Optionally, you can configure your LPAR to start the OMEGAMON subsystem whenever z/OS restarts (IPL).

For Configuration Manager steps, refer to Defining the OMEGAMON subsystem to z/OS. For PARMGEN steps, see below.

Procedure

Update the IEFSSNxx member of the SYS1.PARMLIB.
Create a subsystem ID entry in the appropriate PARMLIB IEFSSNxx member. The default subsystem name generated by the configuration methods is CNDL. The default started task name is IBMCN, so an example of the SSN entry would be as follows:
```
SUBSYS SUBNAME(CNDL) INITRTN(KCNDLINT) INITPARM('SSPROC=IBMCN')
```
In addition to identifying the OMEGAMON subsystem to the z/OS system, this example causes an automatic start of the subsystem address space. If you do not want the subsystem started at IPL, the entry would be the following:
```
SUBSYS SUBNAME(CNDL) INITRTN(KCNDLINT)
```
Tip: Use the xxxxSTRT member to start all configured products in the order that they should be started.
Copy the OMEGAMON subsystem started task (default: IBMCN) from the RKANSAMU library (PARMGEN) or rPlibHilev.SYS1.PROCLIB library (Configuration Manager) to PROCLIB.

You can change the name of this JCL procedure to any name that meets the installation standards of your site. However, do not use the name of the OMEGAMON subsystem (subsystem ID) as the name of your JCL procedure.
Copy the KCNDLINT load module to an appropriate library in the LINKLIST. Follow the installation standards at your site in making the decision about an appropriate library.