TP_STARTED

Le verbe TP_STARTED est émis par le programme de transaction appelant (TP) et avertit APPC que le TP démarre.

Pour Microsoft® Windows® version 3. x système, il est recommandé d’utiliser la fonction WinAsyncAPPC plutôt que la version bloquante de cet appel.

La structure suivante décrit le bloc de contrôle de verbe utilisé par le verbe TP_STARTED .

Syntaxe

  
struct tp_started {  
    unsigned short  opcode;  
    unsigned char   opext;  
    unsigned char   reserv2;  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned char   lu_alias[8];  
    unsigned char   tp_id[8];  
    unsigned char   tp_name[64];  
    unsigned char   syncpoint_rqd;  
};   

Membres

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

opext
Paramètre fourni. Spécifie l’extension d’opération de verbe. Si le bit AP_EXTD_VCB est défini, cela indique que la structure tp_started inclut le membre syncpoint_rqd utilisé pour la prise en charge du point de synchronisation. Sinon, le bloc de contrôle verbe se termine immédiatement après le membre tp_name .

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.

lu_alias
Paramètre fourni. Spécifie l’alias par lequel l’unité logique locale est connue du TP local.

Le nom doit correspondre à un alias lu établi pendant la configuration. APPC vérifie l’alias lu par rapport au fichier de configuration host Integration Server actuel. En raison de l’architecture client/serveur utilisée par Host Integration Server, toutefois, ce paramètre n’est pas validé tant qu’un ALLOCATE ou un MC_ALLOCATE n’est pas effectué.

Ce paramètre est une chaîne de caractères ASCII de 8 octets. Il peut se composer des caractères ASCII suivants :

• Lettres majuscules

• Chiffres de 0 à 9

• Espaces

• Caractères spéciaux $, #, % et @

Le premier caractère de cette chaîne ne peut pas être un espace.

Si la valeur de ce paramètre est inférieure à huit octets, remplissez-la à droite avec des espaces ASCII (0x20).

Pour utiliser une unité logique à partir du pool lu par défaut, définissez ce champ sur huit zéros hexadécimaux. Pour plus d’informations, consultez Unités logiques par défaut.

tp_id
Paramètre retourné. Identifie le tp nouvellement établi.

tp_name
Paramètre fourni. Spécifie le nom du TP local.

Sous l’implémentation host Integration Server d’APPC, ce paramètre est ignoré lorsqu’il est émis par TP_STARTED. Toutefois, ce paramètre est requis si le programme s’exécute sous l’implémentation IBM ES pour OS/2 version 1.0 d’APPC.

Ce paramètre est une chaîne de caractères EBCDIC de 64 octets et respecte la casse. Le paramètre tp_name peut se composer des caractères EDCDIC suivants :

• Lettres majuscules et minuscules

• Chiffres de 0 à 9

• Caractères spéciaux $, #, @et point (.)

Si le nom du TP est inférieur à 64 octets, utilisez des espaces EBCDIC (0x40) pour le remplir à droite.

La convention SNA d’un nom tp de service est de quatre caractères maximum. Le premier caractère est un octet hexadécimal entre 0x00 et 0x3F.

syncpoint_rqd
Ce paramètre facultatif s’applique uniquement si le bit AP_EXTD_VCB est défini dans le paramètre opext et que les services de point de synchronisation sont requis.

• AP_YES si le point de synchronisation est requis.
• AP_NO si le point de synchronisation n’est pas obligatoire.

Codes de retour

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

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_COMM_SUBSYSTEM_NOT_LOADED
Code de retour principal ; un composant requis n’a pas pu être chargé ou arrêté lors du traitement du verbe. Ainsi, la communication n’a pas pu avoir lieu. Contactez l’administrateur système pour obtenir une action corrective.

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_TP_BUSY
Code de retour principal ; le TP local a émis un appel à APPC pendant que APPC a traité un autre appel pour le même TP.

AP_THREAD_BLOCKING
Code de retour principal ; le thread appelant est déjà dans un appel bloquant.

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

En réponse à TP_STARTED, APPC génère un identificateur TP pour l’appel du TP. Cet identificateur est un paramètre requis pour les verbes APPC suivants émis par l’appel du TP.

Il doit s’agir du premier verbe APPC émis par l’appel du TP. Par conséquent, aucun état APPC antérieur n’existe.

Si le verbe s’exécute correctement (primary_rc est AP_OK), l’état passe à RESET.

Dans cette section

• Unités logiques par défaut