Set_Mode_Name (CPI-C)

Der Set_Mode_Name Aufruf (Funktionsname cmsmn) wird vom aufrufenden Programm ausgegeben, um den Modusnamen für eine Unterhaltung anzugeben. Dieser Aufruf setzt den vom System definierten Modusnamen außer Kraft, der von den Seiteninformationen abgeleitet wurde, als der Initialize_Conversation Anruf ausgegeben 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_Mode_Name(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *mode_name,      
  CM_INT32 FAR *mode_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.

mode_name
Angegebener Parameter. Gibt die Startadresse des Modusnamens an (der Name einer Gruppe von Netzwerkmerkmalen, die während der Konfiguration definiert sind). Der Modusname kann bis zu acht ASCII-Zeichen enthalten. Die zulässigen Zeichen sind:

• Großbuchstaben.

• Ziffern von 0 bis 9.

  Der Wert von mode_name muss dem Namen eines Modus entsprechen, der der logischen Partnereinheit (LU) während der Konfiguration zugeordnet ist. Der Name des Modus darf nicht SNASVCMG oder CPSVCMG sein.

  mode_name_length
  Angegebener Parameter. Gibt die Länge des Modusnamens an. Der Bereich liegt zwischen 0 und 8 Bytes.

  Wenn mode_name_length auf Null festgelegt ist, wird Set_Mode_Name ignoriert.

  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 mode_name_length angegebene Wert liegt außerhalb des Bereichs (größer als 8 oder kleiner als 0).

  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

Die Angabe eines ungültigen Werts für mode_name wird erst erkannt, wenn "Zuweisen" ausgegeben wurde.