Initialize_Conversation (CPI-C)
El programa de invocación emite el Initialize_Conversation llamada (nombre de función cminit) 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 a 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 Set_CPIC_Side_Information llamadas.
Este parámetro es una cadena de caracteres ASCII de 8 bytes. Los caracteres permitidos son los siguientes:
Letras mayúsculas
Números del 0 al 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:
-
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. En el caso de otros códigos de retorno, el estado de la conversación permanece sin cambios.
Comentarios
Los valores iniciales son los valores predeterminados de CPI-C o se derivan de la 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 lateral para programas CPI-C.
Las llamadas Set_ pueden cambiar los valores iniciales.
Si la información del lado contiene un valor no válido o una llamada Set_ establece una característica de conversación en un valor no válido, el error se devuelve en la llamada Asignación .
Si una aplicación CPI-C intenta invocar más de una conversación simultánea, solo todas las conversaciones usan una única unidad lógica APPC local (LU). Esto evita que las conversaciones simultáneas entre dos o más LU 6.2 LUs dependientes, lo que hace que las llamadas posteriores de 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 mediante el programa de invocación.
En circunstancias normales, una aplicación 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