HP 3000 Manuals

SHOW [ DICTIONARY 3000 ] MPE/iX 5.0 Documentation


DICTIONARY 3000

SHOW 

Shows all the relationships for an entity and the associations for child
entities.

Syntax 

     [option] SHOW subcommand 
              S

Use the SHOW command to display the hierarchical relationship for an
entity and the association information for child entities.  Relationships
are established using the RELATE command and associations are established
using the ADD command.

The subcommand identifies the entity to be displayed.  For example, the
subcommands LOCATION and CLASS show the association information for a
location and class.  The subcommands CATEGORY, PROCEDURE, FILE, and GROUP
show the relationship and the association information for their
respective entities.  The subcommand ELEMENT shows only the relationship
information for the element.

The relationship information is displayed as a tree structure from the
point of entry down.  After the parent entity name is displayed, each
child is displayed in the order in which the child was related to the
parent.  Data elements associated with each child can also be displayed
depending on your response to the prompt to do so.  If you choose to
display the data elements, an asterisk (*) will appear next to an element
to indicate that it is a key or search element within that file.  The
PRINT option can be used with the command string to redirect what is
shown by this command to the line printer.  Description information will
be printed in addition to the information normally displayed on the
terminal.  The description information is the information that was
entered when the relationship or association was made.

Subcommands 

Any of the following subcommands can be used with the SHOW command:

CATEGORY                  shows all the relationships for a category plus
                          associated data elements where applicable

CLASS                     shows all the associations for a user security
                          class and all the related child classes plus
                          all associated groups.

ELEMENT                   shows all the relationships for a data element

FILE                      shows all the relationships and links for a
                          file plus associated data elements where
                          applicable

GROUP                     shows all the relationships for an HP Inform
                          group plus associated data elements where
                          applicable and access information for the group

LOCATION                  shows all the associations for a location

PROCEDURE                 shows all the relationships for a procedure
                          plus associated data elements where applicable

Example 

     > SHOW FILE
                       FILE> HOUSES              <

     SHOW ALL FILE ELEMENTS(Y/N)?> y

     FILE:                TYPE: RESPONSIBILITY:
      HOUSES               BASE

     FILE(ALIAS):     TYPE:     FILE(PRIMARY):       CAPACITY:
      CITY-MASTER      MAST      CITY-MASTER          101

              ELEMENT(ALIAS):             PROPERTIES:         ELEMENT(PRIMARY):
               CITY-ABBR            *      U (4,0,4)           CITY-ABBR
               CITYNAME                    U (20,0,20)         CITYNAME
     FILE(ALIAS):     TYPE:     FILE(PRIMARY):       CAPACITY:
      BATH-MASTER      AUTO      BATH-MASTER          31
              ELEMENT(ALIAS):             PROPERTIES:         ELEMENT(PRIMARY):
               NUMBER-BATHS         *      X (4,0,4)           NUMBER-BATHS

     FILE(ALIAS):     TYPE:     FILE(PRIMARY):       CAPACITY:
      BEDS-MASTER      AUTO      BEDS-MASTER          11

              ELEMENT(ALIAS):             PROPERTIES:         ELEMENT(PRIMARY):
               NUMBER-BEDS          *      X (2,0,2)           NUMBER-BEDS

     FILE(ALIAS):     TYPE:     FILE(PRIMARY):       CAPACITY:
      RESIDENTIAL      DETL      RESIDENTIAL          200

              ELEMENT(ALIAS):             PROPERTIES:         ELEMENT(PRIMARY):
               CITY-ABBR            *      U (4,0,4)           CITY-ABBR
                                      CHAIN MASTER SET: CITY-MASTER
               NUMBER-BEDS          *      X (2,0,2)           NUMBER-BEDS
                                      CHAIN MASTER SET: BEDS-MASTER
               NUMBER-BATHS         *      X (4,0,4)           NUMBER-BATHS
                                      CHAIN MASTER SET: BATH-MASTER
               CURRENT-OWNER               U (20,0,20)         CURRENT-OWNER
               OWNERS-PHONENR              X (10,0,10)         OWNERS-PHONENR
                  .
                  .
                  .
     >

Subcommand Prompts 

For the prompts shown with an asterisk (*), you must enter a response
other than [[RETURN]] in order to implement the command string.

You enter:              You are prompted for:

                SUB-
     COMMAND   COMMAND         PROMPT

     SHOW     CATEGORY       * CATEGORY

     SHOW     CLASS          * CLASS

     SHOW     ELEMENT        * ELEMENT

     SHOW     FILE           * FILE
                                PRIMARY/SECONDARY(P/S)?   Issued if file type is
                                                        KSAM, MPEF or MPER.
     SHOW     GROUP          * GROUP

     SHOW     LOCATION       * LOCATION

     SHOW     PROCEDURE      * PROCEDURE

Prompts 

Depending on which subcommand you use, one of the following prompts is
issued:

CATEGORY                  Enter the name of an existing category for
                          which relationships are to be shown (20
                          characters maximum).

CLASS                     Enter the name of an existing user security
                          class for which a list of associations is to be
                          given (4 characters maximum).

ELEMENT                   Enter the name of an existing data element for
                          which relationships are to be shown (20
                          characters maximum).

FILE                      Enter the name of an existing file for which
                          relationships are to be shown (20 characters
                          maximum).

GROUP                     Enter the name of an existing HP Inform group
                          for which relationships and access information
                          are to be shown (20 characters maximum).  Note
                          that a pound sign ( ) indicates the element
                          will not be displayed on HP Inform's Data Names
                          Menu.

LOCATION                  Enter the name of an existing location for
                          which a list of associations is to be given (20
                          characters maximum).

PRIMARY/SECONDARY (P/S)?  Enter P (or press [[RETURN]]) if the primary
                          format for that file is to shown.  Enter S if
                          the secondary format for that file is to be
                          shown.  (See the discussion of the ADD command
                          for more information on primary and secondary
                          formats for a file.)  DEFAULT is P.

PROCEDURE                 Enter the name of an existing procedure for
                          which relationships are to be shown (20
                          characters maximum).


MPE/iX 5.0 Documentation