CEMT SET URIMAP
In the CICS Explorer, the URI Maps 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 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 in Working 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 >>-CEMT SET URIMAP--+-(value)-+--+-ENABLED--+--+-NONE------+----> '-ALL-----' '-DISABLED-' +-TEMPORARY-+ '-PERMANENT-' >--LOCATION(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.
