DISPLAY
DISPLAY 동사는 SNA 노드에 대한 구성 정보 및 현재 작동 값을 반환합니다.
GetAppcConfig Windows 확장 함수를 사용하여 APPC RU와 관련된 시스템 구성 정보를 가져오는 것이 좋습니다. 특히 5250명의 에뮬레이터 사용자는 GetAPPCConfig Windows 확장을 사용해야 합니다.
참고
클라이언트/서버 아키텍처의 특성으로 인해 호스트 통합 서버에서 DISPLAY 동사의 구현에는 OS/2 버전 1.0용 IBM 확장 서비스(OS/2 버전 1.0용 IBM ES)의 중요한 차이점이 포함되어 있습니다.
참고
OS/2 버전 1.0 호환 모드용 IBM ES에서 APPC DISPLAY 동사를 사용하고 모든 활성 서버 및 연결을 열거하는 데 호스트 통합 서버 확장을 사용하지 않는 애플리케이션의 경우, 특정 기본 DISPLAY 연결이 SNA Manager에서 구성되지 않은 한 호스트 통합 서버는 기본 DISPLAY 연결을 임의로 선택합니다. 이 연결은 모든 DISPLAY 요청의 기준으로 사용됩니다. 기본 DISPLAY 연결을 지정하는 방법에 대한 자세한 내용은 Host Integration Server 도움말을 참조하세요.
다음 구조체는 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.
참고
이 옵션은 Host Integration Server에서 지원되지 않으며 이 매개 변수는 AP_NO 설정해야 합니다.
tp_info
제공된 매개 변수입니다. 활성 TP 및 활성 대화에 대한 정보가 요청되는지를 지정합니다. 허용되는 값은 AP_YES AP_NO.
참고
이 옵션은 Host Integration Server에서 지원되지 않으며 이 매개 변수는 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.
참고
이 옵션은 Host Integration Server에서 지원되지 않으며 이 매개 변수는 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
반환된 매개 변수입니다. 데이터 버퍼에서 관리자 연결 정보의 시작 부분을 나타냅니다.
참고
이 옵션은 Host Integration Server에서 지원되지 않습니다.
tp_info_ptr
반환된 매개 변수입니다. 데이터 버퍼에서 TP 정보의 시작 부분을 나타냅니다.
참고
이 옵션은 Host Integration Server에서 지원되지 않습니다.
sess_info_ptr
반환된 매개 변수입니다. 데이터 버퍼에서 세션 정보의 시작 부분을 나타냅니다.
link_info_ptr
반환된 매개 변수입니다. 데이터 버퍼의 링크 정보 시작 주소를 나타냅니다.
lu_0_3_info_ptr
반환된 매개 변수입니다. 데이터 버퍼에서 LU 정보의 시작 부분을 나타냅니다.
gw_info_ptr
반환된 매개 변수입니다. 데이터 버퍼의 게이트웨이 정보 시작 주소를 나타냅니다.
x25_physical_link_info_ptr
반환된 매개 변수입니다. 데이터 버퍼에서 X.25 정보의 시작 부분을 나타냅니다.
참고
이 옵션은 Host Integration Server에서 지원되지 않습니다.
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 Extended Edition 제품으로 DISPLAY 동사를 정의했습니다. 그러나 Host Integration Server는 여러 연결을 지원하므로 DISPLAY 동사와 연결된 특정 연결을 구성해야 합니다.
DISPLAY 동사에는 시스템 정보를 반환하기 위해 사용자가 제공한 버퍼가 필요합니다. 버퍼가 충분히 크지 않으면 APPC는 요청 시 실제로 필요한 크기(area_needed 매개 변수)와 함께 AP_DISPLAY_INFO_EXCEEDS_LEN 반환 코드를 반환합니다. 이 동사를 사용하기 위한 한 가지 가능한 전략은 다음과 같습니다.
buffer_len 값이 APPC에서 반환하는 area_needed 값보다 작고 필요한 길이가 64KB보다 작은 경우 표시 버퍼의 크기를 area_needed 값보다 크거나 늘입니다.
area_needed 값이 64KB보다 큰 경우 각 정보 섹션을 개별적으로 요청하도록 선택할 수 있습니다. 또는 다음 단계를 수행할 수 있습니다.
전체 정보로 정보 섹션을 처리합니다. 전체 번호가 표시되어 실제 총 수와 같습니다.
불완전한 정보가 포함된 요청한 정보 섹션의 하위 집합을 선택하고 해당 정보 섹션을 요청하는 동사를 다시 실행합니다.
필요에 따라 a 및 b 단계를 반복합니다.
참고
개별 정보 섹션이 64KB보다 큰 경우 APPC에서 요청된 정보를 모두 가져올 수 없습니다.
DISPLAY 동사는 스레드로부터 안전하지 않으므로 동일한 프로세스의 다른 스레드에서 실행해서는 안 됩니다.
DISPLAY 동사는 init_sect_len 및 num_sections 제공된 매개 변수에 대해 다음 값이 설정되지 않은 경우 AP_DISPLAY_INVALID_CONSTANT 반환합니다.
| NS/2 형식 | IBM EE 형식 | NS/2 형식(Windows에만 해당) | 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 설정해야 합니다.