Collect Required Information for Adapters

For current information about which adapters are supported, see the ibi™ WebFOCUS® Adapter Administration manual.

You must provide information to configure the adapters that you want to install. The installation procedure automatically prompts you for this information. When you are prompted for an optional steplib, ddname, or environment variable, the installation procedure will indicate this with an OPT> prompt.

If you are using non-APF-authorized DBMS libraries, you must allocate the libraries to the ddname TASKLIB in IRUNJCL. The installation routine collects the information and allocates the required libraries in STEPLIB.

After you have installed and configured the server, you will be able to further configure your adapters using a web-based server configuration tool called the WebFOCUS Reporting Server browser interface.

The following table describes what information you need to provide for each adapter that you have. (If an adapter is not listed, no information needs to be provided for it.) Note that the table refers to:

  • EDAENV.This file contains environment variables and values set at server startup
  • IRUNJCL. This procedure starts the server.

    Both files are members of the edaconflib PDS. You will be prompted for the name of this PDS at installation time.

Adapter

Information you must provide

Adabas

Provide the data set name for the following STEPLIB allocation:

  • load library

This is required only for the synonym creation process. For example, in a production environment in which all synonyms already exist, you can omit this.

When you configure the adapter, you will need to provide the name of the Adabas source library and the associated data set name.

CA- DATACOM

Provide the data set names for the following STEPLIB allocations:

  • CUSLIB load library
  • CAILIB load library
  • utility library
  • URT library

CA- IDMS

(both DB and SQL)

Provide the data set names for the following STEPLIB allocations:

  • load library
  • DBA load library

Provide the data set names to which the following ddnames are allocated:

  • SYSIDMS. Check with your CA-IDMS DBA regarding this ddname.
  • SYSCTL. Is the library corresponding to the central version you want to use.

Call Java

You must have the JDK installed.

Provide a value for the following environment variables:

  • CLASSPATH. Provide the paths of the .jar files that you want to access. These paths will be appended to CLASSPATH.
  • This adapter requires configuration of the JSCOM3 listener. The path to JVM must be provided using either JDK_HOME or JAVA_HOME. The installation will prompt for it.

CICS Transaction

Provide the data set name for the following STEPLIB allocation:

  • CICS EXCI load library

Db2 CAF

Provide the data set names for the following STEPLIB allocations:

Db2 CLI

Provide the data set names for the following STEPLIB allocations:

  • SDSNLOAD load library

    For security information, see Db2 Security Exit Configuration for ZFS.

  • SDSNLOD2 load library
  • SDSNEXIT load library (optional; this is needed only for an explicit connection).

Provide a value for the following environment variable:

  • DSNAOINI, which contains the full path and file name of the Db2 CLI .ini file.

EJB

You must have the JDK installed.

Provide a value for the following environment variables:

  • CLASSPATH. Provide the paths of the .jar files that you want to access. These paths will be appended to CLASSPATH.

    If you are deploying the adapter to access an EJB on a:

    • WebLogic server, specify the following path:
      /pathspec/weblogic.jar 
    • WebSphere server, specify the following paths:
      /pathspec/websphere.jar
      
      /pathspec/ejbcontainer.jar

      (one for each EJB container)

  • This adapter requires configuration of the JSCOM3 listener. The path to JVM must be provided using either JDK_HOME or JAVA_HOME. The installation will prompt for it.

IMS

Provide the data set names for the following STEPLIB allocations:

  • DFSPZP load library (optional; not needed if PZP modules are stored in the DFSRESLB library)
  • DFSRESLB load library

JDBC

You must have the JDK installed.

Provide a value for the following environment variables:

  • CLASSPATH. Provide the paths of the .jar files that you want to access. These paths will be appended to CLASSPATH.
  • This adapter requires configuration of the JSCOM3 listener. The path to JVM must be provided using either JDK_HOME or JAVA_HOME. The installation prompts for it.

Microsoft SQL Server

Select the Call Java adapter, in addition to the Microsoft SQL Server adapter.

Provide a value for the following environment variables:

  • CLASSPATH. Provide the paths to the following files. These paths will be appended to CLASSPATH.
    • msbase.jar
    • mssqlserver.jar
    • msutil.jar
  • This adapter requires configuration of the JSCOM3 listener. The path to JVM must be provided using either JDK_HOME or JAVA_HOME. The installation prompts for it.

Millennium

Provide the data set name for the following STEPLIB allocation:

  • load library

Model 204

Provide the data set name for the following STEPLIB allocation:

  • load library

MQSeries

Provide the data set names for the following STEPLIB allocations:

  • SCSQLOAD load library
  • SCSQAUTH load library

NATURAL Batch

Provide the data set name for the following STEPLIB allocation:

  • NATURAL load library

SAP (SQL)

Provide values for the following environment variables:

  • LIBPATH, which contains the path to SAP RFC SDK.
  • SAP_CODEPAGE=0126, or the correct SAP code page for your language environment.

SAP BW

Provide values for the following environment variables:

  • LIBPATH, which contains the path to SAP RFC SDK.SAP_CODEPAGE=0126, or the correct SAP code page for your language environment.

Supra

Provide the data set name for the following STEPLIB allocations:

  • LINKLIB load library.
  • INTERFLM load library.
  • ENVLIB load library.