You must copy and customize the SMTPNOTE CLIST on every system
where users will be able to send mail with the SMTPNOTE command. This
includes TCP/IP nodes and each NJE node that sends mail through SMTP
on a remote gateway node. SMTPNOTE uses the TSO transmit (XMIT) command
to interface with SMTP.
Copy SEZAINST(SMTPNOTE) into the system CLIST data set. Because
the SEZAINST data set is in a fixed format, the SMTPNOTE member may
be truncated if your system CLIST library is not in a fixed format.
You should customize the following variables in the SMTPNOTE CLIST:
- DDNAME
- The DDNAME that SMTPNOTE will use to allocate the input data set.
The allocation is done to allow shared access to the data set. The
default value is set to EZBSMTPN and should be changed only if this
value will cause a conflict on your system.
- HOSTNAME
- The name of the system on which this CLIST is installed. Typically,
the name is the NJE node name of this system. The NJE node name of
the system is the value of the NAME parameter on the NODE(nn) statement
in the JES2PARM member of parmlib.
- SMTPNODE
- The NJE node on which the SMTP server runs. Typically, HOSTNAME
and SMTPNODE have the same value. When SMTPNODE is used on an NJE
network in conjunction with a TCP-to-NJE gateway, the value of this
parameter is the NJE node name of that gateway.
- SMTPJOB
- The name of the address space in which SMTP runs at SMTPNODE.
Usually this is SMTP. The SMTPJOB name must not be defined as a node
name to JES and cannot begin with the characters R, RM, or RMT, because
SMTPNOTE uses TSO XMIT to transmit the note to the SMTP address space.
- TEMPDSN
- The name of the temporary data set used to store the contents
of the note being created. This can be any arbitrary data set name
that ends with the low-level qualifier, TEXT. Do not use a fully qualified
name. If you do not fully qualify the name (no quotes), the data set
name will be prefixed by the userid. If
you enclose the name in single quotes, several users can use this
temporary data set.
- TIMEZONE
- The time zone for your system. This will appear in the "Date:"
stamp of the RFC 822 header generated by SMTPNOTE. See RFC 822 for
valid time zone formats. SMTPNOTE does not check the validity of the
character string configured. If SYSTZ is configured, SMTPNOTE gets
the TIMEZONE value from the MVS™ system
using the local TIME/DATE offset in the communication vector table
(CVT) associated with SMTPNOTE. This value is then converted to a
string format of a plus sign (+) or a minus sign (-) followed by 4
digits (for example, -HHMM). The local TIME/DATE
offset is controlled by the system administrator that sets the MVS system time/date and timezone
parameters. For more information about the CLOCKxx parmlib member,
see z/OS MVS Initialization and Tuning Reference. For more information about the MVS SET CLOCK=hh.mm.ss or SET TIMEZONE={W|E}.hh.mm commands,
see z/OS MVS System Commands.
For information about accessing RFCs, see Related protocol specifications.
Note: SMTPNOTE
does not alter any existing date/time and timezone headers in the
mail.
- ATSIGN
- Some foreign languages need to use a different character to represent
the @ symbol. This input symbol is a single-byte representation of
the @ symbol in their national language code page.
- DOMAIN
- Some SMTP message transfer agents (MTAs) need a fully qualified
name as an email address for the originator of the mail. If DOMAIN
is set, then this string is appended to the HOSTNAME variable string
provided in this CLIST, and the resulting fully qualified name string
is hostname.domain.
The resulting string is later used by the CLIST to create the SMTP
MAIL FROM: command and the RFC 822 From: header in the mail message.
The CLIST does not check validity of the content of the string. This
variable should be set when sending mail to CSSMTP.
You should also modify the following parmlib members:
- IEFSSNxx
- When the SMTP server is
running in the same host (or system) as the SMTPNOTE CLIST, the IEFSSNxx
member can be modified in one of the following two ways:
- The following lines may be included:
TNF,MVPTSSI
VMCF,MVPXSSI, nodename
where nodename is
the NJE node name. The NJE node name, nodename,
must be the same as the hostname and the smtpnode that
are defined in the SMTPNOTE CLIST.
- If you are using restartable VMCF, you must make changes to IEFSSxx
members in the SYS1.PARMLIB data set.
For introductory information
on restartable VMCF, see Step 3: Configure VMCF and TNF.
For the MVS system changes required
for restartable VMCF, see the TCP/IP for MVS Program
Directory. For information on VMCF commands, see z/OS Communications Server: IP Diagnosis Guide.
Note: You
should define the SystemName in the IEFSSNxx parmlib member to be
the same as your JES2 or JES3 (NJE) nodename. This is required for
correct delivery of SMTP mail. For example, if the following line
is coded in your SMTPNOTE CLIST:
SMTPNODE P390
you
need to code NAME=P390 in your IEFSSNxx parmlib member. As an alternative,
instead of using the IEFSSNxx parmlib member to specify the JES node,
you can use the keyword NJENODENAME within your SMTP configuration
to a valid NJE node. For more information, see NJENODENAME.
- IKJTSOxx
- The TRANSREC statement must
contain the correct nodename, or the NODESMF parameter can be coded
as NODESMF((*,*)). For more information on the TRANSREC statement,
see z/OS MVS Initialization and Tuning Reference.