The OPERATE Procedure

Server Management Commands

Displaying Information about a Server

You display information about a single server by using the DISPLAY SERVER command. The syntax for this command is

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.

Alternatively, you can use the SERVERID= option in the PROC OPERATE statement to identify the default server. The default server is also the current server unless you use the SET SERVER command to identify a different current server. For example, the following statements display information about the default server SHARE1, which is also the current server:

proc operate serverid=share1;
   display server;

Quiescing a Server

You quiesce a server by using the QUIESCE SERVER command, which terminates the server process by gradually releasing libraries and users and by denying new requests to access libraries through the server. That is, it moves the server from an active status to a stopped status. The syntax for the QUIESCE SERVER command is

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

You set the current server by using the SET SERVER command, which is referred to by a subsequent PROC OPERATE command. The syntax for the SET SERVER command is

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

You re-start a server that has been quiesced by using the START SERVER command. The syntax for this command is

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