IBM Support

IT45988: MFT Agent abends with NullPointerException when processing Partitioned Data Sets on z/OS.

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • Closed as program error.

Error description

  • An MFT Agent can abend (controlled termination) when processing
    Partitioned Data Sets. This is caused by a NullPointerException
    within the Java MFT Agent.
    
    This can manifest as the following stack trace.
    
    java.lang.NullPointerException
    	at
    com.ibm.wmqfte.cmdhandler.impl.FTETransferItemGenerator.generate
    TransferItemPairs(FTETransferItemGenerator.java:483)
     	at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerSAXParser$FTEIte
    mHandler.generateItemListPairs(FTECommandHandlerSAXParser.java:9
    19)
     	at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerSAXParser$FTEIte
    mHandler.endElement(FTECommandHandlerSAXParser.java:771)
     	at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerSAXParser$FTETra
    nsferSetHandler.endElement(FTECommandHandlerSAXParser.java:543)
     	at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerSAXParser$FTESAX
    Handler.endElement(FTECommandHandlerSAXParser.java:317)
     	at
    org.apache.xerces.parsers.AbstractSAXParser.endElement(Unknown
    Source)
     	at
    org.apache.xerces.impl.xs.XMLSchemaValidator.endElement(Unknown
    Source)
     	at
    org.apache.xerces.impl.XMLNSDocumentScannerImpl.scanEndElement(U
    nknown Source)
     	at
    org.apache.xerces.impl.XMLDocumentFragmentScannerImpl$FragmentCo
    ntentDispatcher.dispatch(Unknown Source)
     	at
    org.apache.xerces.impl.XMLDocumentFragmentScannerImpl.scanDocume
    nt(Unknown Source)
     	at
    org.apache.xerces.parsers.XML11Configuration.parse(Unknown
    Source)
     	at
    org.apache.xerces.parsers.XML11Configuration.parse(Unknown
    Source)
     	at org.apache.xerces.parsers.XMLParser.parse(Unknown
    Source)
     	at
    org.apache.xerces.parsers.AbstractSAXParser.parse(Unknown
    Source)
     	at
    org.apache.xerces.jaxp.SAXParserImpl$JAXPSAXParser.parse(Unknown
     Source)
     	at org.apache.xerces.jaxp.SAXParserImpl.parse(Unknown
    Source)
     	at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerSAXParser.parser
    XML(FTECommandHandlerSAXParser.java:1778)
     	at
    com.ibm.wmqfte.cmdhandler.impl.MessageHandlerImpl.externalMessag
    eHandler(MessageHandlerImpl.java:209)
     	at
    com.ibm.wmqfte.cmdhandler.impl.MessageHandlerImpl.processCommand
    (MessageHandlerImpl.java:167)
     	at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerWorkerThread.pro
    cessCommand(FTECommandHandlerWorkerThread.java:283)
     	at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerWorkerThread.run
    (FTECommandHandlerWorkerThread.java:174)
     	at java.lang.Thread.run(Thread.java:825)
     	at com.ibm.wmqfte.thread.FTEThread.run(FTEThread.java:70)
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users of MFT Agents on z/OS and s390X (Linux on Z) where the
    agent is processing Partitioned Data Sets (PDS).
    
    
    Platforms affected:
    z/OS
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    An MFT Agent can abend (controlled termination) when processing
    Partitioned Data Sets. This is caused by a NullPointerException
    within the Java MFT Agent.
    
    This can manifest as the following stack trace.
    
    java.lang.NullPointerException
    	at
    com.ibm.wmqfte.cmdhandler.impl.FTETransferItemGenerator.generate
    TransferItemPairs(FTETransferItemGenerator.java:483)
     	at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerSAXParser$FTEIte
    mHandler.generateItemListPairs(FTECommandHandlerSAXParser.java:9
    19)
     	at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerSAXParser$FTEIte
    mHandler.endElement(FTECommandHandlerSAXParser.java:771)
     	at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerSAXParser$FTETra
    nsferSetHandler.endElement(FTECommandHandlerSAXParser.java:543)
     	at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerSAXParser$FTESAX
    Handler.endElement(FTECommandHandlerSAXParser.java:317)
     	at
    org.apache.xerces.parsers.AbstractSAXParser.endElement(Unknown
    Source)
     	at
    org.apache.xerces.impl.xs.XMLSchemaValidator.endElement(Unknown
    Source)
     	at
    org.apache.xerces.impl.XMLNSDocumentScannerImpl.scanEndElement(U
    nknown Source)
     	at
    org.apache.xerces.impl.XMLDocumentFragmentScannerImpl$FragmentCo
    ntentDispatcher.dispatch(Unknown Source)
     	at
    org.apache.xerces.impl.XMLDocumentFragmentScannerImpl.scanDocume
    nt(Unknown Source)
     	at
    org.apache.xerces.parsers.XML11Configuration.parse(Unknown
    Source)
     	at
    org.apache.xerces.parsers.XML11Configuration.parse(Unknown
    Source)
     	at org.apache.xerces.parsers.XMLParser.parse(Unknown
    Source)
     	at
    org.apache.xerces.parsers.AbstractSAXParser.parse(Unknown
    Source)
     	at
    org.apache.xerces.jaxp.SAXParserImpl$JAXPSAXParser.parse(Unknown
     Source)
     	at org.apache.xerces.jaxp.SAXParserImpl.parse(Unknown
    Source)
     	at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerSAXParser.parser
    XML(FTECommandHandlerSAXParser.java:1778)
     	at
    com.ibm.wmqfte.cmdhandler.impl.MessageHandlerImpl.externalMessag
    eHandler(MessageHandlerImpl.java:209)
     	at
    com.ibm.wmqfte.cmdhandler.impl.MessageHandlerImpl.processCommand
    (MessageHandlerImpl.java:167)
     	at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerWorkerThread.pro
    cessCommand(FTECommandHandlerWorkerThread.java:283)
     	at
    com.ibm.wmqfte.cmdhandler.impl.FTECommandHandlerWorkerThread.run
    (FTECommandHandlerWorkerThread.java:174)
     	at java.lang.Thread.run(Thread.java:825)
     	at com.ibm.wmqfte.thread.FTEThread.run(FTEThread.java:70)
    

Problem conclusion

  • The MFT Agent will now no longer abend, due to throwing a
    NullPointerException, when processing Partitioned Data Sets.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v9.3 LTS   9.3.0.25
    v9.4 LTS   9.4.0.10
    v9.x CD    9.4.1
    
    The latest available maintenance can be obtained from
    'IBM MQ Recommended Fixes'
    https://www.ibm.com/support/pages/recommended-fixes-ibm-mq
    
    If the maintenance level is not yet available information on
    its planned availability can be found in 'IBM MQ
    Planned Maintenance Release Dates'
    https://ibm.biz/mqplannedmaintenance
    
    ---------------------------------------------------------------
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT45988

  • Reported component name

    MQ BASE V9.3

  • Reported component ID

    5724H7291

  • Reported release

    930

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2024-04-22

  • Closed date

    2024-07-10

  • Last modified date

    2024-07-10

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

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

Fix information

  • Fixed component name

    MQ BASE V9.3

  • Fixed component ID

    5724H7291

Applicable component levels

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"9.3","Line of Business":{"code":"LOB67","label":"IT Automation \u0026 App Modernization"}}]

Document Information

Modified date:
10 July 2024