server task sms session terminate all_sessions
Terminates all user sessions for a specific user.
Syntax
server task server_name–host_name sms session terminate all_sessions user_id –realm realm_name
Options
- –realm realm_name
- Specifies that name of the session management realm.
- server_name–host_name
- Specifies the name of the server or server instance. You must
specify the server name in the exact format as it is shown in the
output of the server list command.
For example, if the configured name of a single WebSEAL server on host example.dallas.ibm.com is default, the server_name would be default-webseald and the host_name would be example.dallas.ibm.com. For this example, the name of the server would be default-webseald-example.dallas.ibm.com.
If multiple server instances are configured on the same computer, for example:- The host is example.dallas.ibm.com.
- The configured name of the WebSEAL server instance is webseal2-webseald.
- The server_name is webseal2-webseald.
- The host_name is example.dallas.ibm.com.
- The name of the server instance is webseal2-webseald-example.dallas.ibm.com.
- user_id
- Specifies the name of the user. Examples of user names are dlucas, sec_master, and "Mary Jones".
Return codes
- 0
- The command completed successfully.
- 1
- The command failed. When a command fails, the pdadmin command
provides a description of the error and an error status code in hexadecimal
format (for example, 0x14c012f2).
See "Error messages" in the IBM Knowledge Center. This reference provides a list of the Security Access Manager error messages by decimal or hexadecimal codes.
Note: This command is available only when the session management
command-line extensions are installed to a hosting authorization server.
Example
The following example terminates
all sessions for the dlucas user in the ibm.com realm
of the default-webseald-cruz WebSEAL server:
pdadmin> server task default-webseald-cruz sms session terminate \
all_sessions dlucas -realm ibm.com