MC_RECEIVE_AND_WAIT
MC_RECEIVE_AND_WAIT 동사는 파트너 TP(트랜잭션 프로그램)에서 현재 사용할 수 있는 모든 데이터를 받습니다. 현재 사용할 수 있는 데이터가 없으면 로컬 TP는 데이터가 도착할 때까지 기다립니다.
비동기 지원으로 전체 사용을 허용하기 위해 비동기적으로 발급된 MC_RECEIVE_AND_WAIT 동사가 MC_RECEIVE_AND_POST 동사처럼 작동하도록 변경되었습니다. 특히 비동기 MC_RECEIVE_AND_WAIT 미해결 상태이지만 동일한 대화에서 다음 동사를 실행할 수 있습니다.
-
따라서 애플리케이션, 특히 5250 에뮬레이터는 비동기 MC_RECEIVE_AND_WAIT 사용하여 데이터를 수신할 수 있습니다. MC_RECEIVE_AND_WAIT 미해결이지만 여전히 MC_SEND_ERROR 및 MC_REQUEST_TO_SEND 사용할 수 있습니다. 전체 비동기 지원을 위해 이 기능을 사용하는 것이 좋습니다.
다음 구조체는 MC_RECEIVE_AND_WAIT 동사에서 사용하는 VCB(동사 제어 블록)에 대해 설명합니다.
구문
struct mc_receive_and_wait {
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 short what_rcvd;
unsigned char rtn_status;
unsigned char reserv4;
unsigned char rts_rcvd;
unsigned char reserv5;
unsigned short max_len;
unsigned short dlen;
unsigned char FAR * dptr;
unsigned char reserv6[5];
};
구성원
opcode
제공된 매개 변수입니다. AP_M_RECEIVE_AND_WAIT 동사 작업 코드를 지정합니다.
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 의해 반환됩니다.
what_rcvd
반환된 매개 변수입니다. 데이터 또는 대화 상태 수신되었는지 여부를 나타냅니다.
AP_CONFIRM_DEALLOCATE 파트너 TP가 AP_SYNC_LEVEL 설정된 dealloc_type MC_DEALLOCATE 발급했으며 MC_ALLOCATE 설정한 대화의 동기화 수준이 AP_CONFIRM_SYNC_LEVEL 나타냅니다. 이 값을 받으면 로컬 TP는 일반적으로 MC_CONFIRMED 발급합니다.
AP_CONFIRM_SEND 파트너 TP가 AP_SYNC_LEVEL 설정된 ptr_type 사용하여 MC_PREPARE_TO_RECEIVE 발급했으며 MC_ALLOCATE 설정된 대화의 동기화 수준이 AP_CONFIRM_SYNC_LEVEL 나타냅니다. 이 값을 받으면 로컬 TP는 일반적으로 MC_CONFIRMED 발급하고 데이터를 보내기 시작합니다.
AP_CONFIRM_WHAT_RECEIVED 파트너 TP가 MC_CONFIRM 발급했음을 나타냅니다. 이 값을 받으면 로컬 TP는 일반적으로 MC_CONFIRMED 발급합니다.
AP_DATA_COMPLETE MC_RECEIVE_AND_WAIT 로컬 TP가 전체 데이터 레코드 또는 데이터 레코드의 마지막 부분을 수신했음을 나타냅니다. 이 값을 받으면 로컬 TP는 일반적으로 MC_RECEIVE_AND_WAIT 다시 발급하거나 다른 수신 동사를 발급합니다. 파트너 TP가 더 많은 데이터를 보낸 경우 로컬 TP는 새 데이터 단위를 수신하기 시작합니다.
그렇지 않으면 로컬 TP는 primary_rc AP_OK 포함하고 what_rcvd AP_SEND, AP_CONFIRM_SEND, AP_CONFIRM_DEALLOCATE 또는 AP_CONFIRM_WHAT_RECEIVED 포함하는 경우 상태 정보를 검사합니다.
로컬 TP가 일반적으로 수행하는 다음 작업은 이 항목의 코드 반환을 참조하세요.
primary_rc AP_DEALLOC_NORMAL 포함하는 경우 파트너 TP에서 발급한 MC_DEALLOCATE 대한 응답으로 대화의 할당이 취소됩니다.
AP_DATA_INCOMPLETE 로컬 TP가 불완전한 데이터 레코드를 수신했음을 나타냅니다. max_len 매개 변수는 데이터 레코드의 길이보다 작은 값을 지정했습니다(레코드를 읽는 첫 번째 수신 동사가 아닌 경우 데이터 레코드의 나머지 부분보다 작음). 이 값을 받으면 로컬 TP는 일반적으로 MC_RECEIVE_AND_WAIT (또는 다른 수신 동사를 발급)하여 레코드의 다음 부분을 받습니다.
AP_NONE TP가 데이터 또는 대화 상태 지표를 받지 못했음을 나타냅니다.
AP_SEND 파트너 TP에 대해 대화가 RECEIVE 상태로 진입했음을 나타냅니다. 로컬 TP의 경우 대화는 이제 SEND 상태입니다. 이 값을 받으면 로컬 TP는 일반적으로 MC_SEND_DATA 사용하여 데이터 전송을 시작합니다.
rtn_status
제공된 매개 변수입니다. 데이터와 대화 상태 표시기가 하나의 API 호출 내에서 반환되어야 하는지 여부를 나타냅니다.AP_NO 동사의 별도 호출에서 표시기를 개별적으로 반환되도록 지정합니다.
AP_YES 둘 다 사용할 수 있는 경우 지표가 함께 반환되도록 지정합니다. 다음 경우 둘 다 반환할 수 있습니다.
수신 버퍼는 상태 표시기 앞에 오는 모든 데이터를 저장할 수 있을 만큼 큽니다.
데이터는 상태 표시기 이전의 마지막 데이터 레코드입니다.
rts_rcvd
반환된 매개 변수입니다. 송신 요청 표시기를 포함합니다.AP_YES 파트너 TP가 로컬 TP가 대화를 RECEIVE 상태로 변경하도록 요청하는 MC_REQUEST_TO_SEND 발급했음을 나타냅니다.
AP_NO 파트너 TP가 MC_REQUEST_TO_SEND 발급하지 않음을 나타냅니다.
max_len
제공된 매개 변수입니다. 로컬 TP가 받을 수 있는 최대 데이터 바이트 수를 나타냅니다. 범위는 0에서 65535까지입니다.Microsoft Windows 운영 체제 및 Windows 그래픽 환경의 경우 이 값이 수신된 데이터를 포함할 버퍼의 길이를 초과해서는 안됩니다.
OS/2 운영 체제의 경우 dptr 의 오프셋과 max_len 값이 데이터 세그먼트의 크기를 초과해서는 안됩니다.
max_len 0으로 설정된 MC_RECEIVE_AND_WAIT 발급하면 로컬 TP가 파트너 TP에 보낼 데이터가 있는지, 확인을 구하거나, 대화 상태를 변경했는지 확인할 수 있습니다.
dlen
반환된 매개 변수입니다. 수신된 데이터의 바이트 수를 나타냅니다. 데이터는 dptr로 지정된 버퍼에 저장됩니다. 길이가 0이면 데이터가 수신되지 않음을 나타냅니다.dptr
제공된 매개 변수입니다. 로컬 TP에서 받은 데이터를 포함할 버퍼의 주소를 제공합니다.Windows 운영 체제 및 Windows 그래픽 환경의 경우 데이터 버퍼는 정적 데이터 영역 또는 전역적으로 할당된 영역에 상주할 수 있습니다. 데이터 버퍼는 이 영역 내에 완전히 맞아야 합니다.
OS/2 운영 체제의 경우 데이터 버퍼는 플래그가 1인 DosAllocSeg 함수에 의해 할당되는 명명되지 않은 공유 세그먼트에 있어야 합니다. 데이터 버퍼는 데이터 세그먼트에 전적으로 맞아야 합니다.
Windows 환경의 경우 데이터 버퍼는 정적 데이터 영역 또는 전역적으로 할당된 영역에 상주할 수 있습니다. 데이터 버퍼는 이 영역 내에 완전히 맞아야 합니다.
반환 코드
AP_OK
기본 반환 코드입니다. 동사가 성공적으로 실행되었습니다.
rtn_status AP_YES 이전 반환 코드 또는 다음 반환 코드 중 하나를 반환할 수 있습니다.
AP_DATA_COMPLETE_SEND
기본 반환 코드; 이는 AP_DATA_COMPLETE 및 AP_SEND 조합입니다.
AP_DATA_COMPLETE_CONFIRM_SEND
기본 반환 코드; 이는 AP_DATA_COMPLETE 및 AP_CONFIRM_SEND 조합입니다.
AP_DATA_COMPLETE_CONFIRM
기본 반환 코드; 이는 AP_DATA_COMPLETE 및 AP_CONFIRM_WHAT_RECEIVED 조합입니다.
AP_DATA_COMPLETE_CONFIRM_DEALL
기본 반환 코드; 이는 AP_DATA_COMPLETE 및 AP_CONFIRM_DEALLOCATE 조합입니다.
AP_DEALLOC_NORMAL
기본 반환 코드; 파트너 TP는 확인을 요청하지 않고 대화를 할당 취소하고 dealloc_type 다음 중 하나로 설정된 MC_DEALLOCATE 발급했습니다.
AP_CONFIRM_SYNC_LEVEL
AP_FLUSH
AP_SYNC_LEVEL 대화의 동기화 수준이 AP_NONE
rtn_status AP_YES 경우 what_rcvd 검사합니다.
AP_PARAMETER_CHECK
기본 반환 코드입니다. 매개 변수 오류로 인해 동사가 실행되지 않았습니다.AP_BAD_CONV_ID
보조 반환 코드; conv_id 값이 APPC에서 할당한 대화 식별자와 일치하지 않습니다.
AP_BAD_TP_ID
보조 반환 코드; tp_id 값이 APPC에서 할당한 TP 식별자와 일치하지 않습니다.
AP_BAD_RETURN_STATUS_WITH_DATA
보조 반환 코드; 지정된 rtn_status 값이 APPC에서 인식되지 않았습니다.
AP_INVALID_DATA_SEGMENT
보조 반환 코드; 데이터 버퍼에 대해 지정된 길이가 버퍼를 포함하도록 할당된 세그먼트보다 길었다.
AP_STATE_CHECK
기본 반환 코드입니다. 동사가 잘못된 상태에서 발행되었으므로 실행되지 않았습니다.AP_RCV_AND_WAIT_BAD_STATE
보조 반환 코드; TP가 이 동사를 발급했을 때 대화가 RECEIVE 또는 SEND 상태가 아니었습니다.
AP_ALLOCATION_ERROR
기본 반환 코드; APPC에서 대화를 할당하지 못했습니다. 대화 상태가 RESET로 설정됩니다.이 코드는 MC_ALLOCATE 후에 발급된 동사를 통해 반환될 수 있습니다.
AP_ALLOCATION_FAILURE_NO_RETRY
보조 반환 코드; 구성 오류 또는 세션 프로토콜 오류와 같은 영구적인 조건으로 인해 대화를 할당할 수 없습니다. 오류를 확인하려면 시스템 관리자가 오류 로그 파일을 검사해야 합니다. 오류가 수정될 때까지 할당을 다시 시도하지 마세요.
AP_ALLOCATION_FAILURE_RETRY
보조 반환 코드; 링크 오류와 같은 임시 조건으로 인해 대화를 할당할 수 없습니다. 오류의 원인은 시스템 오류 로그에 기록됩니다. 할당을 다시 시도하세요.
AP_CONVERSATION_TYPE_MISMATCH
보조 반환 코드; LU(파트너 논리 단위) 또는 TP는 할당 요청에 지정된 대화 유형(기본 또는 매핑됨)을 지원하지 않습니다.
AP_PIP_NOT_ALLOWED
보조 반환 코드; 할당 요청이 지정된 PIP 데이터이지만 파트너 TP에 이 데이터가 필요하지 않거나 파트너 LU가 지원하지 않습니다.
AP_PIP_NOT_SPECIFIED_CORRECTLY
보조 반환 코드; 파트너 TP에는 PIP 데이터가 필요하지만 할당 요청은 PIP 데이터 또는 잘못된 수의 매개 변수를 지정하지 않았습니다.
AP_SECURITY_NOT_VALID
보조 반환 코드; 할당 요청에 지정된 사용자 식별자 또는 암호가 파트너 LU에 의해 수락되지 않았습니다.
AP_SYNC_LEVEL_NOT_SUPPORTED
보조 반환 코드; 파트너 TP는 할당 요청에 지정된 sync_level (AP_NONE 또는 AP_CONFIRM_SYNC_LEVEL)을 지원하지 않거나 sync_level 인식되지 않았습니다.
AP_TP_NAME_NOT_RECOGNIZED
보조 반환 코드; 파트너 LU가 할당 요청에 지정된 TP 이름을 인식하지 못합니다.
AP_TRANS_PGM_NOT_AVAIL_NO_RETRY
보조 반환 코드; 원격 LU가 요청된 파트너 TP를 시작할 수 없어 할당 요청을 거부했습니다. 영구적인 상태입니다. 오류의 원인이 원격 노드에 기록될 수 있습니다. 오류가 수정될 때까지 할당을 다시 시도하지 마세요.
AP_TRANS_PGM_NOT_AVAIL_RETRY
보조 반환 코드; 원격 LU가 요청된 파트너 TP를 시작할 수 없어 할당 요청을 거부했습니다. 조건(예: 시간 제한)은 일시적일 수 있습니다. 오류의 원인이 원격 노드에 기록될 수 있습니다. 할당을 다시 시도하세요.
AP_COMM_SUBSYSTEM_ABENDED
기본 반환 코드입니다. 다음 조건 중 하나를 나타냅니다.이 대화에서 사용하는 노드에 ABEND가 발생했습니다.
TP와 PU 2.1 노드 간의 연결이 끊어졌습니다(LAN 오류).
TP 컴퓨터의 SnaBase에서 ABEND가 발생했습니다.
시스템 관리자는 오류 로그를 검사하여 ABEND의 원인을 확인해야 합니다.
AP_CONV_FAILURE_NO_RETRY
기본 반환 코드; 세션 프로토콜 오류와 같은 영구적인 조건으로 인해 대화가 종료되었습니다. 시스템 관리자는 시스템 오류 로그를 검사하여 오류의 원인을 확인해야 합니다. 오류가 수정될 때까지 대화를 다시 시도하지 마세요.AP_CONV_FAILURE_RETRY
기본 반환 코드; 일시적인 오류로 인해 대화가 종료되었습니다. TP를 다시 시작하여 문제가 다시 발생하는지 확인합니다. 이 경우 시스템 관리자는 오류 로그를 검사하여 오류의 원인을 확인해야 합니다.AP_CONVERSATION_TYPE_MIXED
기본 반환 코드; TP는 기본 및 매핑된 대화 동사를 모두 실행했습니다. 단일 대화에서 하나의 형식만 발급할 수 있습니다.AP_INVALID_VERB_SEGMENT
기본 반환 코드입니다. VCB가 데이터 세그먼트의 끝을 넘어 확장되었습니다.AP_PROG_ERROR_NO_TRUNC
기본 반환 코드; 대화가 SEND 상태인 동안 파트너 TP가 MC_SEND_ERROR 발급했습니다. 데이터가 잘리지 않았습니다.AP_PROG_ERROR_PURGING
기본 반환 코드; 수신, 보류 중, PENDING_POST, CONFIRM, CONFIRM_SEND 또는 CONFIRM_DEALLOCATE 상태에 있는 동안 파트너 TP는 MC_SEND_ERROR 발급했습니다. 전송되었지만 아직 받지 않은 데이터는 제거됩니다.AP_STACK_TOO_SMALL
기본 반환 코드입니다. 애플리케이션의 스택 크기가 너무 작아서 동사를 실행할 수 없습니다. 애플리케이션의 스택 크기를 늘리세요.AP_CONV_BUSY
기본 반환 코드; 모든 대화에서 한 번에 하나의 미해결 대화 동사만 있을 수 있습니다. 로컬 TP에 여러 스레드가 있고 둘 이상의 스레드가 동일한 conv_id 사용하여 APPC 호출을 실행하는 경우에 발생할 수 있습니다.AP_THREAD_BLOCKING
기본 반환 코드입니다. 호출 스레드가 이미 차단 호출에 있습니다.AP_UNEXPECTED_DOS_ERROR
기본 반환 코드입니다. 로컬 TP의 APPC 호출을 처리하는 동안 운영 체제가 APPC에 오류를 반환했습니다. 운영 체제 반환 코드는 secondary_rc를 통해 반환됩니다. Intel 바이트 스와핑 순서로 표시됩니다. 문제가 지속되면 시스템 관리자에게 문의하세요.AP_DEALLOC_ABEND
기본 반환 코드; 대화의 할당이 취소된 이유는 다음과 같습니다.파트너 TP는 dealloc_type AP_ABEND 설정된 MC_DEALLOCATE 발급했습니다.
파트너 TP가 ABEND를 발견하여 파트너 LU가 MC_DEALLOCATE 요청을 보냅니다.
설명
로컬 TP는 다음 프로세스를 통해 데이터를 받습니다.
로컬 TP는 전체 데이터 단위 수신이 완료될 때까지 수신 동사를 발급합니다. 수신된 데이터는 하나의 데이터 레코드입니다.
로컬 TP는 전체 데이터 단위를 수신하기 위해 수신 동사를 여러 번 발급해야 할 수 있습니다. 전체 데이터 단위가 수신되면 로컬 TP에서 데이터를 조작할 수 있습니다.
수신 동사는 MC_RECEIVE_AND_POST, MC_RECEIVE_AND_WAIT 및 MC_RECEIVE_IMMEDIATE.
로컬 TP는 수신 동사를 다시 발급합니다. 다음과 같은 효과 중 하나가 있습니다.
파트너 TP가 더 많은 데이터를 보낸 경우 로컬 TP는 새 데이터 단위를 수신하기 시작합니다.
파트너 TP가 데이터 전송을 완료했거나 확인을 기다리는 경우 상태 정보(what_rcvd 매개 변수를 통해 사용 가능)는 로컬 TP가 일반적으로 수행하는 다음 작업을 나타냅니다.
TP가 이 동사를 발급할 때 대화는 RECEIVE 또는 SEND 상태여야 합니다.
SEND 상태에서 동사 발급
대화가 SEND 상태인 동안 MC_RECEIVE_AND_WAIT 발급하면 다음과 같은 효과가 있습니다.
로컬 LU는 송신 버퍼의 정보와 SEND 표시기를 파트너 TP에 보냅니다.
대화가 RECEIVE 상태로 변경됩니다. 로컬 TP는 파트너 TP가 데이터를 보낼 때까지 기다립니다.
상태 변경
새 대화 상태는 다음 요인에 의해 결정됩니다.
TP가 동사를 발급할 때 대화의 상태입니다.
primary_rc 매개 변수입니다.
primary_rc AP_OK 포함하는 경우 what_rcvd 매개 변수입니다.
SEND 상태에서 발급된 동사
다음 표에서는 MC_RECEIVE_AND_WAIT SEND 상태에서 발급되고 primary_rcAP_OK 때의 상태 변경에 대해 자세히 설명합니다.
what_rcvd | 새 상태 |
---|---|
AP_CONFIRM_DEALLOCATE | CONFIRM_DEALLOCATE |
AP_DATA_COMPLETE_CONFIRM_DEALL | CONFIRM_DEALLOCATE |
AP_DATA_CONFIRM_DEALLOCATE | CONFIRM_DEALLOCATE |
AP_CONFIRM_SEND | CONFIRM_SEND |
AP_DATA_COMPLETE_CONFIRM_SEND | CONFIRM_SEND |
AP_DATA_CONFIRM_SEND | CONFIRM_SEND |
AP_CONFIRM_WHAT_RECEIVED | 확인 |
AP_DATA_COMPLETE_CONFIRM | 확인 |
AP_DATA_CONFIRM | 확인 |
AP_DATA | RECEIVE |
AP_DATA_COMPLETE | RECEIVE |
AP_DATA_INCOMPLETE | RECEIVE |
AP_SEND | 변경 내용 없음 |
AP_DATA_COMPLETE_SEND | SEND_PENDING |
다음 표에서는 MC_RECEIVE_AND_WAIT SEND 상태에서 발급되고 primary_rcAP_OK 않을 때의 상태 변경에 대해 자세히 설명합니다.
primary_rc | 새 상태 |
---|---|
AP_ALLOCATION_ERROR | RESET |
AP_CONV_FAILURE_RETRY | RESET |
AP_CONV_FAILURE_NO_RETRY | RESET |
AP_DEALLOC_ABEND | RESET |
AP_DEALLOC_ABEND_PROG | RESET |
AP_DEALLOC_ABEND_SVC | RESET |
AP_DEALLOC_ABEND_TIMER | RESET |
AP_DEALLOC_NORMAL | RESET |
AP_PROG_ERROR_PURGING | RECEIVE |
AP_PROG_ERROR_NO_TRUNC | RECEIVE |
AP_SVC_ERROR_PURGING | RECEIVE |
AP_SVC_ERROR_NO_TRUNC | RECEIVE |
RECEIVE 상태에서 발급된 동사
다음 표에서는 MC_RECEIVE_AND_WAIT RECEIVE 상태에서 발급되고 primary_rcAP_OK 때의 상태 변경에 대해 자세히 설명합니다.
what_rcvd | 새 상태 |
---|---|
AP_CONFIRM_DEALLOCATE | CONFIRM_DEALLOCATE |
AP_DATA_COMPLETE_CONFIRM_DEALL | CONFIRM_DEALLOCATE |
AP_DATA_CONFIRM_DEALLOCATE | CONFIRM_DEALLOCATE |
AP_CONFIRM_SEND | CONFIRM_SEND |
AP_DATA_COMPLETE_CONFIRM_SEND | CONFIRM_SEND |
AP_DATA_CONFIRM_SEND | CONFIRM_SEND |
AP_CONFIRM_WHAT_RECEIVED | 확인 |
AP_DATA_COMPLETE_CONFIRM | 확인 |
AP_DATA_CONFIRM | 확인 |
AP_DATA | 변경 내용 없음 |
AP_DATA_COMPLETE | 변경 내용 없음 |
AP_DATA_INCOMPLETE | 변경 내용 없음 |
AP_SEND | SEND |
AP_DATA_COMPLETE_SEND | SEND_PENDING |
다음 표에서는 MC_RECEIVE_AND_WAIT RECEIVE 상태에서 발급되고 primary_rcAP_OK 않을 때의 상태 변경에 대해 자세히 설명합니다.
primary_rc | 새 상태 |
---|---|
AP_ALLOCATION_ERROR | RESET |
AP_CONV_FAILURE_RETRY | RESET |
AP_CONV_FAILURE_NO_RETRY | RESET |
AP_DEALLOC_ABEND | RESET |
AP_DEALLOC_ABEND_PROG | RESET |
AP_DEALLOC_ABEND_SVC | RESET |
AP_DEALLOC_ABEND_TIMER | RESET |
AP_DEALLOC_NORMAL | RESET |
AP_PROG_ERROR_PURGING | 변경 내용 없음 |
AP_PROG_ERROR_NO_TRUNC | 변경 내용 없음 |
AP_SVC_ERROR_PURGING | 변경 내용 없음 |
AP_SVC_ERROR_NO_TRUNC | 변경 내용 없음 |
AP_PROG_ERROR_TRUNC | 변경 내용 없음 |
AP_SVC_ERROR_TRUNC | 변경 내용 없음 |