SAS Institute. The Power to Know

FOCUS AREAS
Step 2

Migration

Execution: Migrate Files

Special Topic: Migrating with SLIBREF= across Computers

In this example, the source and target libraries are on different computers. Because the source library contains catalogs that are incompatible with the current release of SAS, the SLIBREF= option is required. To be certain this method is appropriate for your needs, use the PROC MIGRATE Calculator, which sends you to the correct instructions.

You can assign the source library (except the catalogs) to the IN= argument in one of the following two ways:

This example uses NFS, which is a standard protocol of UNIX operating environments. See the documentation for NFS and for your operating environment. If you are not in a UNIX environment, or if you wish to use a SAS/CONNECT or SAS/SHARE server to access the source library, please see Example 1 for instructions.

The example uses the SLIBREF= argument to access the catalogs in the source library. The SLIBREF= argument must be assigned to a SAS/CONNECT or SAS/SHARE server running in a session of SAS that can access the catalogs. For example, if the source library contains SAS 8.2 catalogs created by 32-bit Solaris, SLIBREF= must be assigned to a SAS 8.2 32-bit Solaris server.

Program

In this example, the source library was created in SAS 8.2. If catalogs were created in SAS 6 or SAS 8.2, SLIBREF= must be assigned through a SAS 8.2 server.

  1. From a session in the current release of SAS, submit the SIGNON command to invoke a SAS/CONNECT server session. Note that because you are working across computers, you might specify a machine name in the server ID: 

    signon v8srv sascmd='my-v8-sas-invocation-command';

  2. Within this remote SAS 8.2 session, assign a libref to the source library that contains the library members to be migrated. Use the RSUBMIT and ENDRSUBMIT commands for SAS/CONNECT: 

    rsubmit;
libname srclib <engine> 'source-library-pathname';
endrsubmit;

  3. In the local (client) session in the current release, assign to the same source library through NFS: 

    libname source <engine> '/nfs/v8machine-name/source-library-pathname';

  4. Assign the same libref to the same source libref as in step 2 (in this example, SRCLIB). But do not assign the libref to a physical location. Instead, specify the SERVER= option with the server ID (in this example, V8SRV) that you assigned in the SIGNON command in step 1: 

    libname srclib <engine> server=v8srv;

  5. Assign the target library: 

    libname target <engine> 'target-library-pathname';

  6. Use PROC MIGRATE with the SLIBREF= option. For the IN= and OUT= options, specify the usual source and target librefs (in this example, SOURCE and TARGET, respectively). Set SLIBREF= to the libref that uses the SERVER= option (in this example, SRCLIB):

    proc migrate in=source out=target slibref=srclib <options>;
run;

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

    proc migrate out=target slibref=srclib <options>;
run;

About RLS

See the SAS online documentation for RLS, which is a feature of SAS/SHARE and SAS/CONNECT software. If you don't have access to SAS/SHARE or SAS/CONNECT software, contact the Customer Interaction Center (phone 1-800-727-0025 or send e-mail to CICenter@sas.com).

If you cannot use RLS, then follow the instructions for migrating to a different operating environment family.

You must have access to a 32-bit Version 8 SAS/CONNECT or SAS/SHARE server in order to specify the SLIBREF= option, which migrates the catalogs. If that is not possible, then use an alternative to PROC MIGRATE.

Migrating with Validation Tools

When you run PROC MIGRATE with validation tools, you generate Output Delivery System (ODS) reports that validate a successful migration. To get more information and download the tools, see see Migrating a Library with Validation Tools. Because you are migrating across machines, you are using RLS and therefore you need to download the following files:

Return to Step 2.