Partager via

Set_CPIC_Side_Information (CPI-C)

L’appel Set_CPIC_Side_Information (nom de fonction xcmssi) ajoute ou remplace une entrée d’informations latérales en mémoire. Une entrée d’informations côté CPI-C associe un ensemble de caractéristiques de conversation à un nom de définition symbolique. Cet appel remplace les entrées ayant le même nom de destination symbolique.

Syntaxe

  
CM_ENTRY Set_CPIC_Side_Information(   
  unsigned char FAR *key_lock,             
  SIDE_INFO FAR *side_info_entry,          
  CM_INT32 FAR *side_info_entry_length,    
  CM_INT32 FAR *return_code                
);

Paramètres

key_lock
Paramètre fourni. Ce paramètre est ignoré.

side_info_entry
Paramètre fourni. Spécifie le contenu d’une entrée d’informations latérales. Le tableau suivant décrit la structure side_info_entry , qui définit le format de l’entrée d’informations côté.

Compenser Descriptif Catégorie Longueur
0 sym_dest_name caractères non signés 8 octets
8 partner_LU_name caractères non signés 17 octets
25 réservé caractères non signés 3 octets
28 TP_name_type signé long int 32 bits
32 TP_name caractères non signés 64 octets
96 mode_name caractères non signés 8 octets
104 conversation_ security_type signé long int 32 bits
108 security_user_ID caractères non signés 8 octets
116 security_password caractères non signés 8 octets

Les caractères autorisés pour sym_dest_name sont les lettres majuscules (A à Z) et les chiffres compris entre 0 et 9.

Set_CPIC_Side_Information est le seul appel CPI-C qui vous permet de spécifier un programme de transaction de service SNA (TP) comme programme partenaire. La convention SNA pour nommer un tp de service est de quatre caractères maximum. Le premier caractère est un octet hexadécimal entre 0x00 et 0x3F. Les caractères restants sont traduits d’ASCII en EBCDIC.

Pour connaître les caractères autorisés pour les autres champs, consultez la description de l’appel Set_ correspondant. Par exemple, pour le champ mode_name , consultez la description de l’appel Set_Mode_Name .

Chaque champ de la structure doit être aligné à gauche. Remplissez les champs à droite avec des espaces si nécessaire.

side_info_entry_length
Paramètre fourni. Spécifie la longueur de side_info_entry. C’est toujours 124.

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 :

  • Une valeur spécifiée dans la structure side_info_entry n’est pas valide.

  • Le caractère gauche de la side_info_entry contient 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 peut être dans n’importe quel état.

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

Remarques

Les paramètres de chaîne non valides dans les informations latérales (par exemple, la spécification d’une unité logique partenaire non existante (LU)) ne sont pas détectés tant que l’allocation n’est pas émise. L’erreur est retournée lors d’un appel suivant Allouer.

  • Last updated on