Specify_Local_TP_Name (CPI-C)

  • Artículo

El programa emite la llamada Specify_Local_TP_Name (nombre de función cmsltp) para indicar que es capaz de aceptar conversaciones entrantes dirigidas al nombre especificado.

Sintaxis

  
CM_ENTRY Specify_Local_TP_Name(   
  unsigned char FAR *TP_name,    
  CM_INT32 FAR *TP_name_length,    
  CM_INT32 FAR *return_code    
);

Parámetros

TP_name
Parámetro proporcionado. Especifica la dirección inicial del nombre del programa de transacciones local (TP). El nombre del programa puede contener hasta 64 caracteres ASCII. Los caracteres permitidos son:

  • Letras mayúsculas y minúsculas.

  • Números de 0 a 9.

  • Caracteres especiales, excepto el espacio.

    No puede usar Specify_Local_TP_Name para especificar el nombre de un TP de servicio SNA.

    No se admiten juegos de caracteres de doble byte, como Kanji.

    TP_name_length
    Parámetro proporcionado. Especifica la longitud del nombre del programa local. El intervalo va de 1 a 64.

    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_PARAMETER_CHECK
Código de retorno principal; se produjo una de las siguientes acciones:

  • El TP_name proporcionado no es válido.

  • El valor especificado por TP_name_length está fuera del intervalo (mayor que 64 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 llamada no está asociada a una conversación determinada y no se aplican restricciones de estado.

No hay ningún cambio de estado.

Comentarios

Un programa puede emitir esta llamada más de una vez para controlar las conversaciones entrantes con más de un nombre de TP. El programa puede detectar el nombre real en la conversación entrante llamando a Extract_TP_Name.