Prerequisites

To implement Web Services Security, you must apply the following updates to your CICS® region.

  1. Start of changeInstall the free IBM® XML Toolkit for z/OS® V1.9, program number 5655-J51. You can download the toolkit from the following site: http://www.ibm.com/servers/eserver/zseries/software/xml/.
    • You must install version 1.9. Later versions do not work with Web Services Security support in CICS.
    • The toolkit is an MVS feature and should be installed in the SMP/E zone for MVS.
    • Specify a valid keyring on the KEYRING system initialization parameter.
    • Apply the PTFs for APARs PK65352 and PK97657 to CICS, which change the required version of the toolkit from V1.7 to V1.9.
    End of change
  2. Apply ICSF APAR OA14956 if it is not already installed in your CICS region.
  3. Apply the PTF for APAR PK22736.
  4. Add the following libraries to the DFHRPL concatenation:
    • hlq.SIXMLOD1
    • hlq.SCEERUN
    • hlq.SDFHWSLD
    where hlq is the high level qualifier that was specified by the system programmer when the Web Services Security APAR was installed.

    The first three libraries contain DLLs that are required at run time by DFHWSSE1. IXM4C54 is provided by the XML toolkit and is found in hlq.SIXMLOD1; C128N is provided by the Language Environment® runtime and is found in hlq.SCEERUN.

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

  5. You might need to increase the value of the EDSALIM system initialization parameter. The three DLLs that need to be loaded require approximately 15MB of EDSA storage.
If you do not have the libraries specified, you get the following message:
CEE3501S The module module_name was not found.
The module_name varies depending on which library is missing.