Récapitulatif des verbes APPC

Cette section décrit brièvement chaque verbe APPC, regroupé par fonction.

Verbes pour démarrer des conversations

ALLOCATIONou MC_ALLOCATE
Émis par le programme de transaction local (TP). Ce verbe alloue une session entre l’unité logique locale (LU) et une lu partenaire, et établit une conversation entre le TP local et le TP partenaire.

ALLOCATE peut établir une conversation de base ou mappée. MC_ALLOCATE ne peut démarrer qu’une conversation mappée. Une fois la conversation allouée, APPC utilise ce verbe pour retourner un identificateur de conversation (conv_id).

RECEIVE_ALLOCATE
Émis par le TP partenaire. Ce verbe confirme que le TP partenaire est prêt à commencer une conversation avec le TP local qui a émis ALLOCATE ou MC_ALLOCATE. Une fois l’exécution réussie, ce verbe retourne un identificateur TP (tp_id) pour le tp partenaire et le conv_id.

TP_STARTED
Émis par le TP local. Ce verbe avertit APPC que le TP local démarre. Une fois l’exécution réussie, ce verbe retourne une tp_id pour le TP local.

Verbes pour l’envoi de données

CONFIRMERou MC_CONFIRM
Envoie le contenu de la mémoire tampon d’envoi de la lu locale et une demande de confirmation au TP partenaire.

FLUSHou MC_FLUSH
Vide la mémoire tampon d’envoi de la lu locale, en envoyant le contenu de la mémoire tampon aux lu et TP partenaires. Si la mémoire tampon d’envoi est vide, aucune action n’a lieu.

PREPARE_TO_RECEIVEou MC_PREPARE_TO_RECEIVE
Modifie l’état de la conversation d’ENVOYER à RECEIVE. Avant de modifier l’état de la conversation, ce verbe exécute l’équivalent de FLUSH, MC_FLUSH, CONFIRM ou MC_CONFIRM. Une fois ce verbe exécuté avec succès, le TP local peut recevoir des données.

REQUEST_TO_SENDou MC_REQUEST_TO_SEND
Informe le tp partenaire que le TP local souhaite envoyer des données. Le TP local doit attendre que le TP partenaire ait des problèmes PREPARE_TO_RECEIVE, MC_PREPARE_TO_RECEIVE, RECEIVE_AND_WAIT ou MC_RECEIVE_AND_WAIT, et que l’état de la conversation passe à RECEIVE pour le TP partenaire, avant que le TP local commence à envoyer des données.

SEND_DATAou MC_SEND_DATA
Place les données dans la mémoire tampon d’envoi de la lu locale pour les transmettre au TP partenaire.

Les données collectées dans la mémoire tampon d’envoi de la lu locale sont transmises à l’unité lu partenaire et au tp partenaire lorsque l’une des opérations suivantes se produit :

• La mémoire tampon d’envoi se remplit.

• Le TP local émet des problèmes FLUSH, MC_FLUSH, CONFIRM, MC_CONFIRM, DEALLOCATE, MC_DEALLOCATE ou un autre verbe qui vide la mémoire tampon d’envoi de la lu locale.

Verbes pour la réception de données

POST_ON_RECEIPT ou MC_POST_ON_RECEIPT
L’émission de ce verbe permet à l’application de s’inscrire pour recevoir une notification lorsque des données ou des status arrivent à l’unité lu locale sans les recevoir en même temps. Ce verbe ne peut être émis qu’à l’état RECEIVE et ne provoque jamais de changement d’état de conversation.

Lorsque le TP émet ce verbe, APPC retourne immédiatement le contrôle au TP. Lorsque les conditions spécifiées sont remplies, l’événement Win32® spécifié en tant que paramètre est signalé et le verbe se termine. Ensuite, le TP examine le code de retour dans le bloc de contrôle des verbes pour déterminer si des données ou status notification sont arrivées à l’unité lu locale et émet un RECEIVE_IMMEDIATE ou RECEIVE_AND_WAIT verbe pour recevoir réellement les données ou status notification.

RECEIVE_AND_POSTou MC_RECEIVE_AND_POST
L’émission de ce verbe lorsque la conversation est à l’état RECEIVE modifie l’état de la conversation en PENDING_POST et entraîne la réception asynchrone des données par le TP local. Cela permet au TP local de poursuivre le traitement pendant que les données arrivent toujours à l’unité lu locale.

L’émission de ce verbe lorsque la conversation est à l’état SEND vide la mémoire tampon d’envoi de l’unité logique et modifie l’état de la conversation en PENDING_POST. Le TP local commence alors à recevoir des données de manière asynchrone.

RECEIVE_AND_WAITou MC_RECEIVE_AND_WAIT
L’émission de ce verbe alors que la conversation est à l’état RECEIVE entraîne la réception par le TP local de toutes les données actuellement disponibles du TP partenaire. Si aucune donnée n’est disponible, le TP local attend que les données arrivent.

L’émission de ce verbe lorsque la conversation est à l’état SEND vide la mémoire tampon d’envoi de l’unité lu et remplace l’état de la conversation par RECEIVE. Le TP local commence alors à recevoir des données.

RECEIVE_IMMEDIATEou MC_RECEIVE_IMMEDIATE
Reçoit toutes les données actuellement disponibles à partir du tp partenaire. Si aucune donnée n’est disponible, le TP local n’attend pas.

TEST_RTSou MC_TEST_RTS
Détermine si une REQUEST_TO_SEND , une MC_REQUEST_TO_SEND ou une notification a été reçue.

Verbes pour confirmer des données ou signaler des erreurs

CONFIRMÉou MC_CONFIRMED
Répond à une demande de confirmation du TP partenaire. Il informe le tp partenaire que le TP local a reçu et traité les données sans erreur.

RECEIVE_LOG_DATAou MC_RECEIVE_LOG_DATA
L’émission de ce verbe permet à l’utilisateur de s’inscrire pour recevoir les données de journal associées à un rapport d’erreurs entrant de gestion des fonctions 7 (FMH7). Le verbe transmet une mémoire tampon à APPC, et toutes les données de journal reçues sont placées dans cette mémoire tampon. APPC continue d’utiliser cette mémoire tampon lorsque des FMH7 successifs arrivent jusqu’à ce qu’il soit fourni avec une autre mémoire tampon (autrement dit, jusqu’à ce que le TP émet un autre RECEIVE_LOG_DATA ou MC_RECEIVE_LOG_DATA spécifiant une mémoire tampon différente ou aucune mémoire tampon du tout).

SEND_CONVERSATIONou MC_SEND_CONVERSATION
Émis par le TP appelant, ce verbe alloue une session entre la lu locale et l’unité lu partenaire, envoie des données sur la session, puis libère la session.

SEND_ERRORou MC_SEND_ERROR
Avertit le TP partenaire que le TP local a rencontré une erreur au niveau de l’application.

Verbes pour obtenir et définir des informations

GET_ATTRIBUTESou MC_GET_ATTRIBUTES
Utilisé par un TP pour obtenir les attributs de la conversation.

GET_LU_STATUS
Permet de signaler le status d’une lu distante particulière.

GET_STATE
Utilisé par un TP pour interroger l’état d’une conversation particulière.

GET_TP_PROPERTIES
Retourne les attributs du TP et de la transaction actuelle.

GET_TYPE
Utilisé par un TP pour déterminer le type de conversation (de base ou mappé) d’une conversation particulière. Avec ces informations, le TP peut décider s’il faut émettre des verbes de conversation de base ou mappés.

SET_TP_PROPERTIES
Utilisé pour définir les attributs du TP et de la transaction actuelle.

Verbes qui fournissent des fonctions de gestion

ACTIVATE_SESSION
Active une session entre l’unité lu locale et une lu partenaire spécifiée, à l’aide d’un mode spécifié.

CNOS(Modifier le nombre de sessions)
Établit les limites de session APPC LU 6.2.

DEACTIVATE_SESSION
Désactive une session particulière ou toutes les sessions sur un mode particulier.

DISPLAY
Retourne les informations de configuration et les valeurs de fonctionnement actuelles pour le nœud SNA.

Verbes pour la fin des conversations

DÉSALLOUERou MC_DEALLOCATE
Libère une conversation entre deux fournisseurs de services. Avant de déallouer la conversation, ce verbe effectue l’équivalent de FLUSH, MC_FLUSH, CONFIRM ou MC_CONFIRM.

TP_ENDED
Émis par les fournisseurs de services locaux et partenaires. Il avertit APPC que le TP se termine. L’émission de ce verbe met également fin aux conversations actives.