server task virtualhost delete
Deletes a virtual host junction.
Requires authentication (administrator ID and password) to use.
server task instance-webseald-host virtualhost delete vhost_label
The server task virtualhost delete command deletes a virtual host junction. A virtual host junction cannot be deleted if a second virtual host junction refers to it through the -g option. An error message is returned at such an attempt.
Options
- instance-webseald-host
- Full server name of the installed WebSEAL server 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 server 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 server 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 server instance is configured and named web2, the full WebSEAL server name is web2-webseald-abc.ibm.com.
- vhost_label
- Label name of the virtual host junction.
Authorization
Users and groups that require access to this command must be given the c (control) permission in the ACL that governs the /WebSEAL/host_name-instance_name/@vhost_label object. For example, the sec_master administrative user is given this permission by default.
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. See "Error messages" in the IBM Knowledge Center. This reference provides a list of the ISAM error messages by decimal or hexadecimal codes.
This command is available only when WebSEAL is installed.
Example
The following example deletes the virtual host junction support-vhost-https from the WebSEAL server abc.ibm.com:pdadmin> server task default-webseald-abc.ibm.com virtualhost delete \ support-vhost-https
See also
server task virtualhost add
server task virtualhost create
server task virtualhost list
server task virtualhost remove
server task virtualhost showParent topic: pdadmin commands