Prerequisites for Web Services Security

To implement Web Services Security, you must apply these updates to your CICS® region: install the IBM® XML Toolkit for z/OS® v1.10 and add 3 libraries to the DFHRPL concatenation.

About this task

Complete the following steps before you implement Web Services Security:

Procedure

  1. Install the free IBM XML Toolkit for z/OS v1.10.
    You can download it from the following site: https://www.ibm.com/support/knowledgecenter/SSLTBW_2.3.0/com.ibm.zos.v2r3.gxla100/xmlssfunctions.htm. You must install version 1.10. Later versions do not work with Web Services Security support in CICS.
  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 CICSTS54.

    The first two libraries contain DLLs that are required at run time by the security handler. IXM4C57 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.