TP_STARTED
叫用交易程式 (TP) 發出 TP_STARTED 動詞，並通知 APPC TP 正在啟動。
針對 Microsoft® Windows® 第 3 版。x 系統，建議您使用 WinAsyncAPPC 函式，而不是此呼叫的封鎖版本。
下列結構描述 TP_STARTED 動詞動詞所使用的動詞控制項區塊。
語法
struct tp_started {
unsigned short opcode;
unsigned char opext;
unsigned char reserv2;
unsigned short primary_rc;
unsigned long secondary_rc;
unsigned char lu_alias[8];
unsigned char tp_id[8];
unsigned char tp_name[64];
unsigned char syncpoint_rqd;
};
成員
opcode
提供的 參數。 指定動詞作業程式碼，AP_TP_STARTED。
opext
提供的 參數。 指定動詞操作延伸模組。 如果已設定AP_EXTD_VCB位，這表示 tp_started 結構包含用於同步點支援的 syncpoint_rqd 成員。 否則，動詞控制項區塊會在 tp_name 成員之後立即結束。
reserv2
保留字段。
primary_rc
傳回的參數。 指定 APPC 在動詞完成時所設定的主要傳回碼。 有效的傳回碼會隨著發出的 APPC 動詞而有所不同。 如需此動詞的有效錯誤碼，請參閱傳回碼。
secondary_rc
傳回的參數。 指定 APPC 在動詞完成時所設定的次要傳回碼。 有效的傳回碼會隨著發出的 APPC 動詞而有所不同。 如需此動詞的有效錯誤碼，請參閱傳回碼。
lu_alias
提供的 參數。 指定本機 TP 已知本機 LU 的別名。
名稱必須符合設定期間建立的 LU 別名。 APPC 會根據目前的主機整合伺服器組態檔檢查 LU 別名。 不過，由於主機整合伺服器所使用的用戶端/伺服器架構，在執行 ALLOCATE 或 MC_ALLOCATE 之前，不會驗證此參數。
此參數是 8 位元組的 ASCII 字元字串。 它可以包含下列 ASCII 字元：
大寫字母
從 0 到 9 的數位
空格
特殊字元 $、#、% 和@
此字串的第一個字元不能是空格。
如果此參數的值長度小於 8 個位元組，請使用 ASCII 空格 (0x20) 將它放在右邊。
若要使用預設 LU 集區的 LU，請將此欄位設定為八個十六進位零。 如需詳細資訊，請參閱 預設 LU。
tp_id
傳回的參數。 識別新建立的 TP。
tp_name
提供的 參數。 指定本機 TP 的名稱。
在 APPC 的主機整合伺服器實作下，TP_STARTED發出時，會忽略此參數。 不過，如果程式在 APPC 的 IBM ES/2 1.0 版實作下執行，則需要此參數。
此參數是 64 位元組的 EBCDIC 字元字串，而且區分大小寫。 tp_name參數可以包含下列 EDCDIC 字元：
大寫和小寫字母
從 0 到 9 的數位
特殊字元 $、#、@和 period (.)
如果 TP 名稱長度少於 64 個位元組，請使用 EBCDIC 空格 (0x40) 將它放在右邊。
服務 TP 名稱的 SNA 慣例最多為四個字元。 第一個字元是0x00與0x3F之間的十六進位位元組。
syncpoint_rqd
只有在 opext 參數中設定AP_EXTD_VCB位，而且需要同步點服務時，才適用這個選擇性參數。
- 如果需要同步點，AP_YES。
- 如果不需要同步點，AP_NO。
傳回碼
AP_OK
主要傳回碼;成功執行動詞。
AP_COMM_SUBSYSTEM_ABENDED
主要傳回碼;指出下列其中一個條件：
此交談所使用的節點遇到 ABEND。
TP 與 PU 2.1 節點之間的連線已中斷， (LAN 錯誤) 。
TP 電腦的 SnaBase 遇到 ABEND。
系統管理員應該檢查錯誤記錄檔，以判斷 ABEND 的原因。
AP_COMM_SUBSYSTEM_NOT_LOADED
主要傳回碼;處理動詞時，無法載入或終止必要的元件。 因此，無法進行通訊。 請連絡系統管理員以採取更正動作。
AP_INVALID_VERB_SEGMENT
主要傳回碼;延伸超過資料區段結尾的 VCB。
AP_STACK_TOO_SMALL
主要傳回碼;應用程式的堆疊大小太小，無法執行動詞。 增加應用程式的堆疊大小。
AP_TP_BUSY
主要傳回碼;本機 TP 已發出 APPC 的呼叫，而 APPC 正在處理相同 TP 的另一個呼叫。
AP_THREAD_BLOCKING
主要傳回碼;呼叫執行緒已經在封鎖呼叫中。
AP_UNEXPECTED_DOS_ERROR
主要傳回碼;作業系統在處理來自本機 TP 的 APPC 呼叫時，已將錯誤傳回給 APPC。 作業系統傳回碼會透過 secondary_rc傳回。 它會以 Intel 位元組交換的順序顯示。 如果問題持續發生，請洽詢系統管理員。
備註
為了回應 TP_STARTED，APPC會產生叫用 TP 的 TP 識別碼。 此識別碼是叫用 TP 所發出後續 APPC 動詞的必要參數。
這必須是叫用 TP 所發出的第一個 APPC 動詞。 因此，沒有先前的 APPC 狀態存在。
如果動詞執行成功 (primary_rc AP_OK) ，狀態會變更為 RESET。