Share via

Set_Log_Data (CPI-C)

  • 發行項

Set_Log_Data呼叫 (函式名稱cmsld) 會指定記錄訊息 (記錄資料) ，以及傳送至 LU) (夥伴邏輯單元的長度。 只有基本交談才允許此呼叫。 它會覆寫預設記錄資料，也就是 Null，以及預設記錄資料長度，也就是零。

語法

  
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              
);

參數

conversation_ID
提供的參數。 指定交談的識別碼。 此參數的值是由 Initialize_Conversation 或 Accept_Conversation傳回。

log_data
提供的參數。 指定要傳送給夥伴 LU 之資料的起始位址。 最多可以包含 512 個 ASCII 字元。 允許的字元為：

  • 大寫和小寫字母。

  • 數位從 0 到 9。

  • 特殊字元。

  • 空格。

    log_data_length
    提供的參數。 指定記錄資料的長度。 範圍是從 0 到 512 個位元組。

    長度為 0 表示沒有記錄資料，而且會忽略 log_data 參數。

    return_code
    從這個呼叫傳回的程式碼。 本主題稍後會列出有效的傳回碼。

傳回碼

CM_OK
主要傳回碼;已成功執行呼叫。

CM_PROGRAM_PARAMETER_CHECK
主要傳回碼;發生下列其中一項：

  • conversation_ID指定的值無效。

  • 交談類型會設定為對應。

  • log_data_length指定的值超出範圍 (大於 512 或小於 0) 。

    CM_PRODUCT_SPECIFIC_ERROR
    主要傳回碼;發生產品特定的錯誤，並已記錄在產品錯誤記錄檔中。

狀態變更

交談可以處於 RESET 以外的任何狀態。

沒有狀態變更。

備註

當本機程式發出下列其中一個呼叫時，Set_Log_Data指定的記錄資料會傳送給合作夥伴 LU：

  • Send_Error

  • 解除配置 設定為 CM_DEALLOCATE_ABEND 的交談解除配置類型

  • Send_Data 將交談傳送類型設定為 CM_SEND_AND_DEALLOCATE，並將解除配置類型設定為 CM_DEALLOCATE_ABEND

    將記錄資料傳送至夥伴 LU 之後，本機 LU 會將記錄資料重設為 null，並將記錄資料長度設為零。

    CPI-C 會視需要自動將記錄資料從 ASCII 轉換成其他編碼標準，例如 EBCDIC。