9.137 MAIL_SEND

Note: Built-In Function Rules     Usage Options

Used to send the constructed email message.

Arguments

None

Return Values

No Type Req/ Opt Description Min Len Max Len Min Dec Max Dec 1 A Opt Return Code OK - Action completed ER - Error occurred 2 2

Technical Notes

• On the Visual LANSA platform, MAIL_SET_OPTION calls may be required to logon to the MAPI mail provider. The information set in this way is not used until a MAIL_SEND call is issued at which time an attempt at logon validation will take place.

• On IBM i the mail message is written to the IBM i Mail Server Framework (MSF). The mail message is then processed by a MSF job and delivered according to the schedule of the distribution queues. MSF must be configured and running before any mail messages can be delivered.

• Details of the email definition will be lost unless the MAIL_SEND Built-In Function is used to send the message.

• MAIL_SEND destroys the current mail information on return from the call even if the call is unsuccessful. To start processing a new message, a new call to MAIL_START is required.

Example

This example shows only this function. See the example for MAIL_START which defines all details of an Email message and then sends it by using Built-In Functions.

********** COMMENT(SEND the mail)

USE BUILTIN(MAIL_SEND) TO_GET(#LEM_RETC)