9.139 MAIL_SET_SUBJECT

Note: Built-In Function Rules     Usage Options

Used to set the text of the messages subject.

You would normally call this function to set a Subject but it is not mandatory.

Arguments

No Type Req/ Opt Description Min Len Max Len Min Dec Max Dec 1 A Req Text string describing the message subject. 1 255

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

• No Subject is defined immediately following a MAIL_START call.

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

• If any error occurs, all details of the email definition will be lost. To restart processing, a new call to MAIL_START would be 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(Set Subject text)

USE BUILTIN(MAIL_SET_SUBJECT) WITH_ARGS('Testing Email Built-In Functions') TO_GET(#LEM_RETC)