Initialize_Conversation (CPI-C)
L’appel Initialize_Conversation (nom de la fonction cminit) est émis par le programme d’appel pour obtenir un identificateur de conversation de 8 octets et définir les valeurs initiales pour les caractéristiques des conversations.
Syntaxe
CM_ENTRY Initialize_Conversation(
unsigned char FAR *conversation_ID,
unsigned char FAR *sym_dest_name,
CM_INT32 FAR *return_code
);
Paramètres
conversation_ID
Paramètre retourné. Spécifie l’identificateur de la conversation. Il est utilisé par les appels CPI-C suivants.
sym_dest_name
Paramètre fourni. Spécifie le nom de destination symbolique, le nom associé à une entrée d’informations latérales chargée à partir du fichier de configuration ou définie par Set_CPIC_Side_Information appels.
Ce paramètre est une chaîne de caractères ASCII de 8 octets. Les caractères autorisés sont les suivants :
Lettres majuscules
Chiffres de 0 à 9
Ce paramètre peut également être défini sur huit espaces. Dans ce cas, le programme appelant doit émettre les appels suivants avant d’émettre Allocate :
-
return_code
Code retourné par cet appel. Les codes de retour valides sont répertoriés plus loin dans cette rubrique.
Codes de retour
CM_OK
Code de retour principal ; l’appel a été exécuté avec succès.
CM_PROGRAM_PARAMETER_CHECK
Code de retour principal ; la valeur spécifiée par sym_dest_name ne correspond pas à un nom de destination symbolique dans la table d’informations latérales et n’est pas un espace.
CM_PRODUCT_SPECIFIC_ERROR
Code de retour principal ; une erreur spécifique au produit s’est produite et a été enregistrée dans le journal des erreurs des produits.
Changements d'état
La conversation est à l’état RESET.
Si le return_code est CM_OK, la conversation passe à l’état INITIALIZE. Pour les autres codes de retour, l’état de la conversation reste inchangé.
Remarques
Les valeurs initiales sont des valeurs par défaut CPI-C ou sont dérivées d’informations latérales associées au nom symbolique de destination. Pour plus d’informations sur les valeurs initiales et les informations latérales, consultez Caractéristiques de conversation initiale et informations latérales pour les programmes CPI-C.
Les valeurs initiales peuvent être modifiées par les appels Set_ .
Si les informations latérales contiennent une valeur non valide ou un appel Set_ définit une valeur non valide pour une caractéristique de conversation, l’erreur est retournée sur l’appel Allocate .
Si une application CPI-C tente d’appeler plusieurs conversations simultanées, une seule unité logique APPC locale est utilisée par toutes les conversations. Cela empêche les conversations simultanées entre au moins deux unités lu dépendantes 6.2 LU, ce qui entraîne l’attente des appels de Initialize_Conversation suivants (CMALLC) pour que la première conversation soit libérée.
Si l’application CPI-C doit appeler plusieurs conversations simultanées, la lu 6.2 indépendante doit être utilisée entre Host Integration Server et le système distant.
En cas d’exécution réussie de cet appel, CPI-C génère un identificateur de conversation. Cet identificateur est un paramètre obligatoire pour tous les autres appels CPI-C émis pour cette conversation par le programme d’appel.
Dans des circonstances normales, une application CPI-C ne peut pas appeler deux conversations simultanées à l’aide de deux LU APPC locales différentes. Une clé de Registre est disponible qui, lorsque l’option est définie, force CPI-C à émettre un nouveau verbe TP_STARTED à chaque appel Initialize_Conversation (cminit). Cela est nécessaire pour forcer l’emplacement des ressources APPC pour chaque appel. La clé de Registre qui doit être définie pour forcer ce comportement est la suivante :
\HKLM\CurrentControlSet\Services\SnaBase\Parameters\Client\GETNEWTPID