IT40492: BIP2111 EXCEPTION WHEN DEBUGGING ESQL IF A REFERENCE VARIABLE CHANGES TYPE

APAR status

• Closed as program error.

Error description

• When a debugger is attached and is stepping through ESQL code,
  if there is a reference variable which changes type (e.g. it
  originally was a reference to a variable and is now a reference
  to a field) then a BIP2111 exception will be thrown when trying
  to step past the point where the reference changes type. The
  following ESQL demonstrates the issue
  
  DECLARE dummyVariable INTEGER 0;
  -- myReference is a reference to a variable
  DECLARE myReference REFERENCE TO dummyVariable;
  
  CREATE LASTCHILD OF OutputRoot.JSON.Data NAME 'myValue' VALUE 42
  AS myReference;
  
  -- myReference is now a reference to a field, attempting to
  pause
  -- the debugger after this point will cause a BIP2111 exception
  RETURN TRUE;
  

Local fix

• Do not enable or attach the debugger, do not continue debugging
  ESQL after the point where a reference variable changes type, or
  do not debug ESQL code containing references that change type.
  

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users who debug ESQL code using the toolkit in IBM App
  Connect Enterprise v11 and v12
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  When a debugger is attached and is stepping through ESQL code,
  if there is a reference variable which changes type (e.g. it
  originally was a reference to a variable and is now a reference
  to a field) then a BIP2111 exception will be thrown when trying
  to step past the point where the reference changes type. The
  following ESQL demonstrates the issue
  
  DECLARE dummyVariable INTEGER 0;
  -- myReference is a reference to a variable
  DECLARE myReference REFERENCE TO dummyVariable;
  
  CREATE LASTCHILD OF OutputRoot.JSON.Data NAME 'myValue' VALUE 42
  AS myReference;
  
  -- myReference is now a reference to a field, attempting to
  pause
  -- the debugger after this point will cause a BIP2111 exception
  RETURN TRUE;
  

Problem conclusion

• The debugger can now handle a reference variable changing its
  underlying type during execution.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v11.0      11.0.0.18
  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