The OPERATE Procedure

User Management Commands

Displaying Information about a User

You display information about one or more users by using the DISPLAY USER command. The syntax for this command is

DISPLAY USER userid-1 <. . . userid-n>;

DISPLAY USER _ALL_;

You may use the abbreviation DISP or D in place of DISPLAY.

This command displays information about one or more users who are accessing the current server.

If one or more userids are specified, the DISPLAY USER command displays summary information that is followed by detailed information for each user who has one or more libraries assigned.

If the _ALL_ argument is specified, summary information is displayed for other administrators and for all users who have connected and who have been explicitly stopped.

This section contains examples of display command output that contains host-specific SAS-data-lib values. See Specifying a Host-Specific SAS Data Library for a list of SAS data library host-specific examples. For information about specifying a userid, see Specifying a User.

The following example contains two types of librefs: a user libref and a server libref. The user libref is the name by which the user refers to the library. It is provided only as an aid for communicating with the user, if necessary.

The server libref is the name that a server administrator assigns to the library by using one of these methods:

a LIBNAME statement specified before the PROC SERVER statement
a PROC OPERATE ALLOCATE LIBNAME command
a host-dependent external allocation.

A library that is not defined by using these methods does not have a server libref. Therefore, admininistrative commands that subsequently refer to that library must use the host-specific library name instead of, for example, a UNIX pathname. However, a Version 6 server always reports a server-defined libref that is valid for references to libraries in subsequent commands.

DISPLAY USER 15;

         USER ID       STATUS      LIBRARIES
         -----------------------------------
         MIKE(15)      ACTIVE         2

User MIKE(15) is accessing these libraries:

USER LIBREF   SERVER LIBREF    LIBRARY NAME
-------------------------------------------------
USAGE         USAGE           SAS-data-lib
MEM                           SAS-data-lib

User MIKE(15) is accessing these data sets:

USER   SERVER    MEMBER     TYPE       OPEN MODE
LIBREF LIBREF
---------------------------------------------------
USAGE  USAGE     USAGE      CATALOG    UPDATE
USAGE  USAGE     MODULE     DATA       INPUT
MEM              MEMOBY     DATA       INPUT

In this example, MIKE(15) currently has files open in both of the libraries to which he currently has access. If user MIKE(15) had no files opened when the DISPLAY USER command was issued, only the first two parts of the output would be displayed.

The libname that a user refers to as MEM is not server-defined.

Quiescing a User's Access to a Server

You quiesce (gradually terminate) a user's access to a SAS server by using the QUIESCE USER command to deny new user requests for resources. This command moves the user from an active status to a stopped status. The syntax for the QUIESCE USER command is

QUIESCE USER userid-1 <. . . userid-n>;

QUIESCE USER _ALL_;

You may use the abbreviation QUI or Q in place of QUIESCE.

This command quiesces one or more users who are connected to the current server. It quiesces users who currently have files open, that is, those who are currently reading from or writing to files at the time the command is issued. When a quiesced user closes all files in a server library, the server releases that user's access to the library. If the user has no open files in an accessed server library, the server releases that user's access to the library immediately. When the user has released all server libraries, the userid is assigned a stopped status and is disconnected from the server. While a user is quiesced, you can issue the START USER command to change the user's status back to active.

If you issue the QUIESCE USER command that specifies the userid for a user who is not currently connected to the server, the server assigns a stopped status to that userid. A stopped user cannot connect to the server until you issue the START USER command for that userid.

For information about specifying a userid, see Specifying a User.

The _ALL_ argument quiesces all users who are connected to the current server. When _ALL_ is specified, the QUIESCE USER command does not affect the administrator who issues the command. You cannot quiesce yourself even if you specify your userid in the QUIESCE USER command. However, be aware that you can quiesce other server administrators by name. When PROC OPERATE terminates and its server session is quiesced, that administrator is assigned a stopped status.

Re-Starting a Quiesced or a Stopped User

You re-start a user who has been stopped or quiesced by using the START USER command. The syntax for the START USER command is

START USER userid-1 <. . . userid-n>;

START USER _ALL_;

You may use the abbreviation ST in place of START.

This command allows one or more SAS users to access the SAS server. Because users are allowed access to a SAS server by default, this command is necessary only to undo the effect of a previous STOP USER or a QUIESCE USER command.

If the _ALL_ argument is specified, the command re-starts all users who are quiesced or are stopped. For information about specifying a userid, see Specifying a User

When a stopped userid is re-started, that userid becomes unknown to the server.

Terminating a User's Connection to a Server

You immediately terminate a user's connection to a server by using the STOP USER command. The syntax for the STOP USER command is

STOP USER userid-1 <. . . userid-n>;

STOP USER _ALL_;

This command immediately stops one or more users from using the server and disconnects their communication path to the server. If a user who has a stopped status issues a LIBNAME statement to re-access a server library, the request fails.

If you specify the userid of a user who is currently active or quiesced, the server closes library members that the user has open, terminates the user's access to libraries that are accessed through the server, and terminates the user's communication path to the server. If the user is updating a data set when the command is issued, updates may be lost.

For information about specifying a userid, see Specifying a User.

Because users are allowed access to a SAS/SHARE server by default, this command can be useful as a security tool. To stop users who are not currently using the server, specify their userids in the STOP USER command.

If the _ALL_ argument is specified, users who are currently active or quiesced are stopped; however, the administrator who issues the command is not affected. You cannot stop yourself even if you specify your userid in the STOP USER command. However, be aware that you can stop other server administrators.

Chapter Contents
Previous
Next
Top of Page