Compartir a través de

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ólico. Esta llamada invalida las entradas que tienen el mismo nombre simbólico de destino.

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.

Compensar Descripción Tipo Largura
0 sym_dest_name unsigned char 8 bytes
8 partner_LU_name unsigned char 17 bytes
25 reservado unsigned char 3 bytes
28 TP_name_type signo long int 32 bits
32 TP_name unsigned char 64 bytes
96 mode_name unsigned char 8 bytes
104 conversation_ security_type signo 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 de partners. La convención de SNA para asignar un nombre a un TP de servicio tiene 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 los caracteres permitidos para los otros campos, vea la descripción de la llamada de 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.

Observaciones

No se detectan parámetros de cadena no válidos en la información lateral (por ejemplo, si se especifica una unidad lógica de asociado (LU) inexistente hasta que se emite La asignación . El error se devuelve en una llamada después de Asignar.

  • Last updated on