CEMT INQUIRE HOST

Inquire on the status of a virtual host.

Description

CEMT INQUIRE HOST allows you to retrieve information about a particular virtual host in the local CICS region.

Virtual hosts are based on the URIMAP resource definition object. CICS automatically creates virtual hosts for you by grouping all the URIMAP definitions in a CICS region that specify the same host name and the same TCPIPSERVICE into a single data structure. URIMAP definitions that do not specify a TCPIPSERVICE 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.

Syntax

Press the Clear key and type CEMT INQUIRE HOST to display a list of hosts. If you want to change the displayed value, you can tab to the highlighted field and over type it as required.

Sample screen

Figure 1. CEMT INQUIRE HOST screen
  IN HOST
  STATUS:  RESULTS - OVERTYPE TO MODIFY
    Hos(www.example.com  )               Ena                            
    Hos(www.example.org  )               Ena

If you place the cursor against the result and press Enter, CICS displays an expanded format as shown in Figure 2.

Figure 2. The expanded display
 IN HOST
 RESULT - OVERTYPE TO MODIFY
     Host(www.example.com)                                               
     Tcpipservice(TEST2)                                                         
     Enablestatus( Enabled )

CEMT INQUIRE HOST

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE HOST( value)ALLTCPIPSERVICE( value)ENABLEDDISABLED

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 contains URIMAP definitions that specify a host name of www.example.com, CICS creates a virtual host with the same name. A host name in a URIMAP definition can be up to 120 characters.
TCPIPSERVICE (value)
Displays the 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.
ENABLESTATUS
Displays the status of the virtual host. The possible values are:
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.