PI93625: MQ MFT for z/OS agent abends on startup if the agent property "adminGroup" is set.

APAR status

• Closed as program error.

Error description

• An IBM MQ Managed File Transfer for z/OS V9.0.4.0 agent has been
  configured with the agent property:
  
    adminGroup
  
  set to the name of the group of users that can administer it.
  When the agent is started using the fteStartAgent command, the
  Java Runtime Environment that the agent is running in abends and
  generates a Javacore containing the following information:
  
  ************************************************************
  TITLE subcomponent dump routine
  ===============================
  IBM-1047
  Dump Event "abort" (00020000) received
  :    :    :    :    :    :    :    :    :    :    :     :    :
     :    :    :    :    :
  ------------------------------------------------------------
  THREADS subcomponent dump routine
  =================================
  Thread Details
  
  "main" J9VMThread:0x13389000, omrthread_t:0x12FC4D48,
  java/lang/Thread:0x138287E8, state:R, prio=5
         (java/lang/Thread getId:0x1, isDaemon:false)
         (native thread ID:0x12EE9000, native priority:0x5, native
  policy:UNKNOWN, vmstate:R, vm thread flags:0x00000000)
        CPU usage total: 7.709000000 secs, current
  category="Application"
        Heap bytes allocated since last GC cycle=390456 (0x5F538)
        Java callstack:
            at
  com/ibm/wmqfte/ipc/impl/NativeIPCServer.initialize(Native
  Method)
            at
  com/ibm/wmqfte/ipc/impl/NativeIPCServer.<init>(NativeIPCServer.j
  ava:118)
            at
  com/ibm/wmqfte/ipc/IPCFactory.newIPCServer(IPCFactory.java:91)
            at com/ibm/wmqfte/agent/Agent.main(Agent.java:333)
            at sun/reflect/NativeMethodAccessorImpl.invoke0(Native
  Method)
            at
  sun/reflect/NativeMethodAccessorImpl.invoke(NativeMethodAccessor
  Impl.java:90)
            at
  sun/reflect/DelegatingMethodAccessorImpl.invoke(DelegatingMethod
  AccessorImpl.java:55)
            at java/lang/reflect/Method.invoke(Method.java:508)
            at
  com/ibm/wmqfte/api/StartAgent.main(StartAgent.java:444)
            at sun/reflect/NativeMethodAccessorImpl.invoke0(Native
  Method)
            at
  sun/reflect/NativeMethodAccessorImpl.invoke(NativeMethodAccessor
  Impl.java:90)
            at
  sun/reflect/DelegatingMethodAccessorImpl.invoke(DelegatingMethod
  AccessorImpl.java:55)
            at java/lang/reflect/Method.invoke(Method.java:508)
            at
  com/ibm/wmqfte/agent/bootstrap/impl/BootstrapMain.run(BootstrapM
  ain.java:284)
            at
  com/ibm/wmqfte/agent/bootstrap/impl/BootstrapMain.main(Bootstrap
  Main.java:118)
        No native callstack available on this platform
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects users of IBM MQ Managed File Transfer for
  z/OS who have agents configured with the agent property
  "adminGroup" set.
  
  
  Platforms affected:
  z/OS
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  When an IBM MQ Managed File Transfer for z/OS agent is
  configured with the adminGroup property set, it will perform the
  following processing when it starts up.
  
  - Use the value of the "adminGroup" property to secure the
  interprocess communication (IPC) mechanism so that only members
  of the group specified by adminGroup can administer it.
  - Write the message:
  
  BFGNV0176I: Members of the group '<adminGroup>'' are
  administrators for this agent.
  
  to it's event log (output0.log).
  
  IBM MQ Managed File Transfer for z/OS V9.0.3 (and earlier) used
  the International Components for Unicode For C (ICU4C) library
  to help with the globalization of messages that were output by
  agents and the process controller.
  
  APAR IT22858 removed this dependency, and added logic to IBM MQ
  Managed File Transfer for z/OS to query the locale of the system
  in order to determine which messages file to use when writing a
  message to either:
  
  - An agent's event log.
  - The process controller's event log.
  
  The fix for this APAR was shipped in IBM MQ Managed File
  Transfer for z/OS V9.0.4. As a result of the changes for
  IT22858, if an exception occurred while the agent looked up the
  locale of the system in order to write the BFGNV0176I message to
  it's event log, then the agent would abend and generate a
  Javacore containing the information shown below:
  
  ***********************************************************
  TITLE subcomponent dump routine
  ===============================
  IBM-1047
  Dump Event "abort" (00020000) received
  :    :    :    :    :    :    :    :    :    :    :     :    :
     :    :    :    :    :
  ------------------------------------------------------------
  THREADS subcomponent dump routine
  =================================
  Thread Details
  
  "main"
        Java callstack:
            at
  com/ibm/wmqfte/ipc/impl/NativeIPCServer.initialize(Native
  Method)
            at
  com/ibm/wmqfte/ipc/impl/NativeIPCServer.<init>(NativeIPCServer.j
  ava:118)
            at
  com/ibm/wmqfte/ipc/IPCFactory.newIPCServer(IPCFactory.java:91)
            at com/ibm/wmqfte/agent/Agent.main(Agent.java:333)
            at sun/reflect/NativeMethodAccessorImpl.invoke0(Native
  Method)
            at
  sun/reflect/NativeMethodAccessorImpl.invoke(NativeMethodAccessor
  Impl.java:90)
            at
  sun/reflect/DelegatingMethodAccessorImpl.invoke(DelegatingMethod
  AccessorImpl.java:55)
            at java/lang/reflect/Method.invoke(Method.java:508)
            at
  com/ibm/wmqfte/api/StartAgent.main(StartAgent.java:444)
            at sun/reflect/NativeMethodAccessorImpl.invoke0(Native
  Method)
            at
  sun/reflect/NativeMethodAccessorImpl.invoke(NativeMethodAccessor
  Impl.java:90)
            at
  sun/reflect/DelegatingMethodAccessorImpl.invoke(DelegatingMethod
  AccessorImpl.java:55)
            at java/lang/reflect/Method.invoke(Method.java:508)
            at
  com/ibm/wmqfte/agent/bootstrap/impl/BootstrapMain.run(BootstrapM
  ain.java:284)
            at
  com/ibm/wmqfte/agent/bootstrap/impl/BootstrapMain.main(Bootstrap
  Main.java:118)
        No native callstack available on this platform
  ***********************************************************
  

Problem conclusion

• IBM MQ Managed File Transfer for z/OS has been updated to catch
  any exceptions that might occur while determining the locale of
  the system, and then display messages in US English.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.0 CD    9.0.5
  
  The latest available MQ 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 is sysrouted FROM one or more of the following:

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

Fix information

• Fixed component name

  IBM MQ MFT Z/OS

• Fixed component ID

  5655MF900

Applicable component levels