TP_STARTED
Le verbe TP_STARTED est émis par le programme transactionnel appelant. Il indique à APPC que le programme transactionnel démarre.
Avec la version 3.x du système Microsoft® Windows®, il est recommandé d’utiliser la fonction WinAsyncAPPC plutôt que la version de blocage 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 de l’opération de verbe. Si le bit AP_EXTD_VCB est défini, cela indique que la structure tp_started comprend le membre syncpoint_rqd utilisé pour la prise en charge des points de synchronisation. Dans le cas contraire, le bloc de contrôle de verbe se termine immédiatement après le membre tp_name.
reserv2
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 dépendent du verbe APPC émis. Pour connaître les codes d’erreur valides de ce verbe, consultez Codes de retour.
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 dépendent du verbe APPC émis. Pour connaître les codes d’erreur valides de ce verbe, consultez Codes de retour.
lu_alias
Paramètre fourni. Spécifie l’alias sous lequel l’unité logique locale est connue du programme transactionnel local.
Le nom doit correspondre à un alias d’unité logique établi pendant la configuration. APPC confronte l’alias d’unité logique 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 validé qu’une fois qu’une opération ALLOCATE ou MC_ALLOCATE a été effectuée.
Ce paramètre est une chaîne de caractères ASCII de 8 octets. Il peut contenir les 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 longueur de la valeur de ce paramètre est inférieure à 8 octets, ajoutez à droite des espaces ASCII (0x20) servant de caractères de remplissage.
Pour utiliser une unité logique du pool d’unités logiques par défaut, définissez ce champ sur 8 zéros hexadécimaux. Pour plus d’informations, consultez Unités logiques par défaut.
tp_id
Paramètre retourné. Identifie le programme transactionnel qui vient d’être établi.
tp_name
Paramètre fourni. Spécifie le nom du programme transactionnel local.
Avec l’implémentation Host Integration Server d’APPC, ce paramètre est ignoré lorsqu’il est émis par TP_STARTED. Il est en revanche obligatoire si le programme s’exécute avec l’implémentation de la version 1.0 d’IBM ES pour OS/2 d’APPC.
Ce paramètre est une chaîne de caractères EBCDIC de 64 octets qui respecte la casse. Il peut contenir les caractères EDCDIC suivants :
Lettres majuscules et minuscules
Chiffres de 0 à 9
Caractères spéciaux $, #, @ et point (.)
Si la longueur du nom du programme transactionnel est inférieure à 64 octets, utilisez à droite des espaces EBCDIC (0x40) servant de caractères de remplissage.
La convention SNA utilisée pour le nom des programmes transactionnels de service admet jusqu’à quatre caractères. Le premier caractère est un octet hexadécimal compris entre 0x00 et 0x3F.
syncpoint_rqd
Ce paramètre facultatif n’est applicable que 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 requis.
Codes de retour
AP_OK
Code de retour principal ; indique que le verbe s’est exécuté correctement.
AP_COMM_SUBSYSTEM_ABENDED
Code de retour principal ; indique l’une des situations suivantes :
Le nœud utilisé par cette conversation a rencontré un abandon (ABEND).
La connexion a été interrompue entre le programme transactionnel et le nœud PU 2.1 (erreur LAN).
Le processus SnaBase qui se déroule sur l’ordinateur du programme transactionnel a rencontré un abandon (ABEND).
L’administrateur système doit examiner le journal des erreurs pour déterminer la raison de l’abandon.
AP_COMM_SUBSYSTEM_NOT_LOADED
Code de retour principal ; indique qu’il n’a pas été possible de charger un composant requis ou d’y mettre fin lors du traitement du verbe. Par conséquent, la communication n’a pas pu être établie. Contactez l’administrateur système pour mettre en place une action corrective.
AP_INVALID_VERB_SEGMENT
Code de retour principal ; indique que le bloc de contrôle de verbe s’étend au-delà de la fin du segment de données.
AP_STACK_TOO_SMALL
Code de retour principal ; indique que la taille de la pile de l’application est trop petite pour exécuter le verbe. Augmentez la taille de pile de votre application.
AP_TP_BUSY
Code de retour principal ; indique que le programme transactionnel local a émis un appel à APPC alors qu’APPC traitait un autre appel pour le même programme transactionnel.
AP_THREAD_BLOCKING
Code de retour principal ; indique que le thread appelant se trouve déjà dans un appel de blocage.
AP_UNEXPECTED_DOS_ERROR
Code de retour principal ; indique que le système d’exploitation a retourné une erreur à APPC lors du traitement d’un appel APPC à partir du programme transactionnel local. Le code de retour du système d’exploitation a été retourné via secondary_rc. Il apparaît dans l’ordre Intel avec permutation d’octets. Si le problème persiste, consultez l’administrateur système.
Notes
En réponse à TP_STARTED, APPC génère un identificateur pour le programme transactionnel appelant. Cet identificateur est un paramètre obligatoire pour les verbes APPC émis ensuite par le programme transactionnel appelant.
Il doit s’agir du premier verbe APPC émis par le programme transactionnel appelant. Par conséquent, il n’existe aucun état APPC antérieur.
Si le verbe s’exécute correctement (primary_rc = AP_OK), l’état passe à RESET.