Page History
7.26.1 DEF_LIST Parameters
|
|---|
Specifies the name that is to be assigned to the list. The name specified must not be the same as any other list defined in this function, any group name defined in this function (see the GROUP_BY command), or any field defined in this function or in the LANSA data dictionary.
|
|---|
Specifies the names of the field(s) which are to form one entry in the list. Field control attributes can be included with the field(s) specified. Alternatively, an expandable group expression can be entered in this parameter.
...
Fields of type Binary, VarBinary, Float, and Boolean cannot be used.
Refer to the 7.67.1 GROUP_BY Parameters for more details of specifying field lists and field control attributes.
|
|---|
Specifies a field that is to be automatically maintained with a count of the number of entries currently in the list.
...
If a field is nominated as the automatic counter it must be defined in this function or in the LANSA data dictionary and be of numeric type.
|
|---|
Identifies the list as either a browse list (*BROWSE) which can be displayed at a workstation, or as a working list (*WORKING) that can be used within the program. The default value for this parameter is *BROWSE.
|
|---|
This parameter is used for TYPE(*WORKING) lists or for TYPE(*BROWSE) lists when the application will be run on Visual LANSA It specifies the maximum number of entries that can be contained in the list at any time. If this parameter is omitted a value of 50 is assumed. Otherwise, specify an integer value in the range 1 to 2,147,483,647. If the Function or Component is not enabled for RDMLX, the limit is 9999.
The special value *MAX is provided to represent 2,147,483,647. Using this value on some operating systems, like 32-bit Microsoft Windows versions, will overflow available memory in a process if an attempt is made to add the maximum number of entries. So, the use of a large number of entries needs to be seen as allowing for an unknown number that may never be practically attained. It is up to the application designer to make appropriate use of this feature. The full-function checker issues warnings when the maximum size of the list would overflow the practical available memory on various MS Windows versions. Refer to 7.26.3 DEF_LIST Comments / Warnings for information on how to use the FFC warnings to calculate memory use.
Note that an RDML list pre-allocates all the required memory for the list. An RDMLX list pre-allocates only the number of entries that will fit into one memory page or the width of one entry, whichever is the larger. RDMLX lists allocate more memory at runtime as the need arises.
|
|---|
This parameter is only used for TYPE(*BROWSE) lists. If used, it specifies the name of a numeric field that is to contain the size (number of entries) of the browse list that fits on one "page" of the display device being used.
...
If a field is nominated to contain the "page" size it must be defined in this function or in the LANSA data dictionary and be of numeric type.
| Note |
|---|
| Note: The use of this parameter does not control the page size, it merely allows you to nominate a numeric field that is to have the LANSA assigned page size placed into it at the start of the RDML program. |
This parameter is normally only used when creating browse lists that are displayed using "page at a time" techniques. It saves the programmer from having to find out what the LANSA assigned page size is, and then having to "hard code" it into the RDML program.
|
|---|
This parameter is only used for TYPE(*BROWSE) lists. It specifies a numeric field which can be used to:
...
If a field is nominated to contain the top entry it must be defined in this function or in the LANSA data dictionary and be of numeric type.
|
|---|
This parameter is only used for TYPE(*BROWSE) lists. It specifies a numeric field which is to contain the entry number of a browse list entry that was selected by the user placing the cursor on the entry and pressing enter or a function key. If the cursor is not validly positioned the value will be returned as zero.
...
If a field is nominated to contain the selected entry number it must be defined in this function or in the LANSA data dictionary and be of numeric type.
|
|---|
This parameter is only used for TYPE(*BROWSE) lists. Additionally it should only be used when you are coding your RDML program to use "page at a time" browse list displays.
...