9.97 GET_MESSAGE_LIST

Note: Built-In Function Rules     Usage Options

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.).

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