Sample JCL procedure to run OMEGAMON Data Connect

You can use JCL to run OMEGAMON® Data Connect on z/OS®.

OMEGAMON Data Provider supplies a sample JCL procedure that runs OMEGAMON Data Connect on z/OS. The sample JCL requires the Java™ Batch Launcher and Toolkit for z/OS (JZOS). JZOS is supplied with IBM® Semeru Runtime® Certified Edition for z/OS.

Location

OMEGAMON Data Provider supplies the sample JCL procedure in two locations:

  • MVS library member TKANSAM(KAYCONN)
  • Under the OMEGAMON Data Connect installation directory in the relative file path:

    sample/KAYCONN

    Example absolute file path:

    /usr/lpp/omdp/kay-110/sample/KAYCONN

Before running the JCL

The sample JCL procedure requires a user directory that contains your site-specific OMEGAMON Data Connect configuration file.

Before running the JCL:

  1. Use the create action of the supplied shell script to create a user directory.
  2. Edit the config/connect.yaml configuration file in the user directory to match your site-specific requirements.

Usage

The sample JCL procedure is designed to be used as a starting point for you to copy and edit to meet your site-specific requirements.

Copy the sample from its supplied location to your choice of MVS PROCLIB library. For example, SYS1.PROCLIB.

Tip: Review the entire sample so that you understand it completely before using it.

Typically, to edit the procedure for your own use, you only need to edit the values of the following symbolic parameters, near the start of the procedure. You must edit the values of these parameters in the SET statements in the procedure itself. The sample JCL procedure is not sensitive to values for these parameters passed by a calling job or START command.

JAVAHOME
The path of the installation directory of Java 17 or later, 64-bit edition. The directory must contain a bin subdirectory that contains the java command.
INSTLDIR
The path of the OMEGAMON Data Connect installation directory.
USERDIR
The path of your OMEGAMON Data Connect user directory.