PK19160: WLM USERID MIXED RELEASEWORKLOAD CICS AGENT CODE EXEC CICS START NON-TERMINAL

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When running CICS R620 with CPSM R2.2 you are using a "TRIGGER"
  transaction  to start a non-terminal transaction to be
  routed to a set of TARGET regions. The target AOR's are defined
  in the AORSCOPE of the WLMDEF and you use USERID for workload
  separation.  You are not specifying the USERID as part of the
  EXEC CICS START command, but are counting on the USERID of the
  TRIGGER transaction.
  When you migrate your CPSM to R3.1, and leave your CICS regions
  running R620, the USERID is not honored.  The AORSCOPE reverts
  to using the default defined in the WLMSPEC so your workload
  fails to route properly.
  If the CICS regions are upgraded to R640, the problem does not
  occur.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: When using CPSM WLM with a routing      *
  *                      region running either CICS 5.3.0 or     *
  *                      CICS 6.2.0, an invalid userid may be    *
  *                      associated with the route request.      *
  *                      This may result in invalid routing      *
  *                      requests and invalid affinities.        *
  *                                                              *
  *                      Note that the routing region can be a   *
  *                      normal routing region, or a target      *
  *                      region that is defined as a CPSM        *
  *                      routing region to participate in the    *
  *                      management of non-terminal starts.      *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all MASes that are defined as CPSM     *
  *                 routing regions must be restarted.  Note     *
  *                 that the restarts do not need to occur at    *
  *                 the same time.                               *
  ****************************************************************
  When CPSM receives a route request from CICS (when EYU9XLOP is
  specified as the DTRPGM or DSRTPGM), a userid must be associated
  with the request, in order to perform separation and/or build
  and maintain affinities, based upon the installed WLMSPEC,
  WLMDEFs, and TRANGRPs.  EYU9XLOP issues an EXEC CICS ASSIGN to
  retrieve the userid associated with the task under which the
  request was made, and places it in the CPSM transaction data
  area control block (EYURWTDA) for the request, in field
  TDA_LCL_USERID.
  
  For CICS 6.3.0 and greater, the userid is also passed to
  EYU9XLOP in the CICS dynamic routing commarea (DFHDYPDS).  This
  value is stored in field TDA_DYRUSERID of the request's
  EYURWTDA.
  
  During the route determination process, method EYU0WDIN (WDIN)
  retrieves the userid from the EYURWTDA.  WDIN always assumes
  that TDA_DYRUSERID has been set.  Since this is only set when
  the routing region is running CICS 6.3.0 or higher, an invalid
  value, most likely low values, is used when the routing region
  is running CICS 6.2.0 or lower.  This will result in possible
  invalid matches when determining separation or affinities.
  

Problem conclusion

• WDIN has updated to only use the value in TDA_DYRUSERID when it
  is valid.  Otherwise, the value in TDA_LCL_USERID will be used.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• When using CPSM WLM with a routing
  region running either CICS 5.3.0 or
  CICS 6.2.0, an invalid userid may be
  associated with the route request.
  This may result in invalid routing
  requests and invalid affinities.
  
  Note that the routing region can be a
  normal routing region, or a target
  region that is defined as a CPSM
  routing region to participate in the
  management of non-terminal starts.
  
  
  When CPSM receives a route request from CICS (when EYU9XLOP is
  specified as the DTRPGM or DSRTPGM), a userid must be associated
  with the request, in order to perform separation and/or build
  and maintain affinities, based upon the installed WLMSPEC,
  WLMDEFs, and TRANGRPs.  EYU9XLOP issues an EXEC CICS ASSIGN to
  retrieve the userid associated with the task under which the
  request was made, and places it in the CPSM transaction data
  area control block (EYURWTDA) for the request, in field
  TDA_LCL_USERID.
  
  For CICS 6.3.0 and greater, the userid is also passed to
  EYU9XLOP in the CICS dynamic routing commarea (DFHDYPDS).  This
  value is stored in field TDA_DYRUSERID of the request's
  EYURWTDA.
  
  During the route determination process, method EYU0WDIN (WDIN)
  retrieves the userid from the EYURWTDA.  WDIN always assumes
  that TDA_DYRUSERID has been set.  Since this is only set when
  the routing region is running CICS 6.3.0 or higher, an invalid
  value, most likely low values, is used when the routing region
  is running CICS 6.2.0 or lower.  This will result in possible
  invalid matches when determining separation or affinities.
  
  
  WDIN has updated to only use the value in TDA_DYRUSERID when it
  is valid.  Otherwise, the value in TDA_LCL_USERID will be used.
  

APAR Information

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

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

  PK19337 UK11655

Modules/Macros

•    EYU0WDIN
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UK11655

     UP06/02/11 P F602

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.