PH08039: CPSM API PROGRAM FAILS WITH RESPONSE=1030 (ENVIRONERROR) REASON=1321 (SOCRESOURCE) RESULT=0

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CPSM batch API programs are intermittently failing with
  CPOBJECT: ERROR GETTING RESOURCE TABLE.
  RESPONSE=1030 (ENVIRONERROR) REASON=1321 (SOCRESOURCE) RESULT=0
  .
  A retry of the batch API program usually succeeds.
  REASON=1321 SOCRESOURCE indicates that connected CMAS has
  run out of API command descriptors of which it should have 64.
  Problem occurs after upgrade from CPSM 5.1 to 5.4.
  

Local fix

• RESTART to CMAS
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of CICSPlex SM V5R2M0, V5R3M0,     *
  *                 V5R4M0 and V5R5M0.                           *
  ****************************************************************
  * PROBLEM DESCRIPTION: Using an API command with a large       *
  *                      buffer area can result in API           *
  *                      command descriptor chain corruption     *
  *                      eventually resulting in RESP=1030       *
  *                      (ENVIRONERROR) and RESP2=1321           *
  *                      (SOCRESOURCE).                          *
  ****************************************************************
  * RECOMMENDATION: After applying this PTF, restart all API     *
  *                 BATCH programs to use the updated SEYAUTH    *
  *                 library.                                     *
  ****************************************************************
  When a batch address space issues a command using the CPSM API
  it must acquire a command descriptor to send the command to
  the connected CMAS. The response will be returned in a buffer
  area within this command descriptor. Certain commands, (such
  as FEEDBACK), may result in very large responses, which cannot
  be contained within this buffer. In this case, CPSM will
  acquire a new command descriptor with sufficient space as
  specified by the batch program and copy the data into that new
  command descriptor.  The original command descriptor should be
  returned to the free command descriptor queue so that it can
  be used by other API commands.
  The response is built in the new command descriptor buffer
  area, and is returned correctly to the calling program.  A
  fault in module EYU0ABI0 causes the original command
  descriptor to be referenced during the clean up phase.  This
  could happen even after it had already been allocated to
  another process, which can lead to corruption of the free
  command descriptor chain, potentially orphaning free command
  descriptors from this chain as well as orphaning the new,
  larger, command descriptor.
  The two consequences of this are a small leak of storage in
  the CPSM DAT data cache, and also that there are fewer command
  descriptors available for future processes to use. This can
  cause future requests to fail with response ENVIRONERROR
  SOCRESOURCE RESP=1030 RESP2=1321.
  If this is observed then a CPSM COLD restart of the CMAS is
  recommended to resolve the memory leak.
  

Problem conclusion

• CPSM module EYU0ABI0 has been modified to perform all clean up
  operations using the newly returned command descriptor rather
  than continuing to refer to the one originally allocated.
  Both command descriptors are released correctly.
  
  Keywords
  ENVIRONERROR SOCRESOURCE RESP=1030 RESP2=1321
  

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:

  UI61379 UI61380 UI61381 UI61382

Modules/Macros

• EYU0ABI0
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R00M PSY UI61382

     UP19/02/23 P F902 ¢

• R10M PSY UI61380

     UP19/02/21 P F902 ¢

• R20M PSY UI61381

     UP19/02/23 P F902 ¢

• R90M PSY UI61379

     UP19/02/28 P F902 ¢

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.