This procedure uses the CEMT and CEDA transactions to
install a URIMAP resource definition. If the URIMAP resource already
exists, it has to be disabled before it can be reinstalled.
- If the URIMAP resource already exists, ensure that it is
disabled. Use the following command:
CEMT SET URIMAP(name) DISABLED
While the URIMAP resource is disabled, if a web client makes
an HTTP request that requires the resource, CICS issues error message
DFHWB0763, and returns an HTTP 503 response (Service Unavailable)
to the web client through a web error program. You can tailor this
response by changing the web error program.
- Install the URIMAP definition. Use the following
command:
CEDA INSTALL GROUP(groupname) URIMAP(name)
When you install a URIMAP definition, CICS carries out
the following security checks:- If the URIMAP definition specifies SCHEME(HTTPS), CICS checks
at install time that SSL is active in the CICS region. This is indicated
by the use of the KEYRING system initialization parameter to specify
the key ring used by the CICS region. If SSL is not active in the
CICS region, CICS issues message DFHAM4095, and the URIMAP definition
is not installed.
If the URIMAP definition specifies the CIPHERS attribute,
CICS validates the list of ciphers against the ciphers supported in
the running system. If no valid ciphers are found in the list, CICS
issues message DFHAM4918 and the URIMAP definition is not installed.
However, if some but not all of the ciphers in the list are supported,
CICS issues message DFHAM4917 and the URIMAP is installed with the
reduced set of cipher codes.
If the URIMAP definition specifies the CERTIFICATE attribute,
CICS validates the certificate against those specified in the key
ring. If the specified certificate is not valid, then CICS issues
messages DFHAM4889 and DFHAM4928, and the URIMAP definition is not
installed.
- Optional: When you have successfully installed
the URIMAP definition, use CEMT to enable the resource. Perform
this step only if the URIMAP resource is not already defined as ENABLED,
and you want to make the resource available for web clients or web
services. Use the following command:
CEMT SET URIMAP(name) ENABLED