HP 3000 Manuals

LIST [ DICTIONARY 3000 ] MPE/iX 5.0 Documentation


DICTIONARY 3000

LIST 

Lists information for an entity or entities with a subset of the
attributes.

Syntax 

     [option] LIST subcommand 
             L

Use the LIST command to see the attributes of:

 *  a particular entity
 *  all entities of a particular type
 *  entities selected by using Selection Criteria (see Section III)

A complete list of entities for which a listing can be generated is given
under Subcommands.  The subcommand identifies the type of entity for
which a listing is generated.  The listing is displayed in the order in
which the entities were entered.  After the listing, the number of
records displayed is given.

To list one entity, specify the entity's name in response to the first
prompt.  To list all of the entities for a specific subcommand, press the
[[RETURN]] key for all the prompts or enter an exclamation character (!)
in response to the first prompt.  (Note that this is a different use of
the [[RETURN]] key and of the exclamation mark character than for most
commands.)  The Selection Criteria can also be used to generate a
listing.  (See Section III for more detailed information.)

The PRINT option can be used with the command string to print the listing
and additional information on the line printer.  Along with the
information normally displayed, the listing will include the description
entered when the entity was created.

Subcommands 

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

CATEGORY                  lists the categories

CLASS                     lists the security classes

ELEMENT                   lists the data elements

FILE                      lists the files

GROUP                     lists the HP Inform groups

LOCATION                  lists the physical locations PROCEDURE   lists
                          the procedures

Example 

     > REPEAT LIST ELEMENT

                    ELEMENT> PU^                              <
                       TYPE> !                                <

     ELEMENT:             TYPE: SIZE: DEC: LENGTH: COUNT: RESPONSIBILITY:
      PUB-DATE             X     6     0    6       1     M. Sides
      PURCH-DATE           X     6     0    6       1     M. Abear
      PURCH-NO             U     6     0    6       1     R. Park
      PUBLISHER            X     40    0    40      1     M. Sides

     4 RECORDS FOUND
                    ELEMENT> ^T                               <
                       TYPE> !                                <

     ELEMENT:             TYPE: SIZE: DEC: LENGTH: COUNT: RESPONSIBILITY:
      CREDIT               U     2     0    2       1     J. Smith
      SUBJECT              X     40    0    40      1     M. Sides
      SQUARE-FEET          X     8     0    8       1     R. Park
      ACCOUNT              X     10    0    10      1     M. Abear
      UNIT-COST            P     11    0    6       1     M. Abear
      EXISTING-STRUCT      U     2     0    2       1     J. Smith
      LOAN-AMT             P     11    2    6       1     M. Abear

     7 RECORDS FOUND

                    ELEMENT> ]                                   <
     >

Subcommand Prompts 

You can enter specific information for any of the prompts or use
SELECTION CRITERIA in response to a prompt.  (Refer to Using Selection
Criteria in Section III.) Responding with [[RETURN]] to all the prompts
or with an exclamation mark (!)  to the first prompt lists information
about all entities for the specified subcommand.

You enter:               You are prompted for:

                SUB-
     COMMAND   COMMAND         PROMPT

     LIST     CATEGORY        CATEGORY
                              TYPE
                                RESPONSIBILITY

     LIST     CLASS           CLASS
                                TYPE
                                RESPONSIBILITY

     LIST     ELEMENT   ELEMENT
                          TYPE
                          ELEMENT REFERENCE     Issued only if TYPE is "*".

                          SIZE                  Issued if TYPE is not "*".
                          DECIMAL               Issued only if TYPE is numeric
                                                and TYPE is not "*".

                          STORAGE LENGTH        Issued if TYPE is not "*".
                          COUNT                 Issued if TYPE is not "*".
                          RESPONSIBILITY        Issued if TYPE is not "*".

     LIST     FILE      FILE
                          TYPE
                          RESPONSIBILITY

     LIST     GROUP     GROUP
                          TYPE
                          RESPONSIBILITY

     LIST     LOCATION  LOCATION
                          GROUP
                          ACCOUNT
                          CPU

     LIST     PROCEDURE PROCEDURE
                          TYPE
                          LANGUAGE
                          RESPONSIBILITY

Prompts 

Depending on the subcommand used, one or more of the following prompts is
issued.

ACCOUNT                   Enter the name of the existing MPE account or
                          Selection Criteria for which information is to
                          be listed.

CATEGORY                  Enter the name of the existing category or
                          Selection Criteria for which information is to
                          be listed.

CLASS                     Enter the number of the existing security class
                          or Selection Criteria for which information is
                          to be listed.

COUNT                     Enter the sub-element count if the data element
                          is a compound element or Selection Criteria for
                          which information is to be listed.

CPU                       Enter the name of the machine or Selection
                          Criteria for which information is to be listed.

DECIMAL                   Enter the integer value for the number of
                          digits to the right of the decimal point (0 to
                          9999) or Selection Criteria for which
                          information is to be displayed.  Do not include
                          a position for the decimal point itself.  The
                          largest value for each element type is as
                          follows:

                          For types Z, P, and 9, the largest value is 27
                          digits.

                          For types I, J, and K, the largest value is 28
                          digits.

                          For types E and R, the largest value is 9999
                          decimal digits.

                          This prompt is only issued for numeric type
                          data elements.  Note that if the maximum value
                          for SIZE is entered, a decimal value is
                          required.

ELEMENT                   Enter the name of the existing data element or
                          Selection Criteria for which information is to
                          be listed.

ELEMENT REFERENCE         Enter the name of an existing element (20
                          characters maximum) which is to be used as the
                          back-referenced element.  The element to be
                          listed has the same type, size, storage length,
                          and sub-element count, and the same
                          decimal placement (if applicable) as the
                          back-referenced element.

FILE                      Enter the name of the existing file or
                          Selection Criteria for which information is to
                          be listed.

GROUP                     If the subcommand is:

                          GROUP         enter the name of an existing HP
                                        Inform group or Selection
                                        Criteria for which information is
                                        to be listed.

                          LOCATION      enter the name of an existing MPE
                                        group or Selection Criteria for
                                        which information is to be
                                        listed.

LANGUAGE                  Enter the name of the implementation language
                          or Selection Criteria for which information is
                          to be listed.

LOCATION                  Enter the name of the physical location or
                          Selection Criteria for which information is to
                          be listed.

PROCEDURE                 Enter the name of the existing procedure or
                          Selection Criteria for which information is to
                          be listed.

RESPONSIBILITY            Enter the name of the person, department, or
                          area, or Selection Criteria for which
                          information is to be listed.

SIZE                      Enter an integer value required to display an
                          element (1 to 9999) or Selection Criteria for
                          which information is to be listed.  Include a
                          position for a decimal point if there is one,
                          but do not include one for a sign.  The largest
                          value for each element type is as follows:

                          For types Z, P, and 9, the largest value is 28
                          digits.

                          For types I, J, and K, the largest value is 29
                          digits.

                          For types E, R, X, and U, the largest value is
                          9999 digits.

STORAGE LENGTH            Enter the storage length in bytes or Selection
                          Criteria for which information is to be
                          displayed.

TYPE                      If the subcommand is:

                          ELEMENT       enter the attribute type or
                                        Selection Criteria for which
                                        information is to be listed.

                          FILE          enter the file type or Selection
                                        Criteria for which information is
                                        to be listed.

                          CATEGORY, CLASS, GROUP, PROCEDURE - enter the
                          character value or Selection Criteria for which
                          information is to be listed.


MPE/iX 5.0 Documentation