Copying configuration files to the working directory

If you plan to send any data to IBM Z® APM Connect, you must prepare the Z Common Data Provider Configuration Tool to support the data types that are destined for IBM Z APM Connect. You must complete this task before you create any policies that define data streams with IBM Z APM Connect as the target destination.

Before you begin

Ensure that the APAR OA64079/PTF UJ92532 is installed following all ++HOLD ACTIONS system actions. After the installation, you will find that a data set named hlq.SAGMSAM is created.

The data set contains the following files:
  1. Three JSON configuration files:
    • AGMCDPE
    • AGMCDPP
    • AGMCDPS
  2. Three SQL filters:
    • AGM101
    • AGMQW172
    • AGMQW196

About this task

The JSON configuration files are required to send data with Z Common Data Provider. You must copy the configuration files to the working directory for the Z Common Data Provider Configuration Tool, which you defined in Setting up a working directory for the Configuration Tool. This step must be performed before you configure IBM Z Common Data Provider. The SQL filters should remain in their current location. They do not require any additional steps.

Procedure

Copy and rename the three JSON files from the SAGMSAM dataset to the working directory for the Z Common Data Provider Configuration Tool on the z/OS UNIX System Services. For more information about the configuration files, see configuration files definitions below.

  • Copy and rename AGMCDPE as ibmzapm.enable.json

  • Copy and rename AGMCDPP as ibmzapm.protocols.json

  • Copy and rename AGMCDPS as ibmzapm.streams.json

Tip: To copy and rename the files, use the cp command as specified in the ++HOLD instructions.
Table 1. Configuration files definitions
Configuration files Description More information
ibmzapm.enable.json Contains the information that is necessary for Z Common Data Provider to register with Sub-Capacity Reporting Tool (SCRT) as a running component of Z APM Connect.  
ibmzapm.protocols.json Defines the subscriber protocols that data can be sent to. See Subscriber configuration to learn the protocol changes.
ibmzapm.streams.json Defines the data types that are used by the Z APM Connect. Includes data streams for curated data under group IBM Z Application Performance Management Connect in the Configuration Tool.

Results

You can create policies that define data streams with IBM Z APM Connect as the target destination from the Z Common Data Provider Configuration Tool. To install the Z Common Data Provider Configuration Tool, see Installing the Configuration Tool on z/OSMF.