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