LNCSNDMAIL allows to send electronic messages and controls the main features :
recipients
(TO, CC, BCC), object, message text, attachments , priority level,
acknowledgement.
Messaging system must be MAPI compatible (as Outlook or Exchange), otherwise
Lotus Notes or a SMTP server can be used.
Notice : It is not necessary that the messaging system be currently running on the station to send messages.
Parameters
|
Attached files |
DOC |
*NONE |
|
+ if others values |
|
|
|
Attached files folder |
FLR |
*NONE |
|
To recipient(s): |
TOINTNET |
|
|
Messaging address |
|
|
|
Recipient type |
|
*TO |
|
+ if others values |
|
|
|
Subject |
SUBJECT |
|
|
Message |
MSG |
*NONE |
|
Priority |
PTY |
*NORMAL |
|
Reception confirmation |
CFMDEL |
*NO |
|
Launcher server name |
EXESRV |
*DFT |
|
Ending option |
|
*ALL |
|
Messaging system type |
MSGTYPE |
*SMTP |
|
SMTP Parameters: |
|
|
|
Messaging address of sender |
CFGSMTP |
*DFT |
|
Return address |
|
*DFT |
|
SMTP server adress or name |
|
*DFT |
|
SMTP port number |
|
*DFT |
|
Trace of message being sent |
|
*NO |
|
SMTP user profile |
|
*NONE |
|
User password |
|
*NONE |
|
Enable SSL |
|
*NO |
|
Timeout |
|
*NONE |
|
Number of trials |
|
*NONE |
|
Logfile path |
|
*DFT |
|
SSL protocol |
|
TLS |
|
Signature |
|
*NO |
|
Encrypt email |
|
*NO |
|
Certificate path |
|
*NONE |
|
Password certificate |
|
*NONE |
|
Secure headers |
|
*NO |
|
Wrapper subject |
|
*NONE |
|
Check email |
|
*NO |
Details
Attached files (DOC)
Specifies the PC filename of each attachment.
This parameter allows multiple values.
To enter more values, enter a '+' sign in the "+ if other values" line, and type ENTER.
Attached files folder (FLR)
Specifies the main folder for attached files.
If a full path is specified in the DOC parameter this parameter must be set to *NONE.
Recipient(s) (TOINTNET)
Specifies the messaging address of the destination address(es).
Up to 100 messaging addresses can be specified.
This parameter allows multiple values.
To enter more values, enter a '+' sign in the "+ if other values" line, and type ENTER.
Messaging address
Specify a messaging address of a recipient, in the messaging system syntax.
Can contain up to 253 characters.
Type of recipient
Specifies the kind of recipient that was specified.
Possible values are :
*TO
This is a main recipient.
*CC
This is a CC (Carbon Copy) recipient.
*BCC
This is a BCC (Blind Carbon Copy) recipient.
The other recipients will not see the existence of this recipient.
Subject (SUBJECT)
Message subject. Can contain up to 44 characters.
This parameter is mandatory and must not begin with blanks.
Message (MSG)
Main message text.
Possible values are:
message
The message text. Can contain up to 5000 characters.
To put line breaks, use %PARA%.
*NONE
Use *NONE special value to generate a message with no body.
*DOCMSG
The *DOCMSG special value indicates that the body will be a document specified in the DOCMSG parameter.
Notice : The *DOCMSG value is only valid when using the SMTP messaging system.
Priority (PTY)
Specifies the priority level of the message (low, normal or high).
Possible values are:
*NORMAL
The message has a normal priority level.
*HIGH
The message has a high priority level.
*LOW
The message has a low priority level.
Reception confirmation (CFMDEL)
Specifies if the sender wants to receive a return receipt.
Possible values are :
*NO
The sender will not ask a return receipt.
*YES
The sender asks a return receipt.
This return receipt will be sent by the recipients if they receive the message and accept to return receipts.
LAUNCHER server name (EXESRV)
Specifies the name or IP address of the PC to use to build the document.
Possible values are :
*DFT
The value from the keyword MSGSRV in file LNCDFTP is used.
*DEV
PC where the terminal for the current job is located.
*CURRENT
When *CURRENT is specified, the current job must be already connected to a LAUNCHER Office Server on a PC.
That connection will be used.
IP address or name
Processing is performed on a network PC, referred to here as its hostname, or TCP / IP address.
Notice : The LAUNCHER Office server application must be running on the PC.
Messaging system type (MSGTYPE)
Speficies the messaging system type.
*SMTP
Messaging system is SMTP (Simple Mail Transfer Protocol).
*MAPI
Messaging system is MAPI (For example Exchange or Outlook).
*LOTUS
Messaging system is Lotus Notes.
SMTP parameters SMTP (CFGSMTP)
These are mandatory parameters when using SMTP messaging type.
Email address of sender
Specifies the email address of the sender.
Possible values are:
*DFT
The sender value is specified in the MSGSND keyword of LNCDFTP file.
email-address
Choose an email address for the sender.
Return address
Specifies the email return address.
Name of SMTP server
Specifies the IP address or the name of the SMTP server.
SMTP port number
Port number of the SMTP server. This is 25 by default.
Trace of sent emails
Default is *NO.
*YES: Ensures that the message is sent.
The file is formatted by delimiters (;), to be imported into a database or Excel.
Use WRKLNCDFT to specify the path and name of the logfile.
SMTP user profile
SMTP user profile.
SMTP user password
SMTP user password.
Enable SSL
Default value: *NO.
SSL is used to access the specified SMTP mail server.
TLS is used by default. Change the SSL Protocol setting if you want to use the SMTPS protocol.
Timeout
Defines the waiting time for sending an email. By default, no delay is specified (*NONE). It is the processing time of the SMTP server once the connection is established. Specify a delay in seconds.
Number of trials
Indicate the number of attempts to send an e-mail if the SMTP server is not reachable. By default, no new attempts (*NONE).
Indicate a number of retries.
Logfile path
If the trace of the sent emails is activated (*YES), by default the path of the logfile (*DFT) is defined with the command WRKLNCDFT. You can specify a path here other than *DFT.
SSL protocol
By default: the TLS protocol (STARTTLS command) is used.
Port #587 is generally used with the TLS protocol.
You can specify the SMTPS protocol, also called SMTP/SSL, SMTP over SSL, or SMTPS, and typically uses port #465.
Sign email
Put *YES to sign the email. The certificate path and password are required. Default: *NO.
Encrypt (encrypt) email
The body of the email is encrypted according to PKCS #7. The certificate path and password are required. Default: *NO.
Certificate path
Path of the certificate (.p12 file) used to sign and/or encrypt the email.
Certificate password
Password of the certificate (.p12 file) used to sign and/or encrypt the email.
Secure headers
Protection
of headers through the use of a RFC 822 message.
A message/rfc822 wrapper is used to apply S/MIME security services to headers.
See RFC 8551 for more details. The email will be received as an attachment by
the recipient.
Wrapper subject
If
SecureHeaders=*YES, by default the recipient will receive an email without
subject and an attachment containing the specified email.
You can specify a subject here in order to prevent the email from going into
spam.
Check email
Put *YES to proceed to a verification of the recipients' email addresses, according to the RFC 5322 standard, before sending. Default: *NO.
Example
LNCSNDMAIL TOINTNET(('tech@easycom-aura.com' *CC) +
('INFO@EASYCOM-AURA.COM')) SUBJECT('ENVOI DE MAIL') +
MSG('Ceci est un test d''envoi de mail avec LAUNCHER Office') + CFGSMTP('TECH@EASYCOM-AURA.COM''TECH@EASYCOM-AURA.COM' + '183.145.89.12')
Other example
HTML file as body mail, sent with SMTP. Delivy report and email sent logfile activated.
LNCSNDMAIL TOINTNET(('tech@easycom-aura.com') +
('sales@easycom-aura.com' *BCC)) +
SUBJECT(&OBJET) MSG(*DOCMSG) CFMDEL(*YES) +
EXESRV(*CURRENT) +
CFGSMTP('info@easycom-aura.com' +
'info@easycom-aura.com' +
'smtp.aura.fr' 0 *DFT *YES) +
DOCMSG('C:\A\R_11WORD.HTML')