TRANSFER_MS_DATA

2025-06-05

TRANSFER_MS_DATA動詞會建置 SNA 要求單位，其中包含網路管理向量傳輸（NMVT）數據。動詞命令可以將 NMVT 資料傳送至 NetView，以進行集中式問題診斷和解決。數據會記錄在本機稽核檔案中。

下列結構描述 TRANSFER_MS_DATA 動詞動詞所使用的動詞控制區塊（VCB）。

語法

  
struct transfer_ms_data {  
    unsigned short       opcode;  
    unsigned char        data_type;  
    unsigned char        reserv2;  
    unsigned short       primary_rc;  
    unsigned long        secondary_rc;  
    unsigned char        options;  
    unsigned char        reserv3;  
    unsigned char        origntr_id[8];  
    unsigned short       dlen;  
    unsigned char FAR *  dptr;  
};

成員

opcode
提供的參數。識別作業程式代碼的動詞，SV_TRANSFER_MS_DATA。

data_type
提供的參數。指定這個動詞所提供的資料類型：

使用SV_NMVT產生 NMVT（包括 NS 標頭、主要網路管理向量和子函式）。
使用SV_ALERT_SUBVECTORS產生 RU，其中包含適當格式的警示數據，而不需要 NS 標頭或主要 NMVT 向量。
使用SV_PDSTATS_SUBVECTORS產生 RU，其中包含適當格式的問題判斷統計數據數據，而不需要 NS 標頭或主要 NMVT 向量。
使用SV_USER_DEFINED來產生使用者定義的數據;此數據會記錄在錯誤記錄檔中，但無法在針對診斷設定的連線上傳送系統服務控制點實體單位（SSCP-PU）工作階段。

reserv2
保留欄位。

primary_rc
傳回的參數。指定APPC在動詞完成時設定的主要傳回碼。有效的傳回碼會根據所發出的APPC動詞而有所不同。如需這個動詞的有效錯誤碼，請參閱傳回碼。

secondary_rc
傳回的參數。指定APPC在動詞完成時所設定的次要傳回碼。有效的傳回碼會根據所發出的APPC動詞而有所不同。如需這個動詞的有效錯誤碼，請參閱傳回碼。

選項
提供的參數。開啟或關閉個別位，以指定所需的選項。（如果data_type設定為 SV_USER_DEFINED ，則會忽略位 1、2 和 3。請參閱一節。

reserv3
保留欄位。

origntr_id
提供的參數。指定發行 TRANSFER_MS_DATA元件的名稱。這是選擇性參數。如果您想要讓系統忽略它，請將它設定為0x00。

dlen
提供的參數。指定要提供給這個動詞動詞的數據長度。數據的總長度（使用者提供的數據以及任何新增的標頭或子函式）必須符合一個 RU。 RU 長度上限為 512 個字節。

dptr
提供的參數。指定要傳送之數據的位址。

回傳代碼

SV_OK
主要傳回碼;已順利執行動詞。

SV_PARAMETER_CHECK
主要傳回碼;因為參數錯誤而未執行動詞。

SV_DATA_EXCEEDS_RU_SIZE

次要傳回碼;要傳送的數據太長。使用者提供的數據長度加上標頭和新增的子函式必須符合長度不超過 512 位元組的單一 RU。

SV_INVALID_DATA_SEGMENT

次要傳回碼; dptr 所指向的緩衝區不是可讀取的區段，或延伸超過區段界限。

SV_INVALID_DATA_TYPE

次要傳回碼; data_type 參數包含無效的值。

SV_STATE_CHECK
主要傳回碼;指令動詞未執行，因為發出狀態無效。

SV_SSCP_PU_SESSION_NOT_ACTIVE

次要傳回碼;未傳送 NMVT;SSCP-PU 工作階段未使用中、設定為接收診斷資訊的節點未使用中，或未設定網路管理連線。

SV_COMM_SUBSYSTEM_NOT_LOADED
主要傳回碼;處理動詞時，無法載入或終止必要的元件。因此，無法進行通訊。請連絡系統管理員以採取更正動作。

SV_INVALID_VERB
主要傳回碼; opcode 參數不符合任何動詞的作業程序代碼。未執行動詞。

SV_INVALID_VERB_SEGMENT
主要傳回碼;VCB 延伸超過數據區段結尾。

SV_UNEXPECTED_DOS_ERROR
主要傳回碼;發生下列其中一個情況：

Microsoft Windows作系統在處理動詞時發生錯誤。作系統傳回碼是透過次要傳回碼傳回。如果問題持續發生，請連絡系統管理員以採取更正動作。
CSV 是從發出 Windows SendMessage 函式呼叫的另一個應用程式叫用的訊息循環發出，而不是較常見的 Windows PostMessage 函式呼叫。無法進行動詞處理。
SendMessage 叫用您的應用程式時發出 CSV。您可以使用 InSendMessage Windows API 函數呼叫，判斷是否已使用 SendMessage 叫用應用程式。

SV_CANCELLED
主要傳回碼;當 WinCSVCleanup 呼叫關閉這個程式代碼時，會針對異步動詞傳回。

SV_SERVER_RESOURCE_NOT_FOUND
主要傳回碼;找不到可提供要求函式的通訊伺服器。

SV_SERVER_RESOURCES_LOST
主要傳回碼;提供函式的通訊伺服器因為連線失敗而遺失。

SV_SERVER_CONN_FAILURE

次要傳回碼;伺服器連線因為實體路徑問題而遺失;例如，伺服器可能已關閉電源。

SV_THREAD_BLOCKING
主要傳回碼;這個動詞超過允許的同步動詞最大數目。

備註

若要指定選項，請開啟或關閉位，如下所示：

位元	說明
0	TIME_STAMP_SUBVECTOR。將日期/時間子函式新增至數據。允許的值包括SV_ADD和SV_NO_ADD。
1	PRODUCT_SET_ID_SUBVECTOR。將Product_Set_ID子函式新增至數據。這可讓網路管理服務識別警示的寄件者。允許的值包括SV_ADD和SV_NO_ADD。
2	SSCP_PU_SESSION。如果會話為使用中，則傳送連線上 SSCP-PU 會話上的數據，以進行診斷。（不論數據是在會話上傳送，還是傳回SV_STATE_CHECK或SV_COMM_SUBSYSTEM_NOT_LOADED，都會新增至錯誤記錄檔。允許的值包括SV_SEND和SV_NO_SEND。
3	LOCAL_LOGGING。記錄從錯誤記錄檔擷取並轉送至主機的本機警示。只有在指定選項SV_SEND data_type SV_NMVT或 data_type SV_ALERT_SUBVECTORS 時，此選項才有效。允許的值包括SV_LOG和SV_NO_LOG。
4 到 7	已保留

共用方式為

TRANSFER_MS_DATA

語法

成員

回傳代碼

備註

其他資源