PK13973: A REQUEST USING WEB SERVICES PERFORMS A DPL TO A REMOTE REGION PASSING A COMMAREA THAT'S INVALID RESULTING IN A DFHSM0102.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A request comes into CICS using WEBSERVICES and performs a DPL
  to program in a Remote Region.  The COMMAREA passed on the DPL
  is invalid.  The DPL request that is shipped to the remote
  region is shipped with an invalid user COMMAREA by DFHPIRI. When
  the DPL request completes and that the user program COMMAREA is
  returned, DFHXTP transformer_4 move's the COMMAREA from the
  FMH43 into DFHPIRI DSA causing the overlay.
  .
  The problem is in DFHPIRI where the address of the pointer to
  the COMMAREA is being passed on the EXEC CICS LINK call instead
  of the pointer itself.
  Additional Symptoms and Keywords:
  MSGDFHSM0102 RIDS/DFHSMGF PTFS/HCI6400 PRCS/0000030B
  x'030B' 030b Storage violation in TOR
  DFHPG0002 X'190A' DFHPGCR
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: DFHSM0102 storage violation when        *
  *                      linking to a remote web services        *
  *                      provider application using a COMMAREA.  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A web services provider pipeline does a link to a target
  application program which is defined as remote. DFHPITL calls
  the exec layer remote stub program DFHPIRI to perform the remote
  link, passing the user commarea in container DFHWS-REMOTECA.
  DFHPIRI incorrectly passes the commarea pointer piri_ca_ptr,
  rather than the commarea itself, on the link request. The
  commarea pointer piri_ca_ptr is defined as a DFHPIRI work
  variable. Consequently a copy of DFHPIRI local storage starting
  at piri_ca_ptr is passed on the link request rather than the
  real commarea. On completion of the link request transformer 4
  unwrap processing overlays DFHPIRI storage starting at
  piri_ca_ptr with the modified commarea.
  During program termination DFHAPLI1 attempts to FREEMAIN local
  storage for DFHPIRI resulting in the reported DFHSM0102 storage
  violation because the trailing storage accounting area has been
  overlaid.
  
  Additional Keywords: MSGDFHSM0102 SM0102
  

Problem conclusion

• CICS modules DFHPIRI and DFHPITL have been changed to pass the
  correct commarea storage on the remote link request and pass the
  modified commarea back on the pipeline.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK10267

Modules/Macros

•    DESPITL  DFHPIRI  DFHPITL
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK10267

     UP05/12/23 P F512

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.