Set_Conversation_Security_Password (CPI-C)

Artikel
07/21/2023

Der Set_Conversation_Security_Password Aufruf (Funktionsname cmscsp) wird vom aufrufenden Programm ausgegeben, um das kennwort anzugeben, das für den Zugriff auf das aufgerufene Programm erforderlich ist.

Syntax

  
CM_ENTRY Set_Conversation_Security_Password(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *security_password,    
  CM_INT32 FAR *security_password_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_password
Angegebener Parameter. Gibt das kennwort an, das 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. Sie muss mit dem Kennwort für die für das Partnerprogramm konfigurierte Benutzer-ID übereinstimmen.

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_password_length
Angegebener Parameter. Gibt die Länge der security_password 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 durch security_password_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.

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. Es überschreibt das anfängliche Kennwort aus den seitenseitigen Informationen, die durch Initialize_Conversation angegeben werden. Dieser Aufruf kann nicht ausgegeben werden, nachdem "Allocate" ausgestellt wurde.

Ein ungültiges Kennwort wird erst erkannt, wenn die von Allocate generierte Zuordnungsanforderung an die partner logical unit (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-Domäne angemeldet sein, kann jedoch eine beliebige Plattform sein, die Host Integration 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-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