Version 9.5 SP1
 —  Installation under z/OS  —

Introduction to Installing EntireX under z/OS

This document covers the following topics:


Installation Method

There are two methods for installing EntireX under z/OS:

The information provided in this section applies to both methods. Then continue with either Simplified z/OS Installation Method or Installing EntireX Broker under z/OS.

Top of page

Licensing Considerations

Software AG licensing requires that the modules LICMAIN and LICUTIL can be loaded when the EntireX Broker starts up. These modules are distributed in the MLCvrs.LOAD library.

See z/OS Licensing Data Sets.

Top of page

Installable Components

Installable Components of EntireX Broker

Top of page

Contents of Mainframe Installation Medium

The webMethods EntireX installation medium contains the data sets required to install all EntireX z/OS components. Data set names begin with a product code that identifies the module, as in the following tables.

With webMethods EntireX, the following additional products are included:

Code webMethods EntireX Component
EBV EntireX Broker Services (see Attach Manager under z/OS Prerequisites).
EXP EntireX RPC (mainframe part of EntireX Developer's Kit).
EXB EntireX Broker.
EXX Common modules used by all EntireX components.
IAF Integrated Authentication Framework.
MLC Software AG's common mainframe license check software.
SSX Software AG Security Extensions.
WAL Adabas Limited Libraries.

The installation medium contains the data sets listed below:

Data Set Name Description
SMT111.TABS SMA tables and jobs.
EBVvrs.ERRN Broker Services error message library.
EBVvrs.INPL Broker Services-specific INPL library.
EBVvrs.LOAD Broker Services-specific load library.
EBVvrs.SASC Broker Services runtime for z/OS.
EBVvrs.SRCE Broker Services-specific source library.
EBVvrs.SYSF Broker Services-specific INPL library.
EBVvrs.ZAPS Broker Services zaps library.
EXB951.ERRN Broker Natural tutorial error message data set.
EXB951.INPL Broker Natural tutorial INPL data set.
EXB951.LOAD Broker-specific load library (PDS/E).
EXB951.SRCE Broker-specific source library
EXP951.EXPL EntireX Developer's Kit RPC compressed examples library (COBOL and PL/I).
EXP951.INCL Developer's Kit RPC include and copybook library.
EXP951.LB00 Developer's Kit RPC batch load library.
EXP951.LD00 Developer's Kit RPC CICS load library.
EXP951.MACS Developer's Kit RPC macros.
EXP951.SD00 Developer's Kit RPC side deck library.
EXP951.SRCE Developer's Kit RPC source data set.
EXX951.CERT Certificates to demonstrate SSL/TLS connections.
EXX951.DC00 Readme.
EXX951.LICS License key.
EXX951.JOBS This data set has been thoroughly restructured. It contains installation, installation verification and maintenance jobs of all EntireX subproducts.
EXX951.LOAD Common load library (PDS/E), also includes broker stubs.
EXX951.SD00 Common side deck library.
EXX951.TAR All Java components for z/OS. See Installing EntireX Java Components under z/OS UNIX.
EXX951.SRCE Common source library.
EXX951.ZAPS Common zaps library.
IAFvrs.JOBS IAF-specific jobs library.
IAFvrs.LOAD IAF-specific load library.
IAFvrs.SRCE IAF-specific source library.
MLCvrs.JOBS Sample job library for Software AG's common mainframe license check software.
MLCvrs.LOAD Load library for Software AG's common mainframe license check software.
SSXvrs.LOAD SSX-specific load library.
WAL825.LOAD Adabas limited load library.
WAL825.SRCE Adabas limited source library.
WAL825.JOBS Adabas limited jobs library.

Note:
In the table above, vrs represents the version, release and service pack. Make sure you install the highest patch level available.

Top of page

Installation Jobs

The installation of Software AG products on z/OS is performed by installation jobs. These jobs are either created manually or generated by System Maintenance Aid (SMA).

For each step of the installation procedure, an installation job is generated by SMA according to your specifications in SMA. If you are not using SMA, follow the instructions using your own jobs.

Information on using SMA for the installation process is provided in the System Maintenance Aid Manual.

Top of page

Storage Requirements

For specific storage requirements, see the Software AG Product Delivery Report.

Top of page

Copying the Contents of the Installation Medium to Disk

Installation Steps

Copy the data sets from the supplied installation medium to your disk before you perform the individual installation procedure for each component to be installed.

The way you copy the data sets depends on the installation method and the medium used:

This section explains how to copy all data sets from tape to disk.

Step 1: Copy Data Set COPY.JOB from Tape to Disk

Step 2: Modify hilev.COPY.JOB on Your Disk

Step 3: Submit COPY.JOB

Next Steps

Continue the installation with either Simplified z/OS Installation Method or Installing EntireX Broker under z/OS.

Top of page