server task terminate session
Terminates a user session by using a session ID.
Requires authentication (administrator ID and password) to use this command.
Syntax
server task instance_name-webseald-host_name terminate session session_id
Options
instance_name-webseald-host_name- Specifies the full server name of the installed WebSEAL instance.
You must specify this full server name in the exact format as displayed
in the output of the server list command.
The
instance_namespecifies the configured name of the WebSEAL instance. Thewebsealddesignation indicates that the WebSEAL service performs the command task. Thehost_nameis the name of the physical computer where the WebSEAL server is installed.For example:- The configured name of a single WebSEAL instance is
default. - The host computer name where the WebSEAL server is installed is
abc.ibm.com.
default-webseald-abc.ibm.com.If an additional WebSEAL instance is configured and named
web2, the full WebSEAL server name isweb2-webseald-abc.ibm.com. - The configured name of a single WebSEAL instance is
session_id- Specifies the ID of a user session.
Authorization
Users and groups that require
access to this command must be given the s (server
administration) permission in the ACL that governs the /WebSEAL/ object.
For example, the sec_master administrative
user is given this permission by default.host_name-instance_name/
Return codes
- 0
- The command completed successfully. Note: For WebSEAL server task commands, the return code is
0when the command is sent to the WebSEAL server without errors. However, even after the command was successfully sent, the WebSEAL server might not be able to successfully complete the command. The WebSEAL server returns an error message. - 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 Verify Access error messages by decimal or hexadecimal codes.
Example
default-webseald-cruz WebSEAL
server: pdadmin> server task default-webseald-cruz terminate
session 6fc3187a-ea1c-11d7-8f4e-09267e38aa77