PM41900: EMP: Improve documentation on valid PERL expressions to be used in templates

Rational ClearQuest Fix Pack 03 (8.0.0.3) for 8.0
Rational ClearQuest Fix Pack 11 (8.0.0.11) for 8.0
Rational ClearQuest Fix Pack 12 (8.0.0.12) for 8.0
Rational ClearQuest Fix Pack 13 (8.0.0.13) for 8.0
Rational ClearQuest Fix Pack 14 (8.0.0.14) for 8.0
Rational ClearQuest Fix Pack 15 (8.0.0.15) for 8.0
Rational ClearQuest Fix Pack 16 (8.0.0.16) for 8.0
Rational ClearQuest Fix Pack 17 (8.0.0.17) for 8.0
Rational ClearQuest Fix Pack 18 (8.0.0.18) for 8.0
Rational ClearQuest Fix Pack 19 (8.0.0.19) for 8.0
Rational ClearQuest Fix Pack 20 (8.0.0.20) for 8.0
Rational ClearQuest Fix Pack 21 (8.0.0.21) for 8.0

APAR status

• Closed as program error.

Error description

• The EMP documentation includes a topic on the use of PERL
  expressions in templates that leads users to believe that any
  PERL code, including references to the $entity object, can be
  used.
  This leads to issues with either the validation of templates or
  the execution of the code at run time. The reason for these
  issue is that those PERL expressions in email plus templates are
  validated against the EmailPlusTemplate record type and not the
  target record type of the template. This has been acknowledged
  as a limitation of the current architecture of the EMP package
  and the documentation should clearly state it.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  The CQ EmailPlus documentation includes a topic on the use
  of PERL expressions in templates that leads users to believe
  that any PERL code, including references to the $entity
  object, can be used.
  This leads to issues with either the validation of templates
  or the execution of the code at run time. The reason for
  these issue is that those PERL expressions in email plus
  templates are validated against the EmailPlusTemplate record
  type and not the target record type of the template. This
  has been acknowledged as a limitation of the current
  architecture of the EmailPlus package and the documentation
  should clearly state it.
  

Problem conclusion

• A fix is available in ClearQuest 8.0.0.3
  

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

  CLEARQUEST WIN

• Fixed component ID

  5724G3600

Applicable component levels

• R701 PSN

     UP