INQUIRE HOST
Retrieve information about virtual hosts in the local system.
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. SeeBrowsing 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.