What is the ADSO Migration Utility ?

The AMU is a series of programs that provide you with a quick and easy way to move entities between dictionaries, from secondary to primary within one central version, or from test to production across central versions and machines. It fully automates the functions that you are now performing manually, while retaining the logical flow.

• Determine entities to be migrated
• Analyze impact against the target IDD
• Create CA-IDMS compiler syntax to extract and update

What input is required ?

The AMU allows you to select entities at the highest level, thus eliminating the time consuming research and paperwork. To migrate an entire application, you need only specify the ADSA application name; the AMU will determine all of its components. However, if you prefer to select at lower levels, any of the following may be specified:

• Dialog names or masks
• Conventional program names or masks
• Module names or masks
• Map names or masks
• Schema names
• Record names or masks

Can we tailor the AMU to suit our special needs ?

A variety of options is provided for just this purpose.

• Change entity versions
• Change schema/subschema names
• Copy or re-generate load modules
• Suppress migration of selected entity types
• Suppress migration of selected relational data
• Migrate user passwords
• Migrate records with standard IDD or COBOL syntax
• Create your own template and have it replicated for selected entity types

Exactly what components will be migrated ?

The AMU will select all entities that are related to any of your input specifications. For a dialog or program:

• Subschema
• Maps/Panels
• Modules
• Included Modules
• Records
• Elements
• Dictionary Messages
• Edit/Code Tables
• Class/Attributes
• Users
• User-defined Nests
• User-defined Comments
• User-defined Entities

What types of impact analysis is performed ?

Each component is assigned a migration status based upon a comparison of the two dictionaries. The AMU will only migrate new or modified components. For those which have been modified, all affected entities will be examined, and the appropriate delete/add, modify, replace, and/or regenerate syntax will be created

What reports are produced ?

Exclusive of standard error and exception listings, the AMU produces five reports:

• The Migration Component Report By Entity is a pre-update audit trail of all selected entities, including the migration status and explanatory messages as needed.
• The Migration Component Review Report pinpoints entities that should be examined due to errors or inconsistencies.
• The Imbedded Dialog Report lists dialogs imbedded in process code (LINK, TRANSFER, INVOKE) that have been omitted from the migration.
• The Migration Component Cross-Reference Report provides a complete where used listing for all entities.
• The Component Listing By Dialog is our version of the standard ADSO reports.

RTFM