Change of version

For openFT there is no update installation in the conventional sense but only the possibility to perform a new installation. It is therefore important to back up the configuration data.

Below you will find step-by-step instruction on the procedure for changing version.

1. Use the tools available in openFT to transfer the files of a new openFT version from the product CD to the z/OS computer, see section “Transferring files from CD to the z/OS computer and unpacking them”.

2. Use the NSTATUS command to check whether requests are still present in the request queue.
   If necessary, empty the request queue (<openft qualifier>.<inst>.SYSRQF) before shutting down the old version of openFT since it is not possible to take the request queue over into the new version.

3. Shut down openFT using the FTSTOP command.

4. Back up the configuration data listed below as follows (you do not need to back up other files created by openFT because openFT recreates these files):

   • Use FTSHWOPT to back up the operating parameter settings. These are the entries in the data set <openft qualifier>.<inst>.SYSOPF.

     Example

     The output from the FTSHWOPT command is converted to the correct format using LAYOUT=*ZOS-PROC and redirected to a file with the name OPTZOS.CLIST.

     READY
     FREE DDNAME(SYSPRINT)
     READY
     ALLOC DSNAME(OPTZOS.CLIST) DDNAME(SYSPRINT) NEW KEEP DSORG(PS)
           RECFM(F,B) LRECL(80)
     READY
     FTSHWOPT OUTPUT=*STDOUT(LAYOUT=*ZOS-PROC)
     READY
     FREE DDNAME(SYSPRINT)
     

   • Use FTSHWPTN to back up the partner list entries.
     These are the entries in the data set <openft qualifier>.<inst>.SYSPTF.

     Example:

     The output from the FTSHWPTN command is converted to the correct format using LAYOUT=*ZOS-PROC and redirected to a file with the name PARTZOS.CLIST.

     READY
     FREE DDNAME(SYSPRINT)
     READY
     ALLOC DSNAME(PARTZOS.CLIST) DDNAME(SYSPRINT) NEW KEEP DSORG(PS)
           RECFM(F,B) LRECL(80)
     READY
     FTSHWPTN OUTPUT=*STDOUT(LAYOUT=*ZOS-PROC)
     READY
     FREE DDNAME(SYSPRINT)
     

   • If you are using FTAC: Use FTEXPENV to back up the FTAC environment. These are the entries in the data set <openft qualifier>.<inst>.SYSFSA.

     FTEXPENV FTAC.SAVE

   • Optionally: Use FTSHWLOG to back up the log file.
     These are the entries in the data set <openft qualifier>.<inst>.SYSLOG.

     FTSHWLOG SELECT=*ALL,NUMBER=*ALL,INF=*ALL,OUTPUT=*STDOUT(*CSV)

   • Use the tools available in z/OS to back up the FT parameter library together with all its elements (data set <openft qualifier>.<inst>.PARM)

5. Use the TSO command FJGENPAR to output the installation parameters of the previous environment.

6. Fully shut down openFT:

   • Use the FTTERM command to terminate the started openFT job

   or

   • Terminate the started openFT task.

7. Uninstall openFT:

   • If the new version is to be installed under the same ID and with the same instance name as the old version then delete the openFT libraries and files belonging to the old version.

Changing to version 12.1

1. Install openFT version 12.1 and all the required components (see section “Installation of openFT”).

2. Use the FJGEN procedure to set up a new openFT instance and set the openFT installation parameters (see section “Setting openFT installation parameters with FJGEN”).

3. Adapt the FT parameter library:

   FJGEN recreates the FT parameter library. The library elements that are still required must be taken over from the old version. For a description of the structure of the FT parameter library and a detailed description of the library elements, see section “Settingup the FT parameter library”.

   Proceed as follows:

   • Prepare the OPFT subsystem (see Providing the OPFT subsystem).

   • Set up openFT as a job or started task (see openFT as a job or started task).

   • Load and start the openFT load module (see Loading and starting the openFT loadmodule).

4. Import the following configuration data from the old version:

   • Operating parameter settings using the TSO command EXEC:

     EXEC OPTZOS

   • Partner list entries using the TSO command EXEC:

     EXEC PARTZOS

   • FTAC environment via FTIMPENV:

     FTIMPENV FTAC.SAVE

5. Start openFT (see Activating, deactivating and terminating openFT).