Step 38. Copy definition libraries

1. Compatibility considerations

   Current release library members, such as tables, missions, and rule definitions, have different internal formats than those found in earlier versions.

   Current release products are backward compatible, meaning they can read definition members written in earlier versions. However, products from earlier versions may not be able to read members that were written in the current release.

   When the current release reads a definition member that is in the format of an earlier version, its in-memory representation of the member is converted to the new format. When you exit the screen, you may be prompted to decide whether you want to save the definition member in the current release format, even if you did not modify the member. If you answer "Yes," the member is saved in the current release format.

   WARNING: The member may then be unusable by your earlier version system.

   Because using libraries saved in the current release may make them unusable by earlier versions, copy the old libraries to the current release libraries instead of using earlier version libraries in the current release.

   Note: For additional considerations related to copying definition members and libraries, see the instructions for migrating individual INCONTROL products.

2. Prohibit changes

   Prohibit changes to all IOA and INCONTROL product definition libraries, including those owned by users.

3. Back up definition libraries

   Back up the following current release definition libraries:

   Table 22 Current release definition libraries

   Product	Definition	Suffix	Comments
   IOA	Calendars	CAL	Usually referenced using DD statement DACAL
   Control‑M	Parameter Prompting	PROMP JCLPROMP
   	Tables	SCHEDULE	Also user‑defined tables
   	Master Plan	PLANMSTR
   Control‑D	Print Missions	PRTMIS
   	Restore Missions	RSTMIS
   	Backup Missions	BKPMIS
   	Report Decollating Missions	REPORTS	Also user‑defined report decollating missions
   	Banners	BANNERS	An IOA operational library
   	Printing Parameters	APAPARM ACIFPARM CCIFPARM DJDEPARM OUTPARMS TRANSTO
   	File Transfer Option Parameters	FTOPARM
   Control‑V	Migration Missions	MIGMIS
   Control‑O	Rules	RULES
   	Control‑O GLOBAL variable pool list	PARM	DAGLBLST member
   	Control‑O rule table list	PARM	RULELIST member
   	COSMOS parameters	PARM	COSMOLST member
   	SolveWare	SOLV*	SolveWare was updated. Be sure to reapply local modifications to SolveWare members.
   Control‑M/Analyzer	Balance Missions	BALMIS
   	Rules	RULES
   Control‑M/Tape	Rules Definitions	RULES
   	Pool Definitions	PARM	Default member – $$POOL
   	Vault Definitions	PARM	Default member – $$VAULT
   	Rule Table List	PARM	Default member – RULLIST

4. Back up user‑owned definition libraries

   Back up the current release definition libraries that are owned by users.

5. Copy definition libraries

   Copy the previous version libraries to the current release libraries by using IEBCOPY or ISPF option 3.3. Use the previous table.

   Note: Edit all rule table list members to change, within the member, the library names to the current release rules library name.

6. Copy user‑owned definition libraries

   Copy definition libraries that are owned by users in the version you are now using, to the current release.