Start of change

Installing URIMAP resource definitions

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.

  1. 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.
  2. 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.
    • Start of changeIf 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.End of change
    • Start of changeIf 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.End of change
  3. 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

End of change