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 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
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.