MC_GET_ATTRIBUTES
MC_GET_ATTRIBUTES 동사는 대화의 특성을 반환합니다.
다음 구조체는 MC_GET_ATTRIBUTES 동사에서 사용하는 VCB(동사 제어 블록)에 대해 설명합니다.
구문
struct mc_get_attributes {
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;
unsigned char sync_level;
unsigned char mode_name[8];
unsigned char net_name[8];
unsigned char lu_name[8];
unsigned char lu_alias[8];
unsigned char plu_alias[8];
unsigned char plu_un_name[8];
unsigned char reserv4[2];
unsigned char fqplu_name[17];
unsigned char reserv5;
unsigned char user_id[10];
unsigned long conv_group_id;
unsigned char conv_corr_len;
unsigned char conv_corr[8];
unsigned char reserv6[13];
// NOTE: The following fields are present
// when the high bit of opext is set
// (opext & AP_EXTD_VCB) != 0.
unsigned char luw_id[26];
unsigned char sess_id[8];
};
구성원
opcode
제공된 매개 변수입니다. AP_M_GET_ATTRIBUTES 동사 작업 코드를 지정합니다.
opext
제공된 매개 변수입니다. AP_MAPPED_CONVERSATION 동사 연산 확장을 지정합니다.
reserv2
예약된 필드입니다.
primary_rc
반환된 매개 변수입니다. 동사를 완료할 때 APPC에서 설정하는 기본 반환 코드를 지정합니다. 유효한 반환 코드는 발행된 APPC 동사에 따라 다릅니다. 이 동사의 유효한 오류 코드는 반환 코드를 참조하세요.
secondary_rc
반환된 매개 변수입니다. 동사를 완료할 때 APPC에서 설정하는 보조 반환 코드를 지정합니다. 유효한 반환 코드는 발행된 APPC 동사에 따라 다릅니다. 이 동사의 유효한 오류 코드는 반환 코드를 참조하세요.
tp_id
제공된 매개 변수입니다. TP(로컬 트랜잭션 프로그램)를 식별합니다. 이 매개 변수의 값은 호출하는 TP의 TP_STARTED 또는 호출된 TP의 RECEIVE_ALLOCATE 의해 반환됩니다.
conv_id
제공된 매개 변수입니다. 대화 식별자를 제공합니다. 이 매개 변수의 값은 호출하는 TP의 MC_ALLOCATE 또는 호출된 TP의 RECEIVE_ALLOCATE 의해 반환됩니다.
sync_level
반환된 매개 변수입니다. 대화에 대한 동기화 처리 수준을 지정합니다. 이 매개 변수는 TP가 데이터 수신 확인을 요청하고 데이터 수신을 확인할 수 있는지 여부를 결정합니다.
AP_NONE 이 대화에서 확인 처리가 사용되지 않음을 나타냅니다.
AP_CONFIRM_SYNC_LEVEL TP가 이 대화에서 확인 처리를 사용할 수 있음을 나타냅니다.
AP_SYNCPT TP가 이 대화에서 동기화 지점 수준 2 확인 처리를 사용할 수 있음을 나타냅니다.
mode_name
반환된 매개 변수입니다. 네트워킹 특성 집합의 이름을 지정합니다. EBCDIC 문자열 형식입니다.
net_name
반환된 매개 변수입니다. 이 TP에서 사용하는 LU(로컬 논리 단위)를 포함하는 SNA 네트워크의 이름을 지정합니다. EBCDIC 문자열 형식입니다.
lu_name
반환된 매개 변수입니다. 로컬 LU의 이름을 제공합니다.
lu_alias
반환된 매개 변수입니다. 로컬 LU가 로컬 TP에 알려진 별칭을 제공합니다. ASCII 문자열입니다.
plu_alias
반환된 매개 변수입니다. 파트너 LU가 로컬 TP에 알려진 별칭을 제공합니다. ASCII 문자열입니다.
plu_un_name
반환된 매개 변수입니다. SSCP(시스템 서비스 제어점)에 정의된 파트너 LU의 이름인 파트너 LU의 해석되지 않은 이름을 지정합니다. AE EBCDIC 문자열 형식입니다. 이 매개 변수는 로컬 LU가 종속된 경우에만 반환됩니다.
fqplu_name
반환된 매개 변수입니다. 파트너 LU의 정규화된 이름을 제공합니다. EBCDIC 문자열 형식입니다. 필드에는 네트워크 이름, EBCDIC 기간 및 partner-LU 이름이 포함됩니다.
User_id
반환된 매개 변수입니다. 호출된 TP에 액세스하기 위해 MC_ALLOCATE 통해 호출하는 TP에서 보낸 사용자 식별자를 지정합니다(해당하는 경우). AE EBCDIC 문자열 형식입니다. 다음 조건이 충족되면 필드에 사용자 식별자가 포함됩니다.
호출된 TP에는 대화 보안이 필요합니다.
MC_GET_ATTRIBUTES 호출된 TP에 의해 발급되었습니다.
그렇지 않으면 필드에 공백이 포함됩니다.
conv_group_id
반환된 매개 변수입니다. 대화가 할당된 세션의 대화 그룹 식별자를 지정합니다. 또한 MC_ALLOCATE 및 RECEIVE_ALLOCATE 반환됩니다.conv_corr_len
반환된 매개 변수입니다. 반환되는 대화 상관 관계 식별자의 길이를 지정합니다.conv_corr
반환된 매개 변수입니다. 원본 LU가 원본/파트너 LU 쌍에 대해 고유한 대화를 식별하기 위해 할당하는 대화 상관 관계 식별자(있는 경우)를 지정합니다. 할당 요청에서 원본 LU에 의해 전송됩니다.
참고
다음 필드는 높은 양의 opext가 설정된 경우(opext & AP_EXTD_VCB) != 0입니다. 이러한 필드는 동기화 지점 수준 2 지원을 사용할 때만 존재합니다.
luw_id
논리적 작업 단위 식별자입니다.
sess_id
세션 식별자입니다.
반환 코드
AP_OK
기본 반환 코드입니다. 동사가 성공적으로 실행되었습니다.
AP_PARAMETER_CHECK
기본 반환 코드입니다. 매개 변수 오류로 인해 동사가 실행되지 않았습니다.
AP_BAD_CONV_ID
보조 반환 코드; conv_id 값이 APPC에서 할당한 대화 식별자와 일치하지 않습니다.
AP_BAD_TP_ID
보조 반환 코드; tp_id 값이 APPC에서 할당한 TP 식별자와 일치하지 않습니다.
AP_COMM_SUBSYSTEM_ABENDED
기본 반환 코드입니다. 다음 조건 중 하나를 나타냅니다.
이 대화에서 사용하는 노드에 ABEND가 발생했습니다.
TP와 PU 2.1 노드 간의 연결이 끊어졌습니다(LAN 오류).
TP 컴퓨터의 SnaBase에서 ABEND가 발생했습니다.
시스템 관리자는 오류 로그를 검사하여 ABEND의 원인을 확인해야 합니다.
AP_CONVERSATION_TYPE_MIXED
기본 반환 코드; TP는 기본 및 매핑된 대화 동사를 모두 실행했습니다. 단일 대화에서 하나의 형식만 발급할 수 있습니다.AP_INVALID_VERB_SEGMENT
기본 반환 코드입니다. VCB가 데이터 세그먼트의 끝을 넘어 확장되었습니다.AP_STACK_TOO_SMALL
기본 반환 코드입니다. 애플리케이션의 스택 크기가 너무 작아서 동사를 실행할 수 없습니다. 애플리케이션의 스택 크기를 늘리세요.AP_CONV_BUSY
기본 반환 코드; 모든 대화에서 한 번에 하나의 뛰어난 대화 동사만 있을 수 있습니다. 로컬 TP에 여러 스레드가 있고 둘 이상의 스레드가 동일한 conv_id 사용하여 APPC 호출을 실행하는 경우에 발생할 수 있습니다.AP_UNEXPECTED_DOS_ERROR
기본 반환 코드입니다. 로컬 TP의 APPC 호출을 처리하는 동안 운영 체제가 APPC에 오류를 반환했습니다. 운영 체제 반환 코드는 secondary_rc를 통해 반환됩니다. Intel 바이트 스와핑 순서로 표시됩니다. 문제가 지속되면 시스템 관리자에게 문의하세요.
설명
TP가 이 동사를 발급할 때 RESET을 제외한 모든 상태에 있을 수 있습니다.
상태 변경은 없습니다.