PM20059: Statistics C API call causes S0C4 abend in application

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Retrieving statistics using the Statistics C API when
  connected to a remote Gateway daemon using the
  openRemoteGatewayConnection() API call causes an S0C4 abend.
  
  The abend occurs in the populateHeader() function.
  
  CEE3204S The system detected a protection exception (System
  Completion Code=0C4). From entry point populateHeader at compile
  unit offset +00000238 at entry offset +00000238 at address
  13C5CB00.
  
  Additional search words:
  abend0c4 abends0c4
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the CICS Transaction Gateway    *
  *                 Statistics C API                             *
  ****************************************************************
  * PROBLEM DESCRIPTION: When connected to a remote Gateway      *
  *                      daemon using the                        *
  *                      openRemoteGatewayConnection() API       *
  *                      call, calling the getStatsByStatId()    *
  *                      API call resulted in an S0C4 abend in   *
  *                      the application. The abend occurs in    *
  *                      populateHeader().                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The Statistics C API uses the ioctl() system call to set the
  socket to a specific mode of operation after the initial
  connection to the Gateway daemon is established. An incorrect
  parameter was used on this call, resulting in the socket mode
  being incorrect. The subsequent code is designed to work with
  the socket in the expected mode, the socket in the incorrect
  mode results in unexpected behavior. This leads to a recv()
  system call reading data left over from a previous response
  when it expected a new response with specific header data. The
  API attempts to parse the incorrect data as a header, resulting
  in the S0C4 abend.
  

Problem conclusion

• The Statistics C API has been corrected. The ioctl() system
  call has been changed to use the correct parameter, resulting
  in the correct mode being set for the socket.
  

Temporary fix

Comments

APAR Information

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

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

  PM22912 PM23494 UK60915

Modules/Macros

•    CTGGCONC CTGGTOKC CTGRESBC CTGSACOC CTGSOCOC
  CTGSTDIC CTGSTLOC CTGSTPIC CTGSTQUC
  

Fix information

• Fixed component name

  CTG V8 FOR Z/OS

• Fixed component ID

  5655W1000

Applicable component levels

• R800 PSY UK60915

     UP10/10/07 P F010

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.