General DDDL Syntax Options › Displaying Entity Occurrences › DISPLAY/PUNCH ALL Statement

DISPLAY/PUNCH ALL Statement

The DISPLAY/PUNCH ALL statement allows you to display or punch options for multiple entity occurrences.

Note: The parameter descriptions that apply to both the DISPLAY/PUNCH and the DISPLAY/PUNCH ALL statements appear after the DISPLAY/PUNCH syntax.

Syntax: DISPLAY/PUNCH ALL (for multiple entity occurrences)

►►─┬─ DISplay ─┬─┬─ ALL───────────────────────────┬── entity-type-name ───────►
   └─ PUNch ───┘ └─┬─ FIRst ─┬─┬─ 1 ◄ ──────────┬─┘
                   ├─ NEXt ──┤ └─ entity-count ─┘
                   ├─ LASt ──┤
                   └─ PRIor ─┘

 ►─┬───────────────────────────────────────────────────┬──────────────────────►
   └─ PREpared by user-id ─┬─────────────────────────┬─┘
                           └─ PASsword is password ──┘

 ►─┬────────────────────────────────┬─────────────────────────────────────────►
   └─ WHEre conditional-expression ─┘
(for complete conditional-expression syntax, see WHERE clause later
in this chapter)

 ►─┬─────────────────┬────────────────────────────────────────────────────────►
   └─ BY ─┬─ SET ──┬─┘
          └─ AREa ─┘

 ►─┬──────────────────────────────────────────────────────────────────────────►─
   └─ TO ─┬─ SYSpch ──────────────────────────────────────────────────────────
          └─ MODule module-name ─┬───────────────────────────────────┬────────
                                 └─ Version is ─┬─ version-number ─┬─┘
                                                ├─ HIGhest ────────┤
                                                └─ LOWest ─────────┘
─►──────────────────────────────────────────────────────────────────────────┬─►
  ─────────────────────────────────────────────────────────────────────────┬┘
  ─┬──────────────────────┬┬──────────────────────────────────────────────┬┘
   └ LANguage is language ┘└ PREpared by user-id ┬───────────────────────┬┘
                                                 └ PASsword is password ─┘

 ►─┬──────────────────────┬──┬──────────────────────────────────────┬─────────►◄
   └─ VERB ─┬─ DISplay ─┬─┘  └─ AS ─┬─ SYNtax ───┬──┬─────────────┬─┘
            ├─ PUNch ───┤           └─ COMments ─┘  └─ RECursive ─┘
            ├─ ADD ─────┤
            ├─ MODify ──┤
            ├─ REPlace ─┤
            └─ DELete ──┘

Parameters

Parameters specific to DISPLAY/PUNCH ALL

DISplay/PUNch ALL/FIRst/NEXt/LASt/PRIOr

Specifies that the DDDL compiler is to display or punch multiple entity occurrences. The output consists only of the information necessary to execute a DISPLAY/PUNCH entity request for each entity occurrence. For example, RECORD occurrences are displayed with their name and version, MODULE occurrences with their name and language, and ATTRIBUTE occurrences with their name and class. In an online session, the user can execute the displayed statements by pressing ENTER. This two-step process allows the user to scan the contents of the dictionary for the desired entity-occurrence definitions without generating unneeded output.

ALL

Lists all occurrences of the requested entity type that the current user is authorized to display. With a large number of entity occurrences, ALL may slow online response time. You can use the DISPLAY ALL LIMIT and INTERRUPT COUNT clauses of the SET OPTIONS statement (see SET OPTIONS Statement) to limit DISPLAY.

FIRst/NEXt/LASt/PRIOr

Lists the first, next, last, or prior occurrences of the named entity type.

entity-count

Specifies the number of occurrences displayed or punched. 1 is the default.

entity-type-name

Identifies the entity type or entity synonym that is the object of the DISPLAY/PUNCH ALL request.

WHEre conditional-expression

Specifies criteria to be used by the DDDL compiler in selecting occurrences of the requested entity type. Conditional-expression is described in detail under WHERE Clause (Conditional Expressions), later in this chapter.

BY SET

Retrieves all entity occurrences by the set relationship between the OOAK-012 record and the entity record. BY SET is most efficient when the dictionary contains relatively fewer occurrences than there are pages in the dictionary. BY SET can be applied to any entity type except MESSAGE or LOAD MODULE. SET is the default for all entity types except ELEMENT and ELEMENT SYNONYM.

BY AREa

Retrieves all entity occurrences by sweeping the DDLDML area of the dictionary. BY AREA is most efficient when the dictionary contains relatively numerous occurrences of the requested entity-type, generally more occurrences than there are pages in the dictionary. BY AREA can be applied to any entity type except MESSAGE or LOAD MODULE. AREA is the default for the ELEMENT and ELEMENT SYNONYM entity types.

RECursive

Appends “AS SYNTAX.” or “AS COMMENT.” to each generated line of output.