Appel de fournisseurs de services (CPI-C)

Un programme de transaction appelant (TP) peut se trouver sur n’importe quel système sur le réseau SNA. Un tp appelant s’identifie lui-même en émettant Initialize_Conversation, qui spécifie le nom du TP appelant et le nom de destination symbolique à utiliser. Un alias d’unité logique locale (LU) peut être spécifié pour l’appel du tp à l’aide d’une variable de Registre ou d’environnement, comme indiqué dans le tableau suivant.

Système d'exploitation de l'ordinateur contenant le TP invoqué. Emplacement et nom de la variable
Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 ou Windows 10 Emplacement dans le Registre Windows :

HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services SnaBase Parameters Client <exename> :REG_SZ :localLUalias

Toutes les entrées de Registre exename sous la clé Client représentent les noms de fichiers exécutables Win32 (sans l'extension de fichier) pour n'importe quel programme transactionnel appelant (TP). Une valeur REG_SZ associée à chaque entrée de registre exename spécifie l'alias LU local pour le TP appelant.

Par exemple, l’exemple APING.EXE Common Programming Interface for Communications (CPI-C) inclus avec le Kit de développement logiciel Microsoft® Host Integration Server (SDK) aurait l’entrée de Registre suivante :

HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services SnaBase Parameters Client APING :REG_SZ :localLUalias

Le paramètre de registre pour l'alias LU local a la priorité la plus élevée lors de l'association d'une LU locale à une application CPI-C appelante. Si une valeur de Registre n’est pas configurée, deux autres méthodes sont utilisées pour associer une unité logique locale à l’application CPI-C.

Une LU APPC locale peut être associée au contexte utilisateur sous lequel l’application CPI-C fonctionne. Une LU APPC locale peut être configurée en cochant la case membre du pool d'unités logiques APPC locales par défaut. Parmi les deux options possibles, une unité logique locale associée au contexte utilisateur a la priorité la plus élevée.

Si l’alias LU local n’est pas spécifié dans un registre ou une variable d’environnement, le service SNA doit être configuré pour le fournir par l’intermédiaire de l’un de ces deux types d’alias LU locaux par défaut. Sinon, Initialize_Conversation échouera. Pour plus d’informations, consultez Invocation des programmes de transaction et configuration du service SNA.

Ensuite, le nom de destination symbolique spécifié dans Initialize_Conversation fournit le nom du TP invocable (ou partenaire) et l'alias LU partenaire (alias LU à utiliser par le TP invocable). Avec ces informations disponibles, le TP appelant peut émettre l’appel Allocate.

Une fois qu’un TP a émis un appel Allocate avec succès, une demande d’allocation est initiée. Pour plus d’informations sur ce qui se passe après qu’un TP appelant demande un TP invocable, consultez Correspondance des TPs appelants et invocables.