共用方式為


Set_Log_Data (CPI-C)

Set_Log_Data呼叫 (函式名稱 cmsld) 會指定要傳送至夥伴邏輯單元的記錄訊息(記錄數據)及其長度。 此呼叫只允許在基本交談中。 它會覆寫默認記錄數據,也就是 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_ConversationAccept_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。