CEMT SET 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).

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.