Using the SMTPNOTE command

Purpose

Use the SMTPNOTE command to prepare mail for one or more recipients using the Time Sharing Option (TSO) EDIT command or to send mail that is created with another system editor.

Send electronic mail to one or more recipients on TCP networks using the SMTPNOTE command. Use the SMTPNOTE command to transmit mail messages to the JES spool data set to be processed by the CSSMTP application. If the CSSMTP application does not have an ExtWrtName statement, you must customize the SMTPJOB variable in the SMTPNOTE CLIST to match the CSSMTP application job name; otherwise, ensure that the SMTPJOB variable in the SMTPNOTE CLIST matches the value that is specified on the ExtWrtName configuration statement. The DOMAIN variable should also be set in the SMTPNOTE CLIST when you are using CSSMTP. For more information about customizing the SMTPNOTE CLIST, see the steps for customizing the SMTPNOTE CLIST (optional) in z/OS Communications Server: IP Configuration Guide.

Format


>>-SMTPNOTE--+-----------------+--+-----------------+----------->
             '-To--(recipient)-'  +-Cc--(recipient)-+   
                                  '-NOCc------------'   

>--+--------------------+--+-------------------------------+---><
   '-Subject--(subject)-'  +-Dataset--(dataset)--+-------+-+   
                           |                     '-Batch-' |   
                           '-Reuse-------------------------'

Parameters

To (recipient)

Specifies a single recipient for the mail message. If you do not specify the To parameter, you are prompted to enter a list of recipients. Enter the name of each recipient on a separate line and end the recipient list with a blank line. You must specify at least one mail recipient.

Cc (recipient)

Specifies a single copy recipient for the mail message. If you do not specify the Cc parameter and you do not specify the NOCc or Batch parameters, you are prompted to enter a list of copy recipients.

If there are no copy recipients, press Enter; otherwise, enter the name of each recipient on a separate line and end the list with a blank line.

NOCc

Specifies that no prompting for the Cc parameter takes place.

(recipient)

Specifies the path address of the mail recipient. The format of the recipient parameter is equivalent to the path syntax, as described in RFC 2821, without the less than (<) and greater than (>) delimiters. For information about accessing RFCs, see Related protocol specifications.

The recipient parameter has one of the following formats:

user_id@host_name: A user on a host in your domain, possibly on your local node.

user_id@host_name .domain: A user on a host in a specified domain.

Restrictions:

The CSSMTP application does not rewrite the specified path name. The batch job must specify the proper email address formats, such as userid@host.domain. For example, in the command string user_id%nje_host_name@gateway_name.domain, the term user_id%nje_host_name is treated as a user ID.
The CSSMTP application does not support source routing, such as @host1,@host2:userid@host3 or NJEuserid%NJEhost format. For example, in the address string @host1,@host2,...,@hostn :user_id @host_name, the @host1,@host2,...,@hostn portion of the address is ignored and the user_id @host_name portion of the address is used as the recipient value.
The CSSMTP application does not generate source routing addressing formats.

Subject (subject)

Specifies the subject of the mail message. If the subject is specified as a keyword, the message cannot contain embedded blanks; otherwise, the subject can be any character string. The maximum length is 233 characters.

Batch

Specifies that no prompting takes place. You must also specify the To and Dataset parameters.

Dataset (data_set_name)

Indicates that the text of the mail is contained in a sequential data set. The data set can have any record format, can be blocked or unblocked, and can have records that are 1 – 243 characters in length. The data_set_name variable is the name of the sequential data set that contains the mail message text. The data set name must be a valid data set name, and is fully qualified if it is within single quotation marks (').

Reuse

Causes SMTP to reuse the contents of a mail message that was previously canceled. If a mail message was not canceled, the Reuse parameter is ignored.

Guidelines:

When the To, Cc, Subject, or Dataset parameters are specified more than once, the SMTPNOTE application uses the last value that was specified. No error messages are generated if there are duplicate parameters on the command line.
SMTPNOTE does not require quotation marks around blanks, or single quotation marks, semicolons, or commas around data set names.

Restriction: Do not use extended attribute data sets (PDSE) with the SMTPNOTE command.

Examples

After you enter the SMTPNOTE command, you are prompted for the mail recipients (To:), the copy recipients (Cc:), and the subject of the mail message (Subject:), if they were not specified with the SMTPNOTE command. If you enter a list of recipients, enter the name of each recipient on a separate line and enter a blank line to indicate the end of the list.

After you answer the prompts, SMTPNOTE invokes the TSO EDIT command to enable you to prepare your mail message. Typically, the TSO editor starts in INPUT mode. Enter the text of your mail message line by line. When your mail message is complete, enter a null line (that is, do not type anything when you are prompted) and press Enter. The editor switches to EDIT mode.

In EDIT mode, you can use all of the functions of the editor. You can also return to INPUT mode, send the mail message, or cancel the mail message. For a complete description of the EDIT command, see z/OS TSO/E Command Reference.

If you invoke the SMTPNOTE command with the Reuse or Dataset parameter, your session is immediately placed in EDIT mode. The contents of the previously canceled mail message or the data set that you specify are already part of the mail message. You can add to or change the existing data.

To send the mail message, enter END SAVE in EDIT mode, and then enter SEND. To cancel the mail message, enter END SAVE or END NOSAVE in EDIT mode, and then enter CANCEL. If you cancel a mail message, you can recover the data that you entered by invoking the SMTPNOTE command with the Reuse parameter. The recipients and subject of the mail message are not saved, and must be reentered. The following is an example of the results of preparing and sending mail.

    _____________________________________________________________________ 
   |                                                                     |
   | READY                                                               |
   | smtpnote                                                            |
   |  TO:                                                                |
   | irvine@mvs2.accounting                                              |
   | bekker@mvs2.accounting                                              |
   | mcgregr@mvs1.accounting                                             |
   |                                                                     |
   |  CC:                                                                |
   |                                                                     |
   |  SUBJECT:                                                           |
   | Travel Expenses                                                     |
   |                                                                     |
   |  ENTER "END SAVE" TO SAVE THE NOTE.                                 |
   |  FOR A COMPLETE LIST OF EDIT SUBCOMMANDS ENTER "HELP".              |
   |  INPUT                                                              |
   | Could we please postpone the expense review because I               |
   | will be out of town the week of the 19th.                           |
   |                                                                     |
   | How about the 23rd?  Thank you, John.                               |
   |                                                                     |
   |  EDIT                                                               |
   | end save                                                            |
   |  ENTER "SEND" TO SEND THE NOTE.                                     |
   |  ENTER "CANCEL" TO TERMINATE WITHOUT SENDING THE NOTE.              |
   | send                                                                |
   |  READY                                                              |
   |                                                                     |
   |_____________________________________________________________________|