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
- 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.
- Start the CICS DA Version 5.3 server. When you start the
CICS DA server, the V5.2 model is used.
- 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.