Upgrading the CICS DA model from a previous version

If you have a model that was created by CICS® DA Version 5.2, you must follow these steps to upgrade it to a Version 5.3 model. If you decide not to upgrade the model, any local data in the V5.2 model, such as start policies or tagging, is not transferred to the V5.3 model. Use the following details to guide you through the steps that are required to upgrade a CICS DA Version 5.2 model to a Version 5.3 model.

Before you begin

It is always a good idea to back up your CICS DA model and the configuration files regularly. The configuration files contain pointers to the root model element for the DA model. Any data that you add manually to the model, such as start policies or tagging, is lost if either files get corrupted for any reason. You can run discovery to create a new model, but the new model does not contain any of the tagging or policy data that you previously added. If you do not have a current backup of your CICS DA model, and you have tagging or policy data in your model, then it is suggested that you create a backup before you continue.

The model is stored in the workspace directory that is at the location that is defined in the CPH_USER parameter in the DA environment variables file. The configuration files are stored in the config directory that is at the location that is defined in the CPH_CONFIG parameter in the DA environment variables file. The backup must contain both the directories and their contents.

Procedure

  1. When you complete the configuration steps for the CICS DA V5.2 server, copy your CICS DA V5.2 backup of the workspace and config folders, into the CICS DA V5.3 location that you specified in the environment variables file.
    Important:
    You must ensure that all of the CICS DA V5.2 hidden files and folders are copied across to the CICS DA V5.3 location.
  2. Start the CICS DA Version 5.3 server. When you start the CICS DA server, the V5.2 model is used.
  3. Start the DA client and load the model. When you are happy that the migration completed successfully, you can run a discovery operation. The server discovers all the new 5.3 information and adds it to the model. When you load the model in the client, you see the new details.

What to do next

When the model update is complete, you can continue to use CICS DA.

Note: When a CICS DA Version 5.3 server is used to access a Version 5.2 model, the model is no longer compatible with the Version 5.2 server. If you plan to continue to use both versions of CICS DA server, then you must ensure that the models are stored in different locations.


migrate_model.html | Timestamp icon Last updated: Friday, 11 December 2015