FP_SMTP_TRANSFER_CONTROL_LOG

Control de la transferencia SMTP de los archivos de histórico de datos

Esta instrucción FP controla la transferencia SMTP de un archivo de histórico de datos especificado por nLogID. Las palabras de control válidas son 'ENABLE', 'DISABLE' y 'CANCEL'.

Parámetros

Entrada

nLogID (WORD, INT, UINT)

Número de LOG (rango permitido: 0–15). El compilador genera internamente la cadena para el número de archivo de registro, p. ej., 'LOG=0'

sControl (STRING)

Control trama de caracteres:

'ENABLE': habilita la transferencia de archivos
'DISABLE': deshabilita la transferencia de archivos
'CANCEL': cancela la transferencia de archivos

Salida

bError (BOOL)

Pasa a TRUE bajo las siguientes condiciones:

si se supera el tiempo de espera de la conexión
si la dirección IP no es válida

Cuando se produce un error, consulte la variable del sistema sys_iEthernetConnectionErrorCode para conocer el número de código de error.

Observaciones

El número de caracteres de los datos de cadena no debe superar los 256.
Antes de ejecutar la instrucción, se deben especificar los ajustes de transferencia de correo electrónico de los archivos de histórico de datos utilizando FP_SMTP_SET_MODE_TRANSFER_LOG o el diálogo de configuración del cliente SMTP.
Antes de ejecutar la instrucción, asegurarse de que sys_bIsEthernetInitializing es FALSE. sys_bIsEthernetInitializing pasa a TRUE cuando se ejecuta la instrucción. Cuando ejecuta la instrucción mientras sys_bIsEthernetInitializing es TRUE, se produce un error.
Se pueden utilizar caracteres en mayúsculas y minúsculas para los operandos en los que se puede especificar una constante de caracteres. "Abcd", "ABCD" y "abcd" son sinónimos, pero los nombres de archivo distinguen entre mayúsculas y minúsculas.
Cuando esta instrucción se ha ejecutado con éxito, las variables del sistema sys_bIsCarry y sys_iEthernetConnectionErrorCode se reinician.
El procesamiento de la solicitud de cancelación de la transferencia tarda algún tiempo. Comprobar el estado de transferencia con FP_SMTP_GET_STATUS y verificar si la transferencia se detiene después de ejecutar la instrucción.
Cuando se produce un error, consulte la variable del sistema sys_iEthernetConnectionErrorCode para conocer el número de código de error.

Banderas de error

sys_bIsOperationErrorHold (pasa a TRUE y permanece TRUE)

Si se especifica cualquier cadena de control que no sea 'ENABLE', 'DISABLE' o 'CANCEL' para sControl.
Si el número de caracteres de los datos de cadena supera los 256.
Si se especifica un ajuste de transmisión de correo electrónico para los archivos de histórico de datos que no ha sido configurado con la instrucción FP_SMTP_SET_MODE_TRANSFER_LOG o con el diálogo de configuración del cliente SMTP.

sys_bIsOperationErrorNonHold (pasa a TRUE para un ciclo de scan)

Si se especifica cualquier cadena de control que no sea 'ENABLE', 'DISABLE' o 'CANCEL' para sControl.
Si el número de caracteres de los datos de cadena supera los 256.
Si se especifica un ajuste de transmisión de correo electrónico que no ha sido configurado con la instrucción FP_SMTP_SET_MODE o con el diálogo de configuración del cliente SMTP.
Si se especifica un ajuste de transmisión de correo electrónico para los archivos de histórico de datos que no ha sido configurado con la instrucción FP_SMTP_SET_MODE_TRANSFER_LOG o con el diálogo de configuración del cliente SMTP.

sys_bIsCarry (pasa a TRUE para un ciclo de scan)

si la instrucción se ejecuta durante la inicialización de Ethernet, sys_iEthernetConnectionErrorCode pasa a "11: Ethernet se está inicializando".

Temas relacionados

FP_SMTP_SET_MODE_TRANSFER_LOG

FP_SMTP_GET_STATUS

sys_iEthernetConnectionErrorCode

Cliente SMTP

Instrucciones del sistema

Panel Instrucciones

Áreas de memoria

Tipos de datos

Ejemplo

Cabecera de la POU

Todas las variables de entrada y de salida utilizadas para la programación de esta función han sido declaradas en la Cabecera de la POU. Se utiliza la misma cabecera de la POU para todos los lenguajes de programación.

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

Cuerpo de la POU

Si bSetLogTransferSMTP y bDisableLogTransferSMTP están a TRUE, se ejecuta la instrucción.

Cuerpo LD

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

Cuerpo en ST

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;