Step 2 - Adapt new environment

This step performs the following:

• Locks the first step from being invoked by a user.
• Checks that all components of the new environment are down. If some address spaces of the new environment are active a dialog panel with corresponding information will be displayed. To continue the Adaptation step all active address spaces of the new environment must be stopped. Otherwise it will be impossible to continue the Adaptation step.
• Retrieves parameters from the old environment.
• Switches the new environment to Compatibility Mode according to the version of the old environment.
• Copies the following parameter members (if they exist) from the IOA PARM library of the old version production environment to the new environment:

  — CMMPLEX

  — CTMPLEX

  — IOAPLEX

  — ECAPARMx

  — ECAMAPx

  — ECAIPLx

  — IOACPRM

  — IOAKPRM

  — IOASPRM

  — IOAXPRM

  — REMCONF

  — REMTMPLx

  — SECPARM

  — $PROFMOD

  — AUDTPARM

  — MAILDEST

  — IOACMEML

  — TIMEZONE

• Copies members from the IOA PROF library of the old environment to the IOA PROF library of the new environment.
• Adds new members from the Operational Libraries of the New Environment to the Operational Libraries of the old one.
• Checks and corrects IOAGATE Parameters to make sure that the monitor names in the IOA Online Monitor parameter member ilprefa.PARM(IOAXPRM) are the correct names for the New Environment.
• Displays two screens to enable the user to change the following parameters:

  Table 1 INCONTROL parameters

  Component	Parameter			Description
  IOA
  	PROCLIB			MVS started tasks library
  	SITEPROC			Site's procedure library
  	SYSPROCA			SYSPROC site library
  	PROCPRFA			First 3 characters of IOA JCL procedures
  Control-M/Analyzer
  	PROCPRFB			First 3 characters of Control-M/Analyzer JCL procedures
  Control-D
  	PROCPRFD			First 3 characters of Control-D JCL procedures
  Control-M/JCL Verify
  		PROCPRFJ	First 3 characters of Control-M/JCL Verify JCL procedures
  		CLISTNMJ	New CTJXVER CLIST name
  Control-M
  	PROCPRFM			First 3 characters of Control-M JCL procedures
  Control-O
  	PROCPRFO			First 3 characters of Control-O JCL procedures
  Control-M/Restart
  	PROCPRFR			First 3 characters of Control-M/Restart JCL procedures
  Control-M/Tape
  	PROCPRFT			First 3 characters of Control-M/Tape JCL procedures
  Control-V
  	PROCPRFV			First 3 characters of Control-V JCL procedures

Upon the step termination, the new environment is disconnected from its repository data sets and operation libraries. Instead, the new environment will be connected to the repository data sets and operation libraries of the old version production environment. The new environment cannot be activated until the "Switch to new environment" step is completed.

Take the following considerations into account when defining the values of the parameters in the "Adapt the environment" step:

• If the corresponding values of the Three Letter Prefixes and the Site Libraries names are the same for the old and new environments, it is not possible to simultaneously activate the address spaces for the INCONTROL products from both the new and old environments.
• If the corresponding values of the Three Letter Prefixes are the same for the old and new environments, but the Site Libraries names are different, the order of the Site Libraries names, defined by the PROCLIBs JES2 initialization statements, determines which address spaces of which environment is activated upon request.

The "Adapt the environment" step can be invoked in the following cases:

• After a successful completion of the "Compare two environments" step.
• After a successful completion of the "FALLBACK" step.
• After a failure of the "Adapt the environment" step.