Retrieve information about virtual hosts in the local system.

INQUIRE HOST
>>-INQUIRE HOST(data-area)--+--------------------+-------------->
'-ENABLESTATUS(cvda)-'
>--+-------------------------+---------------------------------><
'-TCPIPSERVICE(data-area)-'
Conditions: END, ILLOGIC, INVREQ, NOTAUTH, NOTFND
This command is threadsafe.
Description
The INQUIRE HOST command allows
you to retrieve information about a particular virtual host in the
local CICS® region. Virtual hosting in the CICS Internet Guide explains
what virtual hosts are. Virtual hosts are based on the URIMAP resource
definition object. CICS automatically creates virtual
hosts for you, by grouping together into a single data structure all
the URIMAP definitions in a CICS region that specify the same
host name and the same TCPIPSERVICE. URIMAP definitions that specify
no TCPIPSERVICE, and therefore apply to all of them, are added to
all the data structures that specify a matching host name, so these
URIMAP definitions might be part of more than one data structure.
Browsing
You can also browse through all
the virtual hosts that exist in the region, using the browse options
(START, NEXT, and END) on INQUIRE HOST commands. See Browsing resource definitions for
general information about browsing, including syntax, exception conditions,
and examples.
Options
- HOST(data-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 name www.example.com. A host name in
a URIMAP definition can be up to 120 characters.
- ENABLESTATUS(cvda)
- returns
a CVDA value indicating the status of this virtual host. CVDA values
are:
- ENABLED
- The virtual host is enabled.
- DISABLED
- The virtual host is disabled.
The URIMAP definitions that make up the virtual host cannot be accessed
by applications.
- TCPIPSERVICE(data-area)
- returns
the 1- to 8-character name of the TCPIPSERVICE definition that specifies
the inbound port to which this virtual host relates. If this definition
is not given, the virtual host relates to all TCPIPSERVICE definitions.
Conditions
- END
- RESP2
values are:
- 2
- There are no more virtual hosts.
- ILLOGIC
- RESP2
values are:
- 1
- You have issued a START command when a browse of this resource
type is already in progress, or you have issued a NEXT or an END command
when a browse of this resource type is not in progress.
- 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.