STEP 7 Professional V13.1 - Siemens Industry Online Support Portals

STEP 7 Professional V13.1
Parameter MAIL_ADDR_PARAM
Parameter MAIL_ADDR_PARAM
Beschreibung
Am Parameter MAIL_ADDR_PARAM definieren Sie in der Struktur TMail_V4, TMail_V6 oder
Tmail_FQDN, über welche Verbindung die E-Mail gesendet werden soll und hinterlegen die
Adresse des E-Mail-Servers sowie die Login-Daten.
Je nachdem, in welchem Format Sie den E-Mail-Server adressieren möchten verwenden Sie
am Parameter MAIL_ADDR_PARAM die Struktur:
•
•
•
TMail_V4: Adressierung über die IP-Adresse nach IPv4.
TMail_V6: Adressierung über die IP-Adresse nach IPv6.
TMail_FQDN: Adressierung über voll qualifizierten Domain-Namen (FQDN).
Welche Struktur Sie verwenden können, ist abhängig von der am Parameter InterfaceId
adressierten Schnittstelle:
•
•
Zur Verwendung der Anweisung "TMAIL_C" mit der internen Schnittstelle muss am Parameter
MAIL_ADDR_PARAM die Struktur TMail_V4 verwendet werden.
Bei der Verwendung eines Kommunikationsprozessors (CP) oder Kommunikationsmoduls (CM)
können Sie alle drei Adressierungsmöglichkeiten (IPv4, IPv6 und FQDN) verwendet werden.
Tabelle 1
TMail_V4 : Adressieren des Mailservers über die IP-Adresse nach IPv4
Parameter
Datentyp
TMail_V4
Struct
Beschreibung
This document constitutes a free excerpt compiled by the user himself/herself from the documentation provided by Siemens for this product. Siemens disclaims
all liability for the completeness of this document. It shall only be used for the user's own internal purposes. It shall not be passed on to third parties. The complete
documentation can be found at:
/dokumentation/default.aspx?DocVersionId=74495465995&Language=de-DE&TopicId=69708003723
11.07.2016
STEP 7 Professional V13.1
Parameter MAIL_ADDR_PARAM
Parameter
Datentyp
Beschreibung
InterfaceId
LADDR
Hardware-Kennung der Schnittstelle
ID
CONN_OUC
Verbindungs-ID
ConnectionType
BYTE
Verbindungstyp. Wählen Sie für IPv4 als Verbindungstyp
16#20.
ActiveEstablished
BOOL
Zustandsbit. Wird auf "1" gesetzt, wenn die Verbindung
hergestellt ist.
CertIndex
BYTE
•
•
WatchDogTime
TIME
=0: Verwendung von SMTP (Simple Mail Transfer
Protocol). Beim Versenden der Mail über die
Schnittstelle einer S7-1500 CPU muss SMTP
verwendet werden.
≠0: Verwendung von SMTPS zur Absicherung der
Verbindung vor dem Verbindungsaufbau (bei CPs/
CMs). Über den Parameter CertIndex geben Sie das zu
verwendende Zertifikat an (siehe "Projektnavigation" >
"Globale Security-Einstellungen" >
"Zertifikatsmanager").
Zeitüberwachung der Ausführung. Definieren Sie über
diesen Parameter die maximale Ausführungsdauer des
Sendevorgangs.
Hinweis: Bei einer langsamen Verbindung kann der
Verbindungsaufbau längere Zeit (ca. eine Minute) dauern.
Die Zeit für den Verbindungsaufbau müssen Sie bei der
Vorgabe des Parameters WATCH_DOG_TIME
berücksichtigen.
Nach Ablauf der vorgegebenen Zeit wird die Verbindung
abgebaut.
MailServerAddress
IP_V4
IP Adresse des Mailservers. Nach IPv4 im Format
XXX.XXX.XXX.XXX (dezimal).
Beispiel: 192.142.131.237.
UserName
STRING[254]
Loginname des Mailservers
PassWord
STRING[254]
Passwort des Mailservers
From
EMAIL_ADDR
Absenderadresse der E-Mail, die über die folgenden beiden
STRING-Parameter definiert wird. Zum Beispiel:
"[email protected]".
LocalPartPlusAtSi STRING[64]
gn
Lokaler Teil der Absenderadresse inklusive @-Zeichen.
Beispiel: "myname@".
FullQualifiedDom
ainName
Fully Qualified Domain Name ( kurz: FQDN) des Mailservers.
Beispiel: "mymailserver.com".
Tabelle 2
STRING[254]
TMail_V6 : Adressieren des Mailservers über die IP-Adresse nach IPv6
Parameter
Datentyp
TMail_V6
Struct
Beschreibung
This document constitutes a free excerpt compiled by the user himself/herself from the documentation provided by Siemens for this product. Siemens disclaims
all liability for the completeness of this document. It shall only be used for the user's own internal purposes. It shall not be passed on to third parties. The complete
documentation can be found at:
/dokumentation/default.aspx?DocVersionId=74495465995&Language=de-DE&TopicId=69708003723
11.07.2016
STEP 7 Professional V13.1
Parameter MAIL_ADDR_PARAM
Parameter
Datentyp
Beschreibung
InterfaceId
LADDR
Hardware-Kennung der Schnittstelle
ID
CONN_OUC
Verbindungs-ID
ConnectionType
BYTE
Verbindungstyp. Wählen Sie für IPv6 als Verbindungstyp
16#21.
ActiveEstablished
BOOL
Zustandsbit. Wird auf "1" gesetzt, wenn die Verbindung
hergestellt ist.
CertIndex
BYTE
•
•
WatchDogTime
TIME
=0: Verwendung von SMTP (Simple Mail Transfer
Protocol). Beim Versenden der Mail über die
Schnittstelle einer S7-1500 CPU muss SMTP
verwendet werden.
≠0: Verwendung von SMTPS zur Absicherung der
Verbindung vor dem Verbindungsaufbau (bei CPs/
CMs). Über den Parameter CertIndex geben Sie das zu
verwendende Zertifikat an (siehe "Projektnavigation" >
"Globale Security-Einstellungen" >
"Zertifikatsmanager").
Zeitüberwachung der Ausführung. Definieren Sie über diesen
Parameter die maximale Ausführungsdauer des
Sendevorgangs.
Hinweis: Bei einer langsamen Verbindung kann der
Verbindungsaufbau längere Zeit (ca. eine Minute) dauern.
Die Zeit für den Verbindungsaufbau müssen Sie bei der
Vorgabe des Parameters WATCH_DOG_TIME
berücksichtigen.
Nach Ablauf der vorgegebenen Zeit wird die Verbindung
abgebaut.
MailServerAddress
IP_V6
IP Adresse des Mailservers nach IPv6 im Format
XXXX.XXXX.XXXX.XXXX.XXXX.XXXX.XXXX.XXXX
(hexadezimal).
Die Adresse ist in 8 Blöcke von jeweils 2 Byte unterteilt
(insgesamt 16 Byte).
Beispiel: 2001:db8:1f11:08d3:290:27ff:0370:2093
UserName
STRING[254]
Loginname des Mailservers
PassWord
STRING[254]
Passwort des Mailservers
From
EMAIL_ADDR
Absenderadresse der E-Mail, die über die folgenden beiden
STRING-Parameter definiert wird. Zum Beispiel:
"[email protected]".
LocalPartPlusAtSi STRING[64]
gn
Lokaler Teil der Absenderadresse inklusive @-Zeichen.
Beispiel: "myname@".
FullQualifiedDom
ainName
Fully Qualified Domain Name ( kurz: FQDN) des Mailservers.
Beispiel: "mymailserver.com".
STRING[254]
This document constitutes a free excerpt compiled by the user himself/herself from the documentation provided by Siemens for this product. Siemens disclaims
all liability for the completeness of this document. It shall only be used for the user's own internal purposes. It shall not be passed on to third parties. The complete
documentation can be found at:
/dokumentation/default.aspx?DocVersionId=74495465995&Language=de-DE&TopicId=69708003723
11.07.2016
STEP 7 Professional V13.1
Parameter MAIL_ADDR_PARAM
Tabelle 3
TMail_FQDN : Adressieren des Mailservers über den FQDN
Parameter
Datentyp
TMail_V6
Struct
Beschreibung
TMail_FQDN
LADDR
Hardware-Kennung der Schnittstelle
ID
CONN_OUC
Verbindungs-ID
ConnectionType
BYTE
Verbindungstyp. Wählen Sie für FQDN als Verbindungstyp
16#22.
ActiveEstablished
BOOL
Zustandsbit. Wird auf "1" gesetzt, wenn die Verbindung
hergestellt ist.
CertIndex
BYTE
•
•
WatchDogTime
TIME
=0: Verwendung von SMTP (Simple Mail Transfer
Protocol). Beim Versenden der Mail über die
Schnittstelle einer S7-1500 CPU muss SMTP
verwendet werden.
≠0: Verwendung von SMTPS zur Absicherung der
Verbindung vor dem Verbindungsaufbau (bei CPs/
CMs). Über den Parameter CertIndex geben Sie das zu
verwendende Zertifikat an (siehe "Projektnavigation" >
"Globale Security-Einstellungen" >
"Zertifikatsmanager").
Zeitüberwachung der Ausführung. Definieren Sie über diesen
Parameter die maximale Ausführungsdauer des
Sendevorgangs.
Hinweis: Bei einer langsamen Verbindung kann der
Verbindungsaufbau längere Zeit (ca. eine Minute) dauern.
Die Zeit für den Verbindungsaufbau müssen Sie bei der
Vorgabe des Parameters WATCH_DOG_TIME
berücksichtigen.
Nach Ablauf der vorgegebenen Zeit wird die Verbindung
abgebaut.
MailServerAddress
STRING[254]
FQDN (Fully Qualified Domain Name) des Mailservers. Die
Adressierung des Mailservers erfolgt über den vollständigen
Namen der Domain.
Beispiel: "www.mymailserver.com.".
UserName
STRING[254]
Loginname des Mailservers
PassWord
STRING[254]
Passwort des Mailservers
From
Struct
Absenderadresse der E-Mail, die über die folgenden beiden
STRING-Parameter definiert wird. Zum Beispiel:
"[email protected]".
LocalPartPlusAtSi STRING[64]
gn
Lokaler Teil der Absenderadresse inklusive @-Zeichen.
Beispiel: "myname@".
FullQualifiedDom
ainName
Fully Qualified Domain Name ( kurz: FQDN) des Mailservers.
Beispiel: "mymailserver.com".
STRING[254]
This document constitutes a free excerpt compiled by the user himself/herself from the documentation provided by Siemens for this product. Siemens disclaims
all liability for the completeness of this document. It shall only be used for the user's own internal purposes. It shall not be passed on to third parties. The complete
documentation can be found at:
/dokumentation/default.aspx?DocVersionId=74495465995&Language=de-DE&TopicId=69708003723
11.07.2016