Set_Mode_Name (CPI-C)

  • Articolo

La chiamata Set_Mode_Name (nome funzione cmsmn) viene emessa dal programma di chiamata per specificare il nome della modalità per una conversazione. Questa chiamata esegue l'override del nome della modalità definita dal sistema derivato dalle informazioni sul lato quando è stata eseguita la chiamata Initialize_Conversation . Questa chiamata non può essere eseguita dopo l'emissione di Allocate. L'emissione di questa chiamata non ha alcun effetto sulle informazioni sul lato stesso.

Sintassi

  
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          
);

Parametri

conversation_ID
Parametro fornito. Specifica l'identificatore per la conversazione. Il valore di questo parametro è stato restituito da Initialize_Conversation.

mode_name
Parametro fornito. Specifica l'indirizzo iniziale del nome della modalità (il nome di un set di caratteristiche di rete definite durante la configurazione). Il nome della modalità può contenere fino a otto caratteri ASCII. I caratteri consentiti sono:

  • Lettere maiuscole.

  • Numerali da 0 a 9.

    Il valore di mode_name deve corrispondere al nome di una modalità associata all'unità logica partner (LU) durante la configurazione. Il nome della modalità non può essere SNASVCMG o CPSVCMG.

    mode_name_length
    Parametro fornito. Specifica la lunghezza del nome della modalità. L'intervallo è compreso tra 0 e 8 byte.

    Se mode_name_length è impostato su zero, Set_Mode_Name viene ignorato.

    return_code
    Codice restituito da questa chiamata. I codici restituiti validi sono elencati più avanti in questo argomento.

Codici restituiti

CM_OK
Codice restituito primario; la chiamata eseguita correttamente.

CM_PROGRAM_STATE_CHECK
Codice restituito primario; la conversazione non è in stato INITIALIZE.

CM_PROGRAM_PARAMETER_CHECK
Codice restituito primario; si è verificato uno dei seguenti:

  • Il valore specificato da conversation_ID non è valido.

  • Il valore specificato da mode_name_length non è compreso nell'intervallo (maggiore di 8 o minore di 0).

    CM_PRODUCT_SPECIFIC_ERROR
    Codice restituito primario; si è verificato un errore specifico del prodotto ed è stato registrato nel log degli errori dei prodotti.

Modifiche di stato

La conversazione deve essere in stato INITIALIZE.

Non esiste alcuna modifica dello stato.

Commenti

La specifica di un valore non valido per mode_name non viene rilevata fino a quando non viene emesso Allocate .