7.23 DEF_LIST
The DEF_LIST command is used to define a list and the fields that comprise an entry in the list.
The list may be a browse list (used for displaying information at a workstation) or a working list (used to store information within a program).
Lists are categorized into static and dynamic lists. A static list is a list that does not specify *MAX in the ENTRYS parameter. If it does it is a dynamic list. Dynamic lists can only be used in RDMLX objects and are recommended as memory requirements are much lower.
For instance the command:
DEF_LIST NAME(#ORDERLINE) FIELDS(#ORDLIN #PRODUCT #QUANTITY #PRICE)
defines a browse list that can be displayed at a workstation and might look like this:
Order Line Product Number Quantity Net
Number Ordered Price
999 XXXXXXXXX 99999 9999.99
999 XXXXXXXXX 99999 9999.99
999 XXXXXXXXX 99999 9999.99
999 XXXXXXXXX 99999 9999.99
999 XXXXXXXXX 99999 9999.99
999 XXXXXXXXX 99999 9999.99
While the command:
DEF_LIST NAME(#ORDERLINE) FIELDS(#ORDLIN #PRODUCT #QUANTITY #PRICE) TYPE(*WORKING) ENTRYS(10)
defines a working list that can contain at most 10 entries. This type of list cannot be directly displayed at the workstation, but can be accessed within the RDML program just like a browse list.
When the DEF_LIST command is used it defines what fields are in one "entry" of the list. The browse list example above has 6 entries shown and each entry contains an order line number, a product number, a quantity and a price.
Once defined, there are limits to the number of entries in each type of list.
- An RDML browse list can contain up to the number of entries as shown in the following table:
|
Continued in 7.23.2 DEF_LIST Description
|
Portability Considerations |
Refer to parameter: SCROLL_TXT. |
Also See
7.23.2 DEF_LIST Description continued
7.23.3 DEF_LIST Comments / Warnings
Required
DEF_LIST ----- NAME --------- name of list ------------------->
>-- FIELDS ------- field name field attributes --->
| | | |
| --- 7 max ----- |
| expandable group expression |
|------ 1000 max for RDMLX----|
------ 100 max for RDML -----
-----------------------------------------------------------------
Optional
>-- COUNTER ------ *NONE -------------------------->
numeric field name
>-- TYPE --------- *BROWSE ------------------------>
*WORKING
>-- ENTRYS ------- 50 ----------------------------->
number in range 1 – 2,147,483,647
>-- PAGE_SIZE ---- *NONE -------------------------->
numeric field name
>-- TOP_ENTRY ---- *CURRENT ----------------------->
numeric field name
>-- SEL_ENTRY ---- *NONE -------------------------->
numeric field name
>-- SCROLL_TXT --- *NONE --------------------------|
alphanumeric field name