Configuring the Data Collector

Edit online

About this task

Follow below steps to configure Data Collector that gathers the information related to the services exposed by the mainframe.

Procedure

  1. Copy the files for Data Collector from zoscDataCollector to a new working directory.
  2. Update the DC.properties file in this newly created working directory, by setting the following property values:
    Important: Please do not update other property values in the file, unless otherwise instructed by IBM® Support.
    1. ZoscURL: Specify the protocol, the host name and the port for the z/OS® Connect server as a URL.
      Note: You need to append /zosConnect/apis as the path part of the URL. An example value is http://<zoscHost>:9081/zosConnect/apis.
    2. ZoscUser: Specify the user name by which Data Collector connects to the z/OS Connect server. If user authentication is disabled on z/OS Connect server or IBM AD Catalog, you do not need to define this property value in the property file
    3. ZoscPass: Specify the password (in plain text) used by Data Collector to connect to the z/OS Connect server. If user authentication is disabled on z/OS Connect server or IBM AD Catalog, you do not need to define this property value in the property file
    4. DataCollectorId: Specify the Data Collector ID, for AD to identify an instance of z/OS Connect server.
      Note: For v5.0.4, the DataCollectorId string must be the same as the ZoscURL property value. Additionally, DataCollectorId must contain the zosConnect/apis string which can be either zosConnect/apis or the full URL of the ZoscURL.
    5. ADCatalogURL: Specify the protocol, the host name and the port used by the AD Catalog.
      Note: You need to append com.ibm.etools.ad.catalog/cat/entity to the URL path. An example value is http://<catalogHost>:9080/com.ibm.etools.ad.catalog/cat/entity/.
    6. ADCatalogUser: Specify the user name by which Data Collector connects to the AD Catalog If user authentication is disabled on z/OS Connect server or IBM AD Catalog, you do not need to define this property value in the property file.
    7. ADCatalogPass: Specify the password (in plain text) used by Data Collector to connect to the IBM AD Catalog If user authentication is disabled on z/OS Connect server or AD Catalog, you do not need to define this property value in the property file.
  3. Check the PATH environment variable. You need to add the directory where java.exe resides in the PATH environment variable, in case it is missing.
  4. Update zoscdc.cmd.
    Important: You need to specify the jar file of JSON4J that resides under /WAS_Liberty_Library/lib/ with full path name, as a part of the -classpath argument. The file name of the jar file should look like com.ibm.json4j_x.x.x.jar.

    Alternatively, you can specify the property values listed in step 2 as the property values passed to the java command. For example, the ZoscUser property can be specified as an argument for -DZoscUser=user1.