DEACTIVATE_SESSION 동사는 Microsoft® Host Integration Server에 LU(로컬 논리 단위)와 지정된 파트너 LU 간의 특정 세션 또는 특정 모드의 모든 세션을 비활성화하도록 요청합니다.
다음 구조에서는 DEACTIVATE_SESSION 동사에서 사용하는 동사 제어 블록에 대해 설명합니다.
문법
typedef struct deactivate_session {
unsigned short opcode;
unsigned char reserv2[2];
unsigned short primary_rc;
unsigned long secondary_rc;
unsigned char reserv3[8];
unsigned char lu_alias[8];
unsigned char session_id[8];
unsigned char plu_alias[8];
unsigned char mode_name[8];
unsigned char type;
unsigned char reserv4[3];
unsigned short sense_data;
unsigned char fqplu_name[17];
unsigned char reserv5[19];
} DEACTIVATE_SESSION;
구성원
opcode
제공된 매개 변수입니다. 동사 작업 코드 AP_DEACTIVATE_SESSION 지정합니다.
reserv2
예약 필드입니다.
primary_rc
반환된 매개 변수입니다. 동사가 완료될 때 APPC에서 설정한 기본 반환 코드를 지정합니다. 유효한 반환 코드는 발급된 APPC 동사에 따라 달라집니다. 이 동사에 대한 유효한 오류 코드는 반환 코드를 참조하세요.
secondary_rc
반환된 매개 변수입니다. 동사가 완료될 때 APPC에서 설정한 보조 반환 코드를 지정합니다. 유효한 반환 코드는 발급된 APPC 동사에 따라 달라집니다. 이 동사에 대한 유효한 오류 코드는 반환 코드를 참조하세요.
reserv3
예약 필드입니다.
lu_alias
제공된 매개 변수입니다. LU에 로컬로 사용되는 8 바이트 ASCII 이름을 제공합니다.
세션_아이디
제공된 매개 변수입니다. 비활성화할 세션의 8바이트 식별자를 제공합니다( ACTIVATE_SESSION 동사에서 반환됨). 이 필드가 8개의 이진 0으로 설정된 경우 Host Integration Server는 파트너 LU 및 모드에 대한 모든 세션을 비활성화합니다.
plu_alias
제공된 매개 변수입니다. 파트너 LU에 로컬로 사용되는 8 바이트 ASCII 이름을 제공합니다. 기본 원격 LU를 사용하는 경우 이 매개 변수를 공백으로 채웁니다. 파트너 LU를 fqplu_name 매개 변수로 지정하려면 이 매개 변수를 이진 0으로 채웁니다.
mode_name
제공된 매개 변수입니다. EBCDIC(형식 A) 모드 이름을 지정합니다.
유형
제공된 매개 변수입니다. 비활성화 유형을 지정합니다. 가능한 값은 다음과 같습니다.
AP_DEACT_CLEANUP
세션이 끝날 때까지 기다리지 않고 세션을 즉시 비활성화합니다.
AP_DEACT_NORMAL
세션을 사용하는 모든 대화가 종료될 때까지 세션을 비활성화하지 마세요.
sense_data
반환된 매개 변수입니다. 세션의 비활성화 감지 데이터를 지정합니다.
reserv4
예약 필드입니다.
fqplu_name
제공된 매개 변수입니다. 로컬 노드에 plu_alias 이름이 정의되지 않고 파트너 LU가 다른 노드에 있는 경우 EBCDIC(형식 A)에서 파트너 LU 이름을 제공합니다.
plu_alias 지정하면 이 매개 변수가 무시됩니다.
reserv5
예약 필드입니다.
반환 코드
AP_OK
기본 반환 코드; 동사가 성공적으로 실행되었습니다. 보조 반환 코드는 설정된 세션의 극성을 나타냅니다. 다음 값을 반환할 수 있습니다.
AP_PARAMETER_CHECK
기본 반환 코드; 다음 보조 반환 코드 중 하나로 지정된 매개 변수 오류로 인해 동사가 실행되지 않았습니다.
AP_INVALID_LU_ALIAS
보조 반환 코드; APPC는 정의된 lu_alias 찾을 수 없습니다.
AP_INVALID_PLU_ALIAS
보조 반환 코드; APPC에서 지정된 plu_alias 인식하지 못했습니다.
AP_INVALID_SESSION_ID
보조 반환 코드; APPC에서 지정된 session_id 인식하지 못했습니다.
AP_INVALID_MODE_NAME
보조 반환 코드; APPC에서 지정된 mode_name 인식하지 못했습니다.
AP_INVALID_FQPLU_NAME
보조 반환 코드; APPC에서 지정된 fqplu_name 인식하지 못했습니다.
AP_INVALID_TYPE
보조 반환 코드; APPC에서 지정된 형식을 인식하지 못했습니다.
AP_COMM_SUBSYSTEM_ABENDED
기본 반환 코드; 는 다음 조건 중 하나가 발생했음을 나타냅니다.
이 대화에 사용된 노드에 ABEND가 발견되었습니다.
TP와 PU 2.1 노드 간의 연결이 끊어졌습니다(로컬 영역 네트워크 오류가 발생했습니다).
TP 컴퓨터의 SnaBase에서 ABEND가 발견되었습니다.
시스템 관리자는 오류 로그를 검사하여 ABEND의 이유를 확인해야 합니다.
AP_COMM_SUBSYSTEM_NOT_LOADED
기본 반환 코드; 동사를 처리하는 동안 필요한 구성 요소를 로드하거나 종료할 수 없습니다. 따라서 통신을 할 수 없습니다. 정정 작업은 시스템 관리자에게 문의하세요.
AP_STACK_TOO_SMALL
기본 반환 코드; 애플리케이션의 스택 크기가 너무 작아서 동사를 실행할 수 없습니다. 애플리케이션의 스택 크기를 늘입니다.
AP_THREAD_BLOCKING
기본 반환 코드; 호출 스레드가 이미 차단 호출에 있습니다.