Specify_Local_TP_Name (CPI-C)

  • Article

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.

  • Nombres 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 sur deux octets, 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é 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 ; l’un des événements suivants s’est produit :

  • Le TP_name fourni n’est pas valide.

  • La valeur spécifiée par TP_name_length est hors de la 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.

Changements d'état

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

Il n’y a aucun changement 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 de la conversation entrante en appelant Extract_TP_Name.