This document covers the following topics:
There are two methods for installing EntireX under z/OS:
the new, 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.
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.
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 |
---|---|
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.
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.
For specific storage requirements, see the Software AG Product Delivery Report.
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.
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.
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
.
Execute hilev.COPY.JOB
to copy
single, multiple, or all data sets to your disk.
Continue the installation with either Simplified z/OS Installation Method or Installing EntireX Broker under z/OS.