PK44000: MULTIPLE EYUPN0007W MESSAGES PRODUCED FOR THE SAME EVENT NOTIFIC ATION.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You use the RTAACTV view to discard an active RTA analysis, and
  modify the EVALDEF, and install the RTADEF. You then repeat this
  same process. After installing the RTADEF twice, the analysis
  becomes true and produces three EYUPN0007W messages for the
  the same analysis. Only one EYUPN0007W message should be
  produced.
  Additional Symtoms and Keywords : 5655-M1501 R310 R300 Real Time
  Analysis CICSPLEX CPSM
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION:    You have an RTADEF which is con-     *
  *                      trolled by a PERIODEF.  You discard     *
  *                      the active RTADEF from the RTAACTV      *
  *                      view, modify the EVALDEF, and re-       *
  *                      install the RTADEF.  When the           *
  *                      evaluation conditions are met, more     *
  *                      than one EVENT record appears.  If      *
  *                      the active RTADEF is deactivated or     *
  *                      discarded, or if the monitored MASes    *
  *                      are brought down, all of the EVENTs     *
  *                      are not removed.                        *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all CMASes must be recycled to pick    *
  *                 up the new code.  Note that the restarts     *
  *                 do not need to be done at the same time.     *
  ****************************************************************
     When an RTADEF is installed under the control of a PERIODEF,
  an entry is added to a cache list whose key contains the RTADEF
  name and the PERIODEF name.  Before the install starts, a look-
  up is performed against the list, and if the element is found,
  the install fails with appropriate messages.  After the install
  completes successfully, a new element is added to the list, but
  the status is not checked to detect a duplicate entry.  When an
  RTADEF is installed under the control of a PERIODEF, the initial
  install may have to wait on outstanding resources.  If the time
  of day is within the active period, the install method is called
  to activate the definition.  Since the initial call is still not
  complete, the cache list lookup does not find an element, the
  activation completes, and an element is added to the installed
  definition list.  Meanwhile, the install which was waiting on
  resources resumes and completes.  There are now two instances of
  the installed RTADEF active, but only one instance appears in
  the RTAACTV view.  If the active definition is discarded or de-
  activated, the EVENT associated with the second instance will
  not be removed.
     Because the key to the Installed Definition list contains the
  PERIODEF name, if the RTADEF is installed a second time with a
  different PERIODEF, or with no PERIODEF, an additional entry
  will appear in the RTAACTV view, and will cause additional EVENT
  instances to appear, but the notification index list does not
  contain the PERIODEF name, so only one EVENT will be removed
  if the RTADEF(s) are discarded or deactivated.
  

Problem conclusion

•    Module EYU0PMDI (PMDI - Install MRM Definition) was modified
  to add an element to the Installed RTADEF list at the beginning
  of the install process.  If the ADD fails, the installation is
  terminated.  If the installation fails after the element has
  been added, it will be removed.  Code was also added to detect
  an attempt to install the same RTADEF as both a timed and un-
  timed definition, and to fail the attempt with an appropriate
  message.  Module EYU0PGDI (PGDI - RTA Manual Install Driver) was
  modified to provide better detection and feedback for install
  failures, including duplicate installs.  Module EYU0PMAT (PMAT -
  MRM Timed Activate / Deactivate) and EYU0PMDD (PMDD - Discard
  RTAMRM Definition) were modified to better manage transition be-
  tween PERIODEFs with overlapping time ranges.  Several other
  modules were updated or reassembled to incorporate modifications
  to the RTAMRM SPEC Descriptor (PMSD) and the Installed RTADEF
  cache list element (PMRL).
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

•    You have an RTADEF which is
  controlled by a PERIODEF.  You
  discard the active RTADEF from the
  RTAACTV view, modify the EVALDEF,
  and reinstall the RTADEF.  When
  the evaluation conditions are met,
  more than one EVENT record appears.
  If the active RTADEF is deactivated
  or discarded, or if the monitored
  MASes are brought down, all of the
  outstanding EVENTs are not removed.
  
     When an RTADEF is installed under the control of a PERIODEF,
  an entry is added to a cache list whose key contains the RTADEF
  name and the PERIODEF name.  Before the install starts, a look-
  up is performed against the list, and if the element is found,
  the install fails with appropriate messages.  After the install
  completes successfully, a new element is added to the list, but
  the status is not checked to detect a duplicate entry.  When an
  RTADEF is installed under the control of a PERIODEF, the initial
  install may have to wait on outstanding resources.  If the time
  of day is within the active period, the install method is called
  to activate the definition.  Since the initial call is still not
  complete, the cache list lookup does not find an element, the
  activation completes, and an element is added to the installed
  definition list.  Meanwhile, the install which was waiting on
  resources resumes and completes.  There are now two instances of
  the installed RTADEF active, but only one instance appears in
  the RTAACTV view.  If the active definition is discarded or de-
  activated, the EVENT associated with the second instance will
  not be removed.
     Because the key to the Installed Definition list contains the
  PERIODEF name, if the RTADEF is installed a second time with a
  different PERIODEF, or with no PERIODEF, an additional entry
  will appear in the RTAACTV view, and will cause additional EVENT
  instances to appear, but the notification index list does not
  contain the PERIODEF name, so only one EVENT will be removed
  if the RTADEF(s) are discarded or deactivated.
  
     Module EYU0PMDI (PMDI - Install MRM Definition) was modified
  to add an element to the Installed RTADEF list at the beginning
  of the install process.  If the ADD fails, the installation is
  terminated.  If the installation fails after the element has
  been added, it will be removed.  The PERIODEF name was also
  removed from the cache list key, so an attempt to install the
  RTADEF as both a timed and untimed definition will fail with
  an appropriate message.  Module EYU0PGDI (PGDI - RTA Manual
  Install Driver) was modified to provide better feedback for
  install failures, including duplicate installs.  Several other
  methods were updated or reassembled to incorporate the modified
  key for the Installed RTADEF cache list.
  ž**** PE07/07/26 FIX IN ERROR. SEE APAR PK49746  FOR DESCRIPTION
  

APAR Information

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

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

  PK46095 UK25920

Modules/Macros

•    EYURPMRL EYURPMSD EYU0DVRC EYU0PGDD EYU0PGDE
  EYU0PGDI EYU0PGRS EYU0PMAT EYU0PMCE EYU0PMCS EYU0PMDD EYU0PMDI
  EYU0PMMN EYU0PMTR
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UK25920

     UP07/06/09 P F706

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.