IBM Support

IC75688: WMQFTE V7 AGENT TERMINATES WITH MQRC_SECURITY_ERROR (2063) IF IT GETS A COMMAND FROM AN UNKNOWN USERID

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • WebSphere MQ File Transfer Edition (WMQFTE) v7 agent terminates
    with
      BFGAG0107E: The agent has received a reason code of '2063'
      from the MQI.  The agent cannot continue processing and will
      now end.
    This occurs when the fteAgent receives a request from an
    unknown userid. It is expected that an unknown userid will
    result in error code 2063 MQRC_SECURITY_ERROR from WMQ but it
    was not expected that the WMQFTE agent should terminate due to
    this error code.
    ADDITIONAL KEYWORDS: WMQ FTE security error BFGAG0107E
    BFGAG0107 Active Directory RPC domain
    

Local fix

Problem summary

  • The agent terminates because it treats the MQRC_SECURITY_ERROR
    as unrecoverable.  The queue manager can return
    MQRC_SECURITY_ERROR if LDAP is temporarily unavailable, for
    example.  This is not desirable as a restart of the LDAP server
    will cause all the agents connected to the queue manager using
    that LDAP server to end.
    
    USERS AFFECTED:
    All users using MQ security
    
    PLATFORMS AFFECTED:
    All
    

Problem conclusion

  • This APAR changes how the agent treats MQRC_SECURITY_ERROR so
    instead of ending, it will try to recover.  When LDAP service is
    restored, the agents will continue processing.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IC75688

  • Reported component name

    WMQ FILE TRANSF

  • Reported component ID

    5724R1000

  • Reported release

    700

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2011-04-08

  • Closed date

    2011-05-31

  • Last modified date

    2011-05-31

  • 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

    WMQ FILE TRANSF

  • Fixed component ID

    5724R1000

Applicable component levels

  • R703 PSY

       UP

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSEP7X","label":"WebSphere MQ File Transfer Edition"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
31 May 2011