CEMT SET URIMAP

Enable or disable a URIMAP definition, and apply or remove redirection for a URIMAP definition.

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

Description

If you disable a URIMAP definition, CICS returns an HTTP response to the Web client with a 503 (Service Unavailable) status code.

You can use the redirection options to set redirection for matching HTTP requests, and specify a URL to which the requests are redirected. You can use this command to apply redirection to an existing URIMAP definition, for example if the application that would normally respond to the HTTP request is unavailable. You can also use this command to remove redirection from a URIMAP definition.

You can only use the CEMT transaction to modify URIMAP definitions that are defined in the CICS® system definition (CSD) file and installed in the running CICS system. You cannot use the CEMT SET URIMAP command for URIMAP definitions that were defined and installed in a CICS bundle.
  • You can control the status of dynamically generated URIMAP resources by enabling or disabling the BUNDLE resources that installed them.
  • You can modify the definition of dynamically generated URIMAP resources using the resource editor in the CICS Explorer®. To update the definition, replace the old version of the CICS bundle with the new one, following the instructions inWorking with bundles in the CICS Explorer product documentation. CICS bundles that were deployed on their own or with a platform can be updated individually. If the CICS bundle was deployed as part of an application or with an application binding, update the whole application.

Syntax

CEMT SET URIMAP

Read syntax diagramSkip visual syntax diagramCEMT SET URIMAP( value)ALLENABLEDDISABLEDNONETEMPORARYPERMANENTLOCATION( value)

Options

(value)
specifies the 8-character name of the URIMAP resource definition to which this command applies.
ENABLED
The URIMAP definition can be accessed.
DISABLED
The URIMAP definition cannot be accessed.
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).
LOCATION (value)
specifies a URL of up to 255 characters, to which matching HTTP requests from Web clients can be redirected. This must be a complete URL, including scheme, host, and path components, and appropriate delimiters. CICS checks that the URL is complete and correctly delimited, but CICS does not check that the destination is valid.

The REDIRECTTYPE option is used to specify the type of redirection. If temporary or permanent redirection is specified, the URL in the LOCATION attribute is used for redirection. If no redirection is specified, the URL in the LOCATION option is ignored.