IBM Support

CWWKB8016E 480 Liberty Server, WOLA connector from CICS to z/OS Connect EE

Question & Answer


Question

Why am I receiving message CWWKB8016E with reason code 480 when attempting to start the WOLA link server task and register into the Liberty server from a CICS region? I receive this message:

 CWWKB8016E The registration with the Liberty profile server was not successful. The return code is 8, and the reason code is 480 

No other diagnostic information returned.

I am following the instructions on page 24 of the z/OS Connect Enterprise Edition V2.0 Getting Started Manual (WP102604). This is first time install of z/OS Connect. I am using z/OS Connect Enterprise Edition (EE) V2.0, and CICS Transaction Server for z/OS (CICSTS V4.2) on z/OS 2.1.

Answer

The reason code 480 is:

Description: The client was not able to become authorized to invoke the register function.
Action: This is an unexpected condition. Ensure that the target server is running and that the zosLocalAdapters service is configured in the server instance.

When I check the server.xml for the zosLocalAdapters configuration element it shows:

     <zosLocalAdapters
         wolaGroup="group"
         wolaName2="name2"
         wolaName3="name3" />

This appears to be correct and will be security checked against the CBIND class for profile BBG.WOLA.group.name2.name3 The documentation for z/OS Connect EE V2 topic on Registering CICS with the WebSphere optimized local adapter (WOLA) shows step 2 for confirming the WOLA registration from the zCEE server which matches your supplied server messages.log:

 [8/5/16 9:14:19:709 GMT] 00000015
 com.ibm.ws.zos.channel.wola.internal.WOLAChannel             I
 CWWKB0501I: The WebSphere Optimized Local Adapter channel registered with the Liberty profile server using the following name: group name1 name2
 [8/5/16 9:14:23:227 GMT] 00000021
 om.ibm.ws.app.manager.rar.internal.RARApplicationHandlerImpl A
 J2CA7001I: Resource adapter ola installed in 1.930 seconds.

The BBOOUT log shows the "BBOC START TRUE" successfully enabled as described in step 4a of the documentation:

 BBOC Fri Aug  5 10:04:49 2016 0000083 WOLA TRACE 1: Enabling BBOATRUE
 exit.&#8230;
 BBOC Fri Aug  5 10:04:49 2016 0000083 WOLA TRACE 1: Exit enabled
 successfully.&#8230;
 BBOC Fri Aug  5 10:04:49 2016 0000083 WOLA TRACE 0: Return Code: 0
 Reason Code: 0&#8230;
 BBOC Fri Aug  5 10:04:49 2016 0000083 WOLA TRACE 0: Elapsed time:
 0.000000 seconds&#8230;
 BBOC Fri Aug  5 10:04:49 2016 0000083 WOLA TRACE 0: Elapsed CPU time:
 0.000497 seconds

The cause is most likely an authorization problem for module BBGZSCFM.

Can you confirm the following...

Create SERVER profiles for z/OS.

Create SERVER profiles for the optimized local adapter authorized service. Use the following Time Sharing Option (TSO) commands:

     RDEF SERVER BBG.AUTHMOD.BBGZSAFM.LOCALCOM UACC(NONE)
     PERMIT BBG.AUTHMOD.BBGZSAFM.LOCALCOM CLASS(SERVER)   ACCESS(READ)   ID(wlpuser1)
     RDEF SERVER BBG.AUTHMOD.BBGZSAFM.WOLA UACC(NONE)
     PERMIT BBG.AUTHMOD.BBGZSAFM.WOLA CLASS(SERVER)  ACCESS(READ)  ID(wlpuser1)

Create a SERVER profile for the authorized client module BBGZSCFM and permit the Started Task user ID of the Liberty server to the profile. This action enables a Liberty server to load the z/OS Authorized client services. To enable a server that is running as WLPUSER1 to access the authorized client module:

 RDEF SERVER BBG.AUTHMOD.BBGZSCFM UACC(NONE)
 PERMIT BBG.AUTHMOD.BBGZSCFM CLASS(SERVER) ACCESS(READ) ID(wlpuser1)

Create SERVER profiles for optimized local adapter authorized client service. Use the following TSO commands:

     RDEF SERVER BBG.AUTHMOD.BBGZSCFM.WOLA UACC(NONE)
     PERMIT BBG.AUTHMOD.BBGZSCFM.WOLA CLASS(SERVER) ACCESS(READ) ID(wlpuser1)

Can you confirm these security settings?

Refer to the z/OS Connect Enterprise Edition V2 topic Configuring the Liberty Angel process and z/OS authorized services.

[{"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

dwa1296755