$LIST compiler directive

$LIST Compiler Directive

Top  Previous  Next


The $LIST directive can be used to start, suspend and resume generation of a listing of the program and any associated error messages.








The listing is directed to a record of the same name as the program source but with a suffix of .LIS. Any existing listing record is deleted by the compiler at the start of compilation regardless of whether a new listing is to be produced.


A $LIST ON directive in the main program starts generation of a listing record from that point onwards. The compiler LISTING option is equivalent to a $LIST ON at the start of the program.


A $LIST OFF directive stops generation of the listing record. If this is on an include record, listing will resume on return to the source or include record from which it was entered.


A $LIST ON directive in an include record only resumes generation of the listing record if listing was active when processing of the include record began.