MC_GET_ATTRIBUTES動詞會傳回交談的屬性。
下列結構描述 MC_GET_ATTRIBUTES 動詞命令所使用的動詞控制區塊 （VCB）。
語法
struct mc_get_attributes {
unsigned short opcode;
unsigned char opext;
unsigned char reserv2;
unsigned short primary_rc;
unsigned long secondary_rc;
unsigned char tp_id[8];
unsigned long conv_id;
unsigned char reserv3;
unsigned char sync_level;
unsigned char mode_name[8];
unsigned char net_name[8];
unsigned char lu_name[8];
unsigned char lu_alias[8];
unsigned char plu_alias[8];
unsigned char plu_un_name[8];
unsigned char reserv4[2];
unsigned char fqplu_name[17];
unsigned char reserv5;
unsigned char user_id[10];
unsigned long conv_group_id;
unsigned char conv_corr_len;
unsigned char conv_corr[8];
unsigned char reserv6[13];
// NOTE: The following fields are present
// when the high bit of opext is set
// (opext & AP_EXTD_VCB) != 0.
unsigned char luw_id[26];
unsigned char sess_id[8];
};
成員
opcode
提供的參數。 指定動詞作業程式代碼，AP_M_GET_ATTRIBUTES。
opext
提供的參數。 指定動詞作業延伸模組，AP_MAPPED_CONVERSATION。
reserv2
保留欄位。
primary_rc
傳回的參數。 指定APPC在動詞完成時設定的主要傳回碼。 有效的傳回碼會根據所發出的APPC動詞而有所不同。 如需這個動詞的有效錯誤碼，請參閱傳回碼。
secondary_rc
傳回的參數。 指定APPC在動詞完成時所設定的次要傳回碼。 有效的傳回碼會根據所發出的APPC動詞而有所不同。 如需這個動詞的有效錯誤碼，請參閱傳回碼。
tp_id
提供的參數。 識別本機交易程式 （TP）。 這個參數的值是由叫用 TP 中的 TP_STARTED 或叫用的 TP 中的 RECEIVE_ALLOCATE 所傳回。
conv_id
提供的參數。 提供交談標識碼。 這個參數的值是由叫用 TP 中的 MC_ALLOCATE 或叫用的 TP 中的 RECEIVE_ALLOCATE 所傳回。
sync_level
傳回的參數。 指定交談的同步處理層級。 此參數會判斷 TP 是否可以要求確認接收數據，以及確認收到數據。
AP_NONE表示不會在此交談中使用確認處理。
AP_CONFIRM_SYNC_LEVEL表示 TP 可以使用此交談中的確認處理。
AP_SYNCPT表示 TP 可以使用此交談中的同步點層級 2 確認處理。
mode_name
傳回的參數。 指定一組網路特性的名稱。 它是類型 A EBCDIC 字元字串。
net_name
傳回的參數。 指定包含這個 TP 所使用之本機邏輯單元 （LU） 的 SNA 網路名稱。 它是類型 A EBCDIC 字元字串。
lu_name
傳回的參數。 提供本機 LU 的名稱。
lu_alias
傳回的參數。 提供本機 TP 已知本機 LU 的別名。 它是 ASCII 字元字串。
plu_alias
傳回的參數。 提供本機 TP 已知夥伴 LU 的別名。 它是 ASCII 字元字串。
plu_un_name
傳回的參數。 指定夥伴 LU 的未解譯名稱，也就是系統服務控制點 （SSCP） 所定義的夥伴 LU 名稱。 它是 AE EBCDIC 字元字串類型。 只有當本機 LU 相依時，才會傳回此參數。
fqplu_name
傳回的參數。 提供夥伴 LU 的完整名稱。 它是類型 A EBCDIC 字元字串。 欄位包含網路名稱、EBCDIC 句號和 partner-LU 名稱。
user_id
傳回的參數。 指定叫用 TP 透過 MC_ALLOCATE 傳送的使用者識別碼，以存取叫用的 TP（如果適用的話）。 它是 AE EBCDIC 字元字串類型。 如果下列條件成立，欄位會包含使用者識別碼：
叫用的 TP 需要對話安全性。
MC_GET_ATTRIBUTES 是由叫用的 TP 所發出。
否則，欄位會包含空格。
conv_group_id
傳回的參數。 指定已配置交談之會話的交談群組標識碼。 這也會在 MC_ALLOCATE 和 RECEIVE_ALLOCATE傳回。conv_corr_len
傳回的參數。 指定傳回之交談相互關聯子標識碼的長度。conv_corr
傳回的參數。 指定來源 LU 指派的交談相互關聯子標識碼（如果有的話），以識別交談，這對來源/夥伴 LU 組而言是唯一的。 它會由來源 LU 在配置要求上傳送。
備註
設定高位 opext 時，會出現下列欄位（opext & AP_EXTD_VCB）！= 0。只有在使用同步點層級 2 支援時才會出現這些欄位。
luw_id
邏輯工作單位標識碼。
sess_id
會話標識碼。
回傳代碼
AP_OK
主要傳回碼;已順利執行動詞。
AP_PARAMETER_CHECK
主要傳回碼;因為參數錯誤而未執行動詞。
AP_BAD_CONV_ID
次要傳回碼; conv_id 的值與 APPC 指派的交談標識碼不符。
AP_BAD_TP_ID
次要傳回碼; tp_id 的值與 APPC 指派的 TP 識別碼不符。
AP_COMM_SUBSYSTEM_ABENDED
主要傳回碼;表示下列其中一個條件：
此交談所使用的節點遇到 ABEND。
TP 與 PU 2.1 節點之間的連線已中斷（LAN 錯誤）。
TP 電腦上的 SnaBase 遇到 ABEND。
系統管理員應該檢查錯誤記錄檔，以判斷 ABEND 的原因。
AP_CONVERSATION_TYPE_MIXED
主要傳回碼;TP 已發出基本和對應的交談動詞。 單一交談中只能發出一個類型。AP_INVALID_VERB_SEGMENT
主要傳回碼;VCB 延伸超過數據區段結尾。AP_STACK_TOO_SMALL
主要傳回碼;應用程式的堆疊大小太小，無法執行動詞。 增加應用程式的堆疊大小。AP_CONV_BUSY
主要傳回碼;在任何交談時，一次只能有一個未完成的交談動詞。 如果本機 TP 有多個線程，而且多個線程使用相同的 conv_id發出 APPC 呼叫，就可能發生此情況。AP_UNEXPECTED_DOS_ERROR
主要傳回碼;從本機 TP 處理 APPC 呼叫時，作系統已將錯誤傳回 APPC。 作系統傳回碼會透過 secondary_rc傳回。 它會以 Intel 位元組交換的順序出現。 如果問題持續發生，請洽詢系統管理員。
備註
當 TP 發出此動詞時，交談可以處於任何狀態，但 TP 發出此動詞時除外。
沒有狀態變更。