DISCARD URIMAP

Description

The DISCARD URIMAP command removes a URIMAP definition from the system. For a URIMAP definition to be discarded, it must be disabled individually (using the SET URIMAP command). Disabling a virtual host (using the SET HOST command) does not allow the URIMAP definitions that make up the virtual host to be discarded.

See Discarding resource definitions for general information about discards.

You cannot directly discard a URIMAP resource that is created by a BUNDLE resource. An INVREQ with a RESP2 value of 300 is issued if you attempt to do so. To discard it you must use the bundle resource. For more information, see URIMAP attributes.

Options

URIMAP(data-value)

specifies the 8-character name of the URIMAP definition that is to be removed.

Conditions

INVREQ

RESP2 values are:

4

The URIMAP is not disabled.

200

The command was executed in a program defined with an EXECUTIONSET value of DPLSUBSET or a program invoked from a remote system by a distributed program link without the SYNCONRETURN option.

300

A DISCARD URIMAP SPI command was issued against a URIMAP resource that was installed through a CICS bundle (BUNDLE).

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.