RECEIVE_ALLOCATE
RECEIVE_ALLOCATE動詞是由叫用的交易程式發出， (TP) ，以確認叫用的 TP 已準備好開始與發出ALLOCATE或MC_ALLOCATE的叫用 TP 交談。
下列結構描述動詞控制項區塊 (RECEIVE_ALLOCATE動詞指令動詞所使用的 VCB ) 。
語法
struct receive_allocate {
unsigned short opcode;
unsigned char opext;
unsigned char reserv2;
unsigned short primary_rc;
unsigned long secondary_rc;
unsigned char tp_name[64];
unsigned char tp_id[8];
unsigned long conv_id;
unsigned char sync_level;
unsigned char conv_type;
unsigned char user_id[10];
unsigned char lu_alias[8];
unsigned char plu_alias[8];
unsigned char mode_name[8];
unsigned char reserv3[2];
unsigned long conv_group_id;
unsigned char fqplu_name[17];
unsigned char pip_incoming;
unsigned char syncpoint_rqd;
unsigned char reserv4[3];
};
成員
opcode
提供的 參數。 指定動詞作業程式碼，AP_RECEIVE_ALLOCATE。
opext
提供的 參數。 指定動詞作業延伸模組，AP_BASIC_CONVERSATION。
reserv2
保留字段。
primary_rc
傳回的參數。 指定 APPC 在動詞完成時所設定的主要傳回碼。 有效的傳回碼會隨著發出的 APPC 動詞而有所不同。 如需此動詞的有效錯誤碼，請參閱傳回碼。
secondary_rc
傳回的參數。 指定 APPC 在動詞完成時所設定的次要傳回碼。 有效的傳回碼會隨著發出的 APPC 動詞而有所不同。 如需此動詞的有效錯誤碼，請參閱傳回碼。
tp_name
提供的 參數。 提供本機 TP 的名稱。 tp_name的值必須符合透過登錄或環境變數設定的 TP 名稱。 APPC 會比對 RECEIVE_ALLOCATE 動詞動詞的 tp_name 參數與傳入配置所指定的 TP 名稱，該參數是由叫用 TP 中的 MC_ALLOCATE 或 ALLOCATE 所產生。
此參數是 64 位元組的 EBCDIC 字元字串，而且區分大小寫。 tp_name參數可以包含來自 AE EBCDIC 字元集類型的字元：
大寫和小寫字母
數位 0 到 9
特殊字元 $、#和 period (.)
如果 tp_name 少於 64 個位元組，請使用 EBCDIC 空格 (0x40) 將它放在右邊。
SNA 慣例是服務 TP 名稱最多可以有四個字元。 第一個字元是0x00與0x3F之間的十六進位位元組。 其他字元來自 AE EBCDIC 字元集類型。
tp_id
傳回的參數。 識別本機 TP。conv_id
傳回的參數。 提供交談識別碼。 它會識別兩個合作夥伴 TP 之間建立的對話 APPC。sync_level
傳回的參數。 指定交談的同步處理層級。 它會判斷 TP 是否可以要求確認資料收據，以及確認資料回條。AP_NONE指定不會在此交談中使用確認處理。
AP_CONFIRM_SYNC_LEVEL指定 TP 可以在此交談中使用確認處理。
AP_SYNCPT指定 TP 可以在此交談中使用同步點層級 2 確認處理。
conv_type
傳回的參數。 使用 MC_ALLOCATE 或 ALLOCATE，指定合作夥伴 TP 所選擇的交談類型。 以下是可能的值：AP_BASIC_CONVERSATION
AP_MAPPED_CONVERSATION
user_id
傳回的參數。 如果合作夥伴 TP 將MC_ALLOCATE或ALLOCATE動詞的安全性參數設定為AP_PGM或AP_SAME) ，則提供合作夥伴 TP 所指定的使用者識別碼，方法是使用MC_ALLOCATE或ALLOCATE (。 它是 AE EBCDIC 字元字串類型。lu_alias
傳回的參數。 提供本機邏輯單元 (LU) 已知為本機 TP 的別名。 它是 ASCII 字元字串。plu_alias
傳回的參數。 提供合作夥伴 LU (起始傳入配置的別名，) 本機 TP 已知。 它是 ASCII 字元字串。mode_name
傳回的參數。 提供合作夥伴 TP 中 MC_ALLOCATE 或 ALLOCATE 所指定的模式名稱。 這是組態期間定義的一組網路特性名稱。 mode_name是 EBCDIC 字元字串類型。reserv3
保留字段。conv_group_id
交談群組識別碼。fqplu_name
這個傳回的參數會提供完整的 LU 名稱。pip_incoming
只有在需要 Sync Point 服務時，才適用這個選擇性提供和傳回的參數。針對提供的 參數：
如果 TP 接受 PIP 資料，AP_YES。
如果 TP 不接受 PIP 資料，AP_NO。
針對傳回的參數：
如果有 PIP 資料可用，AP_YES。
如果無法使用 PIP 資料，AP_NO。
syncpoint_rqd
此參數指出是否需要同步點服務。如果需要同步點，AP_YES。
如果不需要同步點，AP_NO。
reserv4
保留字段。
傳回碼
AP_OK
主要傳回碼;成功執行動詞。
AP_PARAMETER_CHECK
主要傳回碼;動詞未執行，因為發生參數錯誤。
AP_UNDEFINED_TP_NAME
次要傳回碼;未正確設定 TP 名稱。
AP_STATE_CHECK
主要傳回碼;指令動詞未執行，因為發出狀態無效。
AP_ALLOCATE_NOT_PENDING
次要傳回碼;APPC 找不到來自叫用 TP) 的傳入配置 (，以符合RECEIVE_ALLOCATE所提供的tp_name值。 RECEIVE_ALLOCATE 等候傳入配置，最後逾時。
AP_INVALID_PROCESS
次要傳回碼;發行 程式RECEIVE_ALLOCATE 與 APPC 所啟動的程式不同。
AP_COMM_SUBSYSTEM_ABENDED
主要傳回碼;表示下列其中一個條件：
此交談所使用的節點遇到 ABEND。
TP 與 PU 2.1 節點之間的連線已中斷， (LAN 錯誤) 。
TP 電腦上的 SnaBase 遇到 ABEND。
系統管理員應該檢查錯誤記錄檔，以判斷 ABEND 的原因。
AP_CONV_BUSY
主要傳回碼;在任何交談上一次只能有一個未完成的交談動詞。AP_THREAD_BLOCKING
主要傳回碼;呼叫執行緒已經在封鎖呼叫中。AP_COMM_SUBSYSTEM_NOT_LOADED
主要傳回碼;處理動詞時，無法載入或終止必要的元件。 因此，無法進行通訊。 請連絡系統管理員以取得更正動作。AP_INVALID_VERB_SEGMENT
主要傳回碼;超出資料區段結尾的 VCB。AP_STACK_TOO_SMALL
主要傳回碼;應用程式的堆疊大小太小，無法執行動詞。 增加應用程式的堆疊大小。AP_UNEXPECTED_DOS_ERROR
主要傳回碼;作業系統在處理來自本機 TP 的 APPC 呼叫時，已將錯誤傳回給 APPC。 作業系統傳回碼會透過 secondary_rc傳回。 它會以 Intel 位元組交換的順序顯示。 如果問題持續發生，請洽詢系統管理員。
備註
這必須是所叫用 TP 所發出的第一個 APPC 動詞。 初始狀態為 RESET。 如果動詞執行成功 (primary_rc AP_OK) ，狀態會變更為 RECEIVE。
為了回應此動詞，APPC 會建立兩個 TP 之間的交談，並為叫用的 TP 和交談識別碼產生 TP 識別碼。 這些識別碼是後續 APPC 動詞命令的必要參數。
如果叫用的 TP 問題 RECEIVE_ALLOCATE 和對應的傳入配置 (由叫用 TP) 發出的 MC_ALLOCATE 或 ALLOCATE 所產生，則叫用的 TP 會等到傳入配置到達或動詞逾時為止。逾時值是由系統管理員所設定。
主機整合伺服器也支援 APPC RECEIVE_ALLOCATE_EX和RECEIVE_ALLOCATE_EX_END函式，以簡化某些可叫用交易程式的設計和實作。 此函式可讓 APPC 應用程式接收主機整合伺服器透過特定本機 APPC LU 接收的所有傳入 FMH-5 附加要求，讓應用程式可作為「附加管理員」。附加管理員是處理傳入 FMH-5 Attach 要求以啟動 LU6.2 交談的程式。 當 APPC 應用程式呼叫 RECEIVE_ALLOCATE (而不是RECEIVE_ALLOCATE_EX) 時，主機整合伺服器會處理附加管理員功能。
如需附加管理員的詳細資訊，請參閱 RECEIVE_ALLOCATE_EX。