Creating a policy

From the Common Data Provider tab in the Z Common Data Provider Configuration Tool, and under the Policy for streaming data to analytics platforms section, you can create a policy for streaming data to analytics platforms.

About this task

This task provides step-by-step instructions on how to create a policy for streaming data to analytics platforms. If you want to create a policy for streaming data to Apache Kafka through Data Collector, see Creating a policy for streaming data to Apache Kafka through Data Collector.

In a policy, you must define at least one data stream with at least one subscriber. For each data stream, you can also define one or more transforms and multiple subscribers. A subscriber can also be subscribed to multiple data streams and transforms.

Icons on each node in a policy describes the icons that are shown on each data stream, transform, and subscriber node that you define in a policy.

A powerful client may bring better experience with Configuration Tool. The recommended minimum configuration of the client system is 2.5 GHz x 4 core of CPU, and 8 GB of RAM.


Watch this interactive video How to create a policy in the Configuration Tool to understand the general procedures of creating a policy.

You can also see the following instructions:

  1. Click the Create a new policy box.
  2. In the resulting Policy Profile Edit window, type or update the required policy name and, optionally, a policy description.
  3. Define any global properties, which are properties that apply to all data streams in the policy.
    For information about what you can define, see Global properties that you can define for all data streams in a policy.
  4. Click the Add Data Stream icon Add Data Stream icon.
    The Select data stream window is shown with a list of categorized data streams. You can expand the categories to view the possible data streams that you can define for this policy.

    The data stream group Starter Sets includes commonly used data streams. These data streams are categorized into various data stream units based on some z/OS® components and subsystems instead of based on data types. For more information about Starter Sets and other data stream groups, see Groups of data streams in the Configuration Tool.

    Tip: If you create any custom data stream definitions, the associated data streams are listed under the groups that you specified in the stream definitions. For more information about these definitions, see the following information:
  5. Select one or more data streams and click Select.
    After you click Select, each data stream that you choose is shown as a node in the graph. Each node includes the icons that are described in Icons on each node in a policy.
    Important: The policy size will affect the response time of the Configuration Tool. An extremely large policy will render slowly, but will eventually completely render. If the policy renders slowly, review the data streams which are included in your policy and remove any unneeded data streams.
  6. Depending on what you want to define in the policy, use the Configure Configure icon, Transform Transform icon, and Subscribe Subscribe icon icons on each node to complete the policy definition. If you want to add more data streams to the policy, use the Add Data Stream icon Add Data Stream icon.
    • Icons on each node in a policy indicates where you can find more information about configuring data streams, transforms, and subscribers, including information about the configuration values.
    • To remove a data stream, transform, or subscriber node from a policy definition, click the Remove icon (X mark) on the node. When you remove a data stream node or a transform node, any connected transform nodes are also removed.
    • If you select Generic z/OS Job Output, Generic ZFS File, Generic VSAM Cluster, or, if you have IBM Z Operational Log and Data Analytics, zSecure Access Monitor data streams, you must click the Transform Transform icon icon on a data stream node, and configure CRLF Splitter transform or FixedLength Splitter transform. For more information about transforms, see Transform configuration.
  7. To save the policy, click Save.
    The box for the new policy is then shown on the page.