IBM Support

SE40600: MQCRTMH API CALLED FROM RPG/ILE RETURNS REASON CODE 2461

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Calling the MQCRTMH API from an ILE/RPG program results in
    reason code 2461, On an MQCRTMH call, the create message handle
    options structure MQCMHO is not valid.
    
    The reason code is seen in debug.
    The following is seen in trace:
    zstMQCRTMH_CheckParms
     xcsCheckPointer
     xehAS400ConditionHandler(): Expected exception |MCH3601|
     xehRemoveConditionMsg(): Removing message because of xehRmvMsg
    !xcsCheckPointer rc=xecS_I_ACCESS_DENIED
    zstMQCRTMH_CheckParms rc=MQRC_CMHO_ERROR
    

Local fix

  • There are two work around:
    1)Remove the VALUE field from the CRTOPT in the CMQG RPG copy
      file and recompile your program, or
    2)Create your own procedure definition and use it instead, eg
    .
    DMQCRTMH2         PR                  EXTPROC('MQCRTMH')
    D* Connection handle
    D HCONN                         10I 0
    D* Options that control the action of MQCRTMH
    D CRTOPT                        12A
    D* Message handle
    D HMSG                          10I 0
    D* Completion code
    D CMPCOD                        10I 0
    D* Reason code qualifying CompCode
    D REASON                        10I 0
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    WMQ users trying to use MQCRTMH API in ILE/RPG
    
    Platforms affected:
    iSeries
    
    ****************************************************************
    PROBLEM SUMMARY:
    The CMQG RPG copyfile was incorrectly declaring the CRTOPTS
    structure for MQCRTMH
    

Problem conclusion

  • WMQ RPG copyfile CMQG has been modified to correct the procedure
    definition for MQCRTMH
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
                       v7.0
    Platform           Fix Pack 7.0.1.2
    --------           --------------------
    iSeries            tbc_p700_0_1_2
    
    The latest available maintenance can be obtained from
    'WebSphere MQ Recommended Fixes'
    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 'WebSphere MQ
    Planned Maintenance Release Dates'
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
    ---------------------------------------------------------------
    

Temporary fix

Comments

APAR Information

  • APAR number

    SE40600

  • Reported component name

    WMQ ISERIES V7

  • Reported component ID

    5724H7226

  • Reported release

    701

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2010-01-04

  • Closed date

    2010-01-12

  • Last modified date

    2010-01-12

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

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

Modules/Macros

  • RCHMGR
    

Fix information

  • Fixed component name

    WMQ ISERIES V7

  • Fixed component ID

    5724H7226

Applicable component levels

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCPQ63","label":"APAR \/ Maintenance"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
27 April 2020