Physical Database DDL Statements › AREA Statements › Entity Currency › Syntax

Syntax

CREATE/ALTER AREA

►►─┬─ CREATE ─┬─ physical AREA ─┬─────────────────┬─ area-name ───────────────►
   └─ ALTER ──┘                 └─ segment-name. ─┘

 ►─┬──────────────────────────────────────────┬───────────────────────────────►
   ├─ initial-page-range-specification ───────┤
   └─ EXTEND SPACE extend-page-count pages ───┘

 ►─┬─────────────────────────────────────────┬────────────────────────────────►
   └─ PAGE SIZE character-count characters ──┘

 ►─┬────────────────────────────────────────────────────────────────┬─────────►
   └─ PAGE RESERVE size ─┬─ 0 ◄──────────────────────┬─ characters ─┘
                         └─ reserve-character-count ─┘

 ►─┬──────────────────────────────────────────────────────────┬───────────────►
   └─ ORIGINAL PAGE SIZE original-character-count characters ─┘

 ►─┬────────────────────────┬─────────────────────────────────────────────────►
   └─ STAMP BY ─┬─ TABLE ─┬─┘
                └─ AREA ──┘

 ►─┬──────────────────────────────────┬───────────────────────────────────────►
   └──── TIMESTAMP timestamp-value ───┘

 ►─┬────────────────────────────────┬─────────────────────────────────────────►
   │ ┌────────────────────────────┐ │
   └─▼── symbol-specification ────┴─┘

 ►─┬─────────────────────────────────┬────────────────────────────────────────►◄
   │ ┌─────────────────────────────┐ │
   └─▼────file-specification  ─────┴─┘

DROP AREA

►►── DROP physical AREA ─┬─────────────────┬─ area-name ──────────────────────►◄
                         └─ segment-name. ─┘

Expansion of initial-page-range-specification

►►─── PRIMARY SPACE primary-page-count pages FROM page start-page ────────────►

 ►─┬──────────────────────────────────────┬───────────────────────────────────►◄
   └─ MAXIMUM SPACE max-page-count pages ─┘

Expansion of symbol-specification

►►─┬───────────────┬──────────────────────────────────────────────────────────►
   ├─┬─ ADD ◄────┬─┤
   │ └─ INClude ─┘ │
   └─┬─ DROP ────┬─┘
     └─ EXClude ─┘

 ►─┬─ SUBAREA symbolic-subarea-name ─┬─────────────────────────┬────────────┬─►◄
   │                                 └─ subarea-specification ─┘            │
   ├─ SYMBOLIC DISPLACEMENT symbolic-displacement-name ─┬──────────────────┬┤
   │                                                    └─ page-cnt pages ─┘│
   └─ SYMBOLIC INDEX symbolic-index-name ─┬───────────────────────┬─────────┘
                                          └─ index-specification ─┘

Expansion of subarea-specification

►►─┬─ FROM page start-page THRU page end-page ───────────────────────────┬────►◄
   ├─ SPACE subarea-page-count pages FROM page subarea-start-page ───────┤
   └─ OFFSET ─┬─ 0 ◄──────────────────────┬─ FOR ─┬─ 100 PERCENT ◄─────┬─┘
              ├─ offset-page-count PAGEs ─┤       ├─ percent PERCENT ──┤
              └─ offset-percent PERCENT ──┘       └─ page-count PAGEs ─┘

Expansion of index-specification

►►─┬ BLOCK CONTAINS key-count keys ─┬───────────────────────────────┬───────┬─►◄
   │                                └ DISPLACEMENT page-count pages ┘       │
   └ BASED ON ─┬──────────┬─ KEY LENGTH key-length ┌───────────────────────┬┘
               ├ SORTED ◄─┤                        └ FOR index-cnt RECORDS─┘
               └ UNSORTED ┘

Expansion of file-specification

►►─┬───────────────┬─┬─ FILE file-name ──────────────────┬────────────────────►
   ├─┬─ ADD ◄────┬─┤ └─ PATH FILE native-vsam-file-name ─┘
   │ ├─ WITHIN ──┤ │
   │ └─ INClude ─┘ │
   └─┬─ REMOVE ──┬─┘
     ├─ DROP ────┤
     └─ EXClude ─┘

 ►─┬───────────────────────────────────────────────────────┬──────────────────►◄
   └─ FROM start-block ─┬─ THRU end-block ───────────────┬─┘
                        └─ FOR ─┬─ ALL blocks ─────────┬─┘
                                └─ block-count blocks ─┘

DISPLAY/PUNCH AREA

►►─┬─ DISplay ─┬─ AREA ─┬─────────────────┬─ area-name ───────────────────────►
   └─ PUNch ───┘        └─ segment-name. ─┘

   ┌───────────────────────────────────────┐
 ►─▼─┬───────────────────────────────────┬─┴──────────────────────────────────►
     │               ┌────────────────┐  │
     ├─ WITh ──────┬─▼─┬─ FILes ────┬─┴──┘
     └─ WITHOut ───┘   ├─ SYMbols ──┤
                       ├─ DETails ──┤
                       ├─ HIStory ──┤
                       ├─ ALL ◄─────┤
                       └─ NONe ─────┘

 ►─┬────────────────────────┬─────────────────────────────────────────────────►
   └─ VERb ─┬─ DISplay ───┬─┘
            ├─ PUNch ─────┤
            ├─ CREate ◄───┤
            ├─ ALTer ─────┤
            └─ DROp ──────┘

 ►─┬───────────────────────┬──────────────────────────────────────────────────►◄
   └─ AS ─┬─ COMments ◄──┬─┘
          └─ SYNtax ─────┘