The MIGRATE Procedure

Migrating a Library with Validation Tools

When you run PROC MIGRATE with validation tools, you generate Output Delivery System (ODS) reports that validate a successful migration. The validation tools are located on the SAS Web site at http://support.sas.com/rnd/migration/resources/procmigrate/validtools.html. The validation tools support a basic migration or a migration with the SLIBREF option (which uses RLS).

The validation tools consist of a set of macros and a template of example code. Some of the macros run before the migration to record the expected behavior of PROC MIGRATE. Another group of macros runs after the migration to record the actual behavior. The final group of macros compares expected and actual behavior.

Using the MOVE Option with Validation Tools

If you use the MOVE option with PROC MIGRATE, the validation tools can produce validation output only for the members that were migrated. The MOVE option deletes the source library after it has been moved to the target library. For these reasons, the MOVE option significantly limits the validation tools.

Follow these steps to use the MOVE option with validation tools:

Submit the migrate_macros.sas code in the interactive SAS session to compile the needed macros.
Copy the migrate_template.sas code into the interactive SAS session and edit the three LIBNAME statements for your pathnames.
Submit:
```
%before;
```

Submit:

proc migrate in=lib1 out=lib2 move; 
run;

Then, submit the following code:

%mig_in_lib(lib=lib1, after=y);
%mig_in_lib(lib=lib2);
%mig_indexes(lib=LIB2);  /*must be upper case*/
%mig_check_libs;
%mig_check_source(move=yes);

Note: If a member other than a catalog already exists in the target library, the member is not deleted from the source library and a message is sent to the SAS log. If a catalog already exists in the target library, then no catalogs are deleted from the source library and a message is sent to the SAS log. [cautionend]

Top of Page