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 simplified installation method

  • the classic installation method as used in previous versions of EntireX

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.

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 MLC136.LOAD library.

See z/OS Licensing Data Sets.

Installable Components

Installable Components of EntireX Broker

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:

  • Various Base Products for EBCDIC platforms

  • Transport Services for EBCDIC platforms

Code webMethods EntireX Component
EXP EntireX RPC.
EXB EntireX Broker.
EXX Common modules used by all EntireX components.
MLC Software AG's common mainframe license check software.
WAL Adabas Limited Libraries.

The installation medium contains the data sets listed below:

Data Set Name Description
EXB107.LOAD Broker-specific load library (PDS/E).
EXB107.SRCE Broker-specific source library
EXP107.EXPL RPC compressed examples library (COBOL and PL/I).
EXP107.INCL RPC include and copybook library.
EXP107.LB00 RPC batch load library.
EXP107.LD00 RPC CICS load library.
EXP107.MACS RPC macros.
EXP107.SD00 RPC side deck library.
EXP107.SRCE RPC source data set.
EXX107.CERT Certificates to demonstrate SSL/TLS connections.
EXX107.DC00 Readme.
EXX107.LICS License key.
EXX107.JOBS This data set has been thoroughly restructured. It contains installation, installation verification and maintenance jobs of all EntireX subproducts.
EXX107.LOAD Common load library (PDS/E), also includes broker stubs.
EXX107.SD00 Common side deck library.
EXX107.TAR All Java components for z/OS. See Installing EntireX Java Components under z/OS UNIX.
EXX107.SRCE Common source library.
EXX107.ZAPS Common zaps library.
MLC136.JOBS Sample job library for Software AG's common mainframe license check software. (*)
MLC136.LOAD Load library for Software AG's common mainframe license check software. (*)
WAL842.LOAD Adabas limited load library. (*)
WAL842.SRCE Adabas limited source library. (*)
WAL842.JOBS Adabas limited jobs library. (*)

(*) This was the latest version of the MLC and WAL components when this version of EntireX was originally released, and the version with which EntireX was tested. If a higher version of MLC or WAL becomes available at a later time, we recommend you use this.

Installation Jobs

The installation of Software AG products on z/OS is performed by installation jobs. There are three possible scenarios:

  • The jobs are the manually adapted sample jobs in the delivered JOBS data set.

  • The jobs are 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.

  • You are using the simplified installation method. See Simplified z/OS Installation Method.

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

Storage Requirements

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

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:

  • If you use System Maintenance Aid (SMA), refer to the copy job instructions provided in the System Maintenance Aid documentation.

  • If you are not using SMA and want to copy the data sets from CD-ROM, refer to the README.TXT file on the CD-ROM.

  • If you are not using SMA and want to copy the data sets from tape, follow the instructions in this section.

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

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

  • Modify the following sample job according to your requirements:

    //SAGTAPE JOB SAG,CLASS=1,MSGCLASS=X
    //* ---------------------------------
    //COPY EXEC PGM=IEBGENER
    //SYSUT1 DD DSN=COPY.JOB,
    // DISP=(OLD,PASS),
    // UNIT=(CASS,,DEFER),
    // VOL=(,RETAIN,SER=tape-volser),
    // LABEL=(2,SL)
    //SYSUT2 DD DSN=hilev.COPY.JOB,
    // DISP=(NEW,CATLG,DELETE),
    // UNIT=3390,VOL=SER=disk-volser,
    // SPACE=(TRK,(1,1),RLSE),
    // DCB=*.SYSUT1
    //SYSPRINT DD SYSOUT=*
    //SYSIN DD DUMMY
    //

    where:

    tape-volser is the VOLSER of the tape, for example: T12345,
    hilev is a valid high-level qualifier, and
    disk-volser is the VOLSER of the disk.

  • Execute the job to copy the data set COPY.JOB to your disk.

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

  • Modify hilev.COPY.JOB according to your requirements:

    Set EXPDT to a valid expiration date, for example, 99365.

    Set HILEV to a valid high-level qualifier, for example, USERLIB.

    Set LOCATION to a storage location, for example, STORCLAS=ABC or UNIT=3390,VOL=SER=USR123.

Step 3: Submit COPY.JOB

  • Execute hilev.COPY.JOB to copy single, multiple, or all data sets to your disk.

Next Steps

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