MC_SEND_CONVERSATION

發行項
07/21/2023

MC_SEND_CONVERSATION動詞會在本機邏輯單元 (LU) 和夥伴 LU 之間配置會話、傳送會話上的資料，然後解除配置會話。

下列結構描述MC_SEND_CONVERSATION動詞命令所使用的動詞控制區塊 (VCB ) 。

語法

  
struct mc_send_conversation {  
    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[8];  
    unsigned char       rtn_ctl;  
    unsigned char       reserv4;  
    unsigned long       conv_group_id;  
    unsigned long       sense_data;  
    unsigned char       plu_alias[8];  
    unsigned char       mode_name[8];  
    unsigned char       tp_name[64];  
    unsigned char       security;  
    unsigned char       reserv6[11];  
    unsigned char       pwd[10];  
    unsigned char       user_id[10];  
    unsigned short      pip_dlen;  
    unsigned char FAR * pip_dptr;  
    unsigned char       reserv6;  
    unsigned char       fqplu_name[17];  
    unsigned char       reserv7[8];  
    unsigned short      dlen;  
    unsigned char FAR * dptr;  
};

成員

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

opext
提供的參數。指定動詞操作延伸模組，AP_MAPPED_CONVERSATION。

reserv2
保留字段。

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

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

tp_id
提供的參數。識別 TP) (本機交易程式。此參數的值是由 TP_STARTED傳回。

conv_id
提供的參數。提供交談識別碼。

叫用 TP 中的 MC_ALLOCATE 或叫用 TP 中的 RECEIVE_ALLOCATE ，會傳回此參數的值。

rtn_ctl
提供的參數。指定 APPC 應該如何選取要配置給交談的會話，以及本機 LU 何時應該將控制權傳回本機 TP。允許的值包括：

AP_IMMEDIATE指定 LU 會配置爭用者會話，如果立即可用，則會將控制權傳回給 TP。
AP_WHEN_SESSION_ALLOCATED指定在配置會話或遇到本主題傳回碼中所述的其中一個錯誤之前，LU 不會將控制權傳回 TP。如果會話限制為零，LU 會立即傳回控制項。請注意，如果會話無法使用，TP 會等候一個會話。
AP_WHEN_SESSION_FREE指定 LU 配置爭用成功者或爭用-loser 會話，如果有一個或能夠啟用，並將控制權傳回給 TP。如果發生錯誤 (如本主題的傳回碼中所述，) 呼叫會立即傳回 ，並在primary_rc 和 secondary_rc 欄位中立即傳回錯誤。
AP_WHEN_CONWINNER_ALLOC指定在配置爭用者會話之前，LU 不會傳回控制權，或遇到本主題中傳回碼中所述的其中一個錯誤。如果會話限制為零，LU 會立即傳回控制項。請注意，如果會話無法使用，TP 會等候一個會話。
AP_WHEN_CONV_GROUP_ALLOC指定在配置 conv_group_id 指定的會話之前，LU 不會將控制權傳回給 TP，或遇到本主題中傳回碼中所述的其中一個錯誤。如果會話無法使用，TP 會等候它變成免費。

conv_group_id
提供/傳回的參數。當 rtn_ctl WHEN_CONV_GROUP_ALLOC指定應配置會話之交談群組的身分識別時，用來做為提供的參數。當 rtn_ctl 指定不同的值，且 primary_rc AP_OK時，這是傳回的值。此參數的目的是要提供 TP，以確保會重新配置相同的會話，因此在會話上執行的交談會以起始的相同順序發生。

sense_data
傳回的參數。如果主要和次要傳回碼指出配置錯誤， (重試或無重試) ，則會傳回 SNA 定義的感知碼。

plu_alias
提供的參數。指定本機 TP 已知合作夥伴 LU 的別名。此參數必須符合設定期間建立的夥伴 LU 名稱。參數是 8 位元組的型別 G ASCII 字元集，其中包含：
大寫字母
數位 0 到 9
空格
特殊字元 $、#、% 和@

如果此參數的值少於八個位元組，請使用 ASCII 空格 (0x20) 將它填補在右側。

mode_name
提供的參數。指定組態期間定義的一組網路特性名稱。此參數必須符合設定期間與夥伴 LU 相關聯的模式名稱。

參數是 8 位元組的 EBCDIC 字元字串。它可以包含來自 A EBCDIC 字元集類型的字元，包括所有 EBCDIC 空格。這些字元包括：
大寫字母
數位 0 到 9
特殊字元 $、#和@

字串中的第一個字元必須是大寫字母或特殊字元。

在對應的交談中，名稱不能是 SNASVCMG， (APPC) 內部使用的保留模式名稱。

tp_name
提供的參數。指定叫用 TP 的名稱。叫用 TP 中MC_ALLOCATE所指定的tp_name值必須符合所叫用 TP 中RECEIVE_ALLOCATE所指定的tp_name值。

參數是 64 位元組、區分大小寫的 EBCDIC 字元字串。此參數可以包含來自 AE EBCDIC 字元集類型的字元。這些字元包括：
大寫和小寫字母
數位 0 到 9
特殊字元 $、#、@和句號 (.)

如果 TP 名稱少於 64 個位元組，請使用 EBCDIC 空格 (0x40) 在右側填補。

SNA 慣例是服務 TP 名稱最多可以有四個字元。第一個字元是0x00與0x3F之間的十六進位位元組。其他字元來自 EBCDIC AE 字元集。

安全
提供的參數。指定合作夥伴 LU 需要的資訊，以驗證對所叫用 TP 的存取權。
AP_NONE指定叫用的 TP 不會使用交談安全性。
AP_PGM指定叫用的 TP 使用交談安全性，而且需要使用者識別碼和密碼。使用 user_id 和 pwd 來提供這項資訊。
AP_SAME指定使用有效使用者識別碼和密碼叫用的叫用 TP，接著會叫用另一個 TP。

例如，假設 TP A 會叫用具有有效使用者識別碼和密碼的 TP B，而 TP B 接著會叫用 TP C。如果 TP B 指定值AP_SAME，APPC 會將 TP A 的使用者識別碼和已驗證的指標傳送給 TP C 的 LU。如果 TP C 設定為接受已驗證的指標) ，則此指標表示 TP C 不需要密碼 (。

pwd
提供的參數。指定與 user_id相關聯的密碼。只有在安全性參數設定為 AP_PGM，且必須符合設定期間所建立 之user_id 的密碼時，才需要此參數。

此參數是 10 位元組、區分大小寫、EBCDIC 字元字串。它可以由 AE EBCDIC 字元集類型的字元組成。這些字元包括：
大寫和小寫字母
數位 0 到 9
特殊字元 $、#、@和 period (.)

如果密碼少於 10 個位元組，請使用 EBCDIC 空格 (0x40) 將它放在右邊。

user_id
提供的參數。指定存取合作夥伴 TP 所需的使用者識別碼。只有在安全性參數設定為 AP_PGM，且必須符合針對合作夥伴 TP 設定的其中一個使用者識別碼時，才需要此參數。

參數可以包含來自 AE EBCDIC 字元集類型的字元。這些字元包括：
大寫和小寫字母
數位 0 到 9
特殊字元 $、#、@和 period (.)

如果使用者識別碼少於 10 個位元組，請使用 EBCDIC 空格 (0x40) 將它放在右邊。

pip_dlen
提供的參數。指定要傳遞至合作夥伴 TP 的 PIP 長度。此參數的範圍是從 0 到 32767。

pip_dptr
提供的參數。指定包含 PIP 資料的緩衝區位址。只有在 pip_dlen 大於零時，才使用此參數。

PIP 資料可以包含合作夥伴 TP 或遠端作業系統所需的初始化參數或環境設定資訊。 PIP 資料必須遵循 GDS 格式。如需詳細資訊，請參閱 IBM SNA 手動 (s) 。

針對 Microsoft Windows 作業系統，資料緩衝區可以位於靜態資料區域或全域配置的區域中。

fqplu_name
提供的參數。指定本機 LU 的完整名稱。此參數必須符合遠端節點中所定義之本機 LU 的完整名稱。參數是由兩種類型的 EBCDIC 字元字串所組成， (最多八個字元) ，也就是 NETID) 的網路名稱 (，以及夥伴 LU 的 LU 名稱。這些名稱會以 EBCDIC 句號分隔 (.) 。您可以省略 NETID，如果這是這種情況，也應該省略句點。

如果未提供 plu_alias ，則必須提供此名稱。

輸入 EBCDIC 字元包含：
大寫字母
數位 0 到 9
特殊字元 $、#和@

如果此參數的值少於 17 個位元組，請在右側加上 EBCDIC 空格 (0x40) 。

dlen
提供的參數。指定要放在本機 LU 傳送緩衝區中的資料位元組數目。此參數的範圍是從 0 到 65535。

dptr
提供的參數。指定要放入本機 LU 傳送緩衝區之資料的緩衝區位址。

針對 Windows 作業系統，資料緩衝區可以位於靜態資料區域或全域配置的區域中。資料緩衝區必須完全符合這個區域。

傳回碼

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

AP_UNSUCCESSFUL
主要傳回碼;提供的參數 rtn_ctl 指定的控制項立即傳回給 TP (AP_IMMEDIATE) ，而本機 LU 沒有可用的爭用勝者會話。

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

AP_BAD_RETURN_CONTROL

次要傳回碼;指定 給 rtn_ctl 的值無效。

AP_BAD_SECURITY

次要傳回碼;為 安全性 指定的值無效。

AP_BAD_TP_ID

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

AP_PIP_LEN_INCORRECT

次要傳回碼; pip_dlen 的值大於 32767。

AP_UNKNOWN_PARTNER_MODE

次要傳回碼;指定 給 mode_name 的值無效。

AP_BAD_PARTNER_LU_ALIAS

次要傳回碼，APPC 無法辨識提供的 partner_lu_alias。

AP_NO_USE_OF_SNASVCMG

次要傳回碼;SNASVCMG 不是 mode_name的有效值。

AP_INVALID_DATA_SEGMENT

次要傳回碼;PIP 資料或應用程式資料超過配置的資料區段，或資料緩衝區的位址錯誤。

AP_ALLOCATION_ERROR
主要傳回碼;APPC 無法配置交談。交談狀態會設定為 RESET。

此程式碼可以透過 MC_ALLOCATE之後發出的動詞傳回。

AP_ALLOCATION_FAILURE_NO_RETRY

次要傳回碼;因為有永久條件，例如組態錯誤或會話通訊協定錯誤，所以無法配置交談。若要判斷錯誤，系統管理員應該檢查錯誤記錄檔。在修正錯誤之前，請勿重試配置。

AP_ALLOCATION_FAILURE_RETRY

次要傳回碼;因為暫時性狀況，例如連結失敗，所以無法配置交談。失敗的原因會記錄在系統錯誤記錄檔中。重試配置。

AP_COMM_SUBSYSTEM_ABENDED
主要傳回碼;指出下列其中一個條件：

此交談所使用的節點遇到 ABEND。
TP 與 PU 2.1 節點之間的連線已中斷， (LAN 錯誤) 。
TP 電腦的 SnaBase 遇到 ABEND。

系統管理員應該檢查錯誤記錄檔，以判斷 ABEND 的原因。

AP_COMM_SUBSYSTEM_NOT_LOADED
主要傳回碼;無法載入必要的元件，或在處理動詞時終止。因此，無法進行通訊。請連絡系統管理員以採取更正動作。

當此傳回碼與 MC_ALLOCATE搭配使用時，可能表示找不到任何通訊系統來支援本機 LU。 (例如，以 TP_STARTED 指定的本機 LU 別名不正確或尚未設定。) 請注意，如果 lu_alias 或 mode_name 少於八個字元，您必須確定這些欄位會填入右邊的空格。如果這些參數未填滿空格，就會傳回此錯誤，因為沒有任何節點可滿足 MC_ALLOCATE 要求。

當MC_ALLOCATE針對以多個節點設定的主機整合伺服器用戶端系統產生此傳回碼時，有兩個次要傳回碼，如下所示：

0xF0000001

次要傳回碼;尚未啟動任何節點。

0xF0000002

次要傳回碼;至少有一個節點已啟動，但未在任何作用中節點上設定TP_STARTED發出 ) 時，本機 LU (。問題可能是下列其中一項：
未啟動具有本機 LU 的節點。
未設定本機 LU。

AP_INVALID_VERB_SEGMENT
主要傳回碼;延伸超過資料區段結尾的 VCB。

AP_STACK_TOO_SMALL
主要傳回碼;應用程式的堆疊大小太小，無法執行動詞。增加應用程式的堆疊大小。

AP_CONV_BUSY
主要傳回碼;在任何交談上一次只能有一個未完成的交談動詞。如果本機 TP 有多個執行緒，而且多個執行緒會使用相同的 conv_id發出 APPC 呼叫，就會發生這種情況。

AP_THREAD_BLOCKING
主要傳回碼;呼叫執行緒已經在封鎖呼叫中。

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

備註

叫用 TP 以與遠端 TP 進行整個交談時，會發出這個動詞。如果遠端 TP 拒絕交談起始或資料，則叫用 TP 將不會收到拒絕的通知。

當 TP 發出此動詞時，交談狀態為 RESET。沒有狀態變更。

MC_SEND_CONVERSATION的數個參數是 EBCDIC 或 ASCII 字串。 TP 可以使用一般服務動詞 (CSV) CONVERT ，將字串從一個字元集轉譯到另一個字元。

一般而言， mode_name 的值必須符合針對所叫用 TP 節點所設定的模式名稱，並在設定期間與夥伴 LU 相關聯。如果叫用 TP 節點上的其中一個與夥伴 LU 相關聯的模式是隱含模式，當與夥伴 LU 相關聯的模式名稱不符合 mode_name的值時，這兩個 RU 之間的會話將會是隱含模式。

共用方式為

MC_SEND_CONVERSATION

語法

成員

傳回碼

備註

其他資源