HP 3000 Manuals

REPORT [ DICTIONARY 3000 ] MPE/iX 5.0 Documentation


DICTIONARY 3000

REPORT 

Reports a sorted listing of data elements.

Syntax 

     [option] REPORT subcommand 
              R

Use the REPORT command to display an alphabetized list of data elements
owned by an entity or by that entity's children.  Note that any element
that is owned by more than one entity is listed only once by the REPORT
command.

The subcommand identifies the entity to be listed.  For example, REPORT
CLASS lists the elements owned by the named user security class.  REPORT
ELEMENT lists all the elements defined in the Dictionary.  Also, if the
subcommand used is CATEGORY, FILE, GROUPS, or PROCEDURE and the entity
name entered is for a child entity, the elements owned by that entity are
reported.  If the name entered in response to one of these subcommands is
for a parent entity, all the elements for the related child entities are
reported.  If the name entered in response to the PROCEDURE subcommand
prompt is for a parent procedure any elements associated with that
procedure or any of its related child procedures will also be reported.

The PRINT option can be used with the command string to direct the report
to the line printer.  The report would then include descriptive
information in addition to the information normally displayed on the
terminal.  The description information is the description that was
entered when the entity was created or when an association was made.

Subcommands 

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

CATEGORY                  reports all the data elements associated with a
                          category or with related child categories

CLASS                     reports all the data elements associated with a
                          security class

ELEMENT                   reports all the data elements defined in the
                          Dictionary

FILE                      reports all the data elements associated with a
                          file or with related child files

GROUP                     reports all the data elements associated with
                          an HP Inform group or with related child groups

PROCEDURE                 reports all the data elements associated with a
                          procedure or with related child procedures,
                          including any owned by the named procedure

Example 

     > REPEAT REPORT FILE
                       FILE> product             <
     PRIMARY/SECONDARY(P/S)?                     <
     LIST OF PRIMARY FORMAT DATA ELEMENTS UNDER FILE: PRODUCT

     ELEMENT(PRIMARY):    TYPE: SIZE: DEC: LENGTH: COUNT:

      DESCRIPTION          X     30    0    30      1
      PROD-NO              U     8     0    8       1

                       FILE> sales               <
     LIST OF PRIMARY FORMAT DATA ELEMENTS UNDER FILE: SALES

     ELEMENT(PRIMARY):    TYPE: SIZE: DEC: LENGTH: COUNT:

      ACCOUNT              X     10    0    10      1
      DELIV-DATE           X     6     0    6       1
      DESCRIPTION          X     30    0    30      1
      PRICE                P     11    0    6       1
      PROD-NO              U     8     0    8       1
      PURCH-DATE           X     6     0    6       1
      PURCH-NO             U     6     0    6       1
      QUANTITY             P     7     0    4       1
      TOTAL                P     11    0    6       1
                       FILE> customer            <
     PRIMARY/SECONDARY(P/S)?                     <
     LIST OF PRIMARY FORMAT DATA ELEMENTS UNDER FILE: CUSTOMER

     ELEMENT(PRIMARY):    TYPE: SIZE: DEC: LENGTH: COUNT:

      ACCOUNT              X     10    0    10      1
      CITY-NAME            X     14    0    14      1
      CREDIT               U     2     0    2       1
      DELIV-DATE           X     6     0    6       1
      DESCRIPTION          X     30    0    30      1
      FIRST-NAME           U     18    0    18      1
      LAST-NAME            X     20    0    20      1
      PRICE                P     11    0    6       1
      PROD-NO              U     8     0    8       1
      PURCH-DATE           X     6     0    6       1
      PURCH-NO             U     6     0    6       1
      STATE                X     2     0    2       1
      STR-ADDRESS          X     22    0    22      1
      TOTAL                P     11    0    6       1
      ZIP                  X     10    0    10      1

                       FILE>                     <         [[RETURN]] key pressed.
     >

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

     REPORT   CATEGORY      * CATEGORY

     REPORT   CLASS         * CLASS
     REPORT   ELEMENT         (No prompts)

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

     REPORT   PROCEDURE     * PROCEDURE

Prompts 

Depending on the subcommand used, one of the following prompts is issued:

CATEGORY                  Enter the name of an existing category (20
                          characters maximum).

CLASS                     Enter the numeric value which is the
                          identifying number of an existing security
                          class (0 to 9999).

FILE                      Enter the name of an existing file (20
                          characters maximum).

GROUP                     Enter the name of an existing HP Inform group
                          (20 characters maximum).

PRIMARY/SECONDARY (P/S)?  Enter P (or press [[RETURN]]) if the elements
                          to be reported are in the primary format for
                          that file.  Enter S if the elements are in the
                          secondary format.  (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 (20
                          characters maximum).


MPE/iX 5.0 Documentation