SAS/SHARE Macros

SERVINFO Macro

Adds server attributes to the server information table.

Category:

None

Syntax
Syntax Description

Syntax

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

Syntax Description

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. Here are the optional arguments to %SERVINFO:

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:

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

Top of Page