SAS/SHARE User's Guide

SERVLIB

Adds server-library pairs to the library table.

%SERVLIB(SAS-library-name, server-name
<RMTVIEW=REMOTE-engine-RMTVIEW=-option>,
<PHYSNAME=physical-name-of-library>,
<SLIBREF=server-libref> ,
<ENGINE=engine-in-user-session> ,
<RENGINE=engine-in-server-session>);

The SERVLIB macro is used to add new libraries to the library table in the APPLSYS macro library in the form SAS-library-name, server-name. How you specify the SAS library name is host-specific. Optional arguments to the SERVLIB macro follow:

RMTVIEW=: specifies the value of the REMOTE engine's RMTVIEW= option in the LIBNAME statement that is generated by the LIBDEF macro. The RMTVIEW= parameter in the SERVLIB macro can be used to specify the default value of this option for a specific library. This parameter overrides the RMTVIEW= parameter in the SERVINFO macro. But, the RMTVIEW= parameter in the SERVLIB macro is overridden by the RMTVIEW=parameter in the LIBDEF macro
PHYSNAME=: specifies the physical name of a library. This parameter is used by the STRTSRV macro to generate a LIBNAME statement in the server session. If this parameter is used and the SLIBREF= parameter is not used, the first positional parameter is assumed to be the server libref. If both PHYSNAME= and SLIBREF= are specified, the first positional parameter is not used for generating the LIBNAME statement. Instead, the first positional parameter can be used as a description of the library that is specified in place of the physical name when the LIBDEF macro is invoked in the application.
SLIBREF=: specifies the library's libref in the server session. This parameter is used by the STRTSRV macro to generate a LIBNAME statement in the server session. If this parameter is used and the PHYSNAME= parameter is not used, the first positional parameter in the SERVLIB macro is assumed to be the physical name of the library. If both PHYSNAME= and SLIBREF= are specified, the first positional parameter is not used for generating the LIBNAME statement. Instead, the first positional parameter can be used as a description of the library that is specified in place of the physical name when the LIBDEF macro is invoked in the application.
ENGINE=: specifies the engine to be used in the user session to access the library. The default is ENGINE=REMOTE. Omit this parameter unless you need to override the engine that is chosen by SAS.
RENGINE=: specifies the engine to be used in the server session to access the library. There is no default for this option. SAS chooses an appropriate engine. Omit this parameter unless you need to override the engine that is chosen by SAS.

For more information about the SERVLIB macro, see Associating SAS Libraries with Server Aliases (SERVLIB) and comments in the APPLSYS macro library.

Chapter Contents
Previous
Next
Top of Page