IBM Support

CICS BBOC WOLA registration with Liberty profile server fails with RC=12 RSN=16

Question & Answer


Question

Why would the WebSphere Optimized Local Adapter (WOLA) registration with the Liberty profile server fail with return code 12 and reason code 88? I am including the WOLA Task Related User Exit (TRUE) in the CICS PLT so it starts during the CICS initialization. I have installed zOS Connect Enterprise Edition (EE) V2.0 in our development system and the tasks LIBERTY and ANGEL are running fine.

Below is the error message that I see in the CICS log:

 WOLA TRACE 0: Min. connections: 1
 WOLA TRACE 0: Max. connections: 10
 WOLA TRACE 0: Transactional: N   string len:1
 WOLA TRACE 0: Security propagation: N   string len:1
 WOLA TRACE 0: Invoking OLA Register API for ZCONNREG
 
 The default link server could not register with the Liberty profile server. The return code is 12, and the reason code 88.

Here is a copy of my server.xml.

 <?xml version="1.0" encoding="UTF-8"?>                 
 <server description="new server">                      
                                                        
     <!-- Enable features -->                           
     <featureManager>                                   
         <feature>zosconnect:zosconnect-2.0</feature>   
         <feature>appSecurity-2.0</feature>             
     </featureManager>                                  
                                                        
     <keyStore id="defaultKeyStore" password="Liberty"/>
                                                        
     <webAppSecurity allowFailOverToBasicAuth="true" /> 
                                                        
     <basicRegistry id="basic1" realm="zosConnect">     
     <user name="Fred" password="fredpwd" />            
     </basicRegistry>                                   
                                                        
     <authorization-roles id="zos.connect.access.roles">
     <security-role name="zosConnectAccess">                             
     <user name="Fred"/>                                                 
     </security-role>                                                    
     </authorization-roles>                                              
                                                                         
     <zosLocalAdapters                                                   
             wolaGroup="ZOSGROUP"                                        
             wolaName2="ZOSNAME2"                                        
             wolaName3="ZOSNAME3" />                                     
                                                                         
     <connectionFactory id="wolaCF" jndiName="eis/ola">                  
         <properties.ola />                                              
     </connectionFactory>                                                
                                                                         
     <!-- To access this server from a remote client add a host attribute to the following element, e.g. host="*" -->
     <httpEndpoint id="defaultHttpEndpoint"                              
                   host="*"                                              
                   httpPort="29080"                                      
                   httpsPort="29081" />     
                                            
 </server>  

Answer

Your server.xml is not using the zosLocalAdapters-1.0 feature, which is required. The server.xml has:

 <featureManager>
      <feature>zosconnect:zosconnect-2.0</feature>
      <feature>appSecurity-2.0</feature>
  <featureManager>                                                                        

Section Using the WOLA service provider in the IBM z/OS Connect Enterprise Edition documentation states:
z/OS Connect EE provides a service implementation that allows z/OS Connect EE requests to interact with z/OS assets through WebSphere Optimized Local Adapters (WOLA). The service is automatically enabled when both zosconnect:zosconnect-2.0 and the zosLocalAdapters-1.0 features are configured. Instances of this service can be defined through the zosconnect_localAdaptersConnectService configuration element.

If you add the zosLocalAdapters-1.0 feature, and follow the other steps in the documentation to ensure the liberty server is set up correctly for z/OS Connect EE, the WOLA registration for CICS should complete and you should see messages:

 CWWKB0501I: The WebSphere Optimized Local Adapter channel registered with the Liberty profile server using the following name: <GROUP> <NAME2> <NAME3>
 J2CA7001I: Resource adapter ola installed in 0.nnn seconds.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Component":"","Version":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSNPJM","label":"IBM z\/OS Connect"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CICS/TS CICSTS CICS TS CICS Transaction Server;zCEE

Document Information

Modified date:
14 February 2023

UID

dwa1309204