Easytrieve Listing Options

PARM LIST Subparameters

On PARM, LIST accepts FILE, NOFILE, PARM, and NOPARM combinations documented in Language Reference. LIST FILE enables file statistics sections at activity boundaries—record counts, organization hints useful when validating FILE definitions against JCL. LIST PARM prints compile summary showing parameters in effect—critical when comparing dev and prod compile outcomes. NOPARM suppresses that summary when archives need only source and diagnostics.

Source LIST Statement

After PARM, LIST ON prints all subsequent source statements in the listing until LIST OFF. Default at program start is LIST ON MACROS per Controlling Compilation documentation. LIST OFF after FILE definitions is a common pattern: keep Library layout visible once, hide repetitive JOB and REPORT logic from listing bulk. LIST ON before a complex PROC restores visibility for the section under maintenance.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
PARM DEBUG(DMAP XREF) LIST FILE
 
FILE PAYMAST FB(150 1500)
  EMP-NO    1   6 N
  GROSS    94  5 P 2
 
LIST OFF
 
REPORT PAY-RPT
  TITLE 01 'PAYROLL' SYSDATE
  ...
 
LIST ON
COMPLEX-PROC. PROC
  * detailed logic under review
END-PROC

LIST MACROS and LIST NOMACROS

Macros expand before compile logic sees final source. LIST MACROS prints expanded statements— essential when %INCLUDE or cataloged macros generate DEFINE blocks you did not type manually. LIST NOMACROS omits expansion detail, shrinking listing size for stable macro libraries. Macro debugging page pairs with NOMACROS-off compiles until substitution errors resolved.

NEWPAGE, SKIP, PUSH, and POP

NEWPAGE starts a fresh listing page—use before large REPORT section for readability. SKIP n inserts blank lines. PUSH saves current LIST and MACROS settings; change temporarily with LIST OFF NOMACROS; POP restores prior settings without remembering original combination. Nested PUSH/POP stacks like conditional compilation discipline—document depth in team standards.

Compile Summary Section

When LIST PARM active, summary aggregates error and warning counts, compiler options, macro libraries searched, generated code size estimates, and execution options embedded at compile. Before promoting load module, diff summary against golden baseline proc—unexpected DEBUG flag is release defect smoking gun.

Options Table LISTPRM and Listing Defaults

Configuration Manager LISTPRM option mirrors PARM LIST PARM at site level. Compiler Options DMAP, XREF, PMAP defaults interact with listing volume—listing options page focuses on LIST family; see debugging and cross-reference pages for DEBUG-specific sections.

Development Versus Production Profiles

Common Listing Option Mistakes

• LIST OFF before first FILE—cannot verify DEFINE offsets in statement listing.
• NOMACROS while debugging macro substitution errors.
• Assuming listing DD name without reading site compile proc.
• Discarding compile summary when auditing which PARM was active.
• PUSH without matching POP—listing settings drift rest of source.
• Identical prod and dev listing profile—wastes spool and compile time.

Explain It Like I'm Five

Listing options tell the printer how much of your homework to photocopy. LIST ON copies every line; LIST OFF skips lines until you turn copying back on. MACROS means also photocopy the hidden template pages that expanded into real lines. PARM at the top can ask for an extra cover sheet summarizing which copying rules you picked.

Exercises

1. Add LIST OFF after FILE section and note what remains with DEBUG DMAP.
2. Write PUSH/LIST OFF/POP sequence around one PROC.
3. Compare LIST FILE versus NOFILE on a two-file program listing.
4. Draft production versus development listing policy table for your team.
5. Find compile summary in a sample listing and list three fields it contains.