CEMT INQUIRE URIMAP

Retrieve information about URIMAP resource definitions.

In the CICS Explorer, the URI maps operations view provides a functional equivalent to this command.

Description

The USAGE attribute of a URIMAP definition determines which other attributes are specified in that URIMAP definition and sometimes determines the meaning of a particular attribute.

The resource signature

You can use this command to display the resource signature fields. You can use these fields to manage resources by capturing details of when the resource was defined, installed, and last changed. For more information, see Auditing resources. The resource signature fields are CHANGEAGENT, CHANGEAGREL, CHANGETIME, CHANGEUSRID, DEFINESOURCE, DEFINETIME, INSTALLAGENT, INSTALLTIME, and INSTALLUSRID. See Summary of the resource signature field values for detailed information about the content of the resource signature fields.

Input

Press the Clear key to clear the screen. You can start this transaction in two ways:
  • Type CEMT INQUIRE URIMAP (or suitable abbreviations for the keywords). The resulting display lists the current status.
  • Type CEMT INQUIRE URIMAP (or suitable abbreviations for the keywords), followed by the attributes that are necessary to limit the range of information that you require. For example, if you enter cemt i ur tcpipservice, the resulting display shows the details of only those URIMAP resource definitions that apply to the selected TCPIPSERVICE definition (which defines a port).
You can tab to the highlighted or blank fields and overtype them with the required values.
ALL
The default.
(value)
The name of the URIMAP definition for which information is requested.

CEMT INQUIRE URIMAP

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE URIMAP ALL( value)SERVERCLIENTPIPELINEATOMJVMSERVERENABLEDDISABLEDHDISABLEDAVAILABLEUNAVAILABLENOTAPPLICANALYZERNOANALYZERHTTPHTTPSHOST( value)PORT( value)PATH( value)TCPIPSERVICE( value)IPRESOLVED( value)HOSTNAMEIPV4HOSTIPV6HOSTUNKNOWNIPV4FAMILYIPV6FAMILYSOCKETCLOSE( value)SOCKPOOLSIZE( value)TRANSACTION( value)CONVERTER( value)PROGRAM( value)PIPELINE( value)WEBSERVICE( value)ATOMSERVICE( value)USERID( value)CERTIFICATE( value)CIPHERS( value)TEMPLATENAME( value)HFSFILE( value)MEDIATYPE( value)CHARACTERSET( value)HOSTCODEPAGE( value)NONETEMPORARYPERMANENTLOCATION( value)INSTALLTIME( date time)INSTALLUSRID( value)BUNDLECREATESPICSDAPIDYNAMICGRPLISTDEFINESOURCE( value)DEFINETIME( date time)CHANGETIME( date time)CHANGEUSRID( value)CREATESPICSDAPICSDBATCHDREPAPIDYNAMICCHANGEAGREL( value)BASICAUTHNOAUTHENTICAPPLICATIONAPPLMAJORVERAPPLMINORVERAPPLMICROVERPLATFORMOPERATION

Displayed fields

ANALYZERSTAT(value)
Displays the analyzer program setting for the URIMAP definition. The possible values are as follows:
ANALYZER
The analyzer associated with the TCPIPSERVICE definition is to be used in processing the HTTP request.
NOANALYZER
The analyzer program is not to be used.
Start of changeAPPLICATION(data-value)End of change
Start of change Displays the application name of the application for which this URIMAP resource is declared as an application entry point. If the URIMAP resource is not declared as an application entry point, APPLICATION displays blanks.End of change
Start of changeAPPLMAJORVER(data-value)End of change
Start of change Displays the major version number of the application. If the URIMAP resource is declared as an application entry point, the major version number of this application is returned. If the URIMAP resource is not declared as an application entry point, APPLMAJORVER returns -1.End of change
Start of changeAPPLMINORVER(data-value)End of change
Start of change Displays the minor version number of the application. If the URIMAP resource is declared as an application entry point, the minor version number of this application is returned. If the URIMAP resource is not declared as an application entry point, APPLMINORVER returns -1.End of change
Start of changeAPPLMICROVER(data-value)End of change
Start of change Displays the micro version number of the application. If the URIMAP resource is declared as an application entry point, the micro version number of this application is returned. If the URIMAP resource is not declared as an application entry point, APPLMICROVER returns -1.End of change
ATOMSERVICE(value)
Displays the 1- to 8-character name of an ATOMSERVICE resource definition for an Atom feed. The ATOMSERVICE resource definition defines an Atom service, feed, collection, or category document, and identifies the Atom configuration file, CICS resource or application program, and XML binding that are used to supply the data for the feed.
AUTHENTICATE(value)
Displays whether to provide authentication information to a web services provider. The possible values are as follows:
BASICAUTH
The web services provider requires HTTP basic authentication. You can supply credentials to the web services requester (a user ID and password) to the global user exit, XWBAUTH, which, if enabled, sends the credentials to the web services provider.
NOAUTHENTIC
The web services provider does not require authentication.
Start of changeAVAILSTATUS(value)End of change
Start of change Displays the availability status of the URIMAP resource as an application entry point for an application deployed on a platform.
AVAILABLE
The URIMAP resource is declared as an application entry point, and the application entry point controls its availability and is available, so the URIMAP resource is available to callers.
UNAVAILABLE
The URIMAP resource is declared as an application entry point, but the application entry point that controls its availability is unavailable, so the URIMAP resource is not available to callers.
NOTAPPLIC
The URIMAP resource is available to callers. Either the URIMAP resource is not declared as an application entry point, or it is declared as an application entry point but the application entry point is disabled or does not control the availability of the URIMAP resource.
End of change
CERTIFICATE(value)
Displays the label of the certificate that is to be used as the SSL client certificate for the HTTP request by CICS as an HTTP client. The certificate label can be up to 32 characters.
CHANGEAGENT(value)
Displays a value that identifies the agent that made the last change to the resource definition. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:
CREATESPI
The resource definition was last changed by an EXEC CICS CREATE command.
CSDAPI
The resource definition was last changed by a CEDA transaction or the programmable interface to DFHEDAP.
CSDBATCH
The resource definition was last changed by a DFHCSDUP job.
DREPAPI
The resource definition was last changed by a CICSPlex SM BAS API command.
DYNAMIC
The resource definition was last changed by a PIPELINE scan.
CHANGEAGREL(value)
Displays the 4-digit number of the CICS release that was running when the resource definition was last changed.
CHANGETIME(date time)
Displays the date and time when the resource definition was last changed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
CHANGEUSRID(value)
Displays the 8-character user ID that ran the change agent.
CHARACTERSET(value)
Displays the name of the character set for the static response. The name of the character set can be up to 40 characters.
CIPHERS(value)

Returns either a 56–character area that contains the list of cipher suites that is used to negotiate with clients during the SSL handshake or the name of the SSL cipher suite specification file, which is a z/OS® UNIX file in the security/ciphers subdirectory of the directory that is specified by the USSCONFIG system initialization parameter. For more information, see SSL cipher suite specification file.

CONVERTER(value)
Displays the 8-character name of a converter program that performs conversion or other processing on the content of the request.
DEFINESOURCE(value)
Displays the source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT option. For details, see Summary of the resource signature field values.
DEFINETIME(date time)
Displays the date and time when the resource was created. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
ENABLESTATUS(value)
Displays the status of the URIMAP definition. The possible values are as follows:
ENABLED
The URIMAP definition can be accessed.
DISABLED
The URIMAP definition cannot be accessed. A URIMAP definition with this status can be deleted.
HDISABLED
The URIMAP definition cannot be accessed because the virtual host of which it forms a part has been disabled. Use CEMT SET HOST to reenable all the URIMAP definitions in the virtual host. A URIMAP definition with this status cannot be deleted.
HFSFILE(value)
Displays the fully qualified name of a UNIX System Services file that will form the static response. The fully qualified file name can be up to 256 characters.
HOST(value)
Displays the host name, IPv4, or IPv6 address of the URL. All IPv4 addresses are displayed as native IPv4 dotted decimal addresses; for example, 1.2.3.4, regardless of the type of address format used. If you are using a URIMAP definition relating to CICS® as an HTTP client, USAGE(CLIENT), and a native IPv4 address or host name is used, the address or host name and port number are displayed; for example, 1.2.3.4:80 or hostname.com:443. If you specify a hostname that is greater than 110 characters in length, port information is not displayed in the HOST option. Use the PORT option to view the port number.
HOSTCODEPAGE(value)
Displays the IBM codepage (EBCDIC) in which the text document that will form the static response is encoded. This value can be up to 10 characters.
HOSTTYPE(value)
Displays the address format of the HOST option. The HOSTTYPE option is available using an expanded query only. The possible values are as follows:
HOSTNAME
The HOST option contains a character host name.
IPV4HOST
The address is an IPv4 address.
IPV6HOST
The address is an IPv6 address.
INSTALLAGENT(value)
Displays a value that identifies the agent that installed the resource. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:
BUNDLE
The resource was installed by a bundle deployment.
CREATESPI
The resource was installed by an EXEC CICS CREATE command.
CSDAPI
The resource was installed by a CEDA transaction or the programmable interface to DFHEDAP.
DYNAMIC
The resource was installed by using a PIPELINE scan.
GRPLIST
The resource was installed by GRPLIST INSTALL.
INSTALLTIME(date time)
Displays the date and time when the resource was installed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
INSTALLUSRID(value)
Displays the 8-character user ID that installed the resource.
IPFAMILY(value)
Displays the address format of the IPRESOLVED option. The IPFAMILY option is available using an expanded query only. Filtering interacts with the IPFAMILY option when you filter using wildcard characters. For example, if the value in IPFAMILY is IPV6FAMILY, you must use the colon character to retrieve an IP address. The possible values are as follows:
IPV4FAMILY
The address is an IPv4 address.
IPV6FAMILY
The address is an IPv6 address.
UNKNOWN
The IPRESOLVED option is not yet in use, or the address cannot be resolved.
IPRESOLVED(value)
Displays the IPv4 or IPv6 address of the host. The IPRESOLVED option is available using an expanded query only. This option is for all types except USAGE(SERVER) and USAGE(JVMSERVER).
LOCATION(value)
Displays a URL to which matching HTTP requests from Web clients are redirected. The URL can be up to 255 characters. Redirection is activated by the setting specified by the REDIRECTTYPE option.
MEDIATYPE(value)
Displays a description of the data content of the static response. The media type can be up to 40 characters.
Start of changeOPERATION(data-value)End of change
Start of change Displays the operation name of the application for which this URIMAP resource is declared as an application entry point. If the URIMAP resource is not declared as an application entry point, OPERATION displays blanks.End of change
PATH(value)
Displays the path component of the URL. The path component can be up to 255 characters.
Start of changePLATFORM(data-value)End of change
Start of change Displays the platform name of the application for which this URIMAP resource is declared as an application entry point. If the URIMAP resource is not declared as an application entry point, PLATFORM displays blanks.End of change
PORT(value)
Displays the numeric port number value used by USAGE(CLIENT) for the connection to the server, in the range 1 - 65535. The port number is also displayed in the HOST option if HOST contains a native IPv4 address or a host name. For USAGE(CLIENT), the PORT attribute always contains the port number that is being used for the communication, even if PORT(NO) is specified on the URIMAP at define time. For USAGE(ATOM), USAGE(SERVER), or USAGE(PIPELINE), the PORT option displays ().
PROGRAM(value)
Displays the 8-character name of the application program that composes a response.
REDIRECTTYPE(value)
Displays the type of redirection for requests that match this URIMAP definition. The URL for redirection is specified by the Location option. The possible values are as follows:
NONE
Requests are not redirected. Any URL specified by the LOCATION option is ignored.
TEMPORARY
Requests are redirected on a temporary basis. The status code used for the response is 302 (Found).
PERMANENT
Requests are redirected permanently. The status code used for the response is 301 (Moved Permanently).
SCHEME(value)
Displays the scheme component of the URL. The possible values are as follows:
HTTP
HTTP without Secure Sockets Layer (SSL)
HTTPS
HTTP with Secure Sockets Layer (SSL)
SOCKETCLOSE(value)
Displays the maximum length of time in seconds that CICS keeps a client HTTP connection open for reuse after the CICS application has finished using it. If the value is 0, CICS does not keep connections open for reuse. A value is only displayed when the URIMAP definition has a usage type of CLIENT. For other usage types, SOCKETCLOSE displays ().
SOCKPOOLSIZE(value)
Displays the number of client HTTP connections that CICS is currently holding in a pool in a dormant state. The connections can be reused by any CICS application that connects as a Web client to the same host and port. A value is only displayed when the URIMAP definition has a usage type of CLIENT. For other usage types, SOCKPOOLSIZE displays ().
TCPIPSERVICE(value)
Displays the 8-character name of the TCPIPSERVICE definition that specifies the inbound port to which this URIMAP definition relates. If this definition is not given, the URIMAP definition relates to all TCPIPSERVICE definitions.
TEMPLATENAME(value)
Displays the name of a CICS document template that is used to form the static response. The template name can be up to 40 characters.
TRANSACTION(value)
Displays the 4-character name of an alias transaction to run the user application that composes a response.
USAGE(value)
Displays the usage for the URIMAP resource.
SERVER
The URIMAP resource is for CICS as an HTTP server. It maps the URL of an incoming HTTP request from a Web client to CICS application resources.
CLIENT
The URIMAP resource is for CICS as an HTTP client. It is used when CICS makes a client request for an HTTP resource on a server.
PIPELINE
The URIMAP resource is for a web service. It specifies the processing that is to be performed on a request by which a client calls a web service in CICS.
ATOM
The URIMAP resource is for an Atom feed. It is used for an incoming request for data that CICS makes available as an Atom feed.
JVMSERVER
The URIMAP resource is for a JVM server. It maps incoming requests for a Java web application to run under a CICS transaction that has appropriate security.
USERID(value)
Displays the 8-character user ID under which the alias transaction is attached.
WEBSERVICE(value)
Displays the name of a web service. This name can be the 1- to 8-character name of a WEBSERVICE resource definition or a name up to 32 characters representing a web service generated by the CICS web services assistant. It defines aspects of the runtime environment for a CICS application program deployed in a web services setting.