DISPLAY/PUNCH Statement

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

DISPLAY/PUNCH Statement

The DISPLAY/PUNCH statement allows you to display or punch options for a single entity occurrence.

Syntax: DISPLAY/PUNCH (for a single entity occurrence)

►►─┬─ DISplay ─┬─ entity-type-name name is entity-occurrence-name ────────────►
   └─ PUNch ───┘

 ►─┬──────────────────────────────────┬───────────────────────────────────────►
   └─ Version is ─┬─ version-number ─┬┘
                  ├─ HIGhest ────────┤
                  └─ LOWest ─────────┘

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

 ►─┬──────────────────────────────────┬───────────────────────────────────────►
   └─┬─ WITh ──────┬─ entity-option ──┘
     ├─ ALSo WITh ─┤
     └─ WITHOut ───┘

 ►─┬──────────────────────────────────────────────────────────────────────────►─
   └─ 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 ─┘
            ├─ ADD ─────┤
            ├─ MODify ──┤
            ├─ REPlace ─┤
            └─ DELete ──┘

Parameters

DISplay/PUNch entity-type-name

Specifies that the DDDL compiler is to display or punch the information associated with a single entity-occurrence definition. Entity-type-name must be a valid IDD entity type.

name is entity-occurrence-name

Specifies an existing occurrence of the specified entity type.

Version is version-number/HIGhest/LOWest

Qualifies nonunique entity names.

PREpared by user-id

Identifies the user requesting the DISPLAY operation. User-id must be a 1- through 32-character value and must be enclosed in quotation marks if it contains embedded blanks or delimiters.

PASsword is password

Specifies the password associated with the user named in the PREPARED BY parameter.

WITh entity-option

Specifies that the DDDL compiler is to replace the options specified in the SET OPTIONS DISPLAY WITH and DISPLAY ALSO WITH statements with the specified options for this DISPLAY/PUNCH request only.

ALSo WITh

Specifies that the DDDL compiler is to add the specified options to the default options specified in the SET OPTIONS DISPLAY WITH and DISPLAY ALSO WITH statements for this DISPLAY/PUNCH request only.

WITHOut

Specifies that the DDDL compiler is to exclude the specified options from the default options specified in the SET OPTIONS DISPLAY WITH and DISPLAY ALSO statements for this DISPLAY/PUNCH request only.

entity-option

Specifies an entity-specific option that is the object of the WITH/ALSO WITH/WITHOUT specification. All entity-options you can specify are described in detail under the DISPLAY clause of the SET OPTIONS statement (see SET OPTIONS Syntax). Individual syntax diagrams in Chapter 4 list the valid options for each entity type.

TO

Specifies the destination for punched output (used with PUNCH only).

SYSpch

Specifies that the DDDL compiler is to direct PUNCH verb output to the SYSPCH file.

MODule module-name

Specifies that the DDDL compiler is to direct PUNCH verb output to the named module. Module-name must be the 1- through 32-character name of a module defined in the dictionary through the MODULE statement (see MODULE (PROCESS/QFILE/TABLE)). The following rules apply to the named module:

Once the module has been named as the destination of the PUNCH command, it cannot be modified, replaced, or deleted.
A module cannot be punched to itself.
The PUNCH verb cannot name a module that is the object of an INCLUDE statement.

If module source is already associated with the object module, the DDDL compiler adds the PUNCH verb output to the end of the existing module. If module source does not exist, the DDDL compiler generates a header which contains the date and time that the initial punched output was created.

The specified destination overrides the default destination established in the SET OPTIONS PUNCH statement.

Version is version-number/HIGhest/LOWest

Qualifies the named module with a version number.

LANguage is language

Qualifies the named module with a language.

VERB DISplay/PUNch/ADD/MODify/REPlace/DELete

Specifies the verb that is to accompany DISPLAY/PUNCH output. This parameter overrides the default verb established in the SET OPTIONS VERB statement.

AS SYNtax

Specifies that the text output by the DISPLAY/PUNCH verb is to appear as syntax. In an online session, text displayed as syntax can be edited and resubmitted to the DDDL compiler. If the PUNCH command is issued in batch mode, the DDDL compiler directs the output to the SYSPCH file or to an IDD module, where it can be edited and subsequently resubmitted.

This parameter overrides the default format established in the SET OPTIONS statement.

AS COMments

Specifies that the text output by the DISPLAY/PUNCH verb be formatted as compiler comments; comments are preceded by *+ and are ignored by the DDDL compiler. This parameter overrides the default format established in the SET OPTIONS statement.