Compartir a través de

Set_TP_Name (CPI-C)

  • Artículo

El programa de invocación emite el Set_TP_Name llamada (nombre de función cmstpn) para especificar el nombre del programa asociado (invocable). Esta llamada invalida el nombre del programa 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 la llamada de asignación . La emisión de esta llamada no tiene ningún efecto en la propia información del lado.

Sintaxis

  
CM_ENTRY Set_TP_Name(   
  unsigned char FAR *conversation_ID,    
    unsigned char FAR *TP_name,            
    CM_INT32 FAR *TP_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.

TP_name
Parámetro proporcionado. Especifica la dirección inicial del nombre del programa asociado. El nombre del programa puede contener hasta 64 caracteres ASCII. Los caracteres permitidos son:

  • Mayúsculas y minúsculas.

  • Números de 0 a 9.

  • Caracteres especiales, excepto el espacio.

    No puede usar Set_TP_Name para especificar el nombre de un programa de transacciones de servicio SNA (TP). Sin embargo, puede usar Set_CPIC_Side_Information para hacerlo.

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

    TP_name_length
    Parámetro proporcionado. Especifica la longitud del nombre del programa asociado. El intervalo es 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_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 TP_name_length está fuera del intervalo (mayor que 64 o menor que 1).

  • La dirección de una variable no es válida.

    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.