Set_Conversation_Security_User_ID (CPI-C)

Artikel
07/21/2023

Der Set_Conversation_Security_User_ID Aufruf (Funktionsname cmscsu) wird vom aufrufenden Programm ausgegeben, um die Benutzer-ID anzugeben, die für den Zugriff auf das aufgerufene Programm erforderlich ist.

Syntax

  
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              
);

Parameter

conversation_ID
Angegebener Parameter. Gibt den Bezeichner für die Unterhaltung an. Der Wert dieses Parameters wurde von Initialize_Conversation zurückgegeben.

security_user_ID
Angegebener Parameter. Gibt die Benutzer-ID an, die erforderlich ist, um Zugriff auf das Partnerprogramm zu erhalten. Bei diesem Parameter handelt es sich um eine Zeichenfolge mit bis zu acht ASCII-Zeichen, wobei die Groß-/Kleinschreibung beachtet wird.

Zulässige Zeichen sind:

Groß- und Kleinbuchstaben.
Ziffern von 0 bis 9.
Sonderzeichen mit Ausnahme des Leerzeichens.

Wenn die automatische CPI-C-Anmeldefunktion verwendet werden soll, muss dieser Parameter auf die MS$SAME-Zeichenfolge festgelegt werden. Ausführliche Informationen finden Sie im Abschnitt Hinweise weiter unten in diesem Thema.

security_user_ID_length
Angegebener Parameter. Gibt die Länge der security_user_ID an. Der Bereich reicht von 0 bis 8.

Wenn das Feature für die automatische Anmeldung von CPI-C verwendet werden soll, muss dieser Parameter auf 7 festgelegt werden. Ausführliche Informationen finden Sie im Abschnitt Hinweise weiter unten in diesem Thema.

return_code
Der von diesem Aufruf zurückgegebene Code. Die gültigen Rückgabecodes werden weiter unten in diesem Thema aufgeführt.

Rückgabecodes

CM_OK
Primärer Rückgabecode; Der Aufruf wurde erfolgreich ausgeführt.

CM_PROGRAM_PARAMETER_CHECK
Primärer Rückgabecode; eine der folgenden Ereignisse:

Der von conversation_ID angegebene Wert ist ungültig.
Der von security_user_ID_length angegebene Wert liegt außerhalb des Bereichs.

CM_PROGRAM_STATE_CHECK
Primärer Rückgabecode; eine der folgenden Ereignisse:
Die Unterhaltung befindet sich nicht im INITIALIZE-Zustand.
Der Sicherheitstyp unterhaltungen ist nicht auf CM_SECURITY_PROGRAM festgelegt.

CM_PRODUCT_SPECIFIC_ERROR
Primärer Rückgabecode; Ein produktspezifischer Fehler ist aufgetreten und wurde im Produktfehlerprotokoll protokolliert.

Zustandsänderungen

Die Unterhaltung muss sich im INITIALIZE-Zustand befinden.

Es gibt keine Zustandsänderung.

Hinweise

Dieser Aufruf wirkt sich nur auf die Unterhaltung aus, wenn der Unterhaltungssicherheitstyp CM_SECURITY_PROGRAM oder CM_SECURITY_SAME ist. Er überschreibt die anfängliche Benutzer-ID aus den von Initialize_Conversation angegebenen Seiteninformationen. Dieser Aufruf kann nicht ausgegeben werden, nachdem "Allocate" ausgestellt wurde.

Ein ungültiger Benutzerbezeichner wird erst erkannt, wenn die von Allocate generierte Zuordnungsanforderung an die Partner-LU gesendet wird. Der Fehler wird bei einem nachfolgenden Aufruf an das Aufrufprogramm zurückgegeben.

Die automatische Anmeldung für CPI-C-Anwendungen wird von Host Integration Server unterstützt. Dieses Feature erfordert eine bestimmte Konfiguration durch den Netzwerkadministrator. Die CPI-C-Anwendung muss auf der LAN-Seite von einem Client des SNA-Servers aufgerufen werden. Der Client muss bei einer Microsoft Windows Server-Domäne angemeldet sein, kann jedoch eine beliebige Plattform sein, die SNA Server CPI-C-APIs unterstützt.

Die Clientanwendung ist so codiert, dass sie die Sicherheit auf Programmebene mit einem speziellen hartcodierten CPI-C-Benutzernamen MS$SAME und dem Kennwort MS$SAME verwendet. Wenn diese Sitzungszuordnung vom Client zum SNA-Server fließt, sucht der SNA-Server das Hostkonto und das Kennwort, das dem Windows Server-Konto entspricht, unter dem der Client angemeldet ist, und ersetzt die Hostkontoinformationen in der APPC-Anfügungsnachricht, die er an den Host sendet.

Freigeben über