FP_SMTP_SET_MODE_TRANSFER_LOG

SMTP-Datenübertragungsmodus für Datenaufzeichnungsdateien einstellen

Dieser FP-Befehl definiert die SMTP-Client-Datenübertragungseinstellungen für E-Mails, wenn die Datenaufzeichnungsdatei abgeschlossen ist.

Parameter

Eingang

nLogID (WORD, INT, UINT)

LOG-Nummer (zulässiger Bereich: 0–15). Der Compiler erzeugt intern die Zeichenfolge für die Nummer der Protokolldatei, z.B. 'LOG=0'

sGroupNumber_Subject (STRING)

Einstellen der Zielgruppennummer und des Betreffs der E-Mail.

  • Einstellen von bis zu acht Zielgruppennummern mit der Schlüsselwortsyntax 'GRPNO=n1+n2+…+n8'.

    Werte: 0–7

  • Einstellen des Betreffs mit einer der zwei folgenden Schlüsselworteinstellungen (max. 64 Zeichen, ein Byte):

    • 'SUBJECT=xxxxxx': Einstellen eines benutzerdefinierten Betrefftextes.

    • 'SUBJECTAUTO': Automatisch erzeugter Betreff mit Informationen über den Sendetriggertyp.

      Automatisch erzeugte Betreffe:

      Japanisch

      Englisch

      ロギング/トレース (LOG0)

      Logging/Trace (LOG0)

      ロギング/トレース (LOG1)

      Logging/Trace (LOG1)

      ...

      ...

      ロギング/トレース (LOG14)

      Logging/Trace (LOG14)

      ロギング/トレース (LOG15)

      Logging/Trace (LOG15)

    Hinweis:

    • Die Sprache, die für automatisch erzeugte Informationen verwendet wird, wird mit dem Befehl FP_SMTP_SET_CONNECTION angegeben. Verwenden Sie den Parameter sCommunication, um die Sprache von Japanisch (Standardeinstellung) auf Englisch umzuschalten.

    • Die Schlüsselwörter 'GRPNO' und 'SUBJECT' müssen durch Kommas getrennt und in dieser Reihenfolge eingegeben werden.

Beispiele:

  1. Zielgruppennummer 0, benutzerdefinierter Betreff "LogFileTransmission": 'GRPNO=0,SUBJECT=LogFileTransmission'

  2. Zielgruppennummern 1, 3, 4, 7, benutzerdefinierter Betreff "LogFilesGroups": 'GRPNO=1+3+4+7,SUBJECT=LogFilesGroups'

  3. Zielgruppennummern 0 bis 7, automatisch erzeugter Betreff: 'GRPNO=0+1+2+3+4+5+6+7,SUBJECTAUTO'

sBodyText (STRING)

Nachricht (max. 256 Zeichen, ein Byte)

Geben Sie die Variable an, die E-Mail-Text oder eine Zeichenkonstante speichert.

sAttachment (STRING)

Geben Sie an, ob zusätzliche Informationen oder ein Dateianhang gesendet werden sollen oder nicht.

Schließen Sie zusätzliche Informationen in den E-Mail-Text mit einer der folgenden Schlüsselworteinstellungen ein:

  • 'INFO=NONE': Keine Informationen automatisch hinzufügen

  • 'INFO=AUTO': Automatisch erzeugten Text hinzufügen

Die folgenden Informationen werden dem E-Mail-Text hinzugefügt:

Japanisch

Englisch

基本項目

  • 送信元

  • CPU 型番(例:CPS41E)

  • IPv4 アドレス

  • IPv6 アドレス

  • ロギングトレース(ID 番号)

  • ファイル確定時刻

Basic information

  • From

  • CPU Part number (z.B. CPS41E)

  • IPv4-Adresse

  • IPv6-Adresse

  • Logging Trace ID

  • File fixed Time

Hinweis:

  • Die Sprache, die für automatisch erzeugte Informationen verwendet wird, wird mit dem Befehl FP_SMTP_SET_CONNECTION angegeben. Verwenden Sie den Parameter sCommunication, um die Sprache von Japanisch (Standardeinstellung) auf Englisch umzuschalten.

  • Um die Zeichenfolge sAttachment zu erzeugen, können Sie auch FP_SMTP_GET_DATA_FORMAT verwenden.

Hängen Sie die Datenaufzeichnungsdatei (LOG-Datei) mit der folgenden Schlüsselworteinstellung an:

  • 'ATT=NONE': LOG-Datei nicht an die E-Mail anhängen.

  • 'ATT=FILE': LOG-Datei mit der durch nLogID angegebenen Nummer anhängen.

Beispiele:

  1. Keine Informationen hinzufügen und LOG-Datei nicht anhängen: 'INFO=NONE,ATT=NONE'

  2. Automatisch erzeugte Informationen hinzufügen und LOG-Datei anhängen: 'INFO=ADD,ATT=FILE'

Ausgang

bError (BOOL)

Wird unter den folgenden Bedingungen auf TRUE gesetzt:

  • wenn eine Zeitüberschreitung der Verbindung überschritten wird,

  • wenn eine IP-Adresse ungültig ist

Wenn ein Fehler auftritt, prüfen Sie die Systemvariable sys_iEthernetConnectionErrorCode auf die Fehlercodenummer.

Anmerkungen

  • Die Parameter für die automatische Texterstellung und den Dateianhang können nicht weggelassen werden.

  • Trennen Sie alle Schlüsselwörter durch Komma, z.B. 'NAME=abcd,FROM=sender@server.com'

  • Reihenfolge der Schlüsselwörter nicht verändern. Geben Sie die Schlüsselwörter und ihre Einstellparameter in der Reihenfolge an, in der sie hier aufgeführt sind.

  • Die Zeichenanzahl für Zeichenfolgen darf 256 nicht überschreiten.

  • Dieser Befehl ist in Interrupt-Programmen nicht verfügbar.

  • Bevor Sie den Befehl ausführen, müssen Sie die E-Mail-Übertragungsserver mit FP_SMTP_SET_CONNECTION oder dem Einstellungsdialog des SMTP-Clients angeben.

  • Bevor Sie den Befehl ausführen, müssen Sie die E-Mail-Einstellungen mit FP_SMTP_SET_GROUP oder dem Einstellungsdialog des SMTP-Clients angeben.

  • Für die Angabe von Schlüsselwörtern können Groß- und Kleinzeichen verwendet werden. Beim Betreff, dem E-Mail-Text und dem Dateinamen des Anhangs wird jedoch zwischen Groß- und Kleinschreibung unterschieden.

  • Bevor Sie den Befehl ausführen, stellen Sie sicher, dass sys_bIsEthernetInitializing FALSE ist. sys_bIsEthernetInitializing wird auf TRUE gesetzt, wenn der Befehl ausgeführt wird. Wenn Sie den Befehl ausführen, während sys_bIsEthernetInitializing TRUE ist, tritt ein Fehler auf.

  • Wenn dieser Befehl erfolgreich ausgeführt wurde, werden die Systemvariablen sys_bIsCarry und sys_iEthernetConnectionErrorCode zurückgesetzt.

  • Der Befehl kann nur ausgeführt werden, wenn der Merker Datenübertragungsauftrag für die angegebene nLogID Nummer FALSE ist. Wenn der Merker Datenübertragungsauftrag TRUE ist, tritt ein Operationsfehler auf.

  • Der Befehl speichert die E-Mail-Einstellungen für die Datenaufzeichnung von sGroupNumber_Subject, sBodyText und sAttachment in der durch nLogID angegebenen LOG-Dateinummer.

  • Wenn ein Fehler auftritt, prüfen Sie die Systemvariable sys_iEthernetConnectionErrorCode auf die Fehlercodenummer.

Fehleralarmmerker

sys_bIsOperationErrorHold (wird auf TRUE gesetzt und bleibt TRUE)
  • wenn der Merker Datenübertragungsauftrag für eine angegebene nLogID Nummer TRUE ist, z.B. wenn sys_blsLog0DataRecordingActive TRUE ist.

  • wenn die Datenaufzeichnungsbedingung einer bestimmten nLogID Nummer nicht registriert ist.

  • wenn ein für einen Parameter angegebener Wert außerhalb des zulässigen Bereichs liegt.

  • wenn der Befehl in einem Interrupt-Programm ausgeführt wird

  • wenn die Zeichenanzahl für Zeichenfolgendaten 256 überschreitet.

  • wenn eine Zielgruppennummer angegeben ist, die nicht mit dem Befehl FP_SMTP_SET_GROUP oder dem Einstellungsdialog des SMTP-Clients definiert wurde.

  • wenn kein E-Mail-Übertragungsserver angegeben ist.

  • wenn ein E-Mail-Datenübertragungsserver angegeben ist, der nicht mit dem Befehl FP_SMTP_SET_CONNECTION oder dem Einstellungsdialog des SMTP-Clients konfiguriert wurde.

sys_bIsOperationErrorNonHold (wird für einen Zyklus auf TRUE gesetzt)
  • wenn der Merker Datenübertragungsauftrag für eine angegebene nLogID Nummer TRUE ist, z.B. wenn sys_blsLog0DataRecordingActive TRUE ist.

  • wenn die Datenaufzeichnungsbedingung einer bestimmten nLogID Nummer nicht registriert ist.

  • wenn ein für einen Parameter angegebener Wert außerhalb des zulässigen Bereichs liegt.

  • wenn der Befehl in einem Interrupt-Programm ausgeführt wird

  • wenn die Zeichenanzahl für Zeichenfolgendaten 256 überschreitet.

  • wenn eine Zielgruppennummer angegeben ist, die nicht mit dem Befehl FP_SMTP_SET_GROUP oder dem Einstellungsdialog des SMTP-Clients definiert wurde.

  • wenn kein E-Mail-Übertragungsserver angegeben ist.

  • wenn ein E-Mail-Datenübertragungsserver angegeben ist, der nicht mit dem Befehl FP_SMTP_SET_CONNECTION oder dem Einstellungsdialog des SMTP-Clients konfiguriert wurde.

sys_bIsCarry (wird für einen Zyklus auf TRUE gesetzt)
  • wenn der Befehl während der Initialisierung des Ethernets ausgeführt wird, wird sys_iEthernetConnectionErrorCode auf "11: Ethernet wird initialisiert“ gesetzt.

Beispiel

POE-Kopf

Im POE-Kopf werden alle Ein- und Ausgangsvariablen deklariert, die für die Programmierung dieser Funktion verwendet werden. Für alle Programmiersprachen wird der gleiche POE-Kopf verwendet.

	VAR
		bIsError: BOOL:=FALSE;
		bSetLogTransferSMTP: BOOL:=FALSE;
		bDisableLogTransferSMTP: BOOL:=FALSE;
	END_VAR

POE-Rumpf

Wenn bSetLogTransferSMTP und bDisableLogTransferSMTP auf TRUE gesetzt sind, wird der Befehl ausgeführt.

KOP-Rumpf

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 7 ;
        NETWORK_BODY
B(B_VARIN,,0,19,2,21,4,);
B(B_VARIN,,'GRPNO=0~SUBJECTAUTO',19,3,21,5,);
B(B_VARIN,,'Sent Log Files',19,4,21,6,);
B(B_VARIN,,'INFO=NON~ATT=NONE',19,5,21,7,);
B(B_VAROUT,,bIsError,39,2,41,4,);
B(B_CONTACT,,bSetLogTransferSMTP,5,1,7,3,);
B(B_F,FP_SMTP_SET_MODE_TRANSFER_LOG!,,21,0,39,7,,?DEN?DnLogID?DsGroupNumber_Subject?DsBodyText?DsAttachment?AENO?AbError);
L(1,2,5,2);
L(7,2,21,2);
L(1,0,1,7);
        END_NETWORK_BODY
    END_NET_WORK
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 5 ;
        NETWORK_BODY
B(B_CONTACT,,bDisableLogTransferSMTP,5,1,7,3,);
B(B_F,FP_SMTP_TRANSFER_CONTROL_LOG!,,21,0,39,5,,?DEN?DnLogID?DsControl?AENO?AbError);
B(B_VARIN,,0,19,2,21,4,);
B(B_VARIN,,'DISABLE',19,3,21,5,);
B(B_VAROUT,,bIsError,39,2,41,4,);
L(1,2,5,2);
L(7,2,21,2);
L(1,0,1,5);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST-Rumpf

If (bSetLogTransferSMTP) Then
    FP_SMTP_SET_MODE_TRANSFER_LOG(nLogID := 0,
                                  sGroupNumber_Subject := 'GRPNO=0,SUBJECTAUTO',
                                  sBodyText := 'Sent Log Files', 
								  sAttachment := 'INFO=NON,ATT=NONE', bError => bIsError);
End_if;
If (bDisableLogTransferSMTP) Then
    FP_SMTP_TRANSFER_CONTROL_LOG(nLogID := 0,
                                 sControl := 'DISABLE', bError => bIsError);
End_if;

Letzte Änderung: 2024-07-16Feedback zu dieser SeitePanasonic Hotline