Completing the Installation

#### Search Results

Search

# Completing the Installation

This document covers the following topics:

- Entries in the Start Menu

- Setting Up Your Products Using the SYSPCI Utility

- Invoking the SYSPCI Utility

- Optional Steps

- Upgrading from Predict Version 4.5 or below

## Entries in the Start Menu

Depending on your selection in the product selection tree, some or all of the following entries have been created in the Windows Start menu:

- Under All Programs > Software AG > Tools:

  Predict n.n

- All Programs > Software AG > Documentation

where n.n stands for the current version number. The Start menu group name (by default, this is "Software AG") can be changed during the installation.

## Setting Up Your Products Using the SYSPCI Utility

After you have installed your product, you need to set up a number of files, parameters and individual settings depending on your environment. These are described below. To set them up, you use the SYSPCI utility. For detailed information on this utility, see SYSPCI Utility - Product Configuration and Initialization in Natural's Tools and Utilities documentation.

Predict requires the following Adabas system file:

`FDIC`, where the logical file number (`LFILE`) is 253.

The database ID and file number of the new or existing file that you specify using the SYSPCI utility are entered into the parameter files `PRDPARM` and `NATPARM`. If applicable, database ID and file number will be entered into further parameter files like `NDVPARM`, `NSCPARM` and `NBSPARM`.

For the Predict Coordinator functions Load or Import the following Adabas system file is required:

`COORDINATOR_FDIC`, where `DBID` and `FNR` will be stored on the `FDIC` by the SYSPCI utility.

The required Adabas files can either be local or remote.

- Remote Access
  If the file is located in a remote database, Entire Net-Work must be active and the database must be accessible.

- Existing Local File
  Before you start the SYSPCI utility, make sure that the Adabas database containing the required files is active. With this version, you can continue to use your existing files. No migration of data from the previous version to the current version is necessary.

- New File
  Before you start the SYSPCI utility, make sure that the Adabas database which will contain the required files is active. The SYSPCI utility will load and initialize these files. This should be also done if another file is required for your product.

Before you create new files with the SYSPCI utility, make sure that the ASSO and DATA sizes of your Adabas database are appropriate for these files. It is therefore recommended that you check the Adabas .fdu files in the <install-dir>/<product>/INSTALL/<product-code> directory for the used sizes. If required, change your database setup so that the files can be created.

For Predict, the SYSPCI utility offers the following optional functions:

Option | Description
--- | ---
Convert FDIC data | If marked the Data on the Predict System File are converted to 8.5 Format, see Convert the Data on the Predict System File to 8.5 Format in Optional Steps below.
Load FDIC description | If marked, the Predict Description of the Predict System File is loaded.
Load example data | If marked, the Predict example data is loaded.

## Invoking the SYSPCI Utility

In order to invoke the SYSPCI utility, you must first invoke Natural. You can then invoke the SYSPCI utility using the command line.

To invoke the SYSPCI utility

1. From the Windows Start menu, choose All Programs > Software AG > Tools > Natural n.n to invoke Natural.

2. From the View menu, choose Command Line to switch on the display of the command line.

3. Enter the following command in the command line:

       SYSPCI

   For more information, see SYSPCI Utility - Product Configuration and Initialization in Natural's Tools and Utilities documentation.

## Optional Steps

SYSPCI may perform the optional steps Initialize product, Assign Coord. FDIC, Load FDIC description or Load example data.

If the optional installation steps are not performed by SYSPCI or if Natural Security (NSC) is installed, perform the following steps:

- Convert the Data on the Predict System File to 8.6 Format

- Update the Predict Metadata

- Define the Coordinator FDIC in the New SYSDIC Manually

- Define the Predict Libraries to Natural Security Manually

- Load the Predict Description of the Predict System File

- Load the Predict Example Data

- Adapt the Text Modules in Library SYSEXT

Perform the steps in the given order unless mentioned otherwise. Please observe the notes where available.

### Convert the Data on the Predict System File to 8.6 Format

Note
This step is not required for first-time installations.

This step must be performed manually by starting Natural with `PARM=PRDPARM`.

This step converts Predict Version 4.6, Version 8.2, Version 8.3, Version 8.4, or Version 8.5 data to Version 8.6 format. If the data on your Predict system file already is in Version 8.6 format, a corresponding message is returned.

Note
We recommend you save your Predict system file in Version 4.6, Version 8.2, Version 8.3, Version 8.4, or Version 8.5 format before proceeding with the steps below.

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

- Log on to the library SYSDICCO

- Call the Function Main Menu by entering MENU at the NEXT prompt

- Call the function C > Version 4.6 (or Version 8.2, Version 8.3, Version 8.4, or Version 8.5) data

When you execute this step in batch mode, the CMSYNIN file should contain the following:

    LOGON SYSDICCO
    MENU
    CONVERT VERSION86
    FIN

Now the data is in Version 8.6 format.

### Update the Predict Metadata

This step is optional.

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

    LOGON SYSDIC
    MENU
    NEWGEN1
    FIN

### Define the Coordinator FDIC in the New SYSDIC Manually

Note
This step is not required for upgrade installations. This step can also be performed by SYSPCI if the options Initialize product or Assign Coord. FDIC have been selected.

This step must be performed manually by starting Natural with `PARM=PRDPARM`.

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

- Log on to the library SYSDIC

- Call the Function Main Menu by entering MENU at the NEXT prompt

- Call the function Defaults > Coordinator Defaults

- Specify the parameters Coordinator FDIC DBID/FNR with the file number and database ID of the Coordinator FDIC.

### Define the Predict Libraries to Natural Security Manually

This step must be performed manually by starting Natural with `PARM=PRDPARM`.

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

SYSDIC, SYSDICBE, SYSDICCO, SYSDICH and SYSDICMA.

### Load the Predict Description of the Predict System File

Note
This step can also be performed by SYSPCI if the option Load FDIC description has been selected.

This step is optional.

To load the Predict description of the Predict system file, enter:

    setenv WRKF1
    <install-dir>/Predict/INSTALL/data/ALLDATA.DAT

Start Natural with `PARM=PRDPARM`.

When you execute this step in batch mode, the CMSYNIN file should contain the following:

    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 in batch mode:

    LOGON SYSDIC
    MENU
    SPECIAL REFRESH
    FIN

### Load the Predict Example Data

Note
This step can also be performed by SYSPCI if the option Load example data has been selected.

This step is optional.

To load the Predict example data, enter:

    setenv WRKF1
    <install-dir>/Predict/INSTALL/data/ALLDEMO.DAT

Start Natural with `PARM=PRDPARM`.

When you execute this step in batch mode, the CMSYNIN file should contain the following:

    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 in batch mode:

    LOGON SYSDIC
    MENU
    SPECIAL REFRESH
    FIN

### Adapt the Text Modules in Library SYSEXT

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.

## Upgrading from Predict Version 4.5 or below

| Warning: For users of Predict Version 4.5 or below: If you are using Predict Version 4.5 or below and want to migrate to a newer version, it is necessary to perform the following actions in the order given below.

1. Perform a Predict Unload operation using Predict Version 4.5 or below.

   The following data need to be unloaded:

   - If user-defined object-types (UDEs) exist, then their metadata must be unloaded using `UNLOAD METADATA <UDE-name> <parameters>`. Specify the unload parameters that meet your requirements.

   - All documented objects using `UNLOAD OBJECTTYPE ALL CODE=Y,INTERNAL-ID=Y <parameters>`. Specify the unload parameters that meet your requirements.

   - If XRef data are to be transfered to the new FDIC, then they must be unloaded using `UNLOAD OBJECTTYPE XR <parameters>`. Specify the unload parameters that meet your requirements.

   - If user-defined Retrieval Models exist, then these must be unloaded using `UNLOAD RETRIEVALMODEL <object type> <parameters>`. Specify the unload parameters that meet your requirements.

2. Install Predict Version 8.6.

3. Perform a Predict Load operation using Predict Version 8.6.

### On this page

- Entries in the Start Menu
- Setting Up Your Products Using the SYSPCI Utility
- Invoking the SYSPCI Utility
- Optional Steps
- Upgrading from Predict Version 4.5 or below