Der Aufruf Set_Partner_LU_Name (CMSPLN) setzt für die Conversation die Characteristics partner_LU_name und partner_LU_name_length.
Set_Partner_LU_Name ändert die Werte, die beim Initialize_Conversation-Aufruf aus der Side Information entnommen wurden. Die geänderten Werte gelten nur für die Dauer einer Conversation; die Werte in der Side Information selbst werden nicht verändert.
Der Set_Partner_LU_Name-Aufruf darf nach Allocate nicht mehr ausgeführt werden.
Dieser Aufruf gehört zu den Advanced Functions.
UPIC-R mit openUTM-Cluster-Nutzung:
Der Aufruf Set_Partner_LU_Name wird nicht unterstützt, wenn ein openUTM-Cluster konfiguriert ist.
Aufbau von partner_LU_name:
- maximal 8 Zeichen langer Anwendungsname
- maximal 64 Byte langer Prozessorname
getrennt durch einen Punkt.
Der Punkt und der Prozessorname sind nur bei UPIC-R erlaubt
CMSPLN (conversation_ID, partner_LU_name, partner_LU_name_length, return_code)
Parameter
--> conversation_ID | Identifikation der Conversation. |
--> partner_LU_name | Legt fest, welcher partner_LU_name verwendet werden soll. |
--> partner_LU_name_length | Gibt die Länge von partner_LU_name an. Minimum: 1, Maximum: 73. UPIC-L: Minimum: 1, Maximum: 8. |
<-- return_code | Ergebnis des Funktionsaufrufs. |
Ergebnis (return_code)
CM_OK
Aufruf ok
CM_PROGRAM_PARAMETER_CHECK
Der Wert der conversation_ID ist ungültig oder partner_LU_name ist ungültig oder der Wert in partner_LU_name_length ist kleiner als 1 oder größer als 73.
CM_PROGRAM_STATE_CHECK
Die Conversation ist nicht im Zustand "Initialize".
CM_PRODUCT_SPECIFIC_ERROR
Die UPIC-Instanz konnte nicht gefunden werden.
CM_CALL_NOT_SUPPORTED
Die Funktion wird nicht unterstützt.
Der Returncode tritt bei UPIC-R auf, wenn ein openUTM-Cluster konfiguriert ist. Er zeigt dem Programm an, dass der partner_LU_name nicht geändert werden kann.
Zustandsänderung
Der Aufruf ändert den Zustand der Conversation nicht.
Hinweis
Falls der Returncode von CM_OK verschieden ist, bleibt die Characteristic partner_LU_name unverändert.
Mit diesem Aufruf wird lediglich die Characteristic partner_LU_name gesetzt. Ein ungültiger partner_LU_name wird bei diesem Aufruf nicht entdeckt. Erst der Allocate-Aufruf erkennt einen ungültigen partner_LU_name, wenn er keine Transportverbindung zur UTM-Anwendung aufbauen kann. Er liefert dann den return_code CM_ALLOCATE_FAILURE_NO_RETRY zurück.
Falls eine Anwendung mit UPIC-L gebunden ist und einen partner_LU_name mit einer Länge > 8 übergibt, so liefert der Aufruf Set_Partner_LU_Name den Returncode CM_OK. Im nachfolgenden Allocate-Aufruf wird der partner_LU_name aber stillschweigend auf die Länge 8 abgeschnitten.
Verhalten im Fehlerfall
CM_PROGRAM_STATE_CHECK
Programm ändern.
CM_PROGRAM_PARAMETER_CHECK
Programm ändern.
CM_PRODUCT_SPECIFIC_ERROR
Das Betriebssystem kann nicht genügend Speicherplatz für interne Puffer bereitstellen. Überprüfen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf. Ihr System neu.
CM_CALL_NOT_SUPPORTED
Muss kein Fehler sein: Das Programm kann sich diesen Returncode merken und auf weitere Aufrufe zum Setzen von Adressinformationen verzichten.
CM_ENTRY Set_Partner_LU_Name ( unsigned char CM_PTR conversation_ID,
unsigned char CM_PTR partner_LU_name,
CM_INT32 CM_PTR partne_LU_name_length,
CM_RETURN_CODE CM_PTR return_code )