SET HOST

Description

Use the SET HOST command to set the status of a virtual host to enabled or disabled. Disabling a virtual host means that all the URIMAP resources that make up the virtual host cannot be accessed by applications. When a virtual host is disabled, CICS® returns a HTTP response with a 503 (Service Unavailable) status code to web clients.

When you use the INQUIRE URIMAP command to inquire on an individual URIMAP resource, a special status DISABLEDHOST is returned to indicate that the virtual host is disabled. You do not have to change the disabled status of the URIMAP resources individually; you can use the SET HOST command to re-enable all the URIMAP resources that make up the virtual host.

A URIMAP definition with the DISABLEDHOST status cannot be discarded. If you want to discard the definition, use the SET URIMAP command to disable the resource before discarding it. If the URIMAP resource is part of a CICS bundle, use the SET BUNDLE command.

Options

HOST(data-area)

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 name www.example.com. A host name in a URIMAP definition can be up to 120 characters.

ENABLESTATUS(cvda)

CVDA values are:

ENABLED

The URIMAP definitions that make up the virtual host can be accessed by applications.

DISABLED

The URIMAP definitions that make up the virtual host cannot be accessed by applications.

Conditions

INVREQ

RESP2 values are:

10

The specified host name contains disallowed characters, or is blank.

NOTAUTH

RESP2 values are:

100

The user associated with the issuing task is not authorized to use this command.

NOTFND

RESP2 values are:

5

The virtual host cannot be found.