IBM Support

SMTPNOTE fails with 'Unable to transmit' error

Troubleshooting


Problem

Whenever the SMTPNOTE command is used to send a mail message from a TSO ID (or batch job) to an Internet mail address, it fails with an EZA5579E message.

Symptom


EZA5579E
UNABLE TO TRANSMIT DATA TO 'SMTP, ' AT 'YKTVS'

Cause

As a part of installing the z/OS Communications Server component, you must customize the SMTPNOTE exec for the local environment. This error is a result of either missing that customization step or running with an unmodified version of SMTPNOTE.

Resolving The Problem

Refer to the IP Configuration Guide (SC31-8775), Step 3 of Configuring the SMTP Server for a description of the items that need to be customized in the SMTPNOTE exec . Copy the original version of the SMTPNOTE exec from the SEZAINST library shipped with the product to a library that is in the SYSPROC (or SYSEXEC) concatenation for all users.

The following shows the section in the SMTPNOTE exec that you need to update. The values for the hostname and smtpnode need to be modified on every customer system (and are the cause of the EZA5579E message).  But you might want to change the other values as well to match the local environment. See the IP Configuration Guide and comments within the exec (shown here) which describe these values further.


/****                                                             ****/
/****   The following lines set five variables which affect the   ****/
/****   way SMTPNOTE behaves.  The values provided are examples   ****/
/****   only and should be changed, where appropriate, to         ****/
/****   reflect your particular system.                           ****/
/****                                                             ****/
/****                                                             ****/
/****   HOSTNAME   The name of the system on which this EXEC is   ****/
/****              installed (typically the NJE node name of this ****/
/****              system).                                       ****/
/****                                                             ****/
                   hostname = "YKTVS"                                  
/****                                                             ****/
/****                                                             ****/
/****   SMTPNODE   The NJE node on which the SMTP address space   ****/
/****              or virtual machine runs.  Typically HOSTNAME   ****/
/****              and SMTPNODE will have the same value.  In the ****/
/****              case where SMTPNOTE is being used on a NJE     ****/
/****              network in conjunction with a TCP-NJE gateway, ****/
/****              the value of SMTPNODE will be the NJE node     ****/
/****              name of the TCP-NJE gateway.                   ****/
/****                                                             ****/
                   smtpnode = "YKTVS"                                  
/****                                                             ****/
/****                                                             ****/
/****   SMTPJOB    The name of the address space or virtual       ****/
/****              machine in which SMTP runs at SMTPNODE.        ****/
/****              Usually this is "SMTP".                        ****/
/****                                                             ****/
                   smtpjob = "SMTP"                                    
/****                                                             ****/
/****                                                             ****/
/****   TEMPDSN    The name of the temporary dataset used to      ****/
/****              store the contents of notes being created.     ****/
/****              This can be any arbitrary dataset name but it  ****/
/****              must end with '.TEXT'.  DO NOT put single      ****/
/****              quotes around the name, i.e. use a fully       ****/
/****              qualified dataset name, as this will result    ****/
/****              in multiple TSO users using the same           ****/
/****              temporary dataset.                             ****/
/****                                                             ****/
                   tempdsn = "SMTPNOTE.TEXT"                          
                   if sysvar('syspref') = "" then                      
                      tempdsn = userid()"."tempdsn                    
/****                                                             ****/
/****                                                             ****/
/****   TIMEZONE   The time zone which appears in the "Date:"     ****/
/****              stamp of the RFC 822 header.                   ****/
/****              If value "SYSTZ" is configured then the       @A3A*/
/****              timezone value is gotten from the CVT variable@A3A*/
/****              CVTLDTO.                                      @A3A*/
/****                                                             ****/
                   timezone = "EST"                                    
/****                                                             ****/
/****   ATSIGN     Some foreign language need to have a different@A2A*/
/****              character representing the at symbol          @A2A*/
/****                                                            @A2A*/
                   atsign   = "@"                             /* @A2A*/
/****                                                             ****/
/****   DDNAME     The DDNAME that SMTPNOTE will use to allocate @N1A*/
/****              the input data set to allow shared access to  @N1A*/
/****              the data set.                                 @N1A*/
/****                                                            @N1A*/
                   ddname  = "EZBSMTPN"                       /* @N1A*/
/****                                                             ****/
/****   DOMAIN     The name of the domain to be appended to the  @F1A*/
/****              hostname string so that the MAIL FROM: command@F1A*/
/****              can have a fully qualified name (FQN).        @F1A*/
/****                                                            @F1A*/
                   domain = ""                               /* @F1A*/
/****                                                             ****/
/*********************************************************************/

[{"Product":{"code":"SSSN3L","label":"z\/OS Communications Server"},"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Component":"All","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"1.6;1.7;1.8;1.9;1.10;1.11;1.12;1.13;2.1;2.2;2.3","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

TCPIP TCP/IP CS/390 OS/390 MVS

Document Information

Modified date:
19 June 2020

UID

swg21165746