Rational Developer for System z
Enterprise PL/I for z/OS, Version 3.8, Programming Guide

INSOURCE

The INSOURCE option specifies that the compiler should include a listing of the source program before the PL/I macro preprocessor translates it.

Read syntax diagramSkip visual syntax diagram   .-NOINSOURCE--------------------.
>>-+-INSOURCE--+-----------------+-+---------------------------><
               |    .-FULL--.    |
               '-(--+-SHORT-+--)-'
 

ABBREVIATION: IS, NIS

FULL
The INSOURCE listing will ignore %NOPRINT statements and will contain all the source before the preprocessor translates it.

FULL is the default.

SHORT
The INSOURCE listing will heed %PRINT and %NOPRINT statements.

The INSOURCE listing has no effect unless the MACRO option is in effect.

Under the INSOURCE option, text is included in the listing not according to the logic of the program, but as each file is read. So, for example, consider the following simple program which has a %INCLUDE statement between its PROC and END statements.

  insource: proc options(main);
    %include member;
  end;

The INSOURCE listing will contain all of the main program before any of the included text from the file "member" (and it would contain all of that file before any text included by it - and so on).

Under the INSOURCE(SHORT) option, text included by a %INCLUDE statement inherits the print/noprint status that was in effect when the %INCLUDE statement was executed, but that print/noprint status is restored at the end of the included text (however, in the SOURCE listing, the print/noprint status is not restored at the end of the included text).


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)