PI12999: Build Forge 8.0 adaptor dot command does not resolve variable as argument

Rational Build Forge Fix Pack 2 (8.0.0.2) for 8.0
Rational Build Forge Interim Fix 3 for 8.0.0.2
Rational Build Forge Fix Pack 3 (8.0.0.3) for 8.0
Rational Build Forge Fix Pack 4 (8.0.0.4) for 8.0
Rational Build Forge Fix Pack 5 (8.0.0.5) for 8.0
Rational Build Forge Fix Pack 6 (8.0.0.6) for 8.0
Rational Build Forge Fix Pack 7 (8.0.0.7) for 8.0
Rational Build Forge Interim Fix 1 for 8.0.0.2
Rational Build Forge Fix Pack 8 (8.0.0.8) for 8.0
Rational Build Forge Fix Pack 9 (8.0.0.9) for 8.0
Rational Build Forge Fix Pack 10 (8.0.0.10) for 8.0
Rational Build Forge Interim Fix 1 for 8.0.0.10
Rational Build Forge Fix Pack 11 (8.0.0.11) for 8.0
Rational Build Forge Interim Fix 1 for 8.0.0.11
Rational Build Forge Fix Pack 12 (8.0.0.12) for 8.0
Rational Build Forge Fix Pack 13 (8.0.0.13) for 8.0
Rational Build Forge Fix Pack 14 (8.0.0.14) for 8.0
Rational Build Forge Fix Pack 15 (8.0.0.15) for 8.0
Rational Build Forge Interim Fix 1 for 8.0.0.15
Rational Build Forge Fix Pack 16 (8.0.0.16) for 8.0
Rational Build Forge Fix Pack 17 (8.0.0.17) for 8.0
Rational Build Forge Fix Pack 19 (8.0.0.19) for 8.0
Rational Build Forge Fix Pack 18 (8.0.0.18) for 8.0
Rational Build Forge Fix Pack 20 (8.0.0.20) for 8.0
Rational Build Forge Fix Pack 21 (8.0.0.21) for 8.0
Rational Build Forge Fix Pack 22 (8.0.0.22) for 8.0

APAR status

• Closed as program error.

Error description

• When attempting to run an adaptor dot command (.source, .pack,
  .test, .defect) using an environment variable, the variable is
  not resolved.
  
  ie: .source ${ADAPTOR_NAME}
  
  This causes the build step to fail and the adaptor to never run.
  
  Steps to reproduce:
  
  - Generate a simple adaptor that performs a echo of 'Testing',
  called TestAdaptor.
  
  ??xml version='1.0'??
  ?!-- (c) Copyright by IBM Corp. and other(s) [2003], 2007 All
  Rights Reserved. --?
  ?!DOCTYPE PROJECT_INTERFACE SYSTEM 'interface.dtd'?
  ?PROJECT_INTERFACE IFTYPE='Source' INSTANCE='7.021'?
  ?interface?
   ?run command='echo' params='' server='$BF_SERVER' dir='/'
  timeout='360'/?
  
   ?onstep result='fail'?
   ?/onstep?
  
   ?onstep result='pass'?
   ?/onstep?
  
   ?onproject result='pass'?
   ?/onproject?
  ?/interface?
  
  ?command name='echo'?
   ?execute?
    echo 'Testing'
   ?/execute?
  ?/command?
  
  ?/PROJECT_INTERFACE?
  
  - Create an environment group (TestEnv1) with a variable
  ADAPTOR_NAME with the value 'TestAdaptor'.
  
  - Create a project, setting TestEnv1 as the environment, with a
  single step running the .source command with the variable.
  
  .source ${ADAPTOR_NAME}
  
  Expected result:
  
  The variable is resolved to the proper value, which is used by
  the .source command to run the correct adaptor.
  
  Actual result:
  
  The build step fails indicating the variable was used as a
  literal argument for the .source command.
  
  82 2/20/14 10:38 AM  STEP CRRBF9999I: .source '${ADAPTOR_NAME}'.
  83 2/20/14 10:38 AM  ERROR CRRBF9999I: Usage: .source
  ?adaptor_name? [entry_name]
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When the step command is like this .source ${var1} . The
  step will parse the var1 by its environment variables
  

Problem conclusion

• the variable replace operation will do firstly
  

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

  RATIONAL BUILDF

• Fixed component ID

  5724S2700

Applicable component levels

• R800 PSN

     UP