Set_Conversation_Security_Password (CPI-C)

Der Set_Conversation_Security_Password Aufruf (Funktionsname cmscsp) wird vom aufrufenden Programm ausgegeben, um das kennwort anzugeben, das erforderlich ist, um Zugriff auf das aufgerufene Programm zu erhalten.

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

Die 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 und bei Groß-/Kleinschreibung wird die Groß-/Kleinschreibung beachtet. Es muss mit dem Kennwort für die für das Partnerprogramm konfigurierte Benutzer-ID übereinstimmen.

Die zulässigen Zeichen sind:

• Groß- und Kleinbuchstaben.

• Ziffern von 0 bis 9.

• Sonderzeichen mit Ausnahme des Leerzeichens.

  Wenn das feature CPI-C automatische Anmeldung 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 des security_password an. Der Bereich liegt zwischen 0 und 8.

  Wenn das feature für die automatische Anmeldung 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; einer der folgenden Ereignisse:

• Der durch conversation_ID angegebene Wert ist ungültig.

• Der durch security_password_length angegebene Wert liegt außerhalb des zulässigen Bereichs.

  CM_PROGRAM_STATE_CHECK
  Primärer Rückgabecode; einer der folgenden Ereignisse:

• Die Unterhaltung befindet sich nicht im INITIALIZE-Zustand.

• Der Sicherheitstyp "Unterhaltungen" ist nicht auf CM_SECURITY_PROGRAM festgelegt.

Statusänderungen

Die Unterhaltung muss sich im INITIALIZE-Zustand befinden.

Es gibt keine Zustandsänderung.

Bemerkungen

Dieser Anruf wirkt sich nur auf die Unterhaltung aus, wenn der Unterhaltungssicherheitstyp CM_SECURITY_PROGRAM oder CM_SECURITY_SAME ist. Es überschreibt das anfängliche Kennwort von den durch Initialize_Conversation angegebenen Seiteninformationen. Dieser Aufruf kann nicht ausgegeben werden, nachdem "Zuweisung " ausgegeben wurde.

Ein ungültiges Kennwort wird erst erkannt, wenn die zuordnungsanforderung, die von "Allocate" generiert wird, an die logische Partnereinheit (LU) gesendet wird. Der Fehler wird bei einem nachfolgenden Aufruf an das aufrufende Programm zurückgegeben.

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

Die Clientanwendung ist codiert, um die Sicherheit auf Programmebene mit einem speziell hartcodierten CPI-C Benutzernamen MS$SAME und kennwort MS$SAME zu verwenden. Wenn diese Sitzungszuweisung von Client zu SNA Server fließt, sucht der SNA-Server das Hostkonto und das Kennwort entsprechend dem Windows-Konto, unter dem der Client angemeldet ist, und ersetzt die Hostkontoinformationen in die APPC-Anlagenachricht, die sie an den Host sendet.