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
Product Synonym
CICS/TS CICSTS CICS TS CICS Transaction Server
Was this topic helpful?
Document Information
Modified date:
19 March 2020
UID
dwa1465589