PI09423: RTC z/OS PLI dependency scanner does not recognize the include Syntax with a leading comma

APAR status

• Closed as program error.

Error description

• The IBM Rational Team Concert (RTC) z/OS PLI dependency scanner
  does not recognize the include syntax that contains a leading
  comma.
  The problem is a combination of an %include starting with a
  comma and the presence of ! characters (either in code or
  comments or text value).
  With the following code, TSTINC2 is not listed by the source
  code data editor:
  TSTPLI1: proc() options(main);
  %include TSTINC1;
  dcl  1 struct1        unaligned
        , %include TSTINC2
        ;;
     var1 = '!';
     Display( var1 );
  end TSTPLI1;
  =================================
  a- TSTINC2 is listed if you change the language definition to
  use the deprecated scanner.
  b- TSTINC2 is listed if you only change var1='!' into var1='a'
  with default scanner
  c- TSTINC2 is listed if you only put the comma after unaligned
  with default scanner (thus with var1='!')
  dcl  1 struct1        unaligned ,
        %include TSTINC2
        ;;
     var1 = '!';
  WORKAROUND:
  Include member (TSTINC2)  is listed correctly when you do one
  of the following:
  1)Use the deprecated scanner
  2) the comma is placed on the previous source line after
  "unaligned" with default scanner
  dcl  1 struct1        unaligned ,
        %include TSTINC2
  Review the following Work Item on jazz.net for details:
  https://jazz.net/jazz/resource/itemName/com.ibm.team.workitem.Wo
  rkItem/293730
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * The default System z scanner is misidentifying PLI files     *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Users have 4000 PLI files that are being identified as       *
  * another language which may lead to some dependencies not     *
  * being found.                                                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• Implemented code change to address the issue
  

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

  RATL TEAM CONCE

• Fixed component ID

  5724V0400

Applicable component levels

• R401 PSY

     UP