DFB TCP_SEND
(Traduction du document original anglais)
Présentation
Le DFB TCP_SEND permet d'envoyer un message de données à une application cliente distante via une connexion TCP/IP. La taille maximale du message est de 8 ko.
Paramètres d'entrée
Paramètre
Type
Description
RST
Bit
La configuration de ce bit à 1 :
  • interrompt l'échange en cours (si le bit ACTIVITY est réglé sur 1).
  • ferme la connexion.
  • règle le bit d'information ACTIVITY sur 0 et le bit de sortie ERROR sur 1.
Le code d'erreur est stocké dans le mot STATUS.
BUF
Table de mots
Cette variable définit l'adresse du premier mot %MWi du tampon pour envoyer le message.
Paramètres d'entrée/sortie
Paramètre
Type
Description
MANAGNT
Table de mots
Table de gestion commune à tous les DFB
Paramètres de sortie
Paramètre
Type
Description
ERROR
Bit
Ce bit de sortie est réglé sur 1 lorsque l’échange ne s'effectue pas correctement.
Le mot STATUS indique le type de l'erreur survenue.
Données publiques internes
Paramètre
Type
Variables en écriture/lecture
Description
DEST
Mot double
E
Cette variable définit l'adresse IP de la machine distante sur laquelle le client est connecté au port local.
Par défaut, DEST = 0. Le message est envoyé à la seule station cliente distante connectée au port de service local de l'automate.
PORT
Mot
E
Cette variable définit le numéro de port local auquel le client distant est connecté.
SIZE
Mot
E
Cette variable définit la taille du message à envoyer (de 0 à 8 192 octets).
ACTIVITY
Bit
L
Ce bit est réglé sur 1 lorsqu'un échange est en cours. Il revient à 0 lorsque l'échange est terminé.
INHIB
Bit
L
Ce bit permet d'inhiber l'avertissement d'erreur. Le bit de sortie ERROR et le mot STATUS restent à 0 (l'exécution du bloc n'est pas interrompue).
STATUS
Mot
L
Ce mot n'est significatif que si le bit de sortie ERROR est réglé sur 1. Il indique le code de l'erreur survenue pendant l'échange (chaque bit de mot réglé sur 1 signale une erreur).
Fonctionnement
Le transfert de données est lancé lorsque le DFB TCP_SEND est appelé, si les bits RST et ACTIVITY sont réglés sur 0. Pendant l'échange, le bit ACTIVITY est réglé sur 1. A la fin de la transmission, le bit ACTIVITY est réglé sur 0. De plus, si l'échange n'est pas correct, le bit de sortie ERROR est réglé sur 1.
A tout moment, le réglage du bit RST (entrée prioritaire) sur 1 permet d'interrompre l'échange en cours. Le bit ACTIVITY (échange terminé) est réglé sur 0 et le bit ERROR, sur 1. Le mot d'état <TCP_SEND nom instance>.STATUS indique le type de l'erreur. Si la connexion est établie, elle est fermée et le module attend la connexion entrante. Le DFB TCP_CNX rétablit la connexion au port de service TCP pour relancer l'envoi des messages.
Lorsqu'un message est envoyé, les opérations suivantes sont exécutées :