Migrate your configuration to the latest version of TXSeries
Prashanth_Bhat 2700012A22 Visits (2025)
If you are already using TXSeries, and would like to upgrade to the latest version of the product, you will be required to migrate your TXSeries configration. In this blog, we’ll concentrate on the aspects around migrating existing Regions, SFS and PPC gateways to the latest version. More specifically, this blog would cover migration to a new version on the same system.
If you are migrating to a new version on the same system, there is no need to export and then import your region configurations (i.e the use of cicsexport and cicsimport ). On the same vein, migrating the SFS data ( holding TDQ etc ) would also not be required. This is because the de-installation of the product does not remove the /var/cics_regions/ or /var/cics_servers/ folders where the Region, SFS Server or PPC Gateway configurations are available.
Remember to backup your data and your regions, SFS and PPC Gateway configurations before you start migrating rds, before you de-install the older version of TXSeries.
Migrating existing TXSeries configurations is really quite easy. De-install the older version,install the latest version of TXSeries, and just run the following:
On Open Systems:
# cicsmigrate –m –g /tmp
C:\> cicsmigrate –m
This migrates all your Regions, SFS and PPC gateway configurations to the installed version of TXSeries.
Some questions around cicsmigrate are answered here:
Q: So...Why do I have to migrate the TXSeries configurations?
A: TXSeries uses, a set of property files called ‘Stanza files’ or ‘Stanzas’ to store configuration of Regions, SFS and PPC Gateways.
Now, each version of TXSeries adds new features to the product, and this can result as changes in the Stanza files -
- new attributes could be added to the stanza,
- old or unwanted attributes removed,
- there could be changes in the default values, or
- new CICS transaction could have been added.
To uniquely identify these version to version differences, the stanzas are embedded with a code called the Migration Level – a.k.a. ML . The ML is located at the top of each stanza. It includes the word ‘ml’ followed by a number. This number is unique to each TXSeries version.
For instance, TXSeries V7.1 has the Migration Level of 14, as in ‘ml14’
Q: What does this cicsmigrate tool really do?
A:The cicsmigrate tool looks up the stanzas to identify the version where the region, SFS or PPC gateway was originally configured, and makes the relevant changes to move the configuration to the latest ML, (i.e. the latest version).
Q: Does the tool have other options?
A: Yes. It does. These options give you more control – you can migrate each configuration separately.
To migrate a specific Region , use the -r < region_name> option:
# cicsmigrate –r <region_name> –g /tmp
C:\> cicsmigrate -r <region_name>
To migrate SFS Servers configuration only, use the -s option:
# cicsmigrate –s –g /tmp
C:\> cicsmigrate -s
To migrate PPC Gateways only, use the -p option
# cicsmigrate -p –g /tmp
C:\> cicsmigrate -p
As this blog covers migration on the same system, it does not cover migration data, such as TDQ from an old SFS to a new SFS Server. You should be able to continue to use the SFS server after the ML has been updated.