server task virtualhost list

The server task virtualhost list command lists all configured virtual host junctions by label name.

Requires authentication (administrator ID and password) to use.

server task instance-webseald-host virtualhost list

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 machine where the WebSEAL server is installed.

For example, if the configured name of a single WebSEAL instance is default, and host machine name where the WebSEAL server is installed is abc.ibm.com, 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.

Authorization

Users and groups that require access to this command must be given the l (list) permission in the ACL that governs the /WebSEAL/host_name-instance_name/@per_vhost_label object. For example, the sec_master administrative user has permission by default.

Return codes

0

The command completed successfully. For WebSEAL server task commands, the return code becomes 0 when the command is sent to the WebSEAL server without errors. Even if the command was successfully sent, the WebSEAL server might not be able to successfully complete the command and can return 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 which provides a list of the ISAM error messages by decimal or hexadecimal codes.

Examples

The following example lists the label names of all virtual host junctions configured on the abc.ibm.com WebSEAL server:

pdadmin> server task default-webseald-abc.ibm.com virtualhost list

Output is similar to:

pubs-vhost-http
sales-vhost-https
support-vhost-http

See also

server task virtualhost add
server task virtualhost create
server task virtualhost delete
server task virtualhost remove
server task virtualhost show

Parent topic: Command reference