Set_CPIC_Side_Information (CPI-C)

Article
10/14/2023

L’appel Set_CPIC_Side_Information (nom de la 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 latérales.

Offset	Description	Type	Longueur
0	sym_dest_name	unsigned char	8 octets
8	partner_LU_name	unsigned char	17 octets
25	reserved	unsigned char	3 octets
28	TP_name_type	signed long int	32 bits
32	TP_name	unsigned char	64 octets
96	mode_name	unsigned char	8 octets
104	conversation_ security_type	signed long int	32 bits
108	security_user_ID	unsigned char	8 octets
116	security_password	unsigned char	8 octets

Les caractères autorisés pour sym_dest_name sont les lettres majuscules (A à Z) et les chiffres de 0 à 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 comprend jusqu’à quatre caractères. Le premier caractère est un octet hexadécimal compris 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. Champs de pad à droite avec des espaces si nécessaire.

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

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 :

Une valeur spécifiée dans la structure side_info_entry n’est pas valide.
Le caractère gauche du 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.

Changements d'état

La conversation peut être dans n’importe quel état.

Il n’y a aucun changement 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 (LU) inexistante) 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.

Partager via