Set_Partner_LU_Name (CPI-C)

Article
07/21/2023

L’appel Set_Partner_LU_Name (nom de fonction cmspln) est émis par le programme d’appel pour spécifier le nom de l’unité logique partenaire. Cet appel remplace le nom de l’unité logique partenaire dérivé des informations latérales lors de l’émission de l’appel Initialize_Conversation . Cet appel ne peut pas être émis après l’émission d’Allocation . L’émission de cet appel n’a aucun effet sur les informations secondaires elles-mêmes.

Syntaxe

  
CM_ENTRY Set_Partner_LU_Name(   
  unsigned char FAR *conversation_ID,    
    unsigned char FAR *partner_LU_name,    
  CM_INT32 FAR *partner_LU_name_length,    
  CM_INT32 FAR *return_code              
);

Paramètres

conversation_ID
Paramètre fourni. Spécifie l’identificateur de la conversation. La valeur de ce paramètre a été retournée par Initialize_Conversation.

partner_LU_name
Paramètre fourni. Spécifie l’adresse de départ du nom de l’unité logique partenaire. Le nom du mode peut contenir jusqu’à 17 caractères ASCII. Les caractères autorisés sont les suivants :

Lettres majuscules.
Chiffres de 0 à 9.

Le nom de l’unité logique partenaire peut être :
Alias composé d’un à huit caractères.
Nom de réseau complet composé de 2 à 17 caractères. Un point sépare l’identificateur réseau (qui peut être compris entre zéro et huit caractères) du nom de l’unité logique réseau (qui peut être compris entre un et huit caractères). Si l’identificateur réseau est long de zéro caractères, le point est toujours requis.

Le nom de l’unité logique partenaire doit correspondre au nom d’une unité logique partenaire établie lors de la configuration.

partner_LU_name_length
Paramètre fourni. Spécifie la longueur du nom de l’unité logique partenaire. La plage est comprise entre 1 et 17.

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_STATE_CHECK
Code de retour principal ; la conversation n’est pas à l’état INITIALIZE.

CM_PROGRAM_PARAMETER_CHECK
Code de retour principal ; l’une des opérations suivantes s’est produite :

La valeur spécifiée par conversation_ID n’est pas valide.
La valeur spécifiée par partner_LU_name_length est hors plage (supérieure à 17 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

La conversation doit être à l’état INITIALIZE.

Il n’y a aucun changement d’état.

Remarques

La spécification d’une valeur non valide pour partner_LU_name n’est pas détectée tant que l’allocation n’est pas émise.

Partager via