Installing the prerequisites for WS-Security support

To implement WS-Security support in CICS®, you must install the IBM® XML Toolkit for z/OS® and add 3 libraries to the DFHRPL concatenation.

Stabilized feature:

Support for signing and encrypting SOAP messages for the WS-Security feature is stabilized. Consider securing SOAP messages using Transport Layer Security as an alternative. See also Stabilization notices and discontinued functions.

6.3 Support for signing and encrypting SOAP messages for the WS-Security feature is removed as of CICS TS 6.3.

6.16.2 Support for signing and encrypting SOAP messages for the WS-Security feature is stabilized.

Procedure

  1. Install the free IBM XML Toolkit for z/OS.
    You can download it from the following site: https://www.ibm.com/servers/eserver/zseries/software/xml/.
    • 6.2 You must install version 1.11.
    • 6.1 You must install version v1.10.
    Other versions of the IBM XML Toolkit for z/OS do not work with Web Services Security support in CICS.

    6.3 beta Support for installation is removed as of CICS TS 6.3.

  2. Add the following libraries to the DFHRPL concatenation:
    • hlq.SIXMLOD1, where hlq is the high-level qualifier of the XML Toolkit.
    • hlq.SCEERUN, where hlq is the high-level qualifier of the Language Environment®.
    • hlq.SDFHWSLD, where hlq is the high-level qualifier of the CICS installation; for example CICSTS64 for CICS TS beta.

    The first two libraries contain DLLs that are required at run time by the CICS security handler. IXM4C58 is provided by the XML Toolkit and is found in hlq.SIXMLOD1. C128N is provided by the Language Environment run time and is found in hlq.SCEERUN.

    The hlq.SDFHWSLD library enables CICS to find the DFHWSSE1 and DFHWSXXX Web Services Security modules.

  3. You might need to increase the value of the EDSALIM system initialization parameter.
    The three DLLs that are loaded require approximately 15 MB of EDSA storage.

Results

If you do not have the libraries specified, you see the following message: 
CEE3501S The module module_name was not found.
The module_name varies depending on which library is missing.