PK26158: SOCRESOURCE RETURNED AFTER CPSM API RUNS IN MULTIPLE CICS REGIONS IMMEDIATELY FOLLOWING THE CICS REGION STARTS (1321)

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You have an API that is started from the PLTPI during MAS (CICS
  REGION ) initialization.  This is set up to run in multiple CICS
  regions.  This program fails because the connection to the CMAS
  has not been established(NOTAVAILABLE (1034) CPSMAPI (1334)) is
  returned.  The in turn causes the allocated COMMAND DESCRIPTORS
  to be orphaned.  Later when ANY CPSM API program tries to
  CONNECT to the CMAS, a SOCRESOURCE, 1321 is returned.
  .
  Additional Symptoms(s) Search Keyword(s):
  .
  WUI COVA task or CICS CPSM user API tasks in MAS may abend
  in method XDE2 at offset x'4D4' at label EXCP_EXIT_TRACE
  due to an attempt to trace the command descriptor.  The
  following messages will be issued:
  .
  EYUXL0900I   Starting Environment Recovery
  EYUXL0905E applid   ASRA IN XDE2, OFFSET 000004D4
  EYUXL0905E INTC=0004 ILC=6 TXCP=00000000 SCODE=S00C4
  EYUXL0905E Methods=XDE2,XDE0,XDER,XLAP
  EYUXL0906I Registers at ABEND
  EYUXL0907I GPR0-GPR3 0052A014 38F1C308 00000400 38413A80
  EYUXL0907I GPR4-GPR7 0000000A 37974170 38F1B398 38F1BF18
  EYUXL0907I GPR8-GPRB 00000000 379EE9F0 00526014 00000000
  EYUXL0907I GPRC-GPRF 38F1BD30 38F1BF18 B8413D6A 378DBE20
  EYUXL0907I ARR0-ARR3 00000000 00000000 00000000 00000000
  EYUXL0907I ARR4-ARR7 00000000 00000000 00000000 00000000
  EYUXL0907I ARR8-ARRB 00000000 00000000 01FF0027 00000000
  EYUXL0907I ARRC-ARRF 00000000 00000000 00000000 00000000
  EYUXL0908I Storage At ABEND
  EYUXL0909I -20  D35C35F0  D207D39E  35A8D207  D3A635B0
  EYUXL0909I -10  9630D3D6  12AA4780  34ACD203  A0383600
  EYUXL0909I +00  D203A03C  3604D601  D334360A  D20BD360
  EYUXL0909I +10  C020D207  D3AE35A0  9180D0C4  471034B8
  

Local fix

• Ensure MASPLTWAIT(YES) is specified in the EYPARMs of the LMAS
  .
  Additional Symptom: You attempt to perform an action using the
  WUI, and receive continuous 'please wait' messages.  In the
  meantime, you see COVP being attached repeatedly.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:    You have a CPSM API program started  *
  *                      from the PLTPI during MAS (CICS Region) *
  *                      initialization, which runs in multiple  *
  *                      CICS regions.  The program fails when   *
  *                      the connection to the CMAS has not been *
  *                      established;  several API Response /    *
  *                      Reason pairs may be returned including, *
  *                      but not limited to:                     *
  *                                                            . *
  *                      NOTAVAILABLE (1034)/CPSMAPI (1334)      *
  *                      and                                     *
  *                      FAILED (1029)/EXCEPTION (1359).         *
  *                                                            . *
  *                      Later when ANY CPSM API program tries   *
  *                      to CONNECT to the CMAS, a Response and  *
  *                      Reason of                               *
  *                                                            . *
  *                      ENVIRONERROR (1030)/SOCRESOURCE (1321)  *
  *                                                            . *
  *                      is returned.                            *
  *                         FEEDBACK commands will fail in CPSM  *
  *                      API programs, including the CPSM Web    *
  *                      User Interface (WUI) Server, executing  *
  *                      in a MAS.  The API program may be seen  *
  *                      to hang as it waits indefinitely to be  *
  *                      POSTed to resume processing when the    *
  *                      command completes in the CMAS.          *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all MASes must be recycled to pick     *
  *                 up the new code.  Note that the restarts     *
  *                 do not need to be done at the same time.     *
  ****************************************************************
     When a CPSM API command is executed, the API Routing module
  for that command, EYU0XDE# (XDE#) where # is 1 - 5, acquires a
  Command Descriptor from a pool in the DAT cache data space,
  initializes it, and transmits a MAL (Method Argument List) with
  a pointer to the command descriptor, to the CMAS for execution.
  If the transmission fails, or if an exception occurs in the
  router module, the command descriptor is not returned to the
  free pool for reuse.  After 64 such failures the free pool is
  exhausted, and further API commands will fail with ENVIRONERROR
  and SOCRESOURCE, until the CMAS is recycled to reinitialize the
  Command Descriptor pool.
     When a command is passed to the CMAS for execution, the MAS
  in which the command was submitted is identified in a structure
  called the Origin Block (XDOB).  When initializing the Origin
  Block for a FEEDBACK command, the CONTEXT (CICSplex to which
  the MAS belongs) was omitted.
  

Problem conclusion

•    The API Router modules EYU0XDE0 (XDE0 - API Primary Router)
  and EYU0XDE1-5 (XDE1-5 - Low Level API Routers) were modified
  to insure that the Command Descriptor acquired from the free
  pool will always be released, even if an exception occurs in
  the routing process.  Module EYU9XLAP (XLAP - API RMI TRUE) was
  modified to return control to the calling program when an API
  command is submitted before the MAS Agent has initialized.
     The Origin Block for FEEDBACK commands is fully initialized
  in module EYU0XDE2 (XDE2 - ADDRESS, QUERY, FEEDBACK Router).
  

Temporary fix

•             *********
              * HIPER *
              *********
  FIX AVAILABLE BY PTF ONLY
  

Comments

•    You have a CPSM API program started
  from the PLTPI during MAS (CICS Region)
  initialization, which runs in multiple
  CICS regions.  The program fails when
  the connection to the CMAS has not been
  established;  several API Response /
  Reason pairs may be returned including,
  but not limited to:
                                         .
  NOTAVAILABLE (1034) / CPSMAPI (1334)
  and
  FAILED (1029) / EXCEPTION (1359).
                                         .
  Later when ANY CPSM API program tries
  to CONNECT to the CMAS, a Response and
  Reason of
  ENVIRONERROR (1030) / SOCRESOURCE (1321)
  is returned.
     FEEDBACK commands will fail in CPSM
  API programs, including the CPSM Web
  User Interface (WUI) Server, executing
  in a MAS.  The API program may be seen
  to hang as it waits indefinitely to be
  POSTed to resume processing when the
  command completes in the CMAS.
  
     When a CPSM API command is executed, the API Routing module
  for that command, EYU0XDE# (XDE#) where # is 1 - 5, acquires a
  Command Descriptor from a pool in the DAT cache data space,
  initializes it, and transmits a MAL (Method Argument List) with
  a pointer to the command descriptor, to the CMAS for execution.
  If the transmission fails, or if an exception occurs in the
  router module, the command descriptor is not returned to the
  free pool for reuse.  After 64 such failures the free pool is
  exhausted, and further API commands will fail with ENVIRONERROR
  and SOCRESOURCE, until the CMAS is recycled to reinitialize the
  Command Descriptor pool.
     When a command is passed to the CMAS for execution, the MAS
  in which the command was submitted is identified in a structure
  called the Origin Block (XDOB).  When initializing the Origin
  Block for a FEEDBACK command, the CONTEXT (CICSplex to which
  the MAS belongs) was omitted.
  
     The API Router modules EYU0XDE0 (XDE0 - API Primary Router)
  and EYU0XDE1-5 (XDE1-5 - Low Level API Routers) were modified
  to insure that the Command Descriptor acquired from the free
  pool will always be released, even if an exception occurs in
  the routing process.  Module EYU9XLAP (XLAP - API RMI TRUE) was
  modified to return control to the calling program when an API
  command is submitted before the MAS Agent has initialized.
     The Origin Block for FEEDBACK commands is fully initialized
  in module EYU0XDE2 (XDE2 - ADDRESS, QUERY, FEEDBACK Router).
  ž**** PE06/09/11 FIX IN ERROR. SEE APAR PK30972  FOR DESCRIPTION
  

APAR Information

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

  PK26162

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

  UK16233

Modules/Macros

•    EYU0XDE0 EYU0XDE1 EYU0XDE2 EYU0XDE3 EYU0XDE4
  EYU0XDE5 EYU9XLAP
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UK16233

     UP06/07/19 P F607

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.