Set_Mode_Name (CPI-C)

Artículo
07/21/2023

El programa de invocación emite la llamada de Set_Mode_Name (nombre de función cmsmn) para especificar el nombre del modo para una conversación. Esta llamada invalida el nombre del modo definido por el sistema derivado de la información lateral cuando se emitió la llamada Initialize_Conversation . Esta llamada no se puede emitir después de que se haya emitido Allocate. La emisión de esta llamada no tiene ningún efecto en la propia información de los lados.

Sintaxis

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

Parámetros

conversation_ID
Parámetro proporcionado. Especifica el identificador de la conversación. El valor de este parámetro lo devolvió Initialize_Conversation.

mode_name
Parámetro proporcionado. Especifica la dirección inicial del nombre del modo (el nombre de un conjunto de características de red definidas durante la configuración). El nombre del modo puede contener hasta ocho caracteres ASCII. Los caracteres permitidos son:

Letras mayúsculas.
Números de 0 a 9.

El valor de mode_name debe coincidir con el nombre de un modo asociado a la unidad lógica de asociado (LU) durante la configuración. El nombre del modo no puede ser SNASVCMG o CPSVCMG.

mode_name_length
Parámetro proporcionado. Especifica la longitud del nombre del modo. El intervalo es de 0 a 8 bytes.

Si mode_name_length se establece en cero, Set_Mode_Name se omite.

return_code
Código devuelto de esta llamada. Los códigos de retorno válidos se enumeran más adelante en este tema.

Códigos de retorno

CM_OK
Código de retorno principal; la llamada se ejecutó correctamente.

CM_PROGRAM_STATE_CHECK
Código de retorno principal; la conversación no está en estado INITIALIZE.

CM_PROGRAM_PARAMETER_CHECK
Código de retorno principal; se produjo una de las siguientes acciones:

El valor especificado por conversation_ID no es válido.
El valor especificado por mode_name_length está fuera del intervalo (mayor que 8 o menor que 0).

CM_PRODUCT_SPECIFIC_ERROR
Código de retorno principal; se produjo un error específico del producto y se ha registrado en el registro de errores de productos.

Cambios de estado

La conversación debe estar en estado INITIALIZE.

No hay ningún cambio de estado.

Comentarios

No se detecta la especificación de un valor no válido para mode_name hasta que se emite Allocate .

Share via