CEMT SET URIMAP

启用或禁用 URIMAP 定义,并且应用或移除 URIMAP 定义的重定向。

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

描述

如果禁用URIMAP定义, CICS® 将向Web客户端返回 HTTP ,并附带503(服务不可用)状态代码。

您可以使用重定向选项为匹配的 HTTP 请求设置重定向,并指定请求重定向到的 URL。 您可以使用此命令将重定向应用于现有的URIMAP定义,例如,当通常响应 HTTP的应用不可用时。 还可以使用此命令从 URIMAP 定义中除去重定向。

只能使用 CEMT 事务来修改在 CICS 系统定义文件 (CSD) 中定义并安装在正在运行的 CICS 系统中的 URIMAP 定义。 不能将 CEMT SET URIMAP 命令用于已定义并安装在 CICS 束中的 URIMAP 定义。
  • 您可以通过启用或禁用安装了这些资源的 BUNDLE 资源来控制动态生成的 URIMAP 资源的状态。
  • 您可以使用 CICS Explorer中的资源编辑器来修改动态生成的 URIMAP 资源的定义。 要更新定义,请遵循 使用 CICS Explorer 产品文档中的束中的指示信息,将旧版本的 CICS 束替换为新束。 可以单独更新单独部署或使用平台部署的 CICS 束。 如果 CICS 束是作为应用程序的一部分或通过应用程序绑定进行部署,请更新整个应用程序。

语法

CEMT SET URIMAP

读取语法图跳过可视语法图CEMT SET URIMAP( 值)ALLENABLEDDISABLEDNONETEMPORARYPERMANENTLOCATION( 值)

选项

(value)
指定应用此命令的 URIMAP 资源定义的 8 字符名称。
ENABLED
可以访问 URIMAP 定义。
DISABLED
无法访问 URIMAP 定义。
NONE
不会重定向请求。 忽略通过“位置”选项指定的所有 URL。
临时
临时重定向请求。 响应所使用的状态码为 302(已找到)。
PERMANENT
将永久重定向请求。 响应所使用的状态码为 301(已永久移动)。
位置 (值)
指定一个最多包含 255 个字符的 URL ,来自 Web 客户端的匹配 HTTP 请求将被重定向到此地址。 这必须是一个完整的 URL ,包括方案、主机和路径组件,以及适当的分隔符。 CICS 检查 URL 是否完整且分隔正确,但CICS目标是否有效。

REDIRECTTYPE 选项用于指定重定向的类型。 如果指定了临时或永久重定向,则使用 LOCATION 属性中的 URL 进行重定向。 如果没有指定重定向,则忽略“位置”选项中的 URL。