Easytrieve New Reserved Words (Migration)

New reserved words are the surprise compile failures that derail Easytrieve migrations after options tables and deprecated FILE clauses are already fixed. Broadcom 11.6 function mode reserves identifiers that decades of legacy programs used as innocent field names—SET for a configuration flag, EXECUTE for a run-mode code, SYSUSERID for an audit column copied from a security glossary, HIGH-VALUES and LOW-VALUES for business bounds borrowed from COBOL figurative language. BREAK-LEVEL and DRAW collide when report depth or graphics flags used literal English words. The compiler cannot treat SET as both data and grammar; migration means renaming fields, updating macros, recompiling, and parallel-testing output—not arguing that the old name was logical. This page focuses on the 11.6 migration reserved word set, scan-and-rename playbooks, compatibility versus function mode strategy, and links to per-word tutorials for deeper examples.

Progress0 of 0 lessons

Function Mode vs Compatibility Mode

Function mode enables newer language features and stricter reserved word enforcement documented for 11.6. Compatibility mode may allow some legacy identifiers temporarily while teams execute rename projects. Migration strategy: inventory collisions, rename in macros first, compile in compatibility mode if needed for interim schedules, then cut over to function mode with clean listings before mandating new development standards. Staying on compatibility mode forever postpones features and may not be supported indefinitely—plan explicit function mode target dates with change control.

11.6 Migration Reserved Word Set

The table below lists commonly cited migration tokens from Broadcom New Reserved Words guidance. Your installation letter is authoritative; maintenance PTS can adjust Symbols appendices.

11.6 function mode migration reserved words (representative)
WordTypical legacy field useSuggested renameSite tutorial
SETGeneric set/config indicatorWS-SET-IND, CFG-FLAG/reserved-words/set
EXECUTERun mode or batch flag columnWS-RUN-MODE, PROC-MODE/reserved-words/execute
SYSUSERIDAudit user id fieldWS-AUDIT-USER, RPT-USER-ID/reserved-words/sysuserid
BREAK-LEVELReport break depth numericWS-BREAK-DEPTH, RPT-LEVEL-NO/reserved-words/break-level
DRAWChart or draw flagWS-DRAW-FLAG, CHART-IND/reserved-words/draw
HIGH-VALUESMaximum business value fieldWS-MAX-VAL, LIMIT-HIGH/reserved-words/high-values
LOW-VALUESMinimum business value fieldWS-MIN-VAL, LIMIT-LOW/reserved-words/low-values

Follow tutorial links under /tutorials/easytrieve for statement semantics—understanding why EXECUTE reserved helps programmers explain renames to business owners reviewing audit column labels.

Why Each Token Becomes Reserved

SET

SET-related grammar configures runtime and report behavior in modern Easytrieve. A field literally named SET forces the parser to disambiguate assignment configuration from data movement—reserved status removes ambiguity at the cost of renaming legacy indicators copied from generic data dictionaries.

EXECUTE

EXECUTE invokes activities and online procedures. Programs that stored execution mode in a field named EXECUTE collide directly with statement vocabulary—common in shops that mirrored JCL terminology in file layouts without anticipating language evolution.

SYSUSERID

SYSUSERID exposes the authenticated user symbol for audit trails and report headers. Legacy layouts sometimes duplicated the name as a business column populated from batch parameters; the system symbol now owns the spelling.

BREAK-LEVEL and DRAW

Report control enhancements reserve BREAK-LEVEL for hierarchy depth semantics and DRAW for graphics-related report features. Report writers who named working fields after English descriptions suffer collisions—prefix conventions prevent recurrence.

HIGH-VALUES and LOW-VALUES

Figurative constant names familiar from COBOL tempted programmers to use them as field names for limits or sentinels. Reserving them aligns Easytrieve constant semantics with clearer figurative usage in expressions versus DEFINE blocks.

Scan-and-Rename Playbook

  1. Download New Reserved Words PDF for target FMID from TechDocs.
  2. Extract all DEFINE lines and macro-generated symbols from source libraries.
  3. Case-insensitive compare against reserved list; flag exact token matches.
  4. Sort hits by macro fan-out—fix highest reuse first.
  5. Apply team prefix standard (WS-, RPT-, CFG-) on renames.
  6. Recompile pilot; verify no remaining reserved word messages.
  7. Parallel-run affected reports for output equivalence.
  8. Enable function mode site-wide after soak approval.
text
1
2
3
4
5
6
7
8
9
* Before migration — field name collision DEFINE PAYROLL EXECUTE 1 A SET 1 A * After migration — prefixed names DEFINE PAYROLL WS-RUN-MODE 1 A WS-SET-IND 1 A

Compile Diagnostics

Reserved word conflicts produce recognizable SYSPRINT messages referencing the identifier and reserved status. Sort compile-all output by message text frequency—one macro fix may clear hundreds of identical errors. Archive listings with before/after renames for audit when financial reports are involved.

Naming Standards to Prevent Recurrence

  • Require prefixes on all user-defined fields in new development.
  • Prohibit single English dictionary words as bare field names.
  • Review copybook imports from COBOL for figurative constant names.
  • Add reserved word grep to pre-commit or compile-all automation.
  • Link new hire training to reserved-words-by-release page.

Relationship to Deprecated Syntax

Reserved words are not always deprecated syntax—some are new capabilities. Deprecated constructs are obsolete features; reserved words are active grammar occupying names you once used for data. Migration projects track both lists separately but fix them in the same compile sweeps where possible.

Explain It Like I'm Five

New reserved words are when the teacher says "from now on SET is a command word, not a student name." If your friend was named Set, they need a nickname in class so the teacher knows when you mean the command. Rename the fields, update the class roster (macros), and practice the new names before the final test (function mode cutover).

Exercises

  1. Grep one source library for EXECUTE and SET in DEFINE blocks.
  2. Propose rename mapping for three collision examples in your portfolio.
  3. Read the SET reserved word tutorial and summarize its statement use.
  4. Draft function mode cutover criteria for change control.
  5. Design a macro review checklist for imported COBOL field names.

Quiz

Test Your Knowledge

1. 11.6 function mode migration most often breaks programs when:

  • User field names match newly reserved keywords
  • SYSPRINT is omitted
  • Jobs run on Tuesday
  • BUFNO equals one

2. Before cutover you should scan DEFINE lines for:

  • Collisions with New Reserved Words documentation
  • Only comment text
  • JCL DD names exclusively
  • Assembler EQUates

3. A practical rename pattern for a field named SET is:

  • WS-SET-IND or CFG-SET with team prefix standards
  • Delete the field entirely
  • Use single letter S only
  • Rename to JCL

4. Compatibility mode during migration allows:

  • Time to rename fields while older rules may still compile some sources
  • Permanent avoidance of all renames
  • Skipping compile entirely
  • Using COBOL reserved words in Easytrieve

5. Fixing reserved word conflicts in shared macros:

  • Propagates renames across many programs at once
  • Only helps one report
  • Is discouraged by Broadcom
  • Requires deleting REPORT activities

Frequently Asked Questions

What are the new reserved words in Easytrieve 11.6 migration?

Broadcom New Reserved Words documentation for 11.6 function mode lists tokens including SET, EXECUTE, SYSUSERID, BREAK-LEVEL, DRAW, HIGH-VALUES, LOW-VALUES, and additional symbols. Verify the exact list on your installed maintenance PDF—site tutorials mirror common entries.

Why was my field name fine for twenty years?

Reserved sets expand when new language features need unambiguous keywords. EXECUTE as a column label was harmless until EXECUTE became the activity invocation statement in function mode grammar.

How do I scan a large portfolio for collisions?

Export DEFINE lines and macro symbols, grep against the New Reserved Words list, prioritize high-fan-out macros, and compile pilot samples. Enterprise dictionary tools help when available.

Should I rename in source or use compiler workarounds?

Rename in source for long-term maintainability. Workarounds if any are temporary; standards should require prefixes on new fields to reduce future collisions.

Where are per-word tutorials on this site?

The reserved words index links to pages for SET, EXECUTE, SYSUSERID, BREAK-LEVEL, DRAW, HIGH-VALUES, LOW-VALUES, and others with examples and migration notes.

Published
Read time18 min
AuthorMainframeMaster
Reviewed by MainframeMaster teamVerified: 11.6 New Reserved Words migration set, rename playbookSources: Broadcom New Reserved Words documentation, Symbols appendix, site per-word tutorialsApplies to: Easytrieve 11.6 function mode migration and field rename projects