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