Set_Conversation_Security_User_ID (CPI-C)

Article
10/14/2023

L’appel de Set_Conversation_Security_User_ID (nom de la fonction cmscsu) est émis par le programme appelant pour spécifier l’identificateur d’utilisateur requis pour accéder au programme appelé.

Syntaxe

  
CM_ENTRY Set_Conversation_Security_User_ID(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *security_user_ID,    
  CM_INT32 FAR *security_user_ID_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.

security_user_ID
Paramètre fourni. Spécifie l’identificateur d’utilisateur requis pour accéder au programme partenaire. Ce paramètre est une chaîne de caractères de huit caractères ASCII maximum et respecte la casse.

Les caractères autorisés sont les suivants :

Majuscules et minuscules.
Nombres de 0 à 9.
Caractères spéciaux, à l’exception de l’espace.

Si la fonctionnalité d’ouverture de session automatique CPI-C doit être utilisée, ce paramètre doit être défini sur la chaîne MS$SAME. Pour plus d’informations, consultez la section Remarques plus loin dans cette rubrique.

security_user_ID_length
Paramètre fourni. Spécifie la longueur de security_user_ID. La plage est comprise entre 0 et 8.

Si la fonctionnalité d’ouverture de session automatique CPI-C doit être utilisée, ce paramètre doit avoir la valeur 7. Pour plus d’informations, consultez la section Remarques plus loin dans cette rubrique.

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 :

La valeur spécifiée par conversation_ID n’est pas valide.
La valeur spécifiée par security_user_ID_length est hors de portée.

CM_PROGRAM_STATE_CHECK
Code de retour principal ; l’un des événements suivants s’est produit :
La conversation n’est pas dans l’état INITIALIZE.
Le type de sécurité des conversations n’est pas défini sur CM_SECURITY_PROGRAM.

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

Cet appel n’a d’effet sur la conversation que si le type de sécurité de la conversation est CM_SECURITY_PROGRAM ou CM_SECURITY_SAME. Il remplace l’identificateur d’utilisateur initial à partir des informations latérales spécifiées par Initialize_Conversation. Cet appel ne peut pas être émis après l’émission d’Allocation .

Un identificateur d’utilisateur non valide n’est pas détecté tant que la demande d’allocation, générée par Allocation, n’est pas envoyée à l’unité logique partenaire (LU). L’erreur est retournée au programme d’appel lors d’un appel suivant.

L’ouverture de session automatique pour les applications CPI-C est prise en charge par Host Integration Server. Cette fonctionnalité nécessite une configuration spécifique de la part de l’administrateur réseau. L’application CPI-C doit être appelée côté LAN à partir d’un client du serveur SNA. Le client doit être connecté à un domaine Microsoft Windows Server, mais peut être n’importe quelle plateforme prenant en charge les API CPI-C de SNA Server.

L’application cliente est codée pour utiliser la sécurité au niveau du programme, avec un nom d’utilisateur CPI-C codé en dur spécial MS$SAME et un mot de passe MS$SAME. Lorsque cette allocation de session passe du client au serveur SNA, le serveur SNA recherche le compte d’hôte et le mot de passe correspondant au compte Windows Server sous lequel le client est connecté, et remplace les informations du compte hôte dans le message d’attachement APPC qu’il envoie à l’hôte.

Partager via