GSVX529E (IMSCQS) REGAPI failed, rc 00000010 rsn 00000440

Products

• SYSVIEW Performance Management
• NXBRIDGE - SYSVIEW/ENDEVOR

Issue/Introduction

 The following errors appears in the Sysview Job log:

CQS0281I REGISTRATION REJECTED FOR CLIENT=XXXXXXX, USERID=SYSVIEW     613

CQS0281I INSUFFICIENT AUTHORITY TO CQS CQSACQS

CQS0281I RACROUTE AUTH R15=00000008  RC=00000008  RSN=00000000

GSVX529E (IMSCQS) REGAPI failed, rc 00000010 rsn 00000440

CQS0281I REGISTRATION REJECTED FOR CLIENT=XXXXXXX, USERID=SYSVIEW     615

CQS0281I INSUFFICIENT AUTHORITY TO CQS CQSACQS

CQS0281I RACROUTE AUTH R15=00000008  RC=00000008  RSN=00000000

GSVX529E (IMSCQS) REGAPI failed, rc 00000010 rsn 00000440

 

Environment

Release : 16.0

Component : SYSVIEW

Cause

As per the IBM documentation (https://www.ibm.com/support/knowledgecenter/en/SSEPH2_13.1.0/com.ibm.ims13.doc.msgs/msgs/cqs0281i.htm )  :

A client attempted to register with a CQS using a CQSREG request, but the client was not authorized to register with the CQSID. CQS issues a RACROUTE REQUEST=AUTH call to determine if the registering client has the appropriate authority to register with the requested CQSID.
The client job user ID is used by CQS to perform the authorization. The user ID must have at least UPDATE authority to the CQSID.

Resolution

The indicated user should be allowed to access the requested CQS, authorize the user to the structure resource with at least RACF UPDATE authority.

Example of RACF command for authorizing CQS registration :

PERMIT CQS.CQSACQS CLASS(FACILITY) ID(SYSVIEW) ACCESS(UPDATE)

It is also needed  to authorize the connections to any structures.
To define a profile for a CQS primary structure named IMSMSGQ01,and to allow only user SYSVIEW to connect to it, issue the RACF commands shown in the following example :

RDEFINE FACILITY CQSSTR.IMSMSGQ01 UACC(NONE)
PERMIT CQSSTR.IMSMSGQ01 CLASS(FACILITY) ID(SYSVIEW) ACCESS(UPDATE)
SETROPTS CLASSACT(FACILITY)