IT37156: IMPROVE MQSIEXTRACTCOMPONENTS WHEN HANDLING SOME OLDER PRODUCT PROPERTIES AND MISSING REGISTRY ENTRIES

APAR status

• Closed as program error.

Error description

• You can use the mqsiextractcomponents command to migrate the
  configuration and resources of integration servers and
  integration nodes from your source system to your newer product
  version. Some source systems may previously have been migrated
  from even earlier versions of the product than IBM Integration
  Bus V9 and contain some legacy properties that are not supported
  in IBM App Connect Enterprise V11 or V12. This APAR will enhance
  the mqsiextractcomponents command to improve the handling of
  some of these properties, including those reported in the
  following messages:
  
  - BIP8225E: ''node_name'' is not a known component.
  This is reported if the 'ComponentType' file is missing from the
  registry.
  
  - BIP2112E: IBM App Connect Enterprise internal error:
  diagnostic information 'Unknown RM type',
  'DynamicSubscriptionEngine'.
  The old 'DynamicSubscriptionEngine' resource manager property
  details may still be present in the repository but are no longer
  used and can be ignored.
  
  - BIP8391W: Property 'MemoryManagerPoolSize' for the component
  'XMLNSC' is unknown and does not have a policy equivalent. The
  property is configured with value '1024'.
  
  This property can be ignored.
  
  - BIP8392W: An unrecognised file
  'components/node_name/server_uuid/config/known_hosts' is present
  in the backup and will not be converted. The error 'File not in
  container' was returned.
  This file can be ignored as it will be re-generated by the File
  nodes when the message flow next runs after migration.
  
  - BIP8388W: Configurable service or operational policy
  'Interface' of type 'PublishSubscribe' does not have an
  equivalent policy type in this version and will not be
  converted.
  The PublishSubscribe configurable service hasn't been used for a
  number of product versions and will be silently ignored.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of IBM App Connect Enterprise v11 and v12 using the
  mqsiextractcomponents command.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  You can use the mqsiextractcomponents command to migrate the
  configuration and resources of integration servers and
  integration nodes from your source system to your newer product
  version. Some source systems may previously have been migrated
  from even earlier versions of the product than IBM Integration
  Bus V9 and contain some legacy properties that are not supported
  in IBM App Connect Enterprise V11 or V12. This APAR will enhance
  the mqsiextractcomponents command to improve the handling of
  some of these properties, including those reported in the
  following messages:
  
  - BIP8225E: ''node_name'' is not a known component.
  This is reported if the 'ComponentType' file is missing from the
  registry.
  
  - BIP2112E: IBM App Connect Enterprise internal error:
  diagnostic information 'Unknown RM type',
  'DynamicSubscriptionEngine'.
  The old 'DynamicSubscriptionEngine' resource manager property
  details may still be present in the repository but are no longer
  used and can be ignored.
  
  - BIP8391W: Property 'MemoryManagerPoolSize' for the component
  'XMLNSC' is unknown and does not have a policy equivalent. The
  property is configured with value '1024'.
  This property can be ignored.
  
  - BIP8392W: An unrecognised file
  'components/node_name/server_uuid/config/known_hosts' is present
  in the backup and will not be converted. The error 'File not in
  container' was returned.
  This file can be ignored as it will be re-generated by the File
  nodes when the message flow next runs after migration.
  
  - BIP8388W: Configurable service or operational policy
  'Interface' of type 'PublishSubscribe' does not have an
  equivalent policy type in this version and will not be
  converted.
  The PublishSubscribe configurable service hasn't been used for a
  number of product versions and will be silently ignored.
  
  - BIP2115E: IBM App Connect Enterprise internal error:
  diagnostic information ''ConfigStore table query returned
  multiple values when 1 was expected'', '2', ''ExecGroupUUID'',
  ''ExecGroupLabel'', ''myIntegrationServer1''.
  Entries that have processState=3 ('deleted') are now ignored.
  

Problem conclusion

• The mqsiextractcomponents command has been enhanced to improve
  the handling of some legacy properties.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v11.0      11.0.0.14
  v12.0      12.0.2.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