Step 1 - Compare two environments

This step compares the original IOA environment that is being upgraded with the new IOA environment and creates a report that indicates the differences between these environments. These differences result from customizations performed on these environments. Analyze this report to ensure that all customizations performed in the original environment are implemented in the new environment, before you continue to the next step.

The step can be invoked as many times as required as long as the second step ("Adapt new environment") has not been invoked yet. If the "Compare two environments" step is invoked more than one time, you are asked whether you want to rerun the step or to continue with the results of the previous step invocation. If you choose to rerun the step or the step is invoked for the first time, you are asked to provide the Installation Libraries prefix of the old version production environment, which are pointed to by the ILPREFA ICE parameter. The prefix value must be the same as the IOA PARM data set name of the old environment with the low level qualifier PARM omitted. For example, if the name is IOA.PROD.PARM, you have to specify IOA.PROD. Once the prefix is provided, the reference values are retrieved from the old production to the new environment and the comparison process starts.

The step consists of the following sub-steps:

• Compare installed environments
• Compare user exits
• Compare optional wishes
• Compare IOADSN* members
• Check modified members of OLD Environment
• Compare parameters of two environments
• Compare ALC* members in IOA PARM libraries
• Compare IOA Profile Variables
• Compare Control-D skeletons
• Check CTO rules of OLD Environment
• Application Servers considerations
• Check Mail Destination Table
• Review Control-M JCL library
• Check definitions of Control-M scheduled libraries
• Check security interface
• Compare NLS definitions
• Compare samples from operation libraries

Each sub-step performs a specific comparison or analysis operation. The list of the sub-steps varies according to the products installed.

To complete the "Compare two environments" step each sub-step must be completed (the status of each sub-step must be set to COMPLETE). The sub-steps achieve the COMPLETE status when the comparison between old and new environments or an analysis operation satisfies the Express Upgrade process requirements. Otherwise, a sub-step status is set to '*'. Sub-steps having the '*' status must be reviewed by selecting them.

There are two options to change a sub-step status from '*' to COMPLETE:

• Implement the relevant customizations in the new environment to align them with the old version production environment customizations, and then rerun the "Compare two environments" step. If the customizations are identical to those of the old version production environment, then the sub-step status will be automatically changed to COMPLETE.
• Complete a sub-step by typing the word "CONFIRM" when exiting from a sub-step review screen. In this case you confirm that you understand the meaning of the differences and that the differences are irrelevant or non-critical for your environment.

The REP command can be used to review the entire report produced by all sub-steps of the "Compare two environments" step. The name of the member containing the report is UPGREP1. The member is located in the IOA INSTWORK library.

WARNING: After the comparison step is completed, the OLD and NEW environments must remain "frozen" - do not make any modifications to either of the environments until after the successful completion of the "Complete the upgrade" step.