URIMAP 资源

URIMAP 定义是与 HTTP、Atom 订阅源或 Web Service 请求的 URI 相匹配的资源，其提供有关如何处理这些请求的信息。

从 Web 客户机到作为 HTTP 服务器的 CICS 的请求

针对作为 HTTP 服务器的 CICS® 的请求的 URIMAP 定义具有 USAGE 属性 SERVER。 这些 URIMAP 定义与 CICS 期望从 Web 客户机接收的 HTTP 请求的 URL 相匹配，它们定义了 CICS 应如何提供对每个请求的响应。 您可以使用 URIMAP 定义来告诉 CICS:
  • 使用文档模板或 z/OS® UNIX System Services 文件提供对 HTTP 请求的静态响应。
  • 通过使用应用程序来提供对 HTTP 请求的由应用程序生成的响应。

Web 客户机请求可能有资格通过直接连接的用户事务（绕过 Web 连接任务）来进行处理。 有关更多信息，请参阅 HTTP 请求由直接连接的用户事务处理。

有关将 CICS 配置为 HTTP 服务器的信息，请参阅 对作为 HTTP 服务器的 CICS 启用 CICS Web 支持。 有关 HTTP 服务器所需的 CICS 资源的信息，请参阅 将 CICS 的资源定义为 HTTP 服务器。

从 CICS 作为 HTTP 客户机向服务器发出的请求

来自作为 HTTP 客户机的 CICS 的请求的 URIMAP 定义具有 USAGE 属性 CLIENT。 这些 URIMAP 定义指定当充当 Web 客户机的用户应用程序通过 CICS Web Support 向 HTTP 服务器发出请求时使用的 URL。 如果针对此目的设置 URIMAP 定义，那么您不必识别应用程序中的 URL。 还可以选择汇聚供相同应用程序或其他应用程序复用的已打开连接。 有关更多信息，请参阅 将 CICS 的 URIMAP 资源创建为 HTTP 客户机。

从 SOAP 客户机到作为 Web Service 提供程序的 CICS 的请求

对于入站 Web Service 请求，其 URIMAP 定义的 USAGE 属性为 PIPELINE。 这些 URIMAP 定义将入站 Web Service 请求 (即客户机在 CICS中启动 Web Service 的请求) 的 URI 与指定要执行的处理的 PIPELINE 和 WEBSERVICE 资源相关联。

对于使用 CICS Web Service 助手部署的服务提供者，将在扫描拾取目录时自动创建 URIMAP 资源。 在安装了 PIPELINE 资源或者发出了 PERFORM PIPELINE SCAN 命令之后，会执行此扫描操作。 为 CICS 提供信息以将 WEBSERVICE 资源与特定 URI 相关联的 URIMAP 资源是必需资源。 此资源的属性由 pickup 目录中的 Web Service 绑定文件指定。 为 CICS 提供用于将 WSDL 归档文件或 WSDL 文档与特定 URI 相关联的信息的 URIMAP 资源是可选资源，并且是在选取目录中存在 WSDL 文件或 WSDL 归档文件时创建的。

Web Service 概述 包含有关 CICS中的 Web Service 的更多信息。

SOAP 客户机请求可能有资格通过直接连接的用户事务（绕过 Web 连接任务）来进行处理。 有关更多信息，请参阅 HTTP 请求由直接连接的用户事务处理。

从 CICS 作为 Web Service 请求者向 Web Service 提供程序发出的请求

通过使用 INVOKE WEBSERVICE 命令发出的出站 Web Service 请求的 URIMAP 定义是可选定义，其 USAGE 属性为 CLIENT。 例如，可使用 URIMAP 定义来指定在建立使用传输层安全性 (TLS) 的套接字连接时要使用的密码套件或证书标签。 您还可以选择将已打开的连接进行池，以供应用程序进一步 INVOKE WEBSERVICE 命令复用，而不是每次都打开一个新连接。 URIMAP 定义使管理员能够控制与远程 Web Service 的连接：他们可根据需要更改其 URI，或者启用和禁用 URIMAP 以允许或禁止连接。

对于服务请求者， CICS 不会在安装 PIPELINE 资源时或由于 PERFORM PIPELINE SCAN 命令而自动创建任何 URIMAP 资源。

从 Web 客户机到 Java Web 应用程序的请求

Java™ Web 应用程序的 URIMAP 定义的 USAGE 属性为 JVMSERVER。 这些 URIMAP 定义与从 Web 客户机向正在 JVM 服务器中运行的 servlet 或 JSP 发出的入站请求相匹配。 将对初始 HTTP 请求（而不是对转发的任何请求）执行针对 Web 应用程序的 URIMAP 相匹配。 URIMAP 可以指定用于在 JVM 服务器中运行请求的 CICS 事务以及 (可选) 用户标识。

有关更多信息，请参阅 将 CICS 束中的 Java EE 应用程序部署到 Liberty JVM 服务器。

Atom 订阅源请求

对于 Atom 订阅源请求，其 URIMAP 定义的 USAGE 属性为 ATOM。 这些 URIMAP 定义与从 Web 客户机对 Atom 文档发出的入站请求相匹配。 它们将引用指定要返回 Atom 文档的 ATOMSERVICE 资源定义。

有关更多信息，请参阅 为 Atom 订阅源设置 CICS 定义。

Atom 订阅源请求可能有资格通过直接连接的用户事务（绕过 Web 连接任务）来进行处理。 有关更多信息，请参阅 HTTP 请求由直接连接的用户事务处理。

从 HTTP EP 适配器发出的业务事件

CICS 事件处理的 URIMAP 定义的 USAGE 属性为 CLIENT。 这些 URIMAP 定义指定供 HTTP EP 适配器用来向符合 HTTP 1.1 的服务器（使用 HTTP POST）发出事件的 URL。 可选择汇聚要供更多事件发出复用的已打开连接。 事件处理概述 包含有关 CICS 事件处理的更多信息。

对于作为 HTTP 服务器的 CICS ， URIMAP 定义包含先前由与 TCPIPSERVICE 定义关联的分析器程序提供的大部分功能。 您仍可以在处理路径中使用分析器程序（如果需要这样做）。

URIMAP 搜索顺序

如果有多个可用的 URIMAP，那么会先搜索具有相同 URI 和 TCPIPSERVICE 的 URIMAP。 在包含通配符的 URIMAP 中，最先搜索匹配的 URI，最后搜索 TCPIPSERVICE。 此搜索顺序可确保使用最具体的 URIMAP。

CICS 束中的 URIMAP 资源

您可以使用 CICS 束来创建，编辑和安装 URIMAP 资源定义。 如果以此方式创建 URIMAP 资源，那么必须使用 CICS 束来管理该资源的生命周期，并且不能独立管理该资源。 您可以使用 EXEC CICS INQUIRE URIMAP 或 CEMT INQUIRE URIMAP 命令来查询由 CICS 束动态生成的 URIMAP 资源。 但是，不能对 CICS 束动态生成的 URIMAP 资源发出 SET 或 DISCARD 命令。 必须针对 BUNDLE 资源发出命令，并且 CICS 会将这些命令应用于 URIMAP 资源。 有关在 CICS 束中定义资源的更多信息，请参阅 定义 CICS 束。

作为应用程序入口点的 URIMAP 资源

当您将 URIMAP 资源用作应用程序入口点时，支持以下使用方案：
具有 USAGE(JVMSERVER)（使用 Liberty）的 URIMAP 资源
如果 Liberty JVM 服务器找到的 URIMAP 资源已定义为应用程序入口点，那么会为 JVM 服务器请求处理器任务或其别名（由事务属性指定）设置应用程序上下文数据。
不使用 WebSphere® MQ 的带有 USAGE (SERVER) 或 USAGE (PIPELINE) 的 URIMAP 资源
如果 CWXN 找到的 URIMAP 资源已定义为应用程序入口点，那么会为 CWXN 任务设置应用程序上下文数据。 然后，由于 CWXN 为用户任务，所以应用程序上下文数据可自动传播到由 CWXN 启动的别名事务；例如，CPIH（对于 USAGE(PIPELINE)）、CWBA（对于 USAGE(SERVER)）或者由 TRANSACTION 字段指定的事务。
当您将 URIMAP 资源用作应用程序入口点时，支持以下使用方案：
具有使用 WebSphere MQ 的 USAGE (PIPELINE) 的 URIMAP 资源
不支持此方案。
具有 USAGE(CLIENT) 或 USAGE(ATOM) 的 URIMAP 资源
不支持这些方案。 如果 URIMAP 已定义为应用程序入口点，那么具有 URIMAP 和 USAGE(CLIENT) 的捆绑软件或具有 URIMAP 和 USAGE(ATOM) 的捆绑软件的状态为 DISABLED。 如果已安装捆绑软件并且您尝试启用该捆绑软件，那么该捆绑软件内的 ENTRYPOINT 捆绑软件部件的状态为 DISABLED，因此该捆绑软件的状态为 DISABLED。

使用 INQUIRE URIMAP 和 CEMT INQUIRE URIMAP 命令来返回已将 URIMAP 资源定义为其入口点的应用程序的详细信息。

有关应用程序入口点的更多信息，请参阅 应用程序入口点。