Set_CPIC_Side_Information (CPI-C)
La llamada Set_CPIC_Side_Information (nombre de función xcmssi) agrega o reemplaza una entrada de información lateral en la memoria. Una entrada de información del lado CPI-C asocia un conjunto de características de conversación con un nombre de definición simbólica. Esta llamada invalida las entradas que tienen el mismo nombre de destino simbólico.
Sintaxis
CM_ENTRY Set_CPIC_Side_Information(
unsigned char FAR *key_lock,
SIDE_INFO FAR *side_info_entry,
CM_INT32 FAR *side_info_entry_length,
CM_INT32 FAR *return_code
);
Parámetros
key_lock
Parámetro proporcionado. Este parámetro se ignora.
side_info_entry
Parámetro proporcionado. Especifica el contenido de una entrada de información lateral. En la tabla siguiente se describe la estructura side_info_entry , que define el formato de la entrada de información lateral.
| Offset | Descripción | Tipo | Length |
|---|---|---|---|
| 0 | sym_dest_name | unsigned char | 8 bytes |
| 8 | partner_LU_name | unsigned char | 17 bytes |
| 25 | reserved | unsigned char | 3 bytes |
| 28 | TP_name_type | signed long int | 32 bits |
| 32 | TP_name | unsigned char | 64 bytes |
| 96 | mode_name | unsigned char | 8 bytes |
| 104 | conversation_ security_type | signed long int | 32 bits |
| 108 | security_user_ID | unsigned char | 8 bytes |
| 116 | security_password | unsigned char | 8 bytes |
Los caracteres permitidos para sym_dest_name son las letras mayúsculas (A a Z) y los números de 0 a 9.
Set_CPIC_Side_Information es la única llamada CPI-C que le permite especificar un programa de transacciones de servicio SNA (TP) como programa asociado. La convención de SNA para asignar un nombre a un TP de servicio es de hasta cuatro caracteres. El primer carácter es un byte hexadecimal entre 0x00 y 0x3F. Los caracteres restantes se traducen de ASCII a EBCDIC.
Para ver los caracteres permitidos para los demás campos, vea la descripción de la llamada Set_ correspondiente. Por ejemplo, para el campo mode_name , vea la descripción de la llamada Set_Mode_Name .
Cada campo de la estructura debe estar alineado a la izquierda. Rellenar los campos de la derecha con espacios según sea necesario.
side_info_entry_length
Parámetro proporcionado. Especifica la longitud de side_info_entry. Siempre es 124.
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:
Un valor especificado en la estructura side_info_entry no es válido.
El carácter izquierdo del side_info_entry contiene 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 puede estar en cualquier estado.
No hay ningún cambio de estado.
Comentarios
No se detectan parámetros de cadena no válidos en la información lateral (por ejemplo, especificando una unidad lógica de asociado (LU) inexistente hasta que se emite Allocate . El error se devuelve en una llamada siguiente a Allocate.