Compartir a través de

Set_Log_Data (CPI-C)

  • Artículo

La llamada Set_Log_Data (nombre de función cmsld) especifica un mensaje de registro (datos de registro) y su longitud que se enviará a la unidad lógica (LU) del asociado. Esta llamada solo se permite en conversaciones básicas. Invalida los datos de registro predeterminados, que son null y la longitud predeterminada de los datos de registro, que es cero.

Sintaxis

  
CM_ENTRY Set_Log_Data(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *log_data,           
  CM_INT32 FAR *log_data_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 o Accept_Conversation.

log_data
Parámetro proporcionado. Especifica la dirección inicial de los datos que se van a enviar a la LU del asociado. Puede contener hasta 512 caracteres ASCII. Los caracteres permitidos son:

  • Mayúsculas y minúsculas.

  • Números de 0 a 9.

  • Caracteres especiales.

  • Espacio.

    log_data_length
    Parámetro proporcionado. Especifica la longitud de los datos de registro. El intervalo es de 0 a 512 bytes.

    Una longitud de 0 indica que no hay datos de registro y el parámetro log_data se omite.

    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:

  • El valor especificado por conversation_ID no es válido.

  • El tipo de conversación se establece en asignado.

  • El valor especificado por log_data_length está fuera del intervalo (mayor que 512 o menor que 0).

    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 excepto RESET.

No hay ningún cambio de estado.

Comentarios

Los datos de registro especificados por Set_Log_Data se envían a la LU del asociado cuando el programa local emite una de las siguientes llamadas:

  • Send_Error

  • Desasigne con el tipo de desasignación de conversaciones establecido en CM_DEALLOCATE_ABEND

  • Send_Data con el tipo de envío de conversaciones establecido en CM_SEND_AND_DEALLOCATE y el tipo de desasignación establecido en CM_DEALLOCATE_ABEND

    Después de enviar los datos de registro a la LU del asociado, la LU local restablece los datos de registro en null y la longitud de los datos de registro en cero.

    CPI-C convierte automáticamente los datos de registro de ASCII en otros estándares de codificación, como EBCDIC, según sea necesario.