The LISTVIEW option specifies whether the compiler should show the source in the source listing or whether it should show the source after it has been processed by one or more of the preprocessors.
The LISTVIEW option is ignored if the NOSOURCE option is in effect.
.-SOURCE-----. >>-LISTVIEW--(--+-AFTERALL---+--)------------------------------>< +-AFTERCICS--+ +-AFTERMACRO-+ '-AFTERSQL---'
- SOURCE
- Causes the source listing to show the unadulterated source and, more importantly perhaps, it will cause IBM® Debug Tool to bring up this as the source view.
- AFTERALL
- Causes the source listing to show the source as if it came from
the MDECK from the last invocation, if any, of the last preprocessor,
and, more importantly perhaps, it will cause Debug Tool to
bring up this as the source view if the SEPARATE suboption of the
TEST compiler option is also specified.
AALL can be used as an abbreviation for AFTERALL.
- AFTERCICS
- Causes the source listing to show the source as if it came from
the MDECK from the last invocation, if any, of the CICS® preprocessor, and, more importantly perhaps,
it will cause Debug Tool to
bring up this as the source view if the SEPARATE suboption of the
TEST compiler option is also specified.
ACICS can be used as an abbreviation for AFTERCICS.
- AFTERMACRO
- Causes the source listing to show the source as if it came from
the MDECK from the last invocation, if any, of the MACRO preprocessor,
and, more importantly perhaps, it will cause Debug Tool to
bring up this as the source view if the SEPARATE suboption of the
TEST compiler option is also specified.
AMACRO can be used as an abbreviation for AFTERMACRO.
- AFTERSQL
- Causes the source listing to show the source as if it came from
the MDECK from the last invocation, if any, of the SQL preprocessor,
and, more importantly perhaps, it will cause Debug Tool to
bring up this as the source view if the SEPARATE suboption of the
TEST compiler option is also specified.
ASQL can be used as an abbreviation for AFTERSQL.
If the TEST option is specified and a suboption other than SOURCE is specified for LISTVIEW, the SEPARATE suboption must also be specified for the TEST option.
The following example shows the differing effects of the AFTERMACRO, AFTERSQL, and AFTERALL suboptions.
Suppose the PP option is PP( MACRO('INCONLY'), SQL, MACRO).
- Under LISTVIEW(AFTERMACRO), the "source" in the listing and in the Debug Tool source window if TEST(SEP) were specified would appear as if it came from the MDECK that the second invocation of the MACRO preprocessor would have produced.
- Under LISTVIEW(AFTERSQL), the "source" in the listing and in the Debug Tool source window if TEST(SEP) were specified would appear as if it came from the MDECK that the invocation of the SQL preprocessor would have produced (and hence %DCL and other macro statements would still be visible).
- Under LISTVIEW(AFTERALL), the "source" would be as under the LISTVIEW(AFTERMACRO) option because the MACRO preprocessor is the last in the PP option.