2.2.6 Error Message

Specify either message number and message file or message text. If neither an error message number and file nor error message text is specified LANSA will insert a default error message number, file and library as the error message. These default messages are "general purpose" and do not provide much detail about the specific cause of the error.

Message File

Specify the message file name to be used to locate the identified message number.

Message file is mandatory if using a Message Number.

Platform Considerations

• IBM i: Error message files and error message numbers are a native part of the IBM i operating system. Refer to the IBM supplied Control Language Reference Manual for more details. CL commands involving message files include CRTMSGF and ADDMSGD.

• IBM i: You can directly edit the message details from this screen panel. Enter as much of the message details as is known and use the function key labeled "Work Msgd" (Work Message Description). This will cause an IBM i WRKMSGD command to be executed, using as much of the supplied message details as is possible. This IBM i facility will allow you to create or edit the message details. Upon completion of the WRKMSGD command, this screen panel will be redisplayed, unchanged, to allow you to proceed.

• Do not store user defined messages, or modify "shipped" messages, in the LANSA message file DC@M01 via this or any other message file editing facility. It is regularly replaced by new versions or EPCs (Expedited Program Changes).

Error Message Number

Specify the message number from the identified message file that you wish displayed.

Message number is mandatory if using a Message File.

Error Message Text

Specify the text of the error message to be displayed directly.

Message length can be a maximum of 80 characters.

Tips & Techniques

• If Message Text facility is used, then the message will have no second level text associated with it.

• Special substitution characters can be used in the message.