IT40497: MQSIEXTRACTCOMPONENTS MIGRATES INTEGRATION SERVERS WITH INVALID NAMES INCORRECTLY

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 '&#126;' (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 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