IBM Support

PI58732: Message CWWKG0033W auditInterceptor specified for interceptorRef was not found in the configuration is issued.

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as documentation error.

Error description

  • You are following the example in the IBM Knowledge Center topic
    "Auditing and Tracking" to update your server.xml configuration
    element tags to enable an Interceptor for auditing of z/OS
    Connect V2 EE APIs by writing SMF 123 type 1 record.  You are
    following step 1 in the procedure to update your configuration:
    <!-- Audit interceptor configuration -->
    <auditInterceptor id="auditInterceptor" sequence="1"/>
    <!-- Interceptor list configuration -->
    <zosconnect_zosConnectInterceptors id="interceptorList1"
    interceptorRef="auditInterceptor"/>
    <!-- z/OS Connect service definitions -->
    <zosconnect_zosConnectService id="zcs1"
    serviceName="recordOpsCreate" serviceRef="wolaOpsCreateService"
     interceptorsRef="interceptorList1"/>
    Your z/OS Connect V2 EE server sysout log has message:
    CWWKG0033W: The value "auditInterceptor"specified for
    the reference attribute "interceptorRef" was not found in the
    configuration
    You updated the auditInterceptor configuration element tag to
    pre-pend a prefix value of "zosconnect_" and after restarting
    the z/OS Connect V2 EE server, the CWWKG0033W message was no
    longer issued and the SMF 123 audit logging records were being
    written by the server.
    The IBM Knowledge Center in the topic "Migrating from z/OS
    Connect V1 in 2) it states that all configuration elements
    (including interceptors) need the 'zosconnect_' prefix.
    The IBM Knowledge Center needs to clearly describe this
    requirement for all configuration element tags.
    
    Additional Symptom(s) Search Keyword(s): KIXREVWJB
    SMF123
    BAQR0403W msgBAQR0403W BAQR0403 msgBAQR0403 BAQR0402E
    BAQR0402 msgBAQR0402 msgBAQR0402E msgCWWKG0033W msgCWWKG0033
    CWWKG0033
    

Local fix

  • Ensure all server.xml configuration element tags for z/OS
    Connect V2 EE have a "zosconnect_" prefix.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * All users of the z/OS Connect EE V2 audit interceptor.       *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * The z/OS Connect EE Knowledge Center does not fully document *
    * the use of the z/OS Connect EE V2 audit interceptor.         *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * .                                                            *
    ****************************************************************
    

Problem conclusion

  • A new "Enabling the audit interceptor" section has been added to
    the z/OS Connect EE V2 Knowledge Center which includes the
    requirement to prefix "auditInterceptor" with  "zosconnect_".
    http://www.ibm.com/support/knowledgecenter/en/SS4SVW_2.0.0/com.i
    bm.zosconnect.doc/configuring/audit_interceptor.html?view=kc
    
    You can use the audit interceptor included with z/OS® Connect
    EE, to audit and track requests. The interceptor records data to
    the z/OS SMF data store.
    
    About this task
    You can enable the audit interceptor on a single or group of
    z/OS Connect EE services.
    
    Procedure
    Enable the audit interceptor supplied with z/OS Connect EE for a
    service or set of services. The audit interceptor implements the
    com.ibm.zosconnect.spi.Interceptor SPI to store auditing and
    tracking information in the audit interceptor supplied with z/OS
    System Management Facility (SMF) data sets. The following is an
    example that shows how to enable the audit interceptor for a
    single service:
    
    <!-- Audit interceptor configuration -->
    <zosconnect_auditInterceptor id="auditInterceptor"
    sequence="1"/>
    
    <!-- Interceptor list configuration -->
    <zosconnect_zosConnectInterceptors id="interceptorList1"
    interceptorRef="auditInterceptor"/>
    
    <!-- z/OS Connect service definitions -->
    <zosconnect_zosConnectService id="zcs1"
    serviceName="recordOpsCreate" serviceRef="wolaOpsCreateService"
    	interceptorsRef="interceptorList1"/>
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI58732

  • Reported component name

    Z/OS CONNECT EN

  • Reported component ID

    5655CEE00

  • Reported release

    200

  • Status

    CLOSED DOC

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2016-03-08

  • Closed date

    2016-09-22

  • Last modified date

    2016-09-22

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSNPJM","label":"IBM z\/OS Connect"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.0","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
14 February 2023