IBM Support

CICS Liberty fails to connect to the Angel with CWWKB0101I after upgrade to z/OS 2.2 RSU1803 or z/OS 2.3

Question & Answer


Question

I am running CICS Transaction Server for z/OS (CICS TS) V5.3. After upgrading to z/OS V2.2 at RSU1803 or to z/OS V2.3, I am now using the Angel process started by z/OSMF. But now when I start my CICS Liberty JVM server, it is failing to connect to the Angel process with the following message:

 CWWKB0101I: The angel process is not available.  No authorized services will be loaded.  The reason code is 4.

I have verified that z/OSMF is connected to the Angel process, IZUANG1. But CICS Liberty is not. CICS users are not able to sign in to their application(s) due to the lack of a connection to the Angel.

Answer

If the starting server is NOT defined to point to a particular named Angel and there is no default (un-named) Angel running, the CWWKB0101I message can be issued when there are named Angel's running.

The z/OSMF server is now implemented with a named Angel, it is started with a specific name (NAME=IZUANG1). Since the CICS Liberty server was not updated to use a named Angel it is depending on finding the default (un-named) Angel. And there was no default Angel available.

To resolve this problem, either an un-named Angel should be started or the CICS Liberty server needs to be updated to use the z/OSMF's named Angel. This is done by setting the following parameter in the JVM profile:

 -Dcom.ibm.ws.zos.core.angelName=named_angel

where named_angel is IZUANG1 in this case.

In addition, you will need to use the following commands to allow the CICS Liberty JVM server to connect to the named angel process (if it has not been done already):

 RDEFINE SERVER BBG.ANGEL.namedAngelName UACC(NONE)
 PERMIT BBG.ANGEL.namedAngelName CLASS(SERVER) ACCESS(READ) ID(cics_region_user)

You can use the following MODIFY command to get a list of all the Angel processes running on the system: MODIFY [jobname.]IDENTIFIER,DISPLAY,ANGELS

This will provide output similar to the following:

 F IZUANG1,DISPLAY,ANGELS                                     
 CWWKB0076I A list of active angels follows.                  
 CWWKB0077I ACTIVE ANGEL JOBNAME IZUANG1  ASID 5f VERSION 7   
 CWWKB0078I ACTIVE ANGEL NAME IZUANG1  

You can also verify what version of the Angel is running by using this MODIFY command:
MODIFY [jobname.]IDENTIFIER,VERSION Here is a list of angel version numbers and the product level in which each angel first occurred is provided:

 Angel version     Product level
     5               16.0.0.4
     6               17.0.0.1
     7               17.0.0.2
     8               18.0.0.2

The angel is downward compatible. You should try to use the most recent angel for your servers. All Liberty servers that are running on a z/OS image can share a single angel, regardless of the level of code that the servers are running. Note that if you use an uplevel server and downlevel angel there might be new function in the server that is not supported by the down-level angel. For more information please reference the Administering Liberty on z/OS section in the WebSphere Application Server for z/OS Liberty documentation.

Shayla Robinson
IBM CICS/CPSM Level2 Support

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

Product Synonym

CICS/TS CICSTS CICS TS CICS Transaction Server

Document Information

Modified date:
19 March 2020

UID

dwa1465589