This document covers the following topics:
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.
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 MLC135.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 |
---|---|
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 |
---|---|
EXB105.LOAD | Broker-specific load library (PDS/E). |
EXB105.SRCE | Broker-specific source library |
EXP105.EXPL | RPC compressed examples library (COBOL and PL/I). |
EXP105.INCL | RPC include and copybook library. |
EXP105.LB00 | RPC batch load library. |
EXP105.LD00 | RPC CICS load library. |
EXP105.MACS | RPC macros. |
EXP105.SD00 | RPC side deck library. |
EXP105.SRCE | RPC source data set. |
EXX105.CERT | Certificates to demonstrate SSL/TLS connections. |
EXX105.DC00 | Readme. |
EXX105.LICS | License key. |
EXX105.JOBS | This data set has been thoroughly restructured. It contains installation, installation verification and maintenance jobs of all EntireX subproducts. |
EXX105.LOAD | Common load library (PDS/E), also includes broker stubs. |
EXX105.SD00 | Common side deck library. |
EXX105.TAR | All Java components for z/OS. See Installing EntireX Java Components under z/OS UNIX. |
EXX105.SRCE | Common source library. |
EXX105.ZAPS | Common zaps library. |
MLC135.JOBS | Sample job library for Software AG's common mainframe license check software. (*) |
MLC135.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.
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.
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.