INQUIRE HOST

Retrieve information about virtual hosts in the local system.

Read syntax diagramSkip visual syntax diagramINQUIRE 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.
[[ Contents Previous Page | Next Page Index ]]