CEMT SET HOST
Enable or disable a virtual host.
Description
The SET HOST command is used to set the status of a virtual host to enabled or disabled. Disabling a virtual host means that all the URIMAP definitions that make up the virtual host cannot be accessed. When a virtual host is disabled, CICS returns an HTTP response with a 503 (Service Unavailable) status code to Web clients.
When you inquire on an individual URIMAP definition, a special status HDISABLED is returned to indicate that the virtual host is disabled. You do not need to change the disabled status of the URIMAP definitions individually; the SET HOST command can be used to re-enable all the URIMAP definitions that make up the virtual host. However, note that a URIMAP definition with the HDISABLED status cannot be discarded. If you want to discard the definition, it must be disabled individually (using the SET URIMAP command).
Syntax
Options
- (value)
- specifies
the name of a virtual host. The name of each virtual host is taken
from the host name specified in the URIMAP definitions that make up
the virtual host. For example, if your CICS region contained URIMAP
definitions that specified a host name of
www.example.com
, CICS would create a virtual host with the same name. A host name in a URIMAP definition can be up to 120 characters. - ENABLED
- The URIMAP definitions that make up the virtual host can be accessed.
- DISABLED
- The URIMAP definitions that make up the virtual host cannot be accessed.
- TCPIPSERVICE((value)
- The TCPIPSERVICE resource that specifies the inbound port to which this virtual host relates. If you do not specify a value, the virtual host relates to all TCPIPSERVICE resources.