9.118 GET_MESSAGE_LIST
Þ Note: Built-In Function Rules.
The only required parameter will be a message file. This will load the list with each subsequent message file / message stored in the message table LX_MSG.
If a language other than *ALL is specified only messages with the specified language will be returned.
If a message id is specified, all messages following the message id will be returned to the list. (NB a language must be specified if a message id is specified.).
For use with
|
LANSA for i
|
NO
|
|
Visual LANSA for Windows
|
YES
|
|
Visual LANSA for Linux
|
YES
|
|
Arguments
|
No.
|
Type
|
Req/ Opt
|
Description
|
Min Len
|
Max Len
|
Min Dec
|
Max Dec
|
|
1
|
A
|
Req
|
Search Message File
|
1
|
10
|
|
|
|
2
|
A
|
Opt
|
Language Code
If the special value *ALL is specified all languages will be returned, otherwise only messages for the selected language will be listed.
|
1
|
4
|
|
|
|
3
|
A
|
Opt
|
Message Identifier
|
1
|
7
|
|
|
|
Return Values
|
No.
|
Type
|
Req/ Opt
|
Description
|
Min Len
|
Max Len
|
Min Dec
|
Max Dec
|
|
1
|
L
|
Req
|
Working list containing message details.
List must not be more than 32767 entries.
Message details to be formatted as follows:
From - To Description
1 - 4 Language
5 - 14 Message File
15 - 21 Message Identifier
22 - 153 Message Text
|
153
|
153
|
|
|
|
2
|
A
|
Req
|
The last Language in the returned list.
|
1
|
4
|
|
|
|
3
|
A
|
Req
|
The last Message File in the returned list.
|
1
|
10
|
|
|
|
4
|
A
|
Req
|
The last Message Identifier in the returned list.
|
1
|
7
|
|
|
|
5
|
A
|
Req
|
Return Code
OK = list returned partially or completely filled with message details. No more Messages exist beyond those returned in the list
OV = list returned completely filled, but more Messages than could fit in the list still exist
NR = list was returned empty. Last Message File/ Message Identifier in list returned as blanks
|
2
|
2
|
|
|
|