General DDDL Syntax Options › Displaying Entity Occurrences

Displaying Entity Occurrences

You can list one or more entity-occurrence definitions by using the DISPLAY/PUNCH statement, which functions as follows:

• DISPLAY— Lists all or selected portions of the requested entity occurrences at the terminal or on the Integrated Data Dictionary Activity List. During an online session, the user can edit DISPLAY verb output and resubmit it as input to the DDDL compiler.
• PUNCH— When used online, functions in the same way as DISPLAY. When used in batch mode, writes the requested information to the SYSPCH file or to an IDD module defined as the destination for PUNCH verb output.

Optional DISPLAY/PUNCH statement clauses allow the user to specify, for the current DISPLAY/PUNCH statement only, the entity-type options to be listed, whether these options are to appear as syntax or comments, the verb to accompany the DISPLAY/PUNCH output, and, for PUNCH only, the destination for the punched output. If the DISPLAY/PUNCH statement requests multiple occurrences of an entity type, the user can supply a conditional expression that specifies criteria to be used by the DDDL compiler in selecting the requested entities.

Two Output Formats

The format of DISPLAY/PUNCH verb output is governed by the SET OPTIONS statement FORMAT IS FIXED/FREE specification. A FREE format appears as running text, for example:

display next map.
*+   display map name is linda version is 1
*+           within panel linda-olmpanel version is 1
display prior program.
*+   display program name is chs02 version is 1 .

A FIXED format appears in a columnar presentation, for example:

display first 2 maps.
*+   display
*+   map name                         mkmap2
*+    version                          0000000001
*+    within panel                    mkmap2-olmpanel
*+     version                         0000000001
*+     .
*+   display
*+   map name                         mkmap1
*+    version                          0000000001
*+    within panel                    mkmap1-olmpanel
*+     version                         0000000001
*+     .

Columnar format facilitates access to DDDL compiler output by online CA IDMS applications.

Requesting Single or Multiple Occurrences

There are two DISPLAY/PUNCH statements:

• DISPLAY/PUNCH for requesting a single entity occurrence
• DISPLAY/PUNCH ALL for requesting multiple occurrences

The syntax for each statement is presented separately in the following two subsections. Note that parameter descriptions that apply to both DISPLAY/PUNCH and DISPLAY/PUNCH all appear following the DISPLAY/PUNCH syntax.