Open topic with navigation

ibi™ Open Data Hub for Mainframe Connectors 1.0.8

# Installation Requirements for PDS

Before beginning server installation, review all requirements.

## Operating System Requirements

The server runs on any supported release of z/OS. For current information about supported releases, see the ibi™ WebFOCUS® Release Notes.

In general, the operating system should have the latest cumulative patch levels applied.

Confirm that your server installation software is labeled for your operating system level.

## IP Port Number Requirements

The installation process prompts for two IP port numbers: the TCP Listener and HTTP Listener. It also uses the next two consecutive ports after the supplied HTTP Listener port for FDS use. This results in a total of four IP ports.

The supplied IP port numbers must be above the IANA registered well-known reserve range (numbers under 1024) and not over the maximum legal number (65535). Do not use IP port numbers already used by other applications or products. Netstat, or netstat like commands, should reveal what actual ports are in use.

## Browser Requirements

The WebFOCUS Reporting Server browser interface requires one of the following web browsers:

- Microsoft Edge.
- Mozilla Firefox® 59 or higher.
- Google Chrome® 65 or higher.

## Disk Space Requirements

The server disk space requirements are:

Supplied (EDAHOME) Data Sets | 3390 Cylinders
--- | ---
high_level_qualifier.P.HOME.ACX | 2
high_level_qualifier.P.HOME.BIN | 1100
high_level_qualifier.P.HOME.CICS.LOAD | 10
high_level_qualifier.P.HOME.ERR | 500
high_level_qualifier.P.HOME.ETC | 100
high_level_qualifier.P.HOME.FEX | 25
high_level_qualifier.P.HOME.LOAD | 750
high_level_qualifier.P.HOME.MAS | 4

Configuration (EDACONF) Data Sets | 3390 Cylinders
--- | ---
high_level_qualifier.WFS.CONF.ACX | 2
high_level_qualifier.WFS.CONF.CFG | 2
high_level_qualifier.WFS.CONF.MAS | 2
high_level_qualifier.WFS.CONF.PRF | 2

Installation Data Sets | 3390 Cylinders
--- | ---
high_level_qualifier.HOME.DATA | 10
high_level_qualifier.WFS.DATA | 2

Application Data Sets | 3390 Cylinders
--- | ---
approot.IBISAMP.type.DATA | 38 (across 14 data sets)
approot.BASEAPP.type.DATA | 56 (14 data sets using 4 cylinders per file)

Deferred Execution Data Sets (Optional) | 3390 Cylinders
--- | ---
high_level_qualifier.WFS.CONF.DFM.DEL | 5
high_level_qualifier.WFS.CONF.DFM.RPE | 5
high_level_qualifier.WFS.CONF.DFM.RPF | 5
high_level_qualifier.WFS.CONF.DFM.RPO | 100
high_level_qualifier.WFS.CONF.DFM.RQD | 5
high_level_qualifier.WFS.CONF.DFM.RQF | 5
high_level_qualifier.WFS.CONF.DFM.RQO | 5
high_level_qualifier.WFS.CONF.DFM.RQP | 5

Note: Deferred Execution Datasets are not created by the installation procedure. They are created when the Scheduler/Deferred service starts. By default, the Scheduler/Deferred service auto starts at server startup. To disable the feature, enter dfm_autostart = n in the EDASERVE administration control file.

Supplementary Data Sets | 3390 Cylinders
--- | ---
high_level_qualifier.WFS.SYSRPC.FOCUS | 1
high_level_qualifier.WFS.ETLLOG.FOCUS | 1
high_level_qualifier.WFS.ETLSTATS.FOCUS | 1
high_level_qualifier.WFS.CONF.SMARTLIB.DATA | 1

high_level_qualifier

Is the high-level qualifier to be used for all output libraries. This is the same high-level qualifier, which you specify during server installation.

approot

Is the default location for storing applications. You specify approot during server installation, as described in Run isetup

## Memory Requirements

Memory usage of a configured environment consists of the following elements:

- Workspace Manager
- Listeners
- Concurrently running application agents

Actual memory usage depends on application features, and varies depending on the application. The SHRLIBRGNSIZE parameter (defined on SYS1.PARMLIB, member BPXPRMxx) can affect the amount of memory that the server address space will allocate. For SHRLIBRGNSIZE, we recommend the default MVS installation value of 64Mb:

    SHRLIBRGNSIZE(67108864)

Server memory usage:

- The workspace (including Listeners) uses 200 megabytes.
- Each pre-started agent requires 4 megabytes.

The minimum amount of memory for a newly installed server with no workload is 250Mb. However, depending on usage, workload, and configuration options, 500Mb is recommended to start, to be adjusted as needed.

## Communication Requirements

You need four TCP/IP ports for each server instance that you configure. Three of these ports must be consecutive. You specify these port numbers during installation. You may require additional ports depending on which options you configure later.

The server supports only IBM TCP/IP. It does not support Interlink or any other third-party TCP/IP.

## USS Segment Requirements

PDS deployment requires each user of the server to be identified to USS by means of a default segment definition. This default OMVS segment is defined when USS is installed as a part of z/OS. Refer to your IBM UNIX System Services documentation for more information about this subject.

## ZFS Home and Configuration Directory Requirements

Libraries and the APIs supporting them must reside in the ZFS file system to enable the following features:

- Server-side graphics

They are also required for the following Java-based and SAP-based adapters:

- Call Java
- EJB
- JDBC
- Microsoft SQL Server
- SQL SAP
- SAP BWB

At installation time, a panel with a list of adapters to be configured will be displayed. If any of the above adapters are selected, the installation will require the path for two ZFS locations as follows:

- edahome_dir. Provide the edahome path for the dll modules that interface with Java/SAP and must reside in ZFS. The directory will be created with 755 permissions, if it does not exist.
- edaconf_dir. Provide the edaconf path to be used for both configuration files (such as codepage files), as well as the root location for temporary files (such as traces and logs), that must reside in ZFS. If it does not exist, the directory will be created with 755 permissions.

If no data adapters were selected, the next panel will allow an optional configuration for the JSCOM3 listener. If server-side graphics support is desired, the listener must be configured and all three paths are required (edahome_dir, edaconf_dir, plus the path to Java passed to either JDK_HOME or JAVA_HOME).

If edahome_dir is not defined at installation time, it will not be possible to configure it later using the WebFOCUS Reporting Server browser interface. The server will have to be re-installed, configuring the JSCOM3 listener.

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

ibi™ Open Data Hub for Mainframe Connectors

Copyright © 2021-2025. Cloud Software Group, Inc. All Rights Reserved.