First-Time Installation

#### Search Results

Search

# First-Time Installation

This document covers the following topics:

- Before You Begin Installing under z/OS with SMA

- Installation Steps

## Before You Begin Installing under z/OS with SMA

1. Set the SMA switches as shown in the table below.

   SMA Switch |
   --- | ---
   SMA Switch PRD-FIRST-INSTALL | Y
   PRD-CONVERSION | N

   Note
   Leaving a field blank is the equivalent of entering N.

2. Copy the installation medium contents to disk. The steps required depend on your operating system environment and are described in the section Copying the Installation Medium Contents to Disk for z/OS.

3. Perform the following installation steps.

## Installation Steps

Perform the following steps in the order given:

- Step 1: Prepare, Convert, Assemble and Link the License File

- Step 2 - Load Predict System File

- Step 3 - Load Coordinator FDIC

- Step 4 - Delete Modules No Longer Used

- Step 5 - Relink your Natural Nucleus

- Step 6 - Load Predict System Programs

- Step 7 - Define the Predict Libraries to Natural Security manually

- Step 8 - Copy DDMs from Natural system file FNAT to the Predict system file FDIC

- Step 9 - Define Coordinator FDIC in new SYSDIC

- Step 10 - Adapt the Text Modules in Library SYSEXT

- Step 11 - Load the Predict Description of the Predict System File

- Step 12 - Load the Predict Example Data

### Step 1: Prepare, Convert, Assemble and Link the License File

#### (Job I007, Steps 0601, 0602, 0604)

You have to install a valid Entire Operations license file. For detailed information on license files and product licensing, see the Software AG Mainframe Product Licensing documentation.

1. Copy the license file from the installation medium to disk, or transfer it from the PC as described under Transferring a Licence File from PC to z/OS Host Using FTP in the Software AG Mainframe Product Licensing documentation.

2. Step 0601 - Check the license file (here named) `PRDLIC`. This job executes the CHECK function of the LICUTIL license utility.

3. Step 0602 - Convert the license file into an assembler source. This job executes the MAKE function of the LICUTIL license utility.

4. Step 0604 - Assemble and link the assembler source to generate load module `PRDLIC`. This module is then linked to the nucleus in Job I060 (see below).

The functions and option settings provided by LICUTIL are described under Using the License Utility LICUTIL in the Software AG Mainframe Product Licensing documentation.

### Step 2 - Load Predict System File

(Job I050, Step 0600)

Load the Predict 8. system file contained in data set/file PRDvrs.SYSF using the Adabas utility ADALOD.

### Step 3 - Load Coordinator FDIC

(Job I050, Step 0601)

Load the Coordinator FDIC contained in data set/file PRDvrs.SYSF using the Adabas utility ADALOD.

### Step 4 - Delete Modules No Longer Used

(Job I051, Steps 0613 - 0616)

Predict modules from earlier versions which were copied to libraries different from the original libraries after installation must be deleted from these libraries using the Natural utility INPL with the data sets PRDvrs.DE44, PRDvrs.DE45, PRDvrs.DE46, PRDvrs.DE82, PRDvrs.DE83, PRDvrs.DE84 and PRDvrs.DE85 as input.

### Step 5 - Relink your Natural Nucleus

(Job I060 for Batch Mode or Job I080 for Online Operation)

Predict requires the following Natural parameter settings:

Note
The size parameters are recommendations only. It may be necessary to adapt these values to your particular environment.

- `DATSIZE` must be at least 250.

- `SSIZE=64`

- `RI=OFF`

- If you are using work files, you are recommended to specify WORK=(...,OPEN=ACC) instead of using the Natural default

- If Predict XRef data is to be used: set the `XREF` parameter to `ON` or `FORCE`.

- If you want to use the feature Search usage in Web Services, Natural must be started with the following parameter settings:

      XML=(ON,RDOC=ON,PARSE=ON) CP=IBM01140 CFICU=ON

Adapt your Natural parameter module with the new parameters and assemble it.

Link the new Natural parameter module and the following modules to the environment-independent part of the Natural nucleus:

#### Natural

Operating System | Module | Load Library
--- | --- | ---
z/OS | PRDXREF | NATvrs.LOAD

For details, see the Natural Installation for Mainframes documentation and the Natural Operations for Mainframes documentation.

### Step 6 - Load Predict System Programs

(Job I061, Step 0600)

The Predict system programs are contained in the data set/file PRDvrs.INPL and are loaded to your Natural system file (FNAT) using the Natural utility INPL. This data set/file also contains the Predict error messages.

### Step 7 - Define the Predict Libraries to Natural Security manually

If Natural Security is installed, define the following libraries to Natural Security:

SYSDIC, SYSDICBE, SYSDICCO, SYSDICH, SYSDICMA

This step must be performed manually.

Note
If you specify a startup transaction on the Natural Security Modify Library screen, then specify `N` for Batch execution.

### Step 8 - Copy DDMs from Natural system file FNAT to the Predict system file FDIC

(Job I200, Step 0600)

If you were previously using Natural without Predict, the DDMs were stored on the Natural system file. With Predict, the DDMs are stored on the Predict system file.

### Step 9 - Define Coordinator FDIC in new SYSDIC

(Job I200, Step 0601)

To set up your environment so you can use the Coordinator, start a Predict 8.6 online session (using the newly installed FDIC file) or perform the following batch mode commands:

    LOGON SYSDIC
    MENU
    ASSIGN
    COORDINATOR DBNR=n FNR=n UTILITY-CLEAR=Y
    FIN

Where n represents the DBNR and FNR of the Coordinator FDIC you specified in Step 2.

### Step 10 - Adapt the Text Modules in Library SYSEXT

(Job I200, Step 0608)

This step is optional.

Start a Predict 8.6 online session or perform the following batch mode commands:

    LOGON SYSDIC
    MENU
    NEWEXGEN
    FIN

Note:
If you execute this function in batch, please ensure that you have set Batch execution to N (No) on the Natural Security Modify Library screen of library SYSEXT.

### Step 11 - Load the Predict Description of the Predict System File

(Job I500, Step 0605)

This step is optional. Please note that, due to the number of checks performed by the Coordinator when loading this data set/file, this step may take a long time.

The installation data set/file PRDvrs.DATA contains a description of the Predict 8.6 system file in Migrate 8.6 format. Load the description into the Predict system file with the Predict Coordinator.

Note
No support is guaranteed if you manipulate the Predict system file with your own programs.

The following syntax is used:

    LOGON SYSDICBE
    MENU
    LOAD OBJECTTYPE ALL,REPLACE=Y,ADA=N
    FIN

If a previous import operation with the Coordinator terminated abnormally for any reason, the Coordinator FDIC is locked and a corresponding message is given. Enter the following commands to clear the Coordinator FDIC:

    LOGON SYSDIC
    MENU
    SPECIAL REFRESH
    FIN

### Step 12 - Load the Predict Example Data

(Job I500, Step 0606)

This step is optional. Please note that, due to the number of checks performed by the Coordinator when loading this data set/file, this step may take a long time.

The installation data set/file PRDvrs.DEMO contains the example data in Migrate 8.6 format. Load the description into the Predict system file with the Predict Coordinator. The following syntax is used:

    LOGON SYSDICBE
    MENU
    LOAD OBJECTTYPE ALL,REPLACE=Y,ADA=N
    FIN

If a previous import operation with the Coordinator terminated abnormally for any reason, the Coordinator FDIC is locked and a corresponding message is returned. Enter the following commands to clear the Coordinator FDIC:

    LOGON SYSDIC
    MENU
    SPECIAL REFRESH
    FIN