IBM Support

IT43865: QUEUE FILE MIGRATION MAY FAIL IF THE QUEUE IS NOT A LOCAL QUEUE PROBE ID UN201000.

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

  • The migration process amqoqmig cuts an FDC:
    
    | Probe Id          :- UN201000
    | Program Name      :- amqoqmig
    | Major Errorcode   :- MQRC_OPTION_NOT_VALID_FOR_TYPE
    | Minor Errorcode   :- OK
    | Probe Type        :- INCORROUT
    | Probe Severity    :- 4
    | Probe Description :- AMQ6125: An internal IBM MQ error has
    occurred.
    | FDCSequenceNumber :- 0
    | Arith1            :- 2045 (0x7fd)
    | Comment1          :- MQOPEN SYSTEM.DEFAULT.REMOTE.QUEUE failed
    with error 2045.
    

Local fix

  • There is no local fix available and not needed.
    The migration fails and "status migrate" does not show any
    information in runnscnf.
    

Problem summary

  • runnscnf does not check the type of a queue to be migrated and
    may for example attempt to migrate remote queues.
    MQ uses interfaces for queue file migration which are not
    allowed for non local queues and fails with the seen FFST.
    This can happen as of release 8.1.0.12.
    

Problem conclusion

  • The product has been changed to check the file type of the queue
    to be migrated.
    An error message will be displayed and the queue will be skipped
    from the list of queues to be migrated if it is of non
    migrateable type.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v8.1       8.1.0.15
    The latest available maintenance can be obtained from
    'Recommended Fixes for IBM MQ'
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
    If the maintenance level is not yet available information on
    its planned availability can be found in 'IBM MQ planned
    maintenance release dates'
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
    ---------------------------------------------------------------
    

Temporary fix

  • The user can check the name pattern used for
    "class QueuePattern" in runnscnf and make sure only local queues
    match that pattern.
    

Comments

APAR Information

  • APAR number

    IT43865

  • Reported component name

    MQ FOR HPE NS O

  • Reported component ID

    5724A3904

  • Reported release

    810

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2023-06-01

  • Closed date

    2023-06-02

  • Last modified date

    2023-06-02

  • 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 FOR HPE NS O

  • Fixed component ID

    5724A3904

Applicable component levels

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"810","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
03 June 2023