IcomLUO.Online, méthode
Rétablit la session LU0 dans un état en ligne après un appel à Hors connexion.
Syntaxe
void Online(
short initType,
ref System.Array data,
int timeout)
Paramètres
| Paramètre | Description |
|---|---|
initType |
Décrit le type d’initiation de session. Pour plus d'informations, consultez la section Notes. |
data |
Contient le message d’ouverture de session INITSELF ou SSCP, si nécessaire. |
timeout |
Période d’attente, en millisecondes, de l’arrivée de BIND et de SDT. Si le délai d’expiration expire avant l’arrivée du SDT, la lu du serveur SNA est libérée et une erreur est retournée. 0xffffffff indique un délai d’attente infini. |
Valeur de retour
| Valeur | Description |
|---|---|
| S_OK | La session LU0 a été correctement réactivée et la session LU est active et prête à recevoir des entrées. |
| CLU0_S_SSCP_ACTIVE | La session LU0 a été correctement réactivée et la session SSCP est active et prête à recevoir des entrées. Valide uniquement lorsque initType est défini sur INIT_SSCP. |
| CLU0_E_NEG_RESPONSE | L’hôte ou le serveur SNA a envoyé une réponse négative à la commande INITSELF ou d’ouverture de session non mise en forme. Valide uniquement si initType est défini sur INIT_INITSELF ou INIT_LOGON |
| CLU0_E_BADPARAM | connectionStr contenait un paramètre de propriété non valide. |
| CLU0_E_NOFREELU | luname spécifié un pool d’unités logiques de serveur SNA, et aucune unité logique n’est libre dans ce pool. |
| CLU0_E_LUINUSE | luname a spécifié une lu de serveur SNA, et l’unité logique est actuellement utilisée par une autre application. |
| CLU0_E_LUNOTFOUND | Le nom de l’unité logique ou du pool n’existe pas. |
| CLU0_E_TIMEDOUT | La session n’a pas été démarrée dans le délai spécifié. |
| 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 de serveur. Si vous le souhaitez, vous pouvez émettre un appel à Icom3270.Offline pour réinitialiser le serveur, puis réactiver la session à l’aide d’un appel à Icom3270.Online. |
| CLU0_E_SERVER_FAILURE | La session TSS n’est plus valide. Vous devez libérer le handle de session. |
| CLU_E_WAITING | Un autre thread a émis un appel de réception pour cette méthode, qui n’a pas encore été retourné. |
| CLU_E_SYSERROR | Cette méthode a échoué en raison d’une erreur interne. |
Exceptions
Remarques
Online tente d’acquérir la même unité logique du serveur SNA, et donc le même serveur SNA, que celle utilisée lors de la dernière session en ligne.
Le tableau suivant décrit les valeurs possibles pour initType.
| Nom | Valeur | Description |
|---|---|---|
| INIT_BIND | 0 | Attendez les liaisons BIND et SDT non sollicitées à partir du PLU. |
| INIT_SSCP | 1 | Attendez qu’un BIND et un SDT arrivent, mais autorisez l’accès à la session SSCP pour que l’application envoie des données et des commandes SSCP. |
| INIT_INITSELF | 2 | Attendez qu’un BIND et un SDT arrivent après l’envoi de la commande INITSELF spécifiée dans data. |
| INIT_LOGON | 3 | Attendez qu’un BIND et un SDT arrivent après l’envoi du message d’ouverture de session SSCP non mis en forme spécifié dans data. |