Set_Partner_LU_Name (CPI-C)

Artikel
10/14/2023

Der Set_Partner_LU_Name-Aufruf (Funktionsname cmspln) wird vom aufrufenden Programm ausgegeben, um den Namen der logischen Einheit (Lu) der Partnereinheit anzugeben. Dieser Aufruf setzt den Partner-LU-Namen außer Kraft, der von den Seiteninformationen abgeleitet wurde, als der Initialize_Conversation Aufruf ausgegeben wurde. Dieser Aufruf kann nicht ausgegeben werden , nachdem Die Zuordnung ausgestellt wurde. Das Ausstellen dieses Aufrufs hat keine Auswirkungen auf die Nebeninformationen 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              
);

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.
Zahlen von 0 bis 9.

Der Name der Partner-LU kann wie folgt lauten:
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 einem und acht Zeichen bestehen kann). Wenn der Netzwerkbezeichner 0 Zeichen lang ist, ist der Zeitraum weiterhin erforderlich.

Der Partner-LU-Name 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 reicht von 1 bis 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 Punkte ist aufgetreten:

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 Produktfehlerprotokoll protokolliert.

Zustandsänderungen

Die Unterhaltung muss sich im INITIALIZE-Zustand befinden.

Es gibt keine Zustandsänderung.

Hinweise

Das Angeben eines ungültigen Werts für partner_LU_name wird erst erkannt, wenn Die Zuordnung ausgegeben wird.

Freigeben über