Display Structures

DBMAINT Mode - DATACOM/DB Structure Maintenance › Display Structures

Display Structures

Use the DISPLAY function to display all the occurrences in a structure or substructure in an indented format. After displaying the structure or substructure, you can use the margin commands to place occurrences and functions in the online work queue for processing.

How to Use

Use one of the following procedures to display a structure or substructure:

Select the DISPLAY option on the Structure Functions Menu for the selected structure and fill in the resulting prompter panel.
Use the DISPLAY command (see DISPLAY) for the structure.
Type the DIS (or DCS or DFS) margin command in the line number of the occurrence on a structure or index display panel, enter the PROCESS command (press PF4), and press PF9 (APPLY).

When you select the DISPLAY function on the DB Structure Function Panel, you receive a prompter panel similar to the following example:

 =>
 =>
 =>
 1-DDOL000196A - CMPP - PLEASE COMPLETE REQUIRED INFORMATION FOR COMMAND
 -------------------------------------------------------------------------------
 DATACOM/DB Structure Maintenance
                                                                            TXCF
 DISPLAY  DATABASE ________________________________ in STATUS ____
 DIS      BAS      (name)                              STAT  (stat)


 with PASSWORD      using OVERRIDE
      PSWD    (pswd)      OVRD    (ovrd)


 format is COND    AS OF ____________
          (format)      (YYYYMMDDhhmm)





 PF1=HELP  PF2=END  PF3=CLARIFY  PF4=PROCESS  PF5=MENU   PF6=STATUS    MORE....
 PF7=SCB   PF8=SCF  PF9=APPLY    PF10=PATH    PF11=NEXT  PF12=INPUT

The following list describes each field, the valid entries, and the default (if one exists). Fields that require an entry are highlighted on your terminal. Fields which are not highlighted indicate that an entry is optional.

(name)

(Required) Specify the occurrence name of the occurrence displayed.

Valid Entries:: 1- to 32-character occurrence name
Default Value:: (No default)

(stat)

(Required) Specify the status of the occurrence.

Valid Entries:: TEST or T001—T999
PROD or 001—999
QUAL
HIST or H001—H997 (000-997 is the generation number)
ASOF (if you want to use the AS OF option)
Default Value:: (No default)

(pswd)

Only required if this occurrence has protection against unauthorized maintenance with a password assignment. Supply the password for this occurrence.

Valid Entries:: 1- to 4-character password
Default Value:: (No default)

(ovrd)

Only required if this occurrence is restricted from unauthorized maintenance or retrieval with a lock level assignment. Supply the override code.

Valid Entries:: 1- to 4-character override code
Default Value:: (No default)

(format)

(Optional) Specify the format for the display. If you enter FULL, CA Datacom Datadictionary presents the full structure display containing all occurrences in the structure or substructure and the attribute-values on the Structure Maintenance Panels and FILE Maintenance Panels.

If you accept the default, COND, CA Datacom Datadictionary presents the condensed structure display containing all the occurrences in the structure except the FIELD occurrences and some of the attribute-values. See Structure Display Panel for details.

Valid Entries:: COND
FULL
Default Value:: COND

AS OF YYYYMMDDhhmm

(Optional) If you enter ASOF in the status field, specify the date/time stamp to display the version of the structure that was in PROD status at that date and time. You can specify the full date and time or a partial date, such as 201001 for the year and month or 20100131 for the year, month, and day.

Note: If your time value includes seconds, round up to the nearest minute.

Valid Entries:: 1 to 12 digits
Default Value:: (No default)

When you press Enter, CA Datacom Datadictionary presents the structure display panel for the structure or substructure for the occurrence according to your criteria. This sample is the result of a DISPLAY command for a condensed structure display of a DATABASE structure.

 =>
 =>
 =>

 -------------------------------------------------------------------------------
 DATACOM/DB Structure Maintenance                                        DISPLAY
                                                                            TDYD
        Status: T001

        Entity-Type          Occurrence-Name                   DB-Name DB-Id Use
 ====== ========================== T O P ====================================
 000001 DATABASE             ORDER-ENTRY                               00333
 000002   AREA               ACCTS                             ACT
 000004     TABLE            ACCTS                             ACT       001  Y
 000005       KEY            ORD-ID-KEY                        ACTOR     000  I
 000006       KEY            CUST-ID-KY                        ACSTI     000  I
 000007       ELEMENT        ACCTS-REC-EL                      ACTFL
 000008       ELEMENT        CUST-ID-EL                        ACTCS
 000009       ELEMENT        ORD-ID-EL                         ACTOD
 ====== ======================= B O T T O M =================================


 PF1=HELP  PF2=END  PF3=CLARIFY  PF4=PROCESS  PF5=MENU   PF6=STATUS
 PF7=SCB   PF8=SCF  PF9=APPLY    PF10=PATH    PF11=NEXT  PF12=INPUT

You can request a full structure display by typing the DFS (Display Full Structure) margin command in the line numbers for the DATABASE entity. When you press PF4 (PROCESS) you receive the following display:

 =>
 =>
 =>

 -------------------------------------------------------------------------------
 DATACOM/DB Structure Maintenance                                        DISPLAY
                                                                           TDXD
        Status: T001

        Entity-Type          Occurrence-Name                                Use
                              DB-Name DB-Id  Length  Options
 ====== ========================== T O P ======================================

 000001 DATABASE             ORDER-ENTRY
                                       010
 000002   AREA               ACCTS-REC-AREA
                              ACT            04096   1 0005
 000003     TABLE            ACCTS-REC                                        N
                              ACT      006   00031   NNNNY000000YN
 000004       FIELD          ORD-ID
                                             00005   00000001N00001RNSNC000
 PF1=HELP  PF2=END  PF3=CLARIFY  PF4=PROCESS  PF5=MENU   PF6=STATUS    MORE....
 PF7=SCB   PF8=SCF  PF9=APPLY    PF10=PATH    PF11=NEXT  PF12=INPUT

For more information and an explanation of the Options, see Structure Display Panel.

When the display is longer than the screen, you can use the scroll commands or PF keys to move backward and forward through the display.

The full structure display lists the FIELD occurrences defined in the TABLE, KEY and ELEMENT substructures and the attribute-values for each occurrence.