CEMT INQUIRE URIMAP

检索有关 URIMAP 资源定义的信息。

在 CICS Explorer®中， URI 映射视图提供与此命令等效的功能。

描述

URIMAP 定义的 USAGE 属性确定在该 URIMAP 定义中指定的其他属性，有时确定特定属性的含义。

资源特征符

您可以使用此命令来显示资源签名字段。您可以使用这些字段来管理资源，方法是捕获资源的定义，安装和上次更改时间的详细信息。有关更多信息，请参阅审计资源。资源签名字段为 CHANGEAGENT ， CHANGEAGREL ， CHANGETIME ， CHANGEUSRID ，DEFINES还是 DEFINETIME ， INSTALLAGENT ， INSTALLTIME 和 INSTALLUSRID。请参阅资源签名字段值摘要，以获取有关资源签名字段内容的详细信息。

输入

按 "清除" 键以清除屏幕。您可以通过两种方式启动此事务:

输入 CEMT INQUIRE URIMAP (或关键字的适当缩写)。生成的显示将列出当前状态。
输入 CEMT INQUIRE URIMAP (或关键字的适当缩写) ，后跟限制所需信息范围所需的属性。例如，如果输入 cemt i ur tcpipservice，那么生成的屏幕仅显示应用于所选 TCPIPSERVICE 定义 (定义端口) 的那些 URIMAP 资源定义的详细信息。

您可以按 Tab 键切换到突出显示的字段或空白字段，并使用必需的值覆盖这些字段。

ALL: 缺省值。
(value): 为其请求信息的 URIMAP 定义的名称。

CEMT INQUIRE URIMAP

显示的字段

ANALYZERSTAT (value)

显示 URIMAP 定义的分析器程序设置。可能的值如下所示：

ANALYZER: 与TCPIPSERVICE定义相关的分析器用于处理 HTTP。
无分析器: 不使用分析器程序。

APPLICATION(数据值)

显示将此 URIMAP 资源声明为应用程序入口点的应用程序的应用程序名称。如果未将 URIMAP 资源声明为应用程序入口点，那么 APPLICATION 将显示空白。

APPLMAJORVER(数据值)

显示应用程序的主要版本号。如果将 URIMAP 资源声明为应用程序入口点，那么将返回此应用程序的主要版本号。如果未将URIMAP资源声明为应用程序入口点，则APPLMAJORVER将返回 -1。

APPLMINORVER(数据值)

显示应用程序的次版本号。如果将 URIMAP 资源声明为应用程序入口点，那么将返回此应用程序的次版本号。如果未将URIMAP资源声明为应用程序入口点，则APPLMINORVER将返回 -1。

APPLMICROVER(数据值)

显示应用程序的微版本号。如果将 URIMAP 资源声明为应用程序入口点，那么将返回此应用程序的微版本号。如果未将URIMAP资源声明为应用程序入口点，APPLMICROVER将返回 -1。

ATOMSERVICE (value)

显示 Atom 订阅源的 ATOMSERVICE 资源定义的 1-to 8 字符名称。 ATOMSERVICE 资源定义定义 Atom 服务，订阅源，集合或类别文档，并标识用于为订阅源提供数据的 Atom 配置文件， CICS® 资源或应用程序以及 XML 绑定。

AUTHENTICATE (值)

显示是否向 Web Service 提供者提供认证信息。可能的值如下所示：

basicAuth: 网络服务提供商要求HTTP 基本认证。您可以向 Web Service 请求者 (用户标识和密码) 提供凭证到全局用户出口 XWBAUTH ，如果启用此功能，那么会将凭证发送到 Web Service 提供者。
不真实: Web Service 提供程序不需要认证。

AVAILSTATUS(值)

显示 URIMAP 资源的可用性状态，作为部署在平台上的应用程序的应用程序入口点。

AVAILABLE: URIMAP 资源声明为应用程序入口点，应用程序入口点控制其可用性并可用，因此 URIMAP 资源可供调用者使用。
UNAVAILABLE: URIMAP 资源声明为应用程序入口点，但控制其可用性的应用程序入口点不可用，因此 URIMAP 资源不可用于调用者。
NOTAPPLIC: URIMAP 资源可供调用者使用。未将 URIMAP 资源声明为应用程序入口点，或将其声明为应用程序入口点，但应用程序入口点已禁用或未控制 URIMAP 资源的可用性。

CERTIFICATE (value)

显示证书标签，该证书将作为SSL客户端证书，用于 CICS HTTP HTTP。证书标签最多可以包含 32 个字符。

CHANGEAGENT (value)

显示用于标识对资源定义进行最后一次更改的代理程序的值。不能使用 CEMT 对其中某些值进行过滤，因为这些值是重复的。可能的值如下所示：

CREATESPI: 上次由 EXEC CICS CREATE 命令更改资源定义。
CSDAPI: 上次由 CEDA 事务或 DFHEDAP 的可编程接口更改资源定义。
CSDBATCH: DFHCSDUP 作业上次更改资源定义。
DREPAPI: 资源定义上次由 CICSPlex ® SM BAS API 命令更改。
DYNAMIC: 上次由 PIPELINE 扫描更改资源定义。
OVERRIDE: 资源定义上次由资源覆盖文件中的覆盖规则的应用程序更改。

CHANGEAGREL (value)

显示上次更改资源定义时正在运行的 CICS 发行版的 4 数字。

CHANGETIME (日期时间)

显示上次更改资源定义的日期和时间。日期的格式取决于您为 CICS 区域的 DATFORM 系统初始化参数选择的值。时间的格式为 hh:mm:ss。

CHANGEUSRID (值)

显示运行更改代理程序的 8 字符用户标识。

CHARACTERSET (value)

显示静态响应的字符集的名称。字符集的名称最多可包含 40 个字符。

CIPHERS (value)

返回一个 56–character 区域，其中包含用于在 SSL 握手期间与客户机协商的密码套件的列表，或者返回 SSL 密码套件规范文件的名称，该文件是 USSCONFIG 系统初始化参数指定的目录的 security/ciphers 子目录中的 z/OS® UNIX 文件。有关更多信息，请参阅密码套件和密码套件规范文件。

转换器 (value)

显示对请求内容执行转换或其他处理的转换器程序的 8 字符名称。

DEFINESOURCE (值)

显示资源定义的源。 DEFINESOURCE 值取决于 CHANGEAGENT 选项。有关详细信息，请参阅资源特征符字段值摘要。

DEFINETIME (日期时间)

显示创建资源的日期和时间。日期的格式取决于您为 CICS 区域的 DATFORM 系统初始化参数选择的值。时间的格式为 hh:mm:ss。

ENABLESTATUS (value)

显示 URIMAP 定义的状态。可能的值如下所示：

ENABLED: 可以访问 URIMAP 定义。
DISABLED: 无法访问 URIMAP 定义。可以删除处于该状态的 URIMAP 定义。
已禁用: 无法访问 URIMAP 定义，因为其构成部分的虚拟主机已被禁用。使用 CEMT SET HOST 来重新启用虚拟主机中的所有 URIMAP 定义。无法删除处于该状态的 URIMAP 定义。

HFSFILE (value)

显示将构成静态响应的 UNIX 系统服务文件的标准名称。标准文件名最多可以有 256 个字符。

主机 (value)

显示 URL 的主机名 IPv4 或 IPv6 地址。所有 IPv4 地址均显示为本机 IPv4 十进制小数点地址；例如，1.2.3.4，而不考虑所使用的地址格式的类型。如果您使用CICS 相关的URIMAP定义作为 HTTP ，USAGE（客户端），并使用本机 IPv4或主机名，则将显示地址或主机名和端口号；例如， 1.2.3.4:80 或 hostname.com:443 。如果指定长度超过 110 个字符的主机名，那么端口信息不会显示在 HOST 选项中。使用 PORT 选项来查看端口号。

HOSTCODEPAGE (value)

显示 IBM® 代码页 (EBCDIC) ，将在其中对构成静态响应的文本文档进行编码。此值最多可包含 10 个字符。

HOSTTYPE (value)

显示 HOST 选项的地址格式。 HOSTTYPE 选项仅在使用扩展查询时可用。可能的值如下所示：

主机名: HOST 选项包含字符主机名。
IPV4HOST: 该地址是 IPv4 地址。
IPV6HOST: 该地址是 IPv6 地址。

INSTALLAGENT (值)

显示用于标识安装资源的代理程序的值。不能使用 CEMT 对其中某些值进行过滤，因为这些值是重复的。可能的值如下所示：

BUNDLE: 资源是由捆绑软件部署安装的。
CREATESPI: 资源是通过 EXEC CICS CREATE 命令安装的。
CSDAPI: 该资源是由 CEDA 事务或 DFHEDAP 的可编程接口安装的。
DYNAMIC: 资源是使用 PIPELINE 扫描安装的。
GRPLIST: 该资源已由 GRPLIST INSTALL安装。

INSTALLTIME (日期时间)

显示安装资源的日期和时间。日期的格式取决于您为 CICS 区域的 DATFORM 系统初始化参数选择的值。时间的格式为 hh:mm:ss。

INSTALLUSRID (值)

显示安装资源的 8 字符用户标识。

IPFAMILY (value)

显示 IPRESOLVED 选项的地址格式。 IPFAMILY 选项仅在使用扩展查询时可用。使用通配符进行过滤时，过滤将与 IPFAMILY 选项交互。例如，如果 IPFAMILY 中的值为 IPV6FAMILY，那么必须使用冒号字符来检索 IP 地址。可能的值如下所示：

IPV4FAMILY: 该地址是 IPv4 地址。
IPV6FAMILY: 该地址是 IPv6 地址。
UNKNOWN: IPRESOLVED 选项尚未使用，或者无法解析地址。

IpresOLVED (value)

显示主机的 IPv4 或 IPv6 地址。 IPRESOLVED 选项仅在使用扩展查询时可用。此选项适用于除 USAGE (SERVER) 和 USAGE (JVMSERVER) 以外的所有类型。

位置 (value)

显示URL ，来自Web客户端的匹配 HTTP 请求将被重定向到此URL。 URL 最多可包含255个字符。重定向由 REDIRECTTYPE 选项指定的设置激活。

MEDIATYPE (value)

显示静态响应的数据内容的描述。媒体类型最多可包含 40 个字符。

OPERATION(数据值)

显示将此 URIMAP 资源声明为应用程序入口点的应用程序的操作名称。如果未将 URIMAP 资源声明为应用程序入口点，那么 OPERATION 将显示空白。

PATH (value)

显示 URL 的路径部分。路径部分最多可以包含 255 个字符。

PLATFORM(数据值)

显示将此 URIMAP 资源声明为应用程序入口点的应用程序的平台名称。如果未将 URIMAP 资源声明为应用程序入口点，那么 PLATFORM 将显示空白。

端口 (value)

显示 USAGE (CLIENT) 用于连接到服务器的数字端口号值，范围为 1-65535。如果 HOST 包含本机 IPv4 地址或主机名，那么还会在 HOST 选项中显示端口号。对于 USAGE(CLIENT)，PORT 属性始终包含正在用于通信的端口号，即使定义时对 URIMAP 指定了 PORT(NO)，也是如此。对于 USAGE (ATOM) ， USAGE (SERVER) 或 USAGE (PIPELINE) ，将显示 PORT 选项().

程序 (value)

显示构成响应的应用程序的 8 字符名称。

REDIRECTTYPE (value)

显示与此 URIMAP 定义匹配的请求的重定向类型。重定向的 URL 由“位置”选项指定。可能的值如下所示：

NONE: 不会重定向请求。忽略通过“位置”选项指定的所有 URL。
临时: 临时重定向请求。响应所使用的状态码为 302（已找到）。
PERMANENT: 将永久重定向请求。响应所使用的状态码为 301（已永久移动）。

SCHEME (value)

显示 URL方案组成部分。可能的值如下所示：

HTTP: HTTP ，无安全套接字层（SSL）
HTTPS: 具有安全套接字层 (SSL) 的 HTTP

SOCKETCLOSE(value)

显示CICS使用完HTTP后， CICS 保持该连接打开以供重复使用的最长时间（以秒为单位）。如果值为0 CICS 不会保持连接打开状态以供重复使用。仅当 URIMAP 定义的用法类型为 CLIENT 时，才会显示值。对于其他用法类型， SOCKETCLOSE 显示().

SOCKPOOLSIZE(value)

显示 CICS 当前在休眠状态下在池中保持的客户端 HTTP 连接数。任何 CICS都可以通过Web客户端连接到同一主机和端口，从而重复使用这些连接。仅当 URIMAP 定义的用法类型为 CLIENT 时，才会显示值。对于其他用法类型，将显示 SOCKPOOLSIZE().

TCPIPSERVICE (value)

显示 TCPIPSERVICE 定义的 8 字符名称，该定义指定与此 URIMAP 定义相关的入站端口。如果未提供此定义，那么 URIMAP 定义将与所有 TCPIPSERVICE 定义相关。

TEMPLATENAME (value)

显示用于构成静态响应的 CICS 文档模板的名称。模板名称最多可包含 40 个字符。

TRANSACTION (value)

显示用于运行构成响应的用户应用程序的别名事务的 4 字符名称。

用法 (value)

显示 URIMAP 资源的使用情况。

SERVER: URIMAP资源作为 HTTP用于 CICS。它映射了从Web客户端到 CICS资源HTTP URL。
CLIENT: URIMAP资源是 CICS HTTP 客户端。当 CICS 在服务器上发出 HTTP请求时，就会用到它。
PIPELINE: URIMAP 资源用于 Web Service。它指定要对请求执行的处理，客户机通过该请求在 CICS中调用 Web Service。
ATOM: URIMAP 资源用于 Atom 订阅源。它用于针对 CICS 作为 Atom 订阅源提供的数据的入局请求。
JVMSERVER: URIMAP 资源用于 JVM 服务器。它将 Java™ Web 应用程序的入局请求映射到具有相应安全性的 CICS 事务下运行。

USERID (value)

显示用于连接别名事务的 8 字符用户标识。

WEBSERVICE (value)

显示 Web Service 的名称。此名称可以是 WEBSERVICE 资源定义的 1-to 8 字符名称，也可以是代表 CICS Web Service 助手生成的 Web Service 的最多 32 个字符的名称。它定义在 Web Service 设置中部署的 CICS 应用程序的运行时环境的各个方面。