This document covers the following topics:
Transferring a License File from PC to a BS2000 Host Using FTP
Transferring a License File from PC to a BS2000 Host Using FTP
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.
If a license file is supplied as an e-mail attachment, you must transfer the attached license file from the PC to the mainframe using native FTP commands described in this section.
 |
Warning: Using utilities instead of native FTP commands for the license file transfer may corrupt the license key. |
Important:
Make sure to switch to binary transfer and verify that the
resulting data set has file type SAM and RECFORM=V.
To transfer a license file from the PC to a BS2000 host, perform
the following steps:
Save the product license file e-mail attachment as EXX103.xml on your PC's hard disk.
Start an FTP session for communication with the BS2000 host using the following FTP command:
ftp host-name
where host-name is the name of the BS2000 host.
Enter your BS2000 host user ID, password and account number (if relevant).
Switch to binary data mode (the license file must retain its ASCII format during the transfer):
binary
Specify that the file for the license file must be written
with FCBTYPE=SAM and RECFORM=V:
quote file EXX103.LICS,FCBTYPE=SAM,RECFORM=V
Write the license file to the BS2000 host:
put EXX103.xml EXX103.LICS
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.
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 |
|---|---|
| EXX103.JOBS | EntireX Broker jobs and configuration. |
| EXX103.LIB | EntireX Broker components, stubs and examples. |
| EXX103.SYSF | Adabas persistent store FDT. |
| WAL842.MOD | Adabas components required to run EntireX Broker. |
| WAL842.SRC | Adabas components source library. |
| EXP103.JOBS | RPC Server for BS2000 jobs and configuration. |
| EXP103.LIB | RPC Server for BS2000 components. |
| EXP103.CSRV | C server examples library. |
| EXP103.COBS | COBOL server examples library. |
| EXP103.COBC | COBOL client examples library. |
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:
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) |
To copy the procedure COPY.PROC to disk,
call the procedure P.COPYTAPE in the library SRV103.LIB:
/CALL-PROCEDURE (SRV103.LIB,P.COPYTAPE), - / (VSNT=<volser>, DEVT=<tape-device>)
If you use a TAPE-C4 device, you may omit the parameter
DEVT.
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 EntireX Broker under BS2000 and Installing the RPC Server for BS2000.
If a license file is supplied as an e-mail attachment, you must transfer the attached license file from the PC to the mainframe using native FTP commands described in this section.
|
Warning: Using utilities instead of native FTP commands for the license file transfer may corrupt the license key. |
Important:
Make sure to switch to binary transfer and verify that the
resulting data set has file type SAM and RECFORM=V.
To transfer a license file from the PC to a BS2000 host, perform
the following steps:
Save the product license file e-mail attachment as EXX103.xml on your PC's hard disk.
Start an FTP session for communication with the BS2000 host using the following FTP command:
ftp host-name
where host-name is the name of the BS2000 host.
Enter your BS2000 host user ID, password and account number (if relevant).
Switch to binary data mode (the license file must retain its ASCII format during the transfer):
binary
Specify that the file for the license file must be written
with FCBTYPE=SAM and RECFORM=V:
quote file EXX103.LICS,FCBTYPE=SAM,RECFORM=V
Write the license file to the BS2000 host:
put EXX103.xml EXX103.LICS