IBM Support

CICS BAC List VSAM files fails with CBKDC8008E Unknown Error EXCI Error codes: 00000010 00000261 010800B0

Question & Answer


Question

Why do I receive ISPF short message "Server error, rc= 4, rsn= 76, Unknown EXCI error" when I select CICS Batch Application Control (CICS BAC) ISPF dialog option 1 'VSAM files' on panelid CBKPRGRM for '**Region Resource**s' in my test LPAR instead of getting a list of VSAM files returned?

The z/OS syslog showed message:

+CBKDC8008E applid Unknown error received from region cics_region during EXCI request. Error codes: 00000010 00000261 010800B0

Answer

The Error codes in message CBKDC8008E for an EXCI request map to the EXCI return codes as follows:

In assembler copybook DFHXCRCD the first word is the response code:
EXCI_SYSTEM_ERROR EQU 16

The 2nd word is the reason code x'261' which maps to:
IRC_CONNECT_FAILURE EQU 609

CICS Transaction Server (CICS TS) module DFHXCPRH uses the IRC return code for the subreason fields:

     *  None of the above, just set connect system error and use
     *  IRPs return code as the subreason field
     *
           MVC   EXCI_RESPONSE,=A(EXCI_SYSTEM_ERROR) Set response
           MVC   EXCI_REASON,=A(IRC_CONNECT_FAILURE) Set reason

CICS TS module DFHIRPS just past label IRSECFRE following a RACROUTE AUTH call, saves the SAF RC as then 2nd byte:

       SLL   RE,16               Reposition SAF RC

...and the reasons in byte 1, 3 and 4:

       ICM   RE,B'1011',=AL3(256*256***IRERQAUT**+**IRERRSCF**)

IRC Interregion control blocks in the CICS TS documentation describes the qualifiers:

 HEX  00B0  IRERRSCF  Security check failed  
 
     Qualifiers for security check failure  

 HEX  01  IRERQAUT  IRERRSCF qualifier AUTH denied access

Checking z/OS syslog, I then found the message ICH408I for resource DFHAPPL where the userid did not have access.

See CICS BAC support for CICS EXCI security in the CICS BAC documentation which explains the EXCI security requirements for the TSO (ISPF) user.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSWHM2","label":"CICS Batch Application Control for z\/OS"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Component":"","Version":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CICSBAC CICS BAC

Document Information

Modified date:
05 January 2016

UID

dwa1246562