SAS/SHARE User's Guide

Other SAS/SHARE Macros Generated by the SHRMACS Macro

A server administrator or an applications programmer must invoke the SHRMACS macro to compile all other macros. You always invoke the SHRMACS macro before any other macro. Use the following syntax:

%SHRMACS(category,<log-info,>
<APPLSYS=app-sys-lib-tab,>
<SASSAML=alt-sys-lib-tab>);

where

category: specifies the category of macros to be compiled (SERVER, USER, OPER, or ALL). See Other SAS/SHARE Macros Generated by the SHRMACS Macro.
log-info: indicates whether descriptive information is written to the SAS log about each macro (NOMSG, MSG, or HELP). The default is MSG.
APPLSYS=: enables you to specify an alternate applications systems library-alias table. For details about specifying the APPLSYS= argument, see Setting Up the Application System (APPLSYS) Macro Library.
SASSAML=: enables you to specify an applications systems library, which is a set of files that specify SAS data libraries and servers. For details about specifying the SASSAML= argument, see Setting Up the Application System (APPLSYS) Macro Library.

Besides compiling the requested macros, the SHRMACS macro also builds the appropriate library-alias table and server-alias table. These tables are used for generating the server name for the PROC SERVER, PROC OPERATE and LIBNAME statements. Other SAS/SHARE Macros Generated by the SHRMACS Macro lists the categories of macros that can be compiled and the implicit macros that are generated, by category.

Other SAS/SHARE Macros Generated by the SHRMACS Macro
%SHRMACS(category) Macros Generated

Server User Operator

[bull] [bull] [bull] SERVERID

[bull] [bull] [bull] LISTLIB

[bull] [bull] [bull] LISTSRV

[bull]

STRTSRV

[bull]
LIBDEF

[bull] SHUTSRV

[bull] OPERATE

[bull] SETSRV

[bull] [bull] [bull] SERVIIDX

[bull] [bull] [bull] LISTSRVI

For example, all of these macro definitions

%SHRMACS(SERVER)

%SHRMACS(USER)

%SHRMACS(OPER)
generate these macros: SERVERID, LISTLIB, LISTSRV, STRTSRV, LISTSRVI, and SERVIIDX.

However, only %SHRMACS(USER) generates the LIBDEF macro, only %SHRMACS(SERVER) generates the STRTSRV macro, and only %SHRMACS(OPER) generates the SHUTSRV, OPERATE, and SETSRV macros.

The SERVER category of macros generates the server-alias table; the OPER category of macros generates the library-alias table; and the USER category of macros generates both the server-alias and the library-alias tables.

Specifying the ALL category of macros generates all of the macros as well as both the server-alias and library-alias tables.

Server Macro Information shows information about the server macros, as listed in the SAS log.

Server Macro Information

LOG Command ===> 1085 %shrmacs (server,msg); *** SAS/SHARE macros are now available *** For further information about SAS/SHARE macros: %SHRMACS(ALL,HELP) - for information on all macros %SHRMACS(USER,HELP) - for information on macros used in user applications %SHRMACS(OPER,HELP) - for information on macros used with PROC OPERATE %SHRMACS(SERVER,HELP) - for information on macros used with PROC SERVER or %macro(HELP) - for information on a specific macro SAS/SHARE macros generated are: SERVERID - translate server alias LISTLIB - list library table LISTSRV - list server alias table STRTSRV - start a server SERVER ALIAS TABLE --- SERVER ALIAS ------- SERVERID ---------------------------- CESERV V6DSERVR COMSERV MYSERV DEVSERV MYSERV GLOSSERV V6DSERVR LIBSERV V6DSERVR MISSERV MYSERV PRDSERV V6DSERVR --------------------------------------------------------------

For more information about the macros that are compiled by SHRMACS, you can specify the HELP keyword, as shown in this example:

%shrmacs(server,help);

HELP lists the syntax, a brief description, and an example for each macro that SHRMACS defines in the SERVER category.

Chapter Contents
Previous
Next
Top of Page

%SHRMACS(category)			Macros Generated
Server	User	Operator	Macros Generated
			SERVERID
			LISTLIB
			LISTSRV
			STRTSRV
			LIBDEF
			SHUTSRV
			OPERATE
			SETSRV
			SERVIIDX
			LISTSRVI