Send SMTP Mail (RLSNDM)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters
Examples Error messages |
The Send SMTP Mail (RLSNDM) command specifies parameters affecting the content and sending of email messages. It is intended for use only within Raz-Lee.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| TO | To (mail1,mail2,mail3..) | Character value, *SENDER, *SELECT, *REPLY, *USER | Required, Positional 1 |
| SUBJECT | Subject | Character value, *NONE | Optional, Positional 2 |
| TEXT | Mail text | Character value, *SUBJECT, *FILE, *NONE | Optional, Positional 3 |
| ATTACH | Attachment | Values (up to 15 repetitions): Path name, *FILE, *NONE | Optional, Positional 4 |
| SNDMODE | Mail Sending Mode | *DFT, *JAVA, *IBM, *DEFINED, *SECURED, *UNSECURED, *NONE | Optional, Positional 5 |
| FILE | Mail text file | Single values: *NONE Other values: Qualified object name |
Optional, Positional 6 |
| Qualifier 1: Mail text file | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB, *NONE | ||
| MBR | Member | Name, *NONE | Optional, Positional 7 |
| ATTFILE | Attached file | Single values: *NONE Other values: Qualified object name |
Optional, Positional 8 |
| Qualifier 1: Attached file | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB, *NONE | ||
| FILEMBR | File Member | Name, *NONE | Optional, Positional 9 |
| SENDER | Sender | Element list | Optional, Positional 10 |
| Element 1: Address, *TO, *REPLY, *USER... | Character value, *TO, *REPLY, *USER, *DONOTREPLY, *SELECT | ||
| Element 2: Description | Character value | ||
| REPLYTO | Reply-to | Element list | Optional, Positional 11 |
| Element 1: Reply to (mail1,mail2,mail3..) | Character value, *SENDER, *USER, *REPLY, *TO, *DONOTREPLY, *SELECT | ||
| Element 2: Description | Character value | ||
| CC | CC (mail1,mail2,mail3..) | Character value, *NONE, *SELECT, *USER | Optional, Positional 12 |
| BCC | BCC (mail1,mail2,mail3..) | Character value, *NONE, *SELECT, *USER | Optional, Positional 13 |
| FOOTNOTE | Footnote Message | Character value, *DFT, *EMPTY, *ATTACHMENT, *NONE | Optional, Positional 14 |
| SMTPPORT | Mail port number | Character value, *DFT, *LOCAL | Optional, Positional 15 |
| SMTPSSL | SSL/TLS Secured Mail | *DFT, *YES, *NO | Optional, Positional 16 |
| ATCOBJ | Object size to allow attach | Decimal number, *NO, *NOMAX | Optional, Positional 17 |
| ATCDLT | Delete attachment | *NO, *YES | Optional, Positional 18 |
| CVTATT | Convert attachment to ASCII | *NO, *YES | Optional, Positional 19 |
| ZIP | Zip | *NO, *YES | Optional, Positional 20 |
| ZIPPWD | ZIP password | Character value, *NO | Optional, Positional 21 |
| ENVLIB | Environment | *AUD, *AV, *FS | Optional, Positional 22 |
| BATCH | Send in BATCH mode | *YES, *NO | Optional, Positional 23 |
| DUMP | Dump RLSNDM command into QGPL | *NO, *FILE, *JOBLOG, *BOTH, *DUMP | Optional, Positional 24 |
| HOST | Mail (SMTP) server name | Character value, *LOCALHOST, *DFT | Optional, Positional 25 |
| ACCOUNT | Mail account | Character value, *SENDER, *DFT, *NONE | Optional, Positional 26 |
| PWD | Account password | Character value, *DFT, *NONE | Optional, Positional 27 |
| CCSID | CCSID | 37-65535, *JOB, *PROD, *DFT, *SYSVAL, *SMS | Optional, Positional 28 |
| INSCR | Insert CR in text body | Decimal number, *NONE, *DFT | Optional, Positional 29 |
| USRDFNDTA | User defined data | Character value, *NONE | Optional, Positional 30 |
| Top |
To (mail1,mail2,mail3..) (TO)
Specifies the addresses to which email is sent. There can be multiple recipients, separated by commas.
This is a required parameter.
- *SENDER
- Use the value of the SENDER parameter.
- *SELECT
- If running interactively, opens the "Work with Email Address Book" screen to select email addresses.
- *REPLY
- Use the value of the "Reply to mail address" parameter specified through STRAUD > 89 > 2.
- *USER
- The user running the query.
- character-value
- Specify one or more addresses.
| Top |
Subject (SUBJECT)
Specifies the subject line for the email message.
- *NONE
- The email will have no subject line.
- character-value
- Specify the text for the Subject line.
| Top |
Mail text (TEXT)
Specifies the text of the email message.
- *SUBJECT
- The message text is the same as the Subject line.
- *FILE
- If run interactively, displays a dialog to select the file and member.
- *NONE
- The message has no text.
- character-value
- Specify the text of the message.
| Top |
Attachment (ATTACH)
Specifies one or more files to be attached to the message.
You can specify 15 values for this parameter.
- *FILE
- If running interactively, the user is prompted for a file name.
- *NONE
- Nothing is attached.
- path-name
- The pathname to the file to be attached.
| Top |
Mail Sending Mode (SNDMODE)
Specifies the mail sending mode.
- *DFT
- Use the default mode.
- *JAVA
- Send email using Java.
- *IBM
- Use the IBM standard mode to send email.
- *DEFINED
- Follow the system definition to determine whether to send email *SECURED or *UNSECURED.
- *SECURED
- Send a username and password to the server when you send email.
- *UNSECURED
- Send mail without sending a username and password to the server.
- *NONE
- Do not send mail.
| Top |
Mail text file (FILE)
Specifies the file containing mail text.
Single values
- *NONE
- No file is specified.
Qualifier 1: Mail text file
- name
- The name of the file containing mail text.
Qualifier 2: Library
- *LIBL
- All libraries on the library list are searched until a match is found.
- *CURLIB
- The current library.
- *NONE
- No library is specified.
- name
- . Specify the name of the library.
| Top |
Member (MBR)
Specifies whether to use a specified member of a file as the email text.
- *NONE
- Do not use a member.
- name
- Specify the name of the member to send.
| Top |
Attached file (ATTFILE)
Specifies the file to be attached to the email.
Single values
- *NONE
- No file is attached.
Qualifier 1: Attached file
- name
- Specify the name of the file.
Qualifier 2: Library
- *LIBL
- All libraries on the library list are searched until a matich is found.
- *CURLIB
- The current library.
- *NONE
- No library is specified.
- name
- Specify the name of the library.
| Top |
File Member (FILEMBR)
Specifies the member of the file specified as the *ATTFILE parameter to attach.
- *NONE
- Do not specify a member.
- name
- Specify the name of the member.
| Top |
Sender (SENDER)
Specifies the username shown as the sender of the email.
Element 1: Address, *TO, *REPLY, *USER...
- *TO
- The value of the TO parameter.
- *REPLY
- Use the value of the "Reply to mail address" parameter specified through STRAUD > 89 > 2.
- *USER
- The user running the query.
- *DONOTREPLY
- Specifies an address that does not accept replies.
- *SELECT
- If running interactively, opens the "Work with Email Address Book" screen.
- character-value
- Specify one or more addresses.
Element 2: Description
- character-value
- Specify a username.
| Top |
Reply-to (REPLYTO)
Specifies the address to which replies to the email are directed.
Element 1: Reply to (mail1,mail2,mail3..)
- *SENDER
- Use the value of the SENDER parameter.
- *USER
- The user running the query.
- *REPLY
- Use the value of the "Reply to mail address" parameter specified through STRAUD > 89 > 2.
- *TO
- The value of the To parameter.
- *DONOTREPLY
- An address that discards replies.
- *SELECT
- If running interactively, opens the "Work with Email Address Book" screen,
- character-value
- Specify one or more addresses.
Element 2: Description
- character-value
- A text description of the address.
| Top |
CC (mail1,mail2,mail3..) (CC)
Specifies who is specified on the CC: (Carbon Copy) line of the email header.
- *NONE
- No CC: is specified.
- *SELECT
- If running interactively, opens the "Work with Email Address Book" screen.
- *USER
- The user running the query.
- character-value
- Specify one or more addresses.
| Top |
BCC (mail1,mail2,mail3..) (BCC)
Specifies BCC: (Blind Carbon Copy) recipients for the email.
- *NONE
- The are no BCC: recipients.
- *SELECT
- If running interactively, opens the "Work with Email Address Book" screen.
- *USER
- The user running the query.
- character-value
- Specify one or more addresses.
| Top |
Footnote Message (FOOTNOTE)
Specifies a footnote to be appended to the email.
- *DFT
- A default message.
- *EMPTY
- An empty message is appended.
- *ATTACHMENT
- The text of the file specified in the ATTACH parameter.
- *NONE
- No text is appended.
- character-value
- Specify the character string to be appended.
| Top |
Mail port number (SMTPPORT)
Specifies the SMTP port for the email.
- *DFT
- The default port specified in STRAUD > 89 > 2.
- *LOCAL
- The default local port.
- character-value
- Specify a particular value.
| Top |
SSL/TLS Secured Mail (SMTPSSL)
Specifies whether mail is sent via secured or unsecured SMTP.
- *DFT
- The defualt value specified in STRAUD > 89 >2.
- *YES
- Mail is sent secured.
- *NO
- Mail is sent unsecured.
| Top |
Object size to allow attach (ATCOBJ)
Specifies the maximum size of an attachment.
- *NO
- No objects can be attached.
- *NOMAX
- Objects of any size can be attached.
- decimal-number
- Specify a maximum size, in MB.
| Top |
Delete attachment (ATCDLT)
Specifies whether to delete the attached file once the email is successfully sent.
- *NO
- Do not delete the file.
- *YES
- Delete the file.
| Top |
Convert attachment to ASCII (CVTATT)
Specifies whether to convert the attachment to ASCII.
- *NO
- Do not convert the document.
- *YES
- Convert the document.
| Top |
Zip (ZIP)
Specifies whether to attach the document in ZIP format.
- *NO
- Do not zip the document.
- *YES
- Zip the document.
| Top |
ZIP password (ZIPPWD)
Specifies whether to use a password for an attached ZIP file, and what the password should be.
- *NO
- Do not use a password for the ZIP file.
- character-value
- The password to use for the ZIP file.
| Top |
Environment (ENVLIB)
Specifies the environment library to use.
- *AUD
- The environment library for iSecurity Audit.
- *AV
- The environment library for iSecurity Antivirus.
- *FS
- The environment library for FileScope.
| Top |
Send in BATCH mode (BATCH)
Specifies whether to send the email in batch mode.
- *YES
- Send the email in batch mode.
- *NO
- Do not send the email in batch mode.
| Top |
Dump RLSNDM command into QGPL (DUMP)
Specifies whether and how to send dump data if needed.
- *NO
- Do not send dump data.
- *FILE
- Write the dump data to a file.
- *JOBLOG
- Write the dump data to the joblog.
- *BOTH
- Write the dump data to both a file and the job log.
- *DUMP
- Write the dump data to the default destination defined for it.
| Top |
Mail (SMTP) server name (HOST)
Specifies the SMTP server for sending mail.
- *LOCALHOST
- The local server.
- *DFT
- The default server.
- character-value
- Specify the name of a server.
| Top |
Mail account (ACCOUNT)
Specifies the account used for sending email.
- *SENDER
- Use the value of the SENDER parameter.
- *DFT
- The default account.
- *NONE
- Do not specify an account.
- character-value
- Specify the name of the account.
| Top |
Account password (PWD)
Specifies the account password used in sending email.
- *DFT
- The default password.
- *NONE
- Do not specify a password.
- character-value
- Specify the password.
| Top |
CCSID (CCSID)
Specifies the CCSID for sending mail.
- *JOB
- The CCSID of the job.
- *PROD
- The CCSID specified as the "CCSID to use as origin of data" in BASE System Configuration Language Support (STRAUD > 81 > 91).
- *DFT
- The default CCSID.
- *SYSVAL
- The value of the system value "CCSID".
- *SMS
- 819, the value for standard ASCII.
- 37-65535
- The literal value "37-65535".
| Top |
Insert CR in text body (INSCR)
Specifies whether to insert carriage returns at line endings in the email.
- *NONE
- Do not insert carriage returns.
- *DFT
- Follow the system default.
- decimal-number
- Specify the number of carriage returns to be inserted.
| Top |
User defined data (USRDFNDTA)
Specifies user-defined data concerning the email/
- *NONE
- Do not use user-defined data.
- character-value
- Specify the user-defined data.
| Top |
| Top |
| Top |