Configuring the System Data Engine

Edit online

If you want to gather System Management Facilities (SMF) data, you must authorize the Z Common Data Provider System Data Engine with the authorized program facility (APF), and configure the System Data Engine according to your needs. You can also offload the System Data Engine code to System z® Integrated Information Processors.

Before you begin

Before you configure the System Data Engine, the following policy definition tasks, which are done in the Configuration Tool, must be complete:
  1. In the Configuration Tool, create one or more policies that include one or more data streams for SMF data.

    In the Configuration Tool, when you click the Configure icon Configure icon on a data stream node for data that is gathered by the System Data Engine, the Configure System Data Engine data stream window is shown. Data stream configuration for data gathered by System Data Engine lists the configuration values that you can update in this window.

  2. After you configure the data streams for SMF data, click the SYSTEM DATA ENGINE button, which is in the Global Properties section of the Policy Profile Edit window, to set the configuration values for your System Data Engine environment, as described in SYSTEM DATA ENGINE properties: Defining your System Data Engine environment.
  3. Output from the Configuration Tool describes the output from the Configuration Tool, which includes the following System Data Engine file:
    .sde file
    Contains configuration information for the System Data Engine.

Procedure

To configure the System Data Engine, complete the following steps:

  1. Authorize the System Data Engine with the authorized program facility (APF), as described in Authorizing the System Data Engine with APF.
  2. Complete the following steps, depending on whether you want to stream the SMF data, or offload the System Data Engine code to System z Integrated Information Processors:
    Option Description
    Stream SMF data
    1. Decide which method to use for collecting SMF data, as described in Deciding which method to use for collecting SMF data.
    2. Create the System Data Engine started task, as described in Creating the System Data Engine started task for streaming SMF data.
    3. If you want to collect SMF data from the SMF user exit, install the user exit, as described in Installing the SMF user exit.
    Offload the System Data Engine code to System z Integrated Information Processors If you want to offload the System Data Engine code to System z Integrated Information Processors, activate the zIIP offloading function, as described in Offloading the System Data Engine code to System z Integrated Information Processors.
    Tip: You must use the z/OS® SYS1.PARMLIB member SMFPRMxx (or its equivalent) to enable the collection of each SMF record type that you want to gather.