SERVINFO Macro

Adds server attributes to the server information table.
Category: None

Syntax

%SERVINFO (two-level-server-name,<RMTVIEW= REMOTE-engine-RMTVIEW=-option> ,
<NETNODE=network-node-name)> ;

Syntax Description

RMTVIEW=
specifies a default value for the REMOTE engine's RMTVIEW= option in the LIBNAME statement. If you specify this parameter, the LIBDEF macro, by default, generates the RMTVIEW=value for any LIBNAME statement that specifies this server. This parameter is overridden by the RMTVIEW= parameter in the SERVLIB and LIBDEF macros.
NETNODE=
specifies a network node name that is represented by the high-level qualifier in a two-level server name. When a two-level server name is specified in a PROC OPERATE or a LIBNAME statement and the high-level qualifier cannot be found as a network node, the server name is treated as the name of a macro variable whose value is the node name. This substitution is useful when the node name is not a valid SAS name. If you specify NETNODE= in the server information table, the first time that it translates an alias for that server ID %SERVERID generates the following code in an application:
%LET high-level-qualifier=network-node;
High-level-qualifier is the high-level qualifier in the server ID that is specified in the positional parameter and network-node is the value of NETNODE=.
If the high-level qualifier in the server ID is also the high-level qualifier in the full network node name, you can omit it from the value of NETNODE= by using a period (.) at the beginning of the NETNODE= value. For example, if the server SHRSERV runs on HP103.DOM2.ACME.COM, you would specify the following:
%servinfo (hp.shrserv,netnode=hp103.dom2.acme.com);
The SERVERID macro generates the following:
%let hp=hp103.dom2.acme.com;

Details

Usually, the SERVINFO macro is used in the member SERVERID in the APPLSYS macro library.
A server information table is created to contain information about the servers at your site. You can use this information in a program, or you can display it. By default, the table contains the following type of information:
  • a default value for the REMOTE engine's RMTVIEW= option in the LIBNAME statement
  • a network node name that is represented by a fully-qualified node name (for example, HP103.DOM2.ACME.COM).
You can also use the server information table to specify other characteristics of a server, its users, or its administrators, such as server access passwords, PROC SERVER statement options, and which release of SAS the server is running under.