Enables or disables a URIMAP definition, and applies or removes
redirection for a URIMAP definition.

SET URIMAP
>>-SET URIMAP(data-area)--+--------------------+---------------->
'-ENABLESTATUS(cvda)-'
>--+-----------------------------------------+-----------------><
'-REDIRECTTYPE(cvda)--LOCATION(data-area)-'
Conditions: INVREQ, NOTAUTH, NOTFND
This command is threadsafe.
Description
The SET URIMAP command allows you to:
- Enable or disable a URIMAP definition.
- 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.
Options
- ENABLESTATUS(cvda)
- Sets
the URIMAP definition to enabled or disabled status. CVDA values are:
- ENABLED
- The
URIMAP definition can be accessed by applications.
- DISABLED
- The
URIMAP definition cannot be accessed by applications. A URIMAP definition
has to be disabled before it can be reinstalled or discarded.
- LOCATION(data-area)
- 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® does not check that the URL is valid,
so you must ensure that the destination exists and that the URL is specified
correctly.
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 NONE is specified, the URL in the LOCATION
option is ignored.
- REDIRECTTYPE(cvda)
- Specifies
the type of redirection for requests that match this URIMAP definition. The
URL for redirection is specified by the LOCATION option. CVDA values are:
- NONE
- Requests
are not redirected. Any URL specified by the LOCATION option is ignored.
- TEMPORARY
- Requests
are redirected on a temporary basis. The HTTP status code used for the response
is 302 (Found).
- PERMANENT
- Requests
are redirected permanently. The HTTP status code used for the response is
301 (Moved Permanently).
Conditions
- INVREQ
- RESP2
values are:
- 8
- No location specified for redirection (LOCATION option).
- 9
- Invalid REDIRECTTYPE or ENABLESTATUS value.
- 12
- The URIMAP has USAGE(CLIENT) so redirection does not apply, and the LOCATION
option cannot be set.
- NOTAUTH
- RESP2
values are:
- 100
- The user associated with the issuing task is not authorized to use this
command.
- NOTFND
- RESP2
values are:
- 3
- The URIMAP cannot be found.