DISPLAY

發行項
07/21/2023

DISPLAY動詞會傳回 SNA 節點的組態資訊和目前的作業值。

建議您使用 GetAppcConfig Windows 擴充功能來取得與 APPC LU 相關的系統設定資訊。特別是，5250 模擬器的使用者應該使用 GetAPPCConfig Windows 擴充功能。

注意

由於用戶端/伺服器架構的本質，主機整合伺服器上的 DISPLAY 動詞實作包含與 IBM Extended Services for OS/2 1.0 版 (IBM ES for OS/2 1.0 版) 的重要差異。

注意

對於在 IBM ES for OS/2 1.0 版相容性模式中使用 APPC DISPLAY動詞的應用程式，而且不使用主機整合伺服器擴充功能來列舉所有作用中的伺服器和連線，除非已在 SNA Manager 中設定特定的預設 DISPLAY 連線，否則主機整合伺服器會隨機播放預設的 DISPLAY連線。此連線會作為所有 DISPLAY 要求的基礎。如需指定預設 DISPLAY 連線的詳細資訊，請參閱主機整合伺服器說明。

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

語法

  
struct display {  
    unsigned short  opcode;  
    unsigned char   reserv2[2];  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned long   init_sect_len;  
    unsigned long   buffer_len;  
    unsigned char FAR * buffer_ptr;  
    unsigned long  num_sections;  
    unsigned long  display_len;  
    unsigned long  area_needed;  
    unsigned char  sna_global_info;  
    unsigned char  lu62_info;  
    unsigned char  am_info;  
    unsigned char  tp_info;  
    unsigned char  sess_info;  
    unsigned char  link_info;  
    unsigned char  lu_0_3_info;  
    unsigned char  gw_info;  
    unsigned char  x25_physical_link_info;  
    unsigned char  sys_def_info;  
    unsigned char  adapter_info;  
    unsigned char  lu_def_info;  
    unsigned char  plu_def_info;  
    unsigned char  mode_def_info;  
    unsigned char  link_def_info;  
    unsigned char  ms_info;  
    struct sna_global_info_sect FAR * sna_global_info_ptr;  
    struct lu62_info_sect FAR * lu62_info_ptr;  
    struct am_info_sect FAR * am_info_ptr;  
    struct tp_info_sect FAR * tp_info_ptr;  
    struct sess_info_sect FAR * sess_info_ptr;  
    struct link_info_sect FAR * link_info_ptr;  
    struct lu_0_3_info_sect FAR * lu_0_3_info_ptr;  
    struct gw_info_sect FAR * gw_info_ptr;  
    struct x25_physical_link_info_sect FAR * x25_physical_link_info_ptr;  
    struct sys_def_info_sect FAR * sys_def_info_ptr;  
    struct adapter_info_sect FAR * adapter_info_ptr;  
    struct lu_def_info_sect FAR * lu_def_info_ptr;  
    struct plu_def_info_sect FAR * plu_def_info_ptr;  
    struct mode_def_info_sect FAR * mode_def_info_ptr;  
    struct link_def_info_sect FAR * link_def_info_ptr;  
    struct ms_info_sect FAR * ms_info_ptr;  
} DISPLAY;

成員

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

reserv2
保留字段，此值必須設定為 Null。

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

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

init_sect_len
提供的參數。指定 VCB 初始區段中的位元組數目，最多到資訊指標的開頭。此參數和 num_sections 參數必須設定為特定值，視要求的格式而定。如需詳細資訊，請參閱下列附註。

buffer_len
提供的參數。指定所傳遞顯示資料緩衝區) 長度 (0 到 65535 個位元組。

buffer_ptr
提供的參數。提供將包含所要求資訊的顯示資料緩衝區位址。

num_sections
提供的參數。指定動詞可傳回的資訊區段數目上限。此參數和 init_sect_len 參數必須設定為特定值，視要求的格式而定。如需詳細資訊，請參閱下列附註。

display_len
傳回的參數。提供在顯示資料緩衝區中傳回的位元組總數。

area_needed
傳回的參數。提供所有顯示資料所需的位元組總數。

sna_global_info
提供的參數。指定是否要求全域資訊。允許的值AP_YES和AP_NO。

lu62_info
提供的參數。指定是否要求所有作用中 RU、其合作夥伴及其模式的相關資訊。允許的值AP_YES和AP_NO。

am_info
提供的參數。指定是否要求已定義之 TP 的附加管理員資訊。允許的值AP_YES和AP_NO。

注意

主機整合伺服器不支援此選項，而且此參數必須設定為 AP_NO。

tp_info
提供的參數。指定是否要求使用中 TP 和任何作用中的交談資訊。允許的值AP_YES和AP_NO。

注意

主機整合伺服器不支援此選項，而且此參數必須設定為 AP_NO。

sess_info
提供的參數。指定是否要求會話的相關資訊。允許的值AP_YES和AP_NO。

link_info
提供的參數。指定是否要求使用中 SNA 邏輯行的資訊。允許的值AP_YES和AP_NO。

lu_0_3_info
提供的參數。指定是否要求邏輯單元類型 0、1、2 和 3 的相關資訊。允許的值AP_YES和AP_NO。

gw_info
提供的參數。指定是否要求 SNA 閘道的相關資訊。允許的值AP_YES和AP_NO。

x25_physical_link_info
提供的參數。指定是否需要 X.25 資訊。允許的值AP_YES和AP_NO。

注意

主機整合伺服器不支援此選項，而且此參數必須設定為 AP_NO。

sys_def_info
提供的參數。指定是否要求輸入和輸出隱含夥伴的預設 LU、節點名稱和預設參數的相關資訊。允許的值AP_YES和AP_NO。

adapter_info
提供的參數。指定是否要求所設定通訊配接器的相關資訊。允許的值為 AP_YES 和 AP_NO。當要求 NS/2 格式時，此參數必須設定為 AP_NO。

lu_def_info
提供的參數。指定是否要求定義之 RU 的相關資訊。允許的值為 AP_YES 和 AP_NO。

plu_def_info
提供的參數。指定是否要求已定義之夥伴 RU 的相關資訊。允許的值為 AP_YES 和 AP_NO。

mode_def_info
提供的參數。指定是否要求定義之節點的相關資訊。允許的值為 AP_YES 和 AP_NO。

link_def_info
提供的參數。指定是否要求定義之邏輯連結的相關資訊。允許的值為 AP_YES 和 AP_NO。

ms_info
提供的參數。指定是否要求管理服務的相關資訊。允許的值為 AP_YES 和 AP_NO。當要求 NS/2 格式時，此參數必須設定為 AP_NO。

sna_global_info_ptr
傳回的參數。指出資料緩衝區中 SNA 全域資訊開頭的位址。

lu62_info_ptr
傳回的參數。指出資料緩衝區中 LU 6.2 資訊開頭的位址。

am_info_ptr
傳回的參數。指出資料緩衝區中附加管理員資訊開頭的位址。

注意

主機整合伺服器不支援此選項。

tp_info_ptr
傳回的參數。指出資料緩衝區中 TP 資訊開頭的位址。

注意

主機整合伺服器不支援此選項。

sess_info_ptr
傳回的參數。指出資料緩衝區中會話資訊開頭的位址。

link_info_ptr
傳回的參數。指出資料緩衝區中連結資訊開頭的位址。

lu_0_3_info_ptr
傳回的參數。指出資料緩衝區中 LU 資訊開頭的位址。

gw_info_ptr
傳回的參數。指出資料緩衝區中閘道資訊開頭的位址。

x25_physical_link_info_ptr
傳回的參數。指出資料緩衝區中 X.25 資訊開頭的位址。

注意

主機整合伺服器不支援此選項。

sys_def_info_ptr
傳回的參數。指出資料緩衝區中系統預設資訊開頭的位址。

adapter_info_ptr
傳回的參數。指出資料緩衝區中配接器資訊開頭的位址。

lu_def_info_ptr
傳回的參數。指出資料緩衝區中本機 LU 定義資訊開頭的位址。

plu_def_info_ptr
傳回的參數。指出資料緩衝區中夥伴 LU 定義資訊開頭的位址。

mode_def_info_ptr
傳回的參數。指出資料緩衝區中模式定義資訊開頭的位址。

link_def_info_ptr
傳回的參數。指出資料緩衝區中連結定義資訊開頭的位址。

ms_info_ptr
傳回的參數。指出資料緩衝區中管理服務資訊開頭的位址。

傳回碼

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

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

AP_DISPLAY_INVALID_CONSTANT
次要傳回碼;為NUM_SECTIONS或INIT_SEC_LEN提供的值無效。

AP_STATE_CHECK
主要傳回碼;指令動詞未執行，因為發出狀態無效。

AP_DISPLAY_INFO_EXCEEDS_LEN
次要傳回碼;傳回的 DISPLAY 資訊不符合緩衝區。

AP_INVALID_DATA_SEGMENT
次要傳回碼;包含資料緩衝區的區段對於指定的資料長度而言太小。

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

此交談所使用的節點遇到 ABEND。

TP 與節點類型 2.1 之間的連線已中斷， (LAN 錯誤) 。

TP 電腦上的 SnaBase 遇到 ABEND。

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

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

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

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

備註

DISPLAY 會單獨依別名識別 LU。如果在網域 (中多次使用相同的本機 LU 別名進行備份或其他用途，) 且該 LU 別名是透過 DISPLAY指定，動詞命令可以流向與預期不同的 LU。

若要讓 DISPLAY 動詞成功傳回，必須在 [SNA 管理員程式 顯示動詞 ] 對話方塊中定義特定的連接。 IBM 最初使用假設單一連線的 IBM OS/2 擴充版本產品定義 DISPLAY 動詞。不過，由於主機整合伺服器支援多個連接，因此必須設定與 DISPLAY 動詞命令相關聯的特定連接。

DISPLAY動詞命令需要使用者提供的緩衝區，以傳回系統資訊。如果緩衝區不夠大，APPC 會傳回AP_DISPLAY_INFO_EXCEEDS_LEN傳回碼，以及 area_needed參數) 中要求 (所需的大小。使用此動詞命令的其中一個可能策略如下：

如果 buffer_len 值小於 APPC 所傳回 的area_needed 值，而且所需的長度小於 64 KB () ，則請將顯示緩衝區的大小增加為等於或大於 area_needed 值。
如果 area_needed 值大於 64KB，您可以選擇個別要求每個資訊區段。或者，您可以採取下列步驟：
1. 使用完整資訊處理資訊區段，其總數會顯示等於實際總數。
2. 選擇您要求的資訊區段子集，其中包含不完整的資訊，並重新發出要求這些資訊區段的動詞命令。
3. 視需要重複步驟 a 和 b。
注意

如果個別資訊區段大於 64 KB，則您無法從 APPC 取得所有要求的資訊。

DISPLAY動詞不應該從相同進程的不同執行緒執行，因為它不是安全線程。

如果針對init_sect_len和num_sections所提供的參數未設定下列值，DISPLAY動詞命令會傳回AP_DISPLAY_INVALID_CONSTANT：

	NS/2 格式	IBM EE 格式	僅限 Windows) (NS/2 格式	IBM EE 格式 (僅限 Windows)
init_sect_len	50	44	52	48
num_sections	16	9	16	9

未正確設定下列參數時，也會傳回AP_DISPLAY_INVALID_CONSTANT：

reserv2 必須設定為 Null。
am_info 必須設定為 AP_NO。
tp_info 必須設定為 AP_NO。
如果要求 NS/2 格式，adapter_info必須設定為 AP_NO。
如果要求 NS/2 格式，ms_info必須設定為 AP_NO。

另請參閱

Host Integration Server 擴充功能
 依資訊類型說明差異

共用方式為

DISPLAY

語法

成員

傳回碼

備註

另請參閱

其他資源