MC_GET_ATTRIBUTES
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
傳回的參數。 指定 SNA 網路的名稱，其中包含此 TP 所使用的本機邏輯單元 (LU) 。 它是一種類型 A EBCDIC 字元字串。
lu_name
傳回的參數。 提供本機 LU 的名稱。
lu_alias
傳回的參數。 提供本機 TP 已知本機 LU 的別名。 它是 ASCII 字元字串。
plu_alias
傳回的參數。 提供本機 TP 已知合作夥伴 LU 的別名。 它是 ASCII 字元字串。
plu_un_name
傳回的參數。 指定合作夥伴 LU 的未解譯名稱，也就是定義為系統服務控制點的合作夥伴 LU 名稱， (SSCP) 。 它是 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 & AP_EXTD_VCB) ！= 0 設定高位的 opext 時，會出現下列欄位。只有在使用同步點層級 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 發出此動詞時除外。
沒有狀態變更。