SET URIMAP

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

Read syntax diagramSkip visual syntax diagramSET 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:

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.
[[ Contents Previous Page | Next Page Index ]]