Installation Requirements for PDS

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. You specify the high-level qualifier during server installation, as described in Run ISETUP, in Step 4.

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.