9 161 MAIL_SET_SUBJECT

LANSA Technical

9.161 MAIL_SET_SUBJECT

Þ Note: Built-In Function Rules.

Used to set the text of the messages subject.

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

For use with

LANSA for i

YES

 

Visual LANSA for Windows

YES

Refer to Email Built-In Function Notes before using this Built-In Function.

Visual LANSA for Linux

NO

 

 

 

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)