GET_STATE

Le verbe GET_STATE retourne l’état d’une conversation particulière.

La structure suivante décrit le bloc de contrôle de verbe (VCB) utilisé par le verbe GET_STATE .

Syntaxe

  
struct get_state {  
    unsigned short   opcode;  
    unsigned char    opext;  
    unsigned char    reserv2;  
    unsigned short   primary_rc;  
    unsigned long    secondary_rc;  
    unsigned char    tp_id[8];  
    unsigned long    conv_id;  
    unsigned char    conv_state;  
};   

Membres

Opcode
Paramètre fourni. Spécifie le code de l’opération de verbe, AP_GET_STATE.

opext
Ce champ n’est pas utilisé par le verbe GET_STATE .

réserver2
Champ réservé.

primary_rc
Paramètre retourné. Spécifie le code de retour principal défini par APPC à l’achèvement du verbe. Les codes de retour valides varient en fonction du verbe APPC émis. Consultez les codes de retour pour obtenir des codes d’erreur valides pour ce verbe.

secondary_rc
Paramètre retourné. Spécifie le code de retour secondaire défini par APPC à l’achèvement du verbe. Les codes de retour valides varient en fonction du verbe APPC émis. Consultez les codes de retour pour obtenir des codes d’erreur valides pour ce verbe.

tp_id
Paramètre fourni. Identifie le programme de transaction local (TP). La valeur de ce paramètre a été retournée par TP_STARTED dans l’appel du TP ou par RECEIVE_ALLOCATE dans le TP appelé.

conv_id
Paramètre fourni. Fournit l’identificateur de la conversation sur laquelle ce TP se demande. La valeur de ce paramètre a été retournée par MC_ALLOCATE ou ALLOCATE dans l’appel du TP ou par RECEIVE_ALLOCATE dans le TP appelé.

conv_state
Paramètre retourné. Indique l’état de la conversation. Le paramètre conv_state peut être l’une des valeurs suivantes :

AP_RESET_STATE

La conversation est à l’état RESET.

AP_SEND_STATE

La conversation est dans l’état SEND.

AP_RECEIVE_STATE

La conversation est dans l’état RECEIVE.

AP_CONFIRM_STATE

La conversation est dans l’état CONFIRM.

AP_CONFIRM_SEND_STATE

La conversation est dans l’état CONFIRM_SEND.

AP_CONFIRM_DEALL_STATE

La conversation est dans l’état CONFIRM_DEALLOCATE.

AP_PEND_POST_STATE

La conversation a un verbe POST en attente.

AP_PEND_DEALL_STATE

La conversation a un verbe DEALLOCATE en attente.

AP_END_CONV_STATE

La conversation est dans l’état END_CONVERSATION.

AP_SEND_PENDING_STATE

La conversation est dans l’état SEND_PENDING.

Codes de retour

AP_OK
Code de retour principal ; le verbe exécuté avec succès.

AP_PARAMETER_CHECK
Code de retour principal ; le verbe n’a pas été exécuté en raison d’une erreur de paramètre.

AP_BAD_CONV_ID

Code de retour secondaire ; la valeur de conv_id ne correspondait pas à un identificateur de conversation affecté par APPC.

AP_BAD_TP_ID

Code de retour secondaire ; la valeur de tp_id ne correspondait pas à un identificateur TP attribué par APPC.

AP_COMM_SUBSYSTEM_ABENDED
Code de retour principal ; indique l’une des conditions suivantes :

• Le nœud utilisé par cette conversation a rencontré un ABEND.

• La connexion entre le tp et le nœud PU 2.1 a été interrompue (erreur LAN).

• Le SnaBase sur l’ordinateur du TP a rencontré un ABEND.

  L’administrateur système doit examiner le journal des erreurs pour déterminer la raison de l’ABEND.

  AP_INVALID_VERB_SEGMENT
  Code de retour principal ; le VCB s’étend au-delà de la fin du segment de données.

  AP_STACK_TOO_SMALL
  Code de retour principal ; la taille de la pile de l’application est trop petite pour exécuter le verbe. Augmentez la taille de la pile de votre application.

  AP_CONV_BUSY
  Code de retour principal ; il ne peut y avoir qu’un seul verbe de conversation en suspens à la fois sur n’importe quelle conversation. Cela peut se produire si le TP local a plusieurs threads et que plusieurs threads émettent des appels APPC à l’aide du même conv_id.

  AP_UNEXPECTED_DOS_ERROR
  Code de retour principal ; le système d’exploitation a retourné une erreur à APPC lors du traitement d’un appel APPC à partir du TP local. Le code de retour du système d’exploitation est retourné via le secondary_rc. Il apparaît dans l’ordre d’échange d’octets Intel. Si le problème persiste, consultez l’administrateur système.

Remarques

La conversation peut être dans n’importe quel état lorsque le TP émet ce verbe.

Il n’y a aucune modification d’état.