APAR status
Closed as program error.
Error description
Integration servers in ACE can only have names which use a small subset of characters, unlike IIB v10 and below which allow a wide range of characters to be used. The mqsiextractcomponents command should issue a warning when an invalid name is found for an integration server and it should rename it to something acceptable. Valid integration server names contain the following characters: * 'A' (U+0041) through 'Z' (U+005A) * 'a' (U+0061) through 'z' (U+007A) * '0' (U+0030) through '9' (U+0039) * The underscore '_' (U+005F) * The dash '-' (U+002D) * The percent sign '%' (U+0025) * The at sign '@' (U+0040) * The tilde '~' (U+007E) * The exclamation mark '!' (U+0021) * The hash mark '#' (U+0023) Integration servers with invalid names will not start correctly and their integration nodes will become unresponsive.
Local fix
Manually rename integration servers by renaming the integration server folder in /var/mqsi/components/NODE_NAME/servers or C:\ProgramData\IBM\MQSI\components\NODE_NAME\servers
Problem summary
**************************************************************** USERS AFFECTED: All users of IBM Integration Bus migrating existing integration nodes and servers to IBM App Connect Enterprise Platforms affected: MultiPlatform **************************************************************** PROBLEM DESCRIPTION: <div><div><span style="color:#000000">Integration servers in ACE can only have names which use a small subset of characters, unlike IIB v10 and below which allow a wide range of characters to be used. The mqsiextractcomponents command should issue a warning when an invalid name is found for an integration server and it should rename it to something acceptable. Valid integration server names contain the following characters:</span></div> <div><span style="color:#0451a5">*</span><span style="color:#000000"> 'A' (U+0041) through 'Z' (U+005A)</span></div><div><span style="color:#0451a5">*</span><span style="color:#000000"> 'a' (U+0061) through 'z' (U+007A)</span></div><div><span style="color:#0451a5">*</span><span style="color:#000000"> '0' (U+0030) through '9' (U+0039)</span></div><div><span style="color:#0451a5">*</span><span style="color:#000000"> The underscore '_' (U+005F)</span></div><div><span style="color:#0451a5">*</span><span style="color:#000000"> The dash '-' (U+002D)</span></div><div><span style="color:#0451a5">*</span><span style="color:#000000"> The percent sign '%' (U+0025)</span></div><div><span style="color:#0451a5">*</span><span style="color:#000000"> The at sign '@' (U+0040)</span></div><div><span style="color:#0451a5">*</span><span style="color:#000000"> The tilde '~' (U+007E)</span></div><div><span style="color:#0451a5">*</span><span style="color:#000000"> The exclamation mark '!' (U+0021)</span></div><div><span style="color:#0451a5">*</span><span style="color:#000000"> The hash mark '#' (U+0023)</span></div> <div><span style="color:#000000">Integration servers with invalid names will not start correctly and their integration nodes will become unresponsive.</span></div></div>
Problem conclusion
Integration servers that have forbidden characters in their name will be renamed when mqsiextractcomponents is run. A BIP8694 message will be issued when this occurs. After migration, integration servers can be renamed by renaming the appropriate subdirectory of [MQSI_WORKPATH]/components/[integrationNodeName]/servers to a valid server name. --------------------------------------------------------------- The fix is targeted for delivery in the following PTFs: Version Maintenance Level v11.0 11.0.0.20 v12.0 12.0.5.0 The latest available maintenance can be obtained from: http://www-01.ibm.com/support/docview.wss?rs=849&uid=swg27006041 If the maintenance level is not yet available,information on its planned availability can be found on: http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006308 ---------------------------------------------------------------
Temporary fix
Comments
APAR Information
APAR number
IT40497
Reported component name
APP CONNECT ENT
Reported component ID
5724J0550
Reported release
B00
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2022-04-04
Closed date
2022-10-07
Last modified date
2022-10-07
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
APP CONNECT ENT
Fixed component ID
5724J0550
Applicable component levels
[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSDR5J","label":"IBM App Connect Enterprise"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"B00","Line of Business":{"code":"LOB45","label":"Automation"}}]
Document Information
Modified date:
08 October 2022