GET_TP_PROPERTIES

發行項
07/21/2023

GET_TP_PROPERTIES動詞會傳回交易程式的屬性， (TP) 和目前的交易。

下列結構描述 GET_TP_PROPERTIES 動詞動詞所使用的動詞控制項區塊。

語法

  
struct get_tp_properties {  
    unsigned short  opcode;  
    unsigned char   opext;  
    unsigned char   reserv2;  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned char   tp_id[8];  
    unsigned char   tp_name[64];  
    unsigned char   lu_alias[8];  
    unsigned char   luw_id[26];  
    unsigned char   fqlu_name[17];  
    unsigned char   reserve3[10];  
    unsigned char   user_id[10];  
    unsigned char   prot_luw_id[26];  
    unsigned char   pwd[10];  
};

成員

opcode
提供的參數。指定動詞作業程式碼，AP_GET_TP_PROPERTIES。

opext
提供的參數。指定動詞操作延伸模組。如果設定AP_EXTD_VCB位，這表示 get_tp_properties 結構包含用於同步點支援的 prot_luw_id 成員。否則，動詞控制項區塊會在 user_id 成員之後立即結束。

reserv2
保留字段。

primary_rc
傳回的參數。指定 APPC 在動詞完成時所設定的主要傳回碼。有效的傳回碼會隨著發出的 APPC 動詞而有所不同。如需此動詞的有效錯誤碼，請參閱傳回碼。

secondary_rc
傳回的參數。指定 APPC 在動詞完成時所設定的次要傳回碼。有效的傳回碼會隨著發出的 APPC 動詞而有所不同。如需此動詞的有效錯誤碼，請參閱傳回碼。

tp_id
提供的參數。識別本機 TP。在叫用 TP 或叫用的 TP 中RECEIVE_ALLOCATE，TP_STARTED傳回此參數的值。

tp_name
傳回的參數。提供發出動詞之 TP 的 TP 名稱。此名稱會以 64 位元組 EBCDIC 字串的形式傳回，並以 EBCDIC 空格填補右邊。

lu_alias
傳回的參數。提供指派給本機 LU 的別名名稱。它會以 8 位元組的 ASCII 字串的形式傳回，並以 ASCII 空格填補在右邊。

luw_id
傳回的參數。為參與 TP 的交易提供未受保護的邏輯工作單位識別碼。數個 TP 可以涉及交易。這個識別碼會代表起始交易的 TP 指派，允許組成交易的交談以邏輯方式連接。

luw_id可以表示為具有下欄欄位的luw_id_overlay結構：

typedef struct luw_id_overlay { unsigned char fqla_name_len; unsigned char fqla_name[17]; nsigned char instance[6]; unsigned char sequence[2];} LUW_ID_OVERLAY;

luw_id.fqla_name_len

原始 TP 之 LU 完整 LU 名稱的 1 位元組長度。

luw_id.fqla_name

原始 TP 之 LU 的完整名稱。此名稱會以 17 位元組 EBCDIC 字串的形式傳回，其中包含 NETID、句號和 LU 名稱。如果名稱的長度少於 17 個位元組， 則實例 和序號會緊接在後面。 (請注意，因此，您不應該使用 luw_id_overlay 結構的欄位來存取這些值。這些僅提供相容性。)

luw_id.instance

原始 TP 的 LU 唯一產生的 6 位元組字串。

luw_id.sequence

表示工作單位區段的 2 位元組數位。 (如果不支援同步點，則一律會設定為 1。)

如果 luw_id 長度小於 26 個位元組，則會以 EBCDIC 空格填補右邊。

fqlu_name
傳回的參數。提供本機 LU 的完整名稱。此名稱會以 17 位元組 EBCDIC 字串的形式傳回，其中包含 NETID、句號和 LU 名稱。名稱會以 EBCDIC 空格填補右邊。

reserve3
保留字段。

user_id
提供的參數。指出配置要求中起始 TP 所提供的 user_id 。名稱會以 10 位元組的 EBCDIC 字串的形式提供，並以 EBCDIC 空格填補右邊。

prot_luw_id
傳回的參數。如果交談已配置同步處理點，則包含參與 TP 之交易的受保護邏輯工作單位識別碼。

數個 TP 可以涉及交易。這個識別碼會代表起始交易的 TP 指派，允許組成交易的交談以邏輯方式連接。

prot_luw_id可以表示為具有下欄欄位的luw_id_overlay結構：

typedef struct luw_id_overlay { unsigned char fqla_name_len; unsigned char fqla_name[17]; nsigned char instance[6]; unsigned char sequence[2];} LUW_ID_OVERLAY;

luw_id.fqla_name_len

原始 TP 之 LU 完整 LU 名稱的 1 位元組長度。

luw_id.fqla_name

原始 TP 之 LU 的完整名稱。此名稱會以 17 位元組 EBCDIC 字串的形式傳回，其中包含 NETID、句號和 LU 名稱。如果名稱的長度少於 17 個位元組， 則實例 和序號會緊接在後面。 (請注意，因此，您不應該使用 luw_id_overlay 結構的欄位來存取這些值。這些僅提供) 相容性。

luw_id.instance

原始 TP 的 LU 唯一產生的 6 位元組字串。

luw_id.sequence

表示工作單位區段的 2 位元組數位。 (如果不支援同步點，則一律會設定為 1。)

如果 prot_luw_id 長度小於 26 個位元組，則會以 EBCDIC 空格填補右邊。

pwd
提供的參數。包含配置要求中起始 TP 之user_id 的密碼。密碼會以 10 位元組的 EBCDIC 字串的形式提供，並以 EBCDIC 空格填補右邊。

傳回碼

AP_OK
主要傳回碼;成功執行動詞。

AP_PARAMETER_CHECK
主要傳回碼;動詞因為參數錯誤而未執行。

AP_BAD_TP_ID

次要傳回碼; tp_id 的值與 APPC 所指派的 TP 識別碼不符。

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 的另一個呼叫。如果本機 TP 有多個執行緒，而且有多個執行緒使用相同的 tp_id發出 APPC 呼叫，就會發生這種情況。

AP_UNEXPECTED_DOS_ERROR
主要傳回碼;作業系統在處理來自本機 TP 的 APPC 呼叫時，已將錯誤傳回給 APPC。作業系統傳回碼會透過 secondary_rc傳回。它會以 Intel 位元組交換的順序顯示。如果問題持續發生，請洽詢系統管理員。

備註

此動詞與 TP 相關，而不是規格交談，因此 TP 可以發出任何狀態的動詞。沒有狀態變更。

luw_id成員包含fqla_name_len欄位， (源自 TP) 之 LU 的完整 LU 名稱長度， fqla_name (源自 TP) 之 LU 的完整名稱，實例 (由源自 TP) 的 LU 唯一產生，而序列 (一律設定為 1，並指出工作單位) 的區段。

共用方式為

GET_TP_PROPERTIES

語法

成員

傳回碼

備註

其他資源