IT45102: Having a platform value which is NOT OS400/UNIX/WINDOWS in the ProtocolBridgeProperties.xml is ignored silently

APAR status

• Closed as program error.

Error description

• The value of platform has to be either OS400, UNIX or WINDOWS in
  the
  ProtocolBridgeProperties.xml.  However if you provide a
  different value
  the Protocol Bridge Agent does not report anything
  and defaults to the agents platform.  This can cause some
  unexpected behaviours.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects users of IBM MQ Managed File Transfer (MFT),
  having a Protocol Bridge Agent.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  While configuring MFT Protocol Bridge Agent(PBA), if the server
  platform was set incorrectly, MFT did not report the problem and
  used the default platform(UNIX) value.
  
  For example:
  Server platform of "WINDOW" is invalid for MFT PBA, if this
  value was used instead of WINDOWS on MS Windows platform,
  <tns:sftpServer name="mysftpserver" host="mysftpserver"
  platform="WINDOW" fileEncoding="UTF-8" limitedWrite="false"  />
  
  default value of UNIX will be used without reporting any error
  and while performing a Text transfer we may find the the EOL
  marker used during the transfer is NOT correct. We may find we
  have used LF instead of CRLF or CRLF when we should use LF.
  

Problem conclusion

• The code has been updated to validate the platform value to
  ensure that it is set to OS400, UNIX or WINDOWS.
  If any value other than the above mentioned platform are used,
  then the following exception with be reported in the agent logs:
  
  If the file is change before the agent has been started, then,
  during the startup the MFT agent will report the following and
  stop:
  
  [07/12/2023 11:59:40:053 GMT] 00000001 XMLFileLoader E
  BFGPR0156E: An invalid data value has been found in the
  '/var/mqm/mqft/config/QM1/agents/BRIDGE0/ProtocolBridgePropertie
  s.xml' XML file. The details of the error are: BFGBR0046E: The
  server platform type of 'AIX' is not known
  [07/12/2023 11:59:40:054 GMT] 00000001 BridgeManager E
  BFGBR0167E: The ProtocolBridgeProperties.xml file is invalid.
  [07/12/2023 11:59:40:063 GMT] 00000001 AgentRuntime  E
  BFGAG0171E: The agent has ended abnormally with return code 78.
  
  If the file is change after the agent has been started, then,
  while reading the changes, MFT will report the following, and
  continue to use the previous value it had without updating:
  
  [07/12/2023 12:06:02:351 GMT] 00000024 XMLFileLoader E
  BFGPR0051E: An invalid data value has been found in the
  '/var/mqm/mqft/config/QM1/agents/BRIDGE0/ProtocolBridgePropertie
  s.xml' XML file. The internal MQMFT data has not been updated.
  The details of the error are: BFGBR0046E: The server platform
  type of 'AIX' is not known
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v9.3 LTS   9.3.0.20
  v9.x CD    9.3.5
  
  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 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