Display Structures

FILEMAINT Mode - FILE Structure Maintenance › Display Structures

Display Structures

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

How to Use

You can display a structure or substructure by using one of the following procedures:

Select the DISPLAY option on the File Structure Functions panel listing functions 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 File Structure Functions Menu, you receive a prompter panel similar to the following example:

 =>
 =>
 =>
 1-DDOL000196A - CMPP - PLEASE COMPLETE REQUIRED INFORMATION FOR COMMAND
 -------------------------------------------------------------------------------
 FILE Structure Maintenance
                                                                            TXCF
 DISPLAY  FILE     ________________________________ in STATUS ____
 DIS      FIL      (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
 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 to be displayed.

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

(stat)

(Required) Specify the status of the occurrence.

Valid Entries:

T0001—T999
PROD

HIST
H000—H997

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 (condensed), CA Datacom Datadictionary presents the condensed structure display containing the occurrences in the structure except the FIELD occurrences and some of the attribute-values. For more information, see Structure Display Panel.

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 199001 for the year and month or 19900131 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 according to your criteria. This sample is the result of a DISPLAY command for a condensed structure display of a FILE structure.

 =>
 =>
 =>
 1-DDOL000523I - UFUP - SUCCESSFUL FILE STRUCTURE CREATE
 -------------------------------------------------------------------------------
 FILE Structure Maintenance                                              DISPLAY
                                                                            TDYD
        Status: T001

        Entity-Type          Occurrence-Name
 ====== ========================== T O P ====================================
 000001 FILE                 PER-REC-HISTORY
 000002   RECORD             PER-REC-HISTORY
 ====== ======================= 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 FILE entity. When you press PF4 (PROCESS) you receive the following display:

 =>
 =>
 =>

 -------------------------------------------------------------------------------
 FILE Structure Maintenance                                              DISPLAY
                                                                            TDXD
        Status: T001

        Entity-Type          Occurrence-Name
                                             Length  Options
 ====== ========================== T O P ====================================

 000001 FILE                 PER-REC-HISTORY
                                             01024
 000002   RECORD             PER-REC-HISTORY
                                             00132
 000003     FIELD            EMP-NO
                                             00005   00000001N00001RNSNC000
 000004     FIELD            EMP-NAME
                                             00028   00000001C00001LNCNC000
 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 RECORD, KEY, and ELEMENT structures and the attribute-values for each occurrence.