Version 8.0
 —  Installation under z/OS  —

Introduction

This document covers the following topics:


Installable Components

Installable Components of EntireX Broker

Top of page

Contents of Mainframe Tape

The webMethods EntireX installation tape 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 note on Dropped Functionality in the Release Notes).
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
SSX Software AG Security Extensions
WAL Adabas Limited Libraries

The tape 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
EXBvrs.ERRN Broker error message data set
EXBvrs.INPL Broker INPL data set
EXBvrs.LOAD Broker-specific load library (PDS/E)
EXBvrs.SRCE Broker-specific source library
EXPvrs.EXPL Developer's Kit RPC compressed examples library
EXPvrs.INCL Developer's Kit RPC include and copybook library
EXPvrs.JOBS Developer's Kit RPC jobs and procedures
EXPvrs.LB00 Developer's Kit RPC batch load library
EXPvrs.LD00 Developer's Kit RPC CICS load library
EXPvrs.MACS Developer's Kit RPC macros
EXPvrs.SD00 Developer's Kit RPC side deck library
EXPvrs.SRCE Developer's Kit RPC source data set
EXXvrs.DC00 Readme
EXXvrs.JOBS This data set has been thoroughly restructured. It contains installation and IVP jobs of all EntireX subproducts
EXXvrs.LICS License key
EXXvrs.LOAD Common load library (PDS/E), also includes stubs
EXXvrs.SD00 Common side deck library
EXXvrs.SRCE Common source members
EXXvrs.ZAPS Common zaps library
IAFvrs.JOBS IAF-specific jobs library
IAFvrs.LOAD IAF-specific load library
IAFvrs.SRCE IAF-specific source library
SSXvrs.LOAD SSX-specific load library
WALvrs.LOAD Adabas limited load library
WALvrs.SRCE Adabas limited source library
WALvrs.JOBS Adabas limited jobs library

Note:
In the table above, vrs represents the version, release and system maintenance level. 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, refer to the Report of Tape Creation.

Top of page

Copy the Tape Contents to Disk

Note:
If you are using SMA, please refer to the System Maintenanace Aid Manual, chapter Installing Software AG Products with SMA. If you are not using SMA, please follow the instructions below.

This section explains how to:

The JCL in this data set is then used to copy all data sets from tape to disk. You will then need to perform the individual install procedure for each component.

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

The data set COPY.JOB (label 2) contains the JCL to unload all other existing data sets from tape to disk. To unload COPY.JOB, use the following sample JCL:

//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=<Tnnnnn>),
//            LABEL=(2,SL)
//SYSUT2   DD DSN=<hilev>.COPY.JOB,
//            DISP=(NEW,CATLG,DELETE),
//            UNIT=3390,VOL=SER=<vvvvvv>,
//            SPACE=(TRK,(1,1),RLSE),
//            DCB=*.SYSUT1
//SYSPRINT DD SYSOUT=*
//SYSIN    DD DUMMY
//
where <hilev> is a valid high level qualifier
<Tnnnnn> is the tape number
<vvvvvv> is the desired volser

Step 2: Modify COPY.JOB to Your Local Naming Conventions

There are three parameters to set before you can submit this job:

Step 3: Submit COPY.JOB

Submit COPY.JOB to unload all other data sets from tape to your disk.

Top of page