IcomLUO.Receive, méthode
Reçoit des données sortantes sur une session LU0.
Syntaxe
void Receive(
int timeout,
ref int datasize,
out int indication,
out short seqno,
ref System.Array data
)
Paramètres
| Valeur | Description |
|---|---|
timeout |
Période pendant laquelle le thread peut attendre l’arrivée des données, en millisecondes. En définissant dataSize, vous pouvez indiquer si l’application est prête à accepter des données partielles après un délai d’expiration.La saisie de 0xffffffff dans howLong indique une durée infinie. |
datasize |
Quantité maximale de données que l’application est prête à accepter. Si dataSize des octets de données sont reçus avant la concurrence du délai d’expiration, Receive retourne la chaîne partielle.Lorsque cette méthode est retournée, contient le nombre d’octets présents dans la mémoire tampon de données. |
indication |
Un ou plusieurs indicateurs dans un bit OR contenant des informations supplémentaires sur le flux de données sortant. Pour plus d'informations, consultez la section Notes. |
seqno |
Lorsque cette méthode est retournée, contient le numéro de séquence SNA de la chaîne. Si NEG_RESPONSE est défini dans indication, seqno peut plutôt contenir le numéro de séquence de la chaîne à laquelle l’hôte a envoyé une réponse.La valeur retournée dans seqno peut être utilisée dans IcomLU0.SendResponse pour transmettre une réponse SNA. |
data |
Tableau contenant les données à recevoir. |
Valeur de retour
| Valeur | Description |
|---|---|
| S_OK | Une chaîne de données complète, ou le reste d’une chaîne partielle, a été reçu dans la mémoire tampon de données. |
| CLU0_S_PARTIAL_CHAIN | Une chaîne partielle de données a été reçue dans la mémoire tampon de données. |
| CLU0_S_TIMEOUT | Aucune donnée n’a été reçue dans le délai d’expiration spécifié. Vous devez émettre une autre réception. |
| CLU0_E_SESSIONFAILURE | Échec de la session LU0. |
| CLU0_E_SERVER_FAILURE | La session TSS n’est plus valide. L’application doit libérer le handle de session. |
| CLU0_E_WAITING | Un autre thread a émis un appel de réception pour cette méthode et n’a pas encore retourné. |
| CLU0_E_SESSION_FAILED | La session SNA sous-jacente a échoué, peut-être en raison d’une panne de liaison ou d’une autre défaillance temporaire. Vous devez vous déconnecter et libérer la session serveur. Vous pouvez également appeler IcomLU0.Offline pour réinitialiser la session, puis appeler IcomLU0.Online pour réactiver la session. |
| CLU0_E_NOTCONNECTED | Le client comLU0 n’est pas connecté à une session via un appel à Icom3270.Connect. |
| CLU0_E_BADPARAM | L’un des paramètres contenait une valeur non valide. |
| CLU0_E_SYSERROR | La méthode a échoué en raison d’une erreur interne. |
Exceptions
Remarques
Normalement, Receive se bloque jusqu’à ce qu’une chaîne complète de données SNA soit disponible. Toutefois, l’application peut contrôler le bloc via howLong, maxDataet incompleteData.
La réception retourne uniquement les données au niveau de l’application. Plus précisément, Receive ne retourne pas les en-têtes SNA TH et RH.
Le tableau suivant décrit les valeurs possibles pour indication.
| Valeur | Description |
|---|---|
| SESSION_STARTED | Celui-ci peut avoir l'une des valeurs suivantes : - La session lancée par SSCP a été activée. - Une session qui a été réinitialisée par un clear a été redémarrée par un SDT. - Une session qui a précédemment reçu un UNBIUND a été réactivée par un BIND et un SDT. |
| BEGIN_BRACKET | L’hôte a démarré un nouveau crochet. |
| END_BRACKET | L’hôte a terminé le crochet actuel. |
| SEND | L’hôte a donné l’autorisation d’envoyer. |
| DATA_COMPLETE | Les données représentent une chaîne de données complète ou la fin d’une chaîne de données. |
| DATA_INCOMPLETE | Les données représentent une chaîne de données incomplète. |
| ANNULER | La dernière chaîne de l’hôte a été annulée. |
| NO_RESPONSE | L’application ne doit pas envoyer de réponse aux données. |
| EXCEPTION_RESPONSE1/2 | L’application peut envoyer une réponse négative pour rejeter les données, ou un accusé de réception de courtoisie. |
| DEFINITE_RESPONSE1/2 | L’application doit envoyer une réponse aux données. |
| POS_RESPONSE | L’hôte a envoyé une réponse positive. |
| NEG_RESPONSE | L’hôte a envoyé une réponse négative. |
| EXR_REQUEST | Le serveur SNA a converti la demande de l’hôte en demande d’exception. |
| CHASE | L’hôte demande que toutes les réponses en suspens soient envoyées. |
| NORMAL_DATA | Les données ont été reçues sur le flux de données normal. |
| EXPEDITED_DATA | Les données ont été reçues sur le flux de données accéléré. |
| APPL_DATA | Les données sont des données d’application (FMD). |
| FM_DATA | Les données sont des données FMH (Function Management). |
| LU_DATA | Les données ont été reçues sur la session lu. |
| SSCP_DATA | Les données ont été reçues lors de la session SSCP. |
| CLEAR | L’hôte a effacé la session. |
| QUIESCE | L’hôte a suspendu la session. |
| SHUTDOWN | L’hôte arrête la session. |
| RELEASE | L’hôte a annulé l’état d’arrêt ou d’arrêt. |
| UNBIND | L’hôte supprime la session LU-LU. |