SAS/SHARE Macros

SERVLIB Macro

Adds server-library pairs to the library table.

Category:

None

Syntax
Syntax Description

Syntax

%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>);

Syntax Description

The SERVLIB macro adds 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 based on your operating environment. Here are the optional arguments to %SERVLIB:

RMTVIEW=: specifies the value of the REMOTE engine's RMTVIEW= option in the LIBNAME statement that is generated by the LIBDEF macro. You can use the RMTVIEW= parameter in the SERVLIB macro to specify the default value of the RMTVIEW= option for a specific library. This parameter overrides the RMTVIEW= parameter in the SERVINFO macro; but, 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 in %SERVLIB 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 %SERVLIB 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.

Top of Page