Compartir a través de

Set_Partner_LU_Name (CPI-C)

  • Artículo

El programa de invocación emite el Set_Partner_LU_Name llamada (nombre de función cmspln) para especificar el nombre de la unidad lógica (LU) del asociado. Esta llamada invalida el nombre de LU del asociado 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_Partner_LU_Name(   
  unsigned char FAR *conversation_ID,    
    unsigned char FAR *partner_LU_name,    
  CM_INT32 FAR *partner_LU_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.

partner_LU_name
Parámetro proporcionado. Especifica la dirección inicial del nombre de LU del asociado. El nombre del modo puede contener hasta 17 caracteres ASCII. Los caracteres permitidos son:

  • Letras mayúsculas.

  • Números de 0 a 9.

    El nombre de LU del asociado puede ser:

  • Alias que consta de uno a ocho caracteres.

  • Un nombre de red completo que consta de entre 2 y 17 caracteres. Un punto separa el identificador de red (que puede ser de cero a ocho caracteres) del nombre de LU de red (que puede ser de uno a ocho caracteres). Si el identificador de red tiene cero caracteres, el período sigue siendo necesario.

    El nombre de LU del asociado debe coincidir con el nombre de una LU de asociado establecida durante la configuración.

    partner_LU_name_length
    Parámetro proporcionado. Especifica la longitud del nombre de LU del asociado. El intervalo va de 1 a 17.

    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 partner_LU_name_length está fuera del intervalo (mayor que 17 o menor que 1).

    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 partner_LU_name hasta que se emite Allocate .