server task sms session list

Syntax

server task server_name–host_name sms session list –realm realm_name pattern maximum_return

Options

–realm realm_name

Specifies the 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.

Then,

• 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.

maximum_return

Specifies the maximum number of sessions to return. When there are more matches than designated by this option, the output contains the number of matches.

pattern

Specifies the pattern for returning user names. The pattern can include a combination of wildcard and string constant characters. The pattern is case-sensitive. For example, you can specify *luca* as the pattern to find all users that contain the substring luca within the user name.

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 Verify Identity Access error messages by decimal or hexadecimal codes.

See also

server list
server task sms realm list
server task sms realm show
server task sms replica set show