FCT_CLOSE : supprime le socket spécifié
(Traduction du document original anglais)
Description de la fonction
La fonction FCT_CLOSE permet de supprimer le socket spécifié.
NOTE : Si le numéro de socket n'est pas indiqué ou s'il est égal à 0, tous les sockets ouverts sont supprimés.
Comme les sockets ont été ouverts lors de l'utilisation de la fonction FCT_SOCKET, via l'option SO_LINGER, la fonction FCT_CLOSE n'est pas bloquée, même si les files d'attente n'ont pas encore été envoyées ou n'ont pas fait l'objet d'un accusé de réception. On parle dans ce cas d'abandon car le circuit virtuel du socket est immédiatement réinitialisé et toutes les données non envoyées sont perdues.
Tout appel de la fonction FCT_RECEIVE de l'autre côté du circuit échouera et générera le message d'erreur : connexion réinitialisée (16#36).
Les paramètres supplémentaires EN et ENO peuvent être configurés.
Représentation en FBD
Représentation en LD
Représentation en IL
LD Module_Number
FCT_CLOSE Socket_Number, Gest_Index, Management_Param
Représentation en ST
FCT_CLOSE(Module_Number, Socket_Number, Gest_Index, Management_Param);
Description des paramètres
Le tableau suivant décrit les paramètres d'entrée :
Paramètre
Type
Commentaire
Module_Number
Numéro d'emplacement du module réseau dans le rack 0.
  • L'octet de poids faible est le numéro d'emplacement du module réseau dans le rack 0.
  • L'octet de poids fort peut être utilisé pour augmenter le nombre de sockets.
    • 00 : garantit une compatibilité descendante totale avec les applications créées avec une version 3.3 ou antérieure du micrologiciel.
    • 01 : il est possible d'utiliser jusqu'à 64 sockets (la version du micrologiciel doit être supérieure à 3.3).
Socket_Number
Numéro de port à supprimer. Si Socket_Number a pour valeur 0, tous les sockets sont supprimés.
Gest_Index
Index du premier mot dans la matrice Management_Param
Le tableau suivant décrit les paramètres d'E/S :
Paramètre
Type
Commentaire
Management_Param
ARRAY [0... 3] OF INT
Le rapport d'opération peut afficher les valeurs suivantes :
  • 16#00 : pas d'erreur
  • 16#16 : numéro de socket non valide