TRANSFER_MS_DATA

發行項
10/14/2023

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 動詞命令而有所不同。如需此動詞命令的有效錯誤碼，請參閱傳回碼。

options
提供的參數。開啟或關閉個別位，以指定所需的選項。如果 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
主要傳回碼;這個動詞命令超過允許的同步動詞數目上限。

備註

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

bit	描述
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

語法

成員

傳回碼

備註

其他資源