Set_Partner_LU_Name (CPI-C)

Der Set_Partner_LU_Name Aufruf (Funktionsname cmspln) wird vom aufrufenden Programm ausgegeben, um den Namen der logischen Partnereinheit (LU) anzugeben. Dieser Aufruf setzt den Partner-LU-Namen außer Kraft, der von den Seiteninformationen abgeleitet wurde, als der Initialize_Conversation Anruf ausgestellt wurde. Dieser Aufruf kann nicht ausgegeben werden, nachdem "Zuweisung " ausgegeben wurde. Das Ausgeben dieses Aufrufs hat keine Auswirkungen auf die Seiteninformationen selbst.

Syntax

  
CM_ENTRY Set_Partner_LU_Name(   
  unsigned char FAR *conversation_ID,    
    unsigned char FAR *partner_LU_name,    
  CM_INT32 FAR *partner_LU_name_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.

partner_LU_name
Angegebener Parameter. Gibt die Startadresse des Partner-LU-Namens an. Der Modusname kann bis zu 17 ASCII-Zeichen enthalten. Die zulässigen Zeichen sind:

• Großbuchstaben.

• Ziffern von 0 bis 9.

  Der Name der Partner-LU kann eine der folgenden sein:

• Ein Alias, der aus einem bis acht Zeichen besteht.

• Ein vollqualifizierter Netzwerkname, der aus 2 bis 17 Zeichen besteht. Ein Punkt trennt den Netzwerkbezeichner (der von Null bis acht Zeichen sein kann) vom Netzwerk-LU-Namen (der zwischen 1 und acht Zeichen liegen kann). Wenn der Netzwerkbezeichner null Zeichen lang ist, ist der Zeitraum noch erforderlich.

  Der Name der Partner-LU muss mit dem Namen einer Partner-LU übereinstimmen, die während der Konfiguration eingerichtet wurde.

  partner_LU_name_length
  Angegebener Parameter. Gibt die Länge des Partner-LU-Namens an. Der Bereich liegt zwischen 1 und 17.

  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_STATE_CHECK
Primärer Rückgabecode; die Unterhaltung befindet sich nicht im INITIALIZE-Zustand.

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

• Der durch conversation_ID angegebene Wert ist ungültig.

• Der durch partner_LU_name_length angegebene Wert liegt außerhalb des Bereichs (größer als 17 oder kleiner als 1).

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

Statusänderungen

Die Unterhaltung muss sich im INITIALIZE-Zustand befinden.

Es gibt keine Zustandsänderung.

Bemerkungen

Das Angeben eines ungültigen Werts für partner_LU_name wird erst erkannt, wenn "Zuweisen " ausgegeben wurde.