Migrating to TXSeries for Multiplatforms V8.2 from an earlier version

The TXSeries for Multiplatforms V8.2 provides utilities to migrate your regions, SFS and PPC Gateway created on earlier versions of TXSeries for Multiplatforms, to TXSeries for Multiplatforms V8.2.

It is recommended that you backup the existing data stored in SFS and also backup the existing region and SFS configurations. You can do this by completing the following steps:

Backup the TXSeries region and data.
1. Backup of TXSeries region configuration
  Use the cicsexport utility to export your existing TXSeries region. This creates an archive file that you can import if you are moving the region to a new system. This will also serve as a backup for region settings if you encounter problems during your migration. Run either of the following command options to export a region to an archive file:
  - On Open systems:
```
# $CICSPATH/bin/cicsexport -r region_name -o archive_file
```
  - On Windows systems:
```
C:\ %CICSPATH%\bin\cicsexport -r region_name -o archive_file
```
    Where, region_name is the name of the region to export and archive_file is the name of the archive file to be created.
Stop all TXSeries processes running on the system and uninstall the existing version of TXSeries for Multiplatforms.
Install TXSeries for Multiplatforms V8.2.
If you are moving the region to a new machine, import TXSeries regions as described.
1. Transfer the archive file created using cicsexport command to a system where TXSeries is installed (using FTP or any other method).
2. Use the cicsimport utility to import the region:
  - On Open systems:
```
# $CICSPATH/bin/cicsimport -r region_name -i archive_file byteorder_specifier
```
  - On Windows systems:
```
C:\ %CICSPATH%\bin\cicsimport -r region_name -i archive_file byteorder_specifier
```
    Where, region_name is the name of the region to import using information in archive_file. It must not be the name of an existing region on the new machine. The archive_file is name of the archive file created when you ran the cicsexport command.
    
    byteorder_specifier indicates whether byte swapping is necessary while importing the region from the archive file. Operating systems like AIX® and HP-UX run on machines that support the Big Endian byte order. Windows and Linux running on Intel machines that support Little Endian byte order. If byte swapping is required because you are migrating between big-endian and little-endian machines, specify -B. If you are migrating from big-endian machine to a big-endian machine or little-endian machine to a little-endian machine and byte swapping is not required, do not specify this option.
Use the cicsmigrate utility to migrate your region to the latest level.
- On Open systems:
  1. Login as root user.
  2. Create the upgrade script as follows:
```
# $CICSPATH/bin/cicsmigrate -g script_name -o log_filename -r region_name
```
    If you are migrating the region to a different platform, specify the -d option with the command. See cicsmigrate - Create migration script.
    If SFS is used as file manager, run:
```
# $CICSPATH/bin/cicsmigrate -g script_name -o log_filename –s
```
    If you have PPC Gateway servers to be migrated, run:
```
# $CICSPATH/bin/cicsmigrate -g script_name -o log_filename –p
```
    Where:
    - script_name is the full path name of the upgrade script.
    - log_filename is the log file that logs information on the migration.
    - -r region_name is the region that needs to be migrated.
    - -s allows the SFS configuration to be migrated.
    - Use –p option to migrate you PPC Gateway server configuration.
  3. Run the upgrade scripts by entering the command:
```
# ksh script_name
```
    Where script_name is the full path name of the upgrade script.
    
    Note: You need to execute the above upgrade scripts as root user.
    
    The SFS configuration has to be migrated before migrating any region.
    
    New SFS and PPC Gateway servers created on TXSeries for Multiplatforms V8.2 on all open systems (including AIX) uses File volumes by default. However, the migrated servers on AIX will continue to use the existing Logical Volumes.
    
    TXSeries for Multiplatforms V8.2 does not use AIX supported subsystem. The upgrade script removes the TXSeries related subsystem entries from the SRC. The Region/SFS Server/PPC Gateway Server entries are maintained internally from this release onwards.
    
    The region would be successfully migrated to the latest version, with the completion of running the script.
- On Windows, run the upgrade script as follows:
```
C:\> %CICSPATH%\bin\cicsmigrate region_name
```
  Where region_name is the region that needs to be migrated. When the script has run, the region would be migrated to the latest version level.
To verify whether it is migrated successfully, check your region's database RD.stanza file. It would have migration level ml18 as a first entry on the file.
Ensure that you do a cold start, for every region on the machine (that you have migrated) by entering the following command:
```
cicscp -v start region region_name StartType=cold
```
To ensure that no errors occurred during the region start, check the appropriate console.number file in the /var/cics_regions/region_name directory. (To determine the appropriate console file, view the region's console.nam file in the same directory.)
You can connect to the region using one of the following methods:
- Using cicslterm (On Open systems):
  Connect to the region using cicslterm 3270 Client.
```
# $CICSPATH/bin/cicslterm –r region_name
```
- Using telnet server:
  For connecting to the region, you need a TN3270 client application.
  - On Open systems:
```
#$CICSPATH/bin/cicsteld –r region_name –P <portnum>
```
  - On Windows systems:
```
C:\> %CICSPATH%\bin\cicsteld –r region_name –P <portnum>
```
  The TN3270 telnet server (cicsteld process) will be listening on the port <portnum>. You can connect to the region using the port from any 3270 client software such as IBM® Personal communication Server.
- Using CICS® Transaction Gateway for Multiplatforms:
  You can configure a CICSIP listener on the region and use CICS Transaction Gateway for Multiplatforms to connect to the region.
Run a CICS transaction such as CEMT or CECI to test the region.
Before running any user applications, follow the instructions applicable to your environment in Performing post-migration tasks.