A fix is available
APAR status
Closed as program error.
Error description
When multiple .jar files are specified in the "advancedSecurityPath" agent property, separated using a semi-colon character, ";", a defect in the property parsing resulted in the character before the semicolon being stripped when the jar file list is split. For example, setting the following in the agent.properties file: advancedSecurityPath= /opt/ibm/WebSphere/MQAMS/classes/com.ibm.mq.ese.jar;/opt/mqm/jav a/lib/com.ibm.mq.jar resulted in the agent trying to load the jar file: /opt/ibm/WebSphere/MQAMS/classes/com.ibm.mq.ese.ja which fails with following error logged to the agent's output0.log file: BFGAG0126E: One or more files specified in the extendedSecurityPath property were not found. The WebSphere MQ Advanced Message Security interceptor might not be loaded, or it might be partially loaded and malfunction. The agent will stop. The missing file(s) are: /opt/ibm/WebSphere/MQAMS/classes/com.ibm.mq.ese.ja
Local fix
Add an extra space between the last character of the jar file and and the semi-colon. For example: advancedSecurityPath= /opt/ibm/WebSphere/MQAMS/classes/com.ibm.mq.ese.jar ;/opt/mqm/ja va/ lib/com.ibm.mq.jar
Problem summary
**************************************************************** USERS AFFECTED: This issue affects all users of WebSphere MQ File Transfer Edition who use the agent property: advancedSecurityPath to load multiple jar files for use with WebSphere MQ Advanced Message Security. Platforms affected: MultiPlatform **************************************************************** PROBLEM DESCRIPTION: When using WebSphere MQ File Transfer Edition (FTE) with WebSphere MQ Advanced Message Security (AMS), the agent property: advancedSecurityPath can be used to specify the location of one or more Java archive (jar) files, separated by non-escaped semicolon characters. This property is specified in the "agent.properties" file. To use WebSphere MQ AMS with WebSphere MQ FTE, use the "advancedSecurityPath" agent property to specify the location of the WebSphere MQ AMS Java Interceptor jar file: com.ibm.mq.ese.jar and the pre-requisite WebSphere MQ Java client jar file: com.ibm.mq.jar For example: --------------- advancedSecurityPath= /opt/ibm/WebSphere/MQAMS/classes/com.ibm.mq.ese.jar; /opt/mqm/java/ lib/com.ibm.mq.jar When multiple jar files are specified, using with the "advancedSecurityPath" agent property, the agent splits the property value on non-escaped semicolon characters and attempts to load to each jar file. However a defect in the regular expression splitting code resulted in the character directly preceding the semicolon from being removed from the returned path. Continuing the example above, this would result in the agent attempting to load the jar files "/opt/ibm/WebSphere/MQAMS/classes/com.ibm.mq.ese.ja" and "/opt/mqm/java/ lib/com.ibm.mq.jar". The agent therefore attempted to load "/opt/ibm/WebSphere/MQAMS/classes/com.ibm.mq.ese.ja" fails with a BFGAG0126E logged to the agent's ouptut0.log file.
Problem conclusion
The WebSphere MQ File Transfer Edition product code has been updated to correct the splitting of jar files, separated by non-escaped semicolon characters, specified as the value to the agent property: advancedSecurityPath As such, the character directly before the semicolon character, on which the split is performed, is not removed from the returned jar file path. In addition, the reference to the property "extendedSecurityPath" in the error and warning messages: - BFGAG0126E - BFGAG0127E - BFGAG0128W has been corrected to be "advancedSecurityPath". --------------------------------------------------------------- The fix is targeted for delivery in the following PTFs: Version Maintenance Level v7.0 7.0.4.6 The latest available FTE maintenance can be obtained from 'Fix List for WebSphere MQ File Transfer Edition 7.0' http://www-01.ibm.com/support/docview.wss?uid=swg27015313 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 number
IT10333
Reported component name
WMQ FILE TRANSF
Reported component ID
5724R1000
Reported release
704
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2015-07-24
Closed date
2015-08-21
Last modified date
2016-05-05
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
R704 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.4","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Document Information
Modified date:
05 May 2016