EntireX on all applicable platforms must have a valid license key. If the license key does not match for a component, the component cannot be used. The license is checked during installation and when the component is started.
For EntireX Broker, the license file is checked once daily. If the license file is due to expire in the next 30 days, a warning is issued. This is written to the log file.
Note:
The documentation delivered with this product
covers all components of EntireX on all platforms, including those for which
you may not have a valid license. The inclusion of a component or feature in
this documentation does not imply that this component/feature is available for
your installed version of the product.
Normally the EntireX license key is delivered directly on the installation medium as file EXX101.LICS. This file contains the license information necessary to start EntireX broker. It is no longer necessary to transfer the file to the host file system.
However, if you received the EntireX license key file EXX101.LICS by e-mail or diskette, you need to transfer this file to the host file system, using FTP. You will need:
an FTP client (comes with Windows) and an FTP server on the mainframe, or
an FTP server on Windows and an FTP client on the mainframe.
To transfer license file EXX101.LICS to your mainframe host
Transfer the file EXX101.XML to the host, using FTP.
As the target of the host, use the data set EXX101.LICS provided with the EntireX kit or allocate a new data set on z/OS with the following attributes:
DSORG=PS RECFM=FB BLKSIZE=800 LRECL=80
You must use binary transfer mode to transfer the file EXX101.XML to the host. This ensures that the license key remains unaltered.
Note:
You cannot "cut and paste" the certificate using a 3270 emulator
due to format incompatibilities: the mainframe is an EBCDIC system, whereas the
certificate is an ASCII-formatted binary file.
Ensure that the LICENSE DD card in the broker startup
JCL references data set EXX101.LICS.
open <host> <userid> <password> binary put EXX101.xml '<hlq>.EXX101.LICS' close bye
On UNIX and Windows platforms, the license file is requested during installation and must be provided by the user performing the installation. The Software AG Installer renames this file to "license.xml" and copies it to the EntireX/config directory.
Note:
You cannot change the name or location of the license file. You may update the license file at a later time, but make sure
the name and location are the same.
The EntireX license file EXX101.LICS is delivered on the installation medium. It is referenced in the EntireX Broker startup job control. For this purpose, you can copy the license file to a sublibrary or to a sequential disk file. See Step 2: Install the EntireX License File for detailed information.