PM72031: JCICS METHOD SETNEXTCOMMAREA() DID NOT CORRECTLY SET UP THE COMMAREA FOR THE EXEC CICS RETURN

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible in next release.

Error description

• You are trying to run the program control example for JCICS on
  how to use the JCICS program class to pass a COMMAREA to
  another program. But it seems that the setNextCOMMAREA() method
  is not correctly set up for the COMMAREA on the EXEC CICS
  RETURN.
  You are using the program control examples located at
  /samples/dfjcics/examples/ProgramControl/
  The setNextCOMMAREA() did not correctly set up the COMMAREA for
  the return. You can see that COMMAREA is null, and the
  COMMAREALength is 0 while stepping through using CEDF. But
  referring to the documentation this does not act as described.
  Additional Symptom(s) Search Keyword(s): KIXREVSVR
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: ALL CICS users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: The setNextCOMMAREA method for          *
  *                      TerminalPrincipalFacility doesn't       *
  *                      work correctly in CICS V4.2 whereby     *
  *                      the commarea is lost on a return.       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  In CICS V4.2, when JCICS program tries to pass a COMMAREA using
  setNextCOMMAREA() method, COMMAREA is not correctly set up
  for the next transaction. The EXEC CICS RETURN shows null
  COMMAREA and the length of COMMAREA is 0. Because the COMMAREA
  length is now only set when JCICS fails to get the COMMAREA
  elements.
  

Problem conclusion

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• DTCPROGRAM has been changed to set correct CommArea length
  when JCICS gets the COMMAREA successfully during the EXEC
  CICS RETURN.
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK83163

Modules/Macros

•    DFJ@H356 DFJDTCOE
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R70D PSY UK83163

     UP12/11/09 P F211

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.