Initialize_Conversation (CPI-C)

L’appel Initialize_Conversation (nom de fonction cminit) est émis par le programme appelant pour obtenir un identificateur de conversation de 8 octets et définir les valeurs initiales des 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 de CPI-C suivants.

sym_dest_name
Paramètre fourni. Spécifie le nom de destination symbolique , le nom associé à une entrée d’informations côté chargée à partir du fichier de configuration ou défini 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 l’allocation :

• Set_Mode_Name

• Set_Partner_LU_Name

• Set_TP_Name

  return_code
  Code retourné à partir de 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.

Modifications 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 CPI-C valeurs par défaut ou sont dérivées d’informations latérales associées au nom de destination symbolique. Pour plus d’informations sur les valeurs initiales et les informations côté, consultez Les caractéristiques de conversation initiales et les informations côté pour les programmes CPI-C.

Les valeurs initiales peuvent être modifiées par les appels de Set_ .

Si les informations latérales contiennent une valeur non valide ou qu’un appel Set_ définit une caractéristique de conversation sur une valeur non valide, l’erreur est retournée sur l’appel Allou .

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 deux unités lu 6.2 dépendantes ou plus, ce qui entraîne la désallouation des appels de Initialize_Conversation (CMALLC) suivants pour attendre que la première conversation soit libérée.

Si l’application CPI-C doit appeler plusieurs conversations simultanées, l’unité logique indépendante 6.2 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 requis pour tous les autres appels CPI-C émis pour cette conversation par le programme appelant.

Dans des circonstances normales, une application CPI-C ne peut pas appeler deux conversations simultanées à l’aide de deux unités logiques APPC locales différentes. Une clé de Registre est disponible lorsque la définition force CPI-C à émettre un nouveau verbe TP_STARTED sur 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