Specify_Local_TP_Name (CPI-C)

L’appel Specify_Local_TP_Name (nom de fonction cmsltp) est émis par le programme pour indiquer qu’il est en mesure d’accepter les conversations entrantes dirigées vers le nom donné.

Syntaxe

  
CM_ENTRY Specify_Local_TP_Name(   
  unsigned char FAR *TP_name,    
  CM_INT32 FAR *TP_name_length,    
  CM_INT32 FAR *return_code    
);  

Paramètres

TP_name
Paramètre fourni. Spécifie l’adresse de départ du nom du programme de transaction local (TP). Le nom du programme peut contenir jusqu’à 64 caractères ASCII. Les caractères autorisés sont les suivants :

• Majuscules et minuscules.

• Chiffres de 0 à 9.

• Caractères spéciaux, à l’exception de l’espace.

  Vous ne pouvez pas utiliser Specify_Local_TP_Name pour spécifier le nom d’un tp de service SNA.

  Les jeux de caractères double octet, tels que Kanji, ne sont pas pris en charge.

  TP_name_length
  Paramètre fourni. Spécifie la longueur du nom du programme local. La plage est comprise entre 1 et 64.

  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 ; l’une des opérations suivantes s’est produite :

• La TP_name fournie n’est pas valide.

• La valeur spécifiée par TP_name_length est hors plage (supérieure à 64 ou inférieure à 1).

  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

L’appel n’est pas associé à une conversation particulière et aucune restriction d’état ne s’applique.

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

Remarques

Un programme peut émettre cet appel plusieurs fois pour gérer les conversations entrantes avec plusieurs noms TP. Le programme peut découvrir le nom réel sur la conversation entrante en appelant Extract_TP_Name.