server task terminate session
Terminates a user session using a session ID.
Requires authentication (administrator ID and password) to use.
server task instance-webseald-host terminate session session_id
Options
- instance-webseald-host
- Full server name of the installed WebSEAL instance. Specify in the exact format as displayed in the output of the server list command.
The instance_name specifies the configured name of the WebSEAL instance. The webseald designation indicates the WebSEAL service performs the command task. The host_name is 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.
Then, the full WebSEAL server name is default-webseald-abc.ibm.com.
If an additional WebSEAL instance is configured and named web2, the full WebSEAL server name is web2-webseald-abc.ibm.com.
- 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/host_name-instance_name/ object. For example, the sec_master administrative user is given this permission by default. This command is available only when WebSEAL is installed.
Return codes
- 0
- The command completed successfully. For WebSEAL server task commands, the return code is 0 when 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 ISAM error messages by decimal or hexadecimal codes.
For information about the WebSEAL server tasks and junction points, see the Administering topics in the IBM Knowledge Center.
Example
The following exampleterminates a specific session on the default-webseald-cruz WebSEAL server:pdadmin> server task default-webseald-cruz terminate session 6fc3187a-ea1c-11d7-8f4e-09267e38aa77
See also
server task refresh all_sessions
server task terminate all_sessionsParent topic: pdadmin commands