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 überschreibt den systemdefinierten Modusnamen, der von den Seiteninformationen abgeleitet wurde, als der Initialize_Conversation Aufrufs ausgegeben wurde. Dieser Aufruf kann nicht ausgegeben werden , nachdem Die Zuordnungausgestellt wurde. Das Ausstellen dieses Aufrufs hat keine Auswirkungen auf die Nebeninformationen 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          
);  

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 wurden). Der Modusname kann bis zu acht ASCII-Zeichen enthalten. Die zulässigen Zeichen sind:

• Großbuchstaben.

• Zahlen von 0 bis 9.

  Der Wert von mode_name muss mit dem Namen eines Modus übereinstimmen, der der partner logical unit (LU) während der Konfiguration zugeordnet ist. Der Modusname darf nicht SNASVCMG oder CPSVCMG sein.

  mode_name_length
  Angegebener Parameter. Gibt die Länge des Modusnamens an. Der Bereich reicht von 0 bis 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 Punkte ist aufgetreten:

• 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 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 mode_name wird erst erkannt, wenn Die Zuordnung ausgegeben wird.