 |
Warning: The inplace conversion will result in considerable modifications to the internal structure of your dictionary data. Software AG recommends that, before you execute the following installation steps you back up your Predict system file using the backup procedures usually performed in your environment. |
Please read the following operating system specific information before you start installing Predict.
This document covers the following topics:
Set the SMA switches as shown in the table below.
| SMA Switch | For Migrate from Version 4.6 and beyond |
|---|---|
| PRD-FIRST-INSTALL | N |
| PRD-CONVERSION | Y |
Note:
Leaving a field blank is the equivalent of entering
N.
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
For the conversion from Version 4.6, perform the following Installation Steps and continue.
The following must be considered prior to an upgrade:
A Predict system file converted with Inplace conversion will still contain a number of Adabas fields no longer used in Predict 8.3. These can be ignored.
Predict provides a number of user exits which can be used to customize many Predict functions to meet special needs. Sample user exit routines illustrating the use of user exits and explaining the parameters are delivered with Predict.
All user exit routines from previous Predict versions with the prefix U- together with their parameter data areas will be replaced by new sample routines during the installation.
In addition to user exits, a number of other Predict programs are delivered in source form. During installation, these source programs replace those delivered with the previous Predict version.
The following source programs in the library SYSDIC are replaced:
EXIT MAIN__ MAINM1 MAINM2 MAINM3 PUNCH01
Note:
The program MAIN__ is the equivalent of the former
program MAIN. You are recommended to remove existing old sources
of MAIN.
The following type-dependent user exits are also replaced:
ACM**EX CAT**EX PUR**EX
Note:
The asterisks above represent an object type code, for example
FI or SY.
If you adapted any of these programs to meet special needs at your site, save them to a different library before starting the installation.
All fields in the Predict system file (FDIC) that have been modified since the last version are assigned the keyword SAG-PRD-V83-MOD.
All new fields in Predict 8.3 are assigned the keyword SAG-PRD-V83.
All fields that are no longer used in Predict 8.3 are assigned the keyword SAG-PRD-V83-DEL.
If you have written your own programs which access these fields in the Predict system file, check that these programs are still compatible with these modified fields.
To access Predict data, use API USR3005N.
Predict supplies a large number of online help texts as Natural text members with the prefix H- in the library SYSDIC. These texts can be customized and extended with the special function Maintain Predict Help Texts.
All help texts with the prefix H- are replaced during installation. To prevent user-modified help texts being replaced with new texts supplied by Software AG, rename the prefix H- of modified help texts to T-.
If a help text with the prefix T- exists, this is always used by the Predict help system instead of the standard help text with the prefix H-.
The inplace conversion will result in considerable modifications to the internal structure of your dictionary data. Software AG recommends that, before you execute the following installation steps you back up your Predict system file using the backup procedures usually performed in your environment.
Before starting installation with this method, carefully read the section Conversion in the Predict Administration documentation.
Note:
There are no physical changes in the Predict system file from
Version 4.6 or Version 8.2 to Version 8.3.
Perform the following steps after copying the installation medium contents to disk.
(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 and PRDvrs.DE83 as input.
(Job I060 for Batch Mode, Job I080 for Online Operation)
Predict requires the following Natural parameter settings:
Note:
The size parameters are only recommendations. It may be
necessary to adapt these values to your particular environment.
DATSIZE must be at least 200.
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:
| Operating System | Module | Load Library |
|---|---|---|
| BS2000 | PRDXREF | NATvrs.MOD |
| z/OS | PRDXREF | NATvrs.LOAD |
| z/VSE | PRDXREF | NATvrs.LIBR |
For details see the corresponding Natural Installation for Mainframes documentation and the Natural Operations for Mainframes documentation.
(Job I061, Step 0600)
The Predict system programs are contained in the data set/file PRDvrs.INPL. Load these programs into your Natural system file using the Natural utility INPL. This data set/file also contains the Predict error messages.
(Job I200, Step 0606)
This job converts Predict 4.6 or 8.2 data to Version 8.3 format. If the data on your Predict system file is already in Version 8.3 format, a corresponding message is returned.
Note:
We recommend you save your Predict system file in Version 4.6
or 8.2 format before proceeding with the steps below.
LOGON SYSDICCO MENU CONVERT VERSION83 FIN
Now the data is in Version 8.3 format.
(Job I200, Step 0608)
This step is optional.
Start a Predict 8.3 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.
(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.3 system file in Migrate 8.3 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
(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.3 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
|
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. |
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.
Install Predict Version 8.3.
Perform a Predict Load operation using Predict Version 8.3.