PK17360: ENABLE CPSM TO USE CICS MESSAGE DOMAIN TO ISSUE MESSAGES

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR is raised to allow CPSM to use CICS message domain to
  issue messages.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: New function to allow CICSPlex SM the   *
  *                      ability to use the CICS message domain  *
  *                      to build up a CICSPlex SM message.      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  New function is required to allow CPSM to retrieve CPSM
  messages from the CPSM message table by using the CICS
  message domain, using the retrieve_message function.
  XMEOUT will need to be extended to be invoked for
  CPSM messages.
  

Problem conclusion

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• The CICS message domain has been enhanced to allow
  CICSPlex SM to retrieve a CICSPlex SM message from the
  CICSPlex SM message table by using the CICS message
  domain.
  CICSPlex SM messages will be obtained via the RETRIEVE_MESSAGE
  domain call to message domain. XMEOUT can now be invoked for
  CICSPlex SM messages only on the RETRIEVE_MESSAGE function, but
  will be more restricted in its capabilities. The XMEOUT
  parameter list has been enhanced to allow the exit to
  distinguish between CICS and CICSPlex SM messages.
  Compatibility with existing XMEOUT exits has been maintained
  and no further action is required after application of this
  apar.
  The CICS Transaction Server for z/OS v3.1 Messages and Codes,
  GC34-6442-02 will be updated to include the new message
  DFHME0140.
  DFHME0140 applid CICSPlex SM messages cannot be issued because
  the English message table mmmmmm cannot be found.
  Explanation:
  The message load module mmmmmm was not found in STEPLIB
  for the CICS job.
  This load module is required for CICSPlex SM messages.
  System Action:
  An exception entry is made in the CICS trace table.  Message
  domain stops processing this message and returns a disaster
  response to CICSPlex SM which in turn cannot continue to issue
  messages because its message module has not been loaded.
  User Response:
  This error could have occurred because the CICSPlex SM
  authorized library, which contains the default message load
  module is not in the JCL for the CICS job. Ensure that the
  correct library is included in the STEPLIB concatenation of the
  CICS JCL and restart your CICS.
  Destination:
  Console
  Modules:
  DFHMEME
  The CICS Transaction Server for z/OS v3.1 Customization Guide,
  SC34-6429-02 will be updated for the enhancements to the XMEOUT
  global user exit.
  Chapter 1, Message domain exit XMEOUT should be updated to read:
  For CICSPlex SM, XMEOUT will be invoked only for messages that
  have a destination of EYULOG. Check the CICSPlex SM Messages
  and Codes manual to see which messages this applied to.
  
  For CICSPlex SM, it cannot suppress or reroute messages sent
  to EYULOG.
  It cannot reroute or suppress CICSPlex SM web user interface
  messages.
  
  The XMEOUT exit allows you to suppress or reroute CICS and
  CICSPlex SM messages that use the message domain.
  
  As it is now possible to pass APPLID as an optional parameter in
  a message , the APPLID that is inserted in a message may not be
  the applid of the current CICS system. For example, when a MAS
  message is routed to a CMAS, the APPLID of the MAS system may
  be passed, therefore the message will contain the APPLID of
  the MAS system and not the current system (the CMAS).
  The description of UEPMNTD has been clarified:
  
  UEPMNTD
      Address of halfword containing number of TDQs in the TDQ
      array.
  Additional parameters have been included after UEPNRTE.
  These are:
  UEPCPID
      Address of 3-byte product ID. The possible values are:
      DFH   CICS Messages.
      EYU   CICSPlex SM messages.
      Note when this is EYU, for CICSPLex SM, UEPMNUM and UEPMDOM
       will be binary zeros.
   UEPCPDOM
       Address of a 2-byte field containing the domain
       identifier of the message.
   UEPCPNUM
       Address of a 4-byte field containing the message number.
   UEPCPSEV
       Address of message severity code.
  
   Response UERCBYP should be amended to include:
   Note CICSPlex SM messages being retrieved cannot be suppressed
   and such a response will be treated as normal.
   The CICS Transaction Server for Z/OS V3.1 Supplementary Data
   Areas, LY33-6108-00, will be updated to include the changes to
   the ME domain anchor block where the following fields after
   MSG_LEVEL_INFO have been added:
    (244) address   4  CPSM_DEFAULT_LANG_PTR
                          Default CICSPlex SM table pointer
    (248) address   4  CPSM_MSG_MOD_PTRS(MAX_LANGUAGES)
                          Array of pointers one for each user
                          message module
  
  ž**** PE07/04/20 FIX IN ERROR. SEE APAR PK43718  FOR DESCRIPTION
  

APAR Information

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

  PK16582

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

  UK16641

Modules/Macros

•    DFH$SXP1 DFH$SXP2 DFH$SXP3 DFH$SXP4 DFH$SXP5
  DFH$SXP6 DFHAMER  DFHMEBM  DFHMEBU  DFHMEDM  DFHMEDS  DFHMEDUF
  DFHMEFO  DFHMEIN  DFHMEME  DFHMEMEA DFHMEMEC DFHMEMEE DFHMEMEH
  DFHMEMEJ DFHMEMEK DFHMEMEM DFHMEMER DFHMEMET DFHMEMEV DFHMEME1
  DFHMEME2 DFHMEMGT DFHMEPS  DFHMESR  DFHMETMD DFHMEU   DFHMEWS
  DFHMGPME DFHSUME  DFHUEXIT DFH17360 MFHMEMEE
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK16636

     UP06/08/04 P F608

• R403 PSN

     UP

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.