We are upgrading to new release of CICS and when the CICS USS option is enabled the CICS startup hangs waiting on DCCOCPR.

book

Article ID: 36971

calendar_today

Updated On:

Products

CA Datacom - DB CA Datacom CA Datacom - AD CA Datacom - Server CA CIS CA Common Services for z/OS CA 90s Services CA Database Management Solutions for DB2 for z/OS CA Common Product Services Component CA Common Services CA Datacom/AD CA ecoMeter Server Component FOC CA Easytrieve Report Generator for Common Services CA Infocai Maintenance CA IPC Unicenter CA-JCLCheck Common Component CA Mainframe VM Product Manager CA Chorus Software Manager CA On Demand Portal CA Service Desk Manager - Unified Self Service CA PAM Client for Linux for zSeries CA Mainframe Connector for Linux on System z CA Graphical Management Interface CA Web Administrator for Top Secret CA CA- Xpertware

Issue/Introduction

Symptoms: 

We are upgrading to new release of CICS.

  • When the CICS USS option is enabled the CICS startup hangs waiting on DCCOCPR. USS is enabled by specifying the USSHOME parameter in the CICS DFHSIT.
  • When the CICS USS option is not enabled the CICS region starts, or when DCCOCPR is disabled, the CICS regions also starts.

What can be causing this?

  

Cause: 

This is due to the CPLT task waiting for an open TCBs to become available. The USS option takes up one open TCB so if there are insufficient open TCBs defined the CPLT task will hang. You can confirm this by looking at a CICS SVC dump and checking if the CPLT task waiting on resource DISPATCH OPENPOOL

Follow this procedure to analyse the dump with IPCS:

    1. Issue this command in IPCS to format the CICS control blocks: 

      VERBEXIT DFHPD670 'JOB=CURRENT,KE=3,DS=1,TR=3'

      You need to use the correct DFHPDxxx for the release of CICS you are using. CICS TS 4.2 is CICS 6.7 so you need DFHPD670. DFHPD650 is for CICS TS 3.2. 

      You also need the CTS420.SDFHLINK in the STEPLIB.

    2. Look for 'KE_TASK Summary' in the report and search for the CPLT task: 

      ===KE: Kernel Domain KE_TASK Summary 
      KE_NUM KE_TASK STATUS TCA_ADDR TRAN_# TRANSID DS_TASK KE_KTCB ERROR 
       
      0001 164EC000 KTCB Step 00000000 00000000 16530038 
      0002 164EC630 KTCB QR 00000000 16519F00 165331B8 
      ....
      0020 166E0630 Not Running 0004C080 00008 CPLT 166B2080 165331B8 <-------
      0021 166EF450 Not Running 00000000 166B2C80 165331B8 

      You can see above CPLT is task 0020 with an address of 166E0630.

    3. Now find 'DS: TASKS SUMMARY' and look in the KE_TASK column for address 166E0630

      ==DS: TASKS SUMMARY

      DS_TOKEN KE_TASK T S F P TT RESOURCE RESOURCE_NAME W TIME OF TIMEOUT

      TYPE SUSPEND DUE 
      00860003 166A3630 S S N N - ICMIDNTE DFHAPTIM S 06:13:56.605 - 
      008E0003 177C6800 S S N N - ICEXPIRY DFHAPTIX S 06:15:56.238 - 
      01000003 166E0630 S S P N - DISPATCH OPENPOOL S 06:14:03.079 - <-------  

      This shows the task is waiting on resource DISPATCH OPENPOOL 

 

Resolution:

Increase the value for the MAXOPENTCBS parameter in the CICS DFHSIT. 

Alternatively you can specify MAXOPENTCBS in the JCL in the PARM paramerter of the EXEC statement or in the SYSIN data set of the CICS startup.

 

Environment

Release: DATABB00200-14-Datacom/AD
Component: