Chapter Contents |
Previous |
Next |
The OPERATE Procedure |
Displaying Information about a Server |
DISPLAY SERVER; |
DISPLAY SERVER serverid <(SAPW=password)>; |
DISPLAY SERVER serverid </ SAPW=password>; |
You may use the abbreviation DISP or D in place of DISPLAY.
This command displays summary information about the server identified by the serverid argument. If you do not specify a serverid, this command displays summary information about the current server. For information about specifying a serverid, see Specifying a Server. For information about specifying the SAPW= option, see Specifying a Server-Access Password.
An example of using the DISPLAY SERVER command follows:
proc operate; display server share1;
This command displays information about the server SHARE1.
proc operate serverid=share1; display server;
Quiescing a Server |
QUIESCE SERVER; |
QUIESCE SERVER serverid <(SAPW=password)>; |
QUIESCE SERVER serverid </ SAPW=password>; |
You may use the abbreviation QUI or Q in place of QUIESCE.
This command gradually terminates the server that is identified by the serverid argument. If you do not specify a serverid, this command gradually terminates the current server.
A quiesced server accepts only PROC OPERATE commands. If a user attempts to access server libraries or open SAS files through a quiesced server by using a LIBNAME statement, the attempt fails.
When you quiesce a server, current DATA and PROC steps can continue to access files that are already open but cannot perform any further opens. Subsequent DATA and PROC steps cannot access any server files, and users cannot re-open members that are closed or open other members. After a user has closed all members in a server library, the server releases the library. If this is the only server library that the user has accessed, that user is disconnected from it.
The QUIESCE SERVER command does not quiesce server administrators. When a QUIESCE SERVER command is issued, server administrators who are executing the OPERATE procedure remain connected, and the server continues to accept connections from them. Because the server terminates only after all users are disconnected, a server administrator can keep the server quiesced indefinitely by remaining connected to it. While a server is quiesced, an administrator can issue the START SERVER command to change the status of the server back to active.
For information about specifying a serverid, see Specifying a Server. For information about specifying the SAPW= option, see Specifying a Server-Access Password.
Setting the Current Server |
SET SERVER; |
SET SERVER serverid <(SAPW=password)>; |
SET SERVER serverid </ SAPW=password>; |
The server specified in the SET SERVER command overrides the server that is specified in a previous SET SERVER command. It also overrides the default server that is specified in the SERVERID= option in the PROC OPERATE statement.
If no server is specified, the SET SERVER command re-sets the current server to the default server that is specified in the SERVERID= option in the PROC OPERATE statement. However, if the SERVERID= option was not specified in the PROC OPERATE statement, SET SERVER retains the current server value.
The effect of a SET SERVER command is limited to the current execution of PROC OPERATE.
For information about specifying a serverid, see Specifying a Server. For information about specifying the SAPW= option, see Specifying a Server-Access Password.
In the following example, you use the SET SERVER command to establish the current server. After a server is set as current, you can display information about that current server without specifying the serverid.
proc operate; set server share1; display server;
In the following example, the OPERATE procedure first displays information about the two server libraries identified by LIB1 and LIB2, which are defined to the current server MYSHR. Next, the current server is re-set to SHARE, and information is displayed about library LIBALPHA, which is defined to the server SHARE.
proc operate serverid=share; set server myshr; display library lib1 lib2; set server; display library libalpha;
If you fail to identify the server before you issue a command that acts on the current server, PROC OPERATE issues the following message:
ERROR: PROC OPERATE is not currently set to any server, so this command will be ignored. Use the 'SET SERVER serverid;' command to establish communication with a server.
Re-Starting a Quiesced Server |
START SERVER; |
START SERVER serverid <(SAPW=password)>; |
START SERVER serverid </ SAPW=password>; |
You may use the abbreviation ST in place of START.
This command re-starts a SAS server from a quiesced state only. If the serverid argument is not specified, this command starts the current server.
For information about specifying a serverid, see Specifying a Server. For information about specifying the SAPW= option, see Specifying a Server-Access Password.
You cannot use the START SERVER command to re-start a stopped server; instead, you must execute the SERVER procedure.
Stopping a Server |
You terminate a server immediately by using the STOP SERVER command. The syntax for this command is
STOP SERVER; |
STOP SERVER serverid <(SAPW=password)>; |
STOP SERVER serverid </ SAPW=password>; |
This command immediately terminates the server that is identified by the serverid argument or the current server if no serverid is specified.
If users are currently reading from or writing to members in the server library, the server closes the members. If users are in the process of updating data sets, updates may be lost. The server releases the libraries held by each user and disconnects each user.
For information about specifying a serverid, see Specifying a Server. For information about specifying the SAPW= option, see Specifying a Server-Access Password.
Chapter Contents |
Previous |
Next |
Top of Page |
Copyright 1999 by SAS Institute Inc., Cary, NC, USA. All rights reserved.