Data Mover error message, ZDMV2005E BPX4QCT service failed; return value -1, RC=111 RSN=x'07020303'

Products

• COMMON SERVICES FOR Z/OS

Issue/Introduction

The Common Services Data Mover and the Message Server have been running on that LPAR for several weeks. Some days ago they had to be stopped and restarted.  On the restart of the Data Mover these error messages appeared:

ZDMV2005E BPX4QCT service failed; return value -1, RC=111 RSN=x'07020303'   
 
ZDMV2023E Consumer connection rejected - Invalid response Message Queue  006
   006             Message Service Data Mover connection                                       
 
ZDMV2005E BPX4QCT service failed; return value -1, RC=111 RSN=x'07020303'   
 
ZDMV2023E Consumer connection rejected - Invalid response Message Queue  012
   012             Message Service Data Mover connection      

Is there a way to determine for which resource the connect request is failing?.

Environment

Release : 15.0

Component : CCS MESSAGE SERVICE

Resolution

The RC=111 does indeed equate to permission denied (EACCES), with reason code x'0303" indicating (JRIpcDenied) "Access was denied because the caller does not have the correct permission. Action: The caller lacked ownership, read or alter permission."

The Message Service creates an IPC message queue and passes the ID of that message queue to the z/Data Mover as part of the connection request.  The z/Data Mover attempts to verify this message queue with the ID, and that is where it is currently failing due to a permissions error.  The permissions of the message queue created by the Message Service are automatically set to be accessible to the owning user ID, as well as the group that the owning user ID belongs to.  Because of this, the user IDs associated with both the z/Data Mover (ZDMVPROC) and the Message Service (ZMSSTART) must belong to the same group.

From the logs sent in, we can see that the groups of user IDs ZMSSTART and ZDMADM are different :

IEF695I START ZMSSTART WITH JOBNAME ZMSSTART IS ASSIGNED TO USER ZMSSTART, GROUP TCAX90

IEF695I START ZDMVPROC WITH JOBNAME ZDMVPROC IS ASSIGNED TO USER ZDMADM  , GROUP GSTDATMV

Once the groups are adjusted appropriately, the z/Data Mover should be able to verify the Message Service's IPC message queues.