IBM Support

PH28983: DFHMN0002 X'0D0D' IN MODULE DFHMNAC AFTER CEMT SET PROGRAM OPERATION COMMAND

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • CICS issued a series of DFHMN0002 0D0D errors:
    
    DFHMN0002 A severe error (code X'0D0D') has occurred
     in module DFHMNAC.
    
    These were followed by a program check, and then the
    QR TCB went into a loop while running under the CSNE
    transaction.
    
    The problems occurred after a CEMT SET PROGRAM
    OPERATION(aaaaaaaa) NEW ALL command was issued.
    
    The DFHMN0002 0D0D errors are occurring when DFHMNAC calls
    DFHMNAD for SET_APP_CONTEXT, while running under a system
    task. System tasks don't have an ADCB (Associated Data Control
    Block to hold application context data).
    
    
    The CEMT SET PROGRAM OPERATION (aaaaaaaa) NEW ALL command
    caused all non-DFH programs to have an application context.
    
    This command caused problems for system transactions like:
    
    - COIR whose initial program is  EYU9XLOP. (The PPTE for
      EYU9XLOP includes a PPTE64 extension with this context data).
    
    - CSNE who invoked a URM (DFHZNEP) that did EXEC CICS LINK
      to a program that had context data.
    
    In addition, the exception trace entry for MN 0D0D did not
    format correctly:
    
    MN 0D0D ** POINT_ID NOT RECOGNIZED **
    
    Also, the parameter list that DFHMNAC uses to call DFHMNAD
    for function SET_APP_CONTEXT is reused by DFHMNAC when it
    calls DFHMEME for the DFHMN0002 0D0D. If possible, the
    parameter lists should be split so that the call to DFHMEME
    does not overlay the response from DFHMNAD.
    
    Additional Symptom(s) Search Keywords:  KIXREVxxx
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHMN0002 X'0D0D' in DFHMNAC after a    *
    *                      CEMT SET PROGRAM OPERATION targets      *
    *                      program EYUXL09, COIR is running as     *
    *                      a system task.                          *
    ****************************************************************
    1.From CICS 5.4, the CPSM programs run as system tasks and so
    do not have an Association Data Control Block ( ADCB ). DFHMNAC
    should not be called to update association data for these.
    
    2.MNAC trace point 0D0D is not formatted.
    
    3.The call to message processing overlays the PLIST used to
    call DFHMNAD so making debugging more difficult.
    

Problem conclusion

  • DFHEIQSP is changed to check for programs beginning EYU and halt
    association data processing.
    
    The reason shown on the CEMT command response screen is changed
    from 'PROGRAM BEGINS WITH DFH' to 'PROGRAM BEGINS DFH OR EYU'.
    
    
    In addition the DFHMNAC trace point 0D0D is now formatted
       MN 0D0D MNAC  *EXC* - UNEXPECTED MNAD ERROR
    and the PLIST used for the call to DFHMNAD will be visible in
    the dump.
    
    
    The CICS Transaction Server for z/OS V5.4 V5.5 & V5.6 Knowledge
    Center will be updated as follows:
    
    In System Commands SET PROGRAM options OPERATION the following
    bullet point:
    
    The PROGRAM resource is a CICS program, that is, it has a name
    beginning "DFH".
    
    has 'or "EYU"' appended to the end.
    
    
    In CEMT SET commands CEMT SET PROGRAM options OPERATION the
    following bullet point:
    
    The program resource is a CICS program (program resources that
    begin with DFH).
    
    has 'or "EYU"' appended to the end.
    
    
    The CICS Transaction Server for z/OS V5.4 Knowledge Center will
    be updated as follows:
    
    In 'Using the SET PROGRAM OPERATION command to experiment with
    application context' at the following bullet point:
    
    You cannot use the OPERATION option on a PROGRAM resource that
    has a name beginning "DFH".
    
    has 'or "EYU" appended to the end. Also EYU will be added to the
    next sentence after the DFH.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH28983

  • Reported component name

    CICS TS Z/OS V5

  • Reported component ID

    5655Y0400

  • Reported release

    100

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-08-31

  • Closed date

    2020-11-26

  • Last modified date

    2020-12-01

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

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

    UI72784 UI72785 UI72786

Modules/Macros

  • DFHEIQSP DFHEMT55 DFHMNAC  DFHMNTRI
    

Fix information

  • Fixed component name

    CICS TS Z/OS V5

  • Fixed component ID

    5655Y0400

Applicable component levels

  • R100 PSY UI72786

       UP20/11/28 P F011

  • R200 PSY UI72785

       UP20/11/28 P F011

  • R300 PSY UI72784

       UP20/11/28 P F011

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.

[{"Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.4"}]

Document Information

Modified date:
02 December 2020