The MIGRATE Procedure

Using the SLIBREF= Option

The SLIBREF= option is required if the source library contains catalogs and the processing invokes CEDA on the target session. In general, CEDA is invoked when you migrate from a 32-bit to a 64-bit operating environment, when you migrate to a different family of operating environments, or when you migrate to an environment with an incompatible character encoding.

For SAS 8 files, you can run a test to determine whether CEDA processing will be used by PROC MIGRATE. In the target session, set MSGLEVEL=I and try processing a data set that was created under the source session. Submit something simple like the CONTENTS procedure. Check the SAS log for a message. If CEDA processing was used, then you need the SLIBREF= option.

For SAS 6 files, only use the SLIBREF= option for SAS 6 HP-UX or Solaris libraries that contain catalogs. For more information, see Migrating a SAS 6 Library.

If you are uncertain whether you must specify SLIBREF=, use the PROC MIGRATE Calculator on the SAS Web site at http://support.sas.com/rnd/migration/planning/files/migratecalc/.

For sample code, see Migrating with SLIBREF= across Computers and Migrating with SLIBREF= on the Same Computer.

When to Not Use the SLIBREF= Option

If you are migrating from a SAS 9 release or later (for example, migrating from SAS 9.1.3 to SAS 9.2), then SLIBREF= is not required. Instead, specify the SAS/CONNECT or SAS/SHARE server libref in the IN= argument.
Do not use the SLIBREF= option if the library contains no catalogs.
If the library does contain catalogs, do not use the SLIBREF= option for the following source and target libraries:
- source is 64-bit HP-UX or Solaris and target is 64-bit AIX, HP-UX, or Solaris
- source and target are both 32-bit Windows
- source and target are both z/OS

If you are uncertain whether you must specify SLIBREF=, use the PROC MIGRATE Calculator on the SAS Web site at http://support.sas.com/rnd/migration/planning/files/migratecalc/.

Requirements for the SAS/CONNECT or SAS/SHARE Server

To use the SLIBREF= option, you must have access to a SAS/CONNECT or SAS/SHARE server that is running on the same kind of operating environment as the source library. For example, if the source session is running under UNIX, then the server must be running under UNIX.

If the catalogs were created in SAS 6 or SAS 8, SLIBREF= must be assigned through a SAS 8 server. (Note that this is not the same server that you assign through the IN= argument. If you assign a server through the IN= argument, the IN= server must be SAS 9.)

If you cannot meet these requirements, use the alternate method described in Additional Steps for Unsupported Catalogs.

Restrictions for the SLIBREF= Option

If CATALOG is the only member type in the library and you are using the SLIBREF= option, then omit the IN= argument.

When you use the SLIBREF= option for a SAS 8.2 library, multilabel formats are not supported. If a catalog contains a multilabel format, the format is not created on the target and an error is printed to the log. See SAS Note 20052, which is available from SAS customer support at http://support.sas.com.

Top of Page