Completing the Installation

This document covers the following topics:


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.4 Format, see Convert the Data on the Predict System File to 8.4 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.

Start of instruction setTo 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:

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.4 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 or Version 8.3 data to Version 8.4 format. If the data on your Predict system file already is in Version 8.4 format, a corresponding message is returned.

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

To set up your environment so you can use the Coordinator, start a Predict 8.4 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 or Version 8.3) data

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

LOGON SYSDICCO 
MENU
CONVERT VERSION84 
FIN

Now the data is in Version 8.4 format.

Update the Predict Metadata

This step is optional.

Start a Predict 8.4 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.4 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.4 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.4.

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