General Information

This document covers the following topics:

Distribution Media

All BS2000 components of EntireX are distributed on the supplied mainframe installation medium including the EntireX license certificate. A license certificate can also be sent by e-mail.

Instalation Jobs

The installation of Software AG products on mainframe platforms is performed by installation jobs. These jobs are contained in the delivered files. The System Maintenance Aid (SMA) generates the following jobs:

  • Copy the contents of the installation medium to disk.

Contents of Installation Medium

The installation medium contains the files listed in the table below. The sequence of the files, the file types, the number of library blocks needed and the space each file requires on disk are shown in the Software AG Product Delivery Report, which accompanies the installation medium. During installation, the files are loaded from the installation medium.

File Name Type
EXX811.JOBS EntireX Broker jobs and configuration.
EXX811.LIB EntireX Broker components, stubs and examples.
EXX811.SYSF Adabas persistent store FDT.
WAL826.MOD Adabas components required to run EntireX Broker.
WAL826.SRC Adabas components source library.
EXP811.JOBS RPC Server for BS2000 jobs and configuration.
EXP811.LIB RPC Server for BS2000 components.
EXP811.CSRV C server examples library.
EXP811.COBS COBOL server examples library.
EXP811.COBC COBOL client examples library.

Copying the Contents of the Installation Medium to Disk

If you are not using SMA, use the procedure described below and supply the values specified below.

To copy the data sets from installation medium to disk, perform the following steps:

1. Copy the Library SRVnnn.LIB from Installation Medium to Disk

This step is not necessary if you have already copied the library SRVnnn.LIB from another Software AG installation medium. For more information, refer to the element #READ-ME in this library.

The library SRVnnn.LIB is stored on the installation medium as the sequential file SRVnnn.LIBS containing LMS commands. The current version nnn can be obtained from the Software AG Product Delivery Report. To convert this sequential file into an LMS library, execute the following commands: 

/IMPORT-FILE SUPPORT=*TAPE(FILE-NAME=SRVnnn.LIBS, -
/ VOLUME=<volser>, DEV-TYPE=<tape-device>)
/ADD-FILE-LINK LINK-NAME=EDTSAM, FILE-NAME=SRVnnn.LIBS, -
/ SUPPORT=*TAPE(FILE-SEQ=3), ACC-METH=*BY-CAT, -
/ BUF-LEN=*BY-CAT, REC-FORM=*BY-CAT, REC-SIZE=*BY-CAT
/START-EDT 
@READ '/'
@SYSTEM 'REMOVE-FILE-LINK EDTSAM'
@SYSTEM 'EXPORT-FILE FILE-NAME=SRVnnn.LIBS'
@WRITE 'SRVnnn.LIBS'
@HALT
/ASS-SYSDTA SRVnnn.LIBS
/MOD-JOB-SW ON=1
/START-PROG $LMS
/MOD-JOB-SW OFF=1
/ASS-SYSDTA *PRIMARY
where tape-device is the device type of the installation medium, e.g. TAPE-C4
  volser is the VOLSER of the installation medium (see Software AG Product Delivery Report)

2. Copy the Procedure COPY.PROC from Installation Medium to Disk

To copy the procedure COPY.PROC to disk, call the procedure P.COPYTAPE in the library SRVvrs.LIB: 

/CALL-PROCEDURE  (SRVnnn.LIB,P.COPYTAPE), -
  /   (VSNT=<volser>, DEVT=<tape-device>)

If you use a TAPE-C4 device, you may omit the parameter DEVT.

3. Copy all Product Files from Installation Medium to Disk

To copy all Software AG product files from installation medium to disk, enter the procedure COPY.PROC: 

 /ENTER-PROCEDURE  COPY.PROC, DEVT=<tape-device>

If you use a TAPE-C4 device, you may omit the parameter DEVT. The result of this procedure is written to the file L.REPORT.SRV.

When the files have been copied to disk, continue with the steps described under Installing the EntireX Broker under BS2000 and Installing the RPC Server for BS2000.