Initialize_Conversation (CPI-C)

El programa de invocación emite la llamada de Initialize_Conversation ( cminit) de nombre de función para obtener un identificador de conversación de 8 bytes y para establecer los valores iniciales de las características de las conversaciones.

Sintaxis

  
CM_ENTRY Initialize_Conversation(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *sym_dest_name,    
  CM_INT32 FAR *return_code            
);  

Parámetros

conversation_ID
Parámetro devuelto. Especifica el identificador de la conversación. Lo usan las llamadas CPI-C posteriores.

sym_dest_name
Parámetro proporcionado. Especifica el nombre de destino simbólico: el nombre asociado a una entrada de información lateral cargada desde el archivo de configuración o definida por llamadas Set_CPIC_Side_Information .

Este parámetro es una cadena de caracteres ASCII de 8 bytes. Los caracteres permitidos son los siguientes:

• Letras mayúsculas

• Números de 0 a 9

  Este parámetro también se puede establecer en ocho espacios. En este caso, el programa de invocación debe emitir las siguientes llamadas antes de emitir La asignación:

• Set_Mode_Name

• Set_Partner_LU_Name

• Set_TP_Name

  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; el valor especificado por sym_dest_name no coincide con un nombre de destino simbólico en la tabla de información lateral y no es un espacio.

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 está en estado RESET.

Si el return_code es CM_OK, la conversación cambia al estado INITIALIZE. Para otros códigos de retorno, el estado de la conversación permanece sin cambios.

Observaciones

Los valores iniciales son CPI-C valores predeterminados o se derivan de información lateral asociada al nombre de destino simbólico. Para obtener más información sobre los valores iniciales y la información lateral, vea Características iniciales de conversación e información de lado para programas de CPI-C.

Las llamadas de Set_ pueden cambiar los valores iniciales.

Si la información del lado contiene un valor no válido o una llamada de Set_ establece una característica de conversación en un valor no válido, el error se devuelve en la llamada a Allocate .

Si una aplicación de CPI-C intenta invocar más de una conversación simultánea, solo todas las conversaciones usan una sola unidad lógica APPC local (LU). Esto evita que las conversaciones simultáneas entre dos o más LU 6.2 LU dependientes, lo que hace que las llamadas posteriores Initialize_Conversation (CMALLC) esperen a que se desasigne la primera conversación.

Si la aplicación CPI-C necesita invocar más de una conversación simultánea, se debe usar lu 6.2 independiente entre Host Integration Server y el sistema remoto.

Tras la ejecución correcta de esta llamada, CPI-C genera un identificador de conversación. Este identificador es un parámetro necesario para todas las demás llamadas CPI-C emitidas para esta conversación por el programa de invocación.

En circunstancias normales, una aplicación de CPI-C no puede invocar dos conversaciones simultáneas con dos LU de APPC locales diferentes. Hay disponible una clave del Registro que cuando se establece obliga a CPI-C a emitir un nuevo verbo TP_STARTED en cada llamada a Initialize_Conversation (cminit). Esto es necesario para forzar la ubicación de recursos de APPC para cada llamada. La clave del Registro que se debe definir para forzar este comportamiento es la siguiente:

\HKLM\CurrentControlSet\Services\SnaBase\Parameters\Client\GETNEWTPID