SEND_DATA

아티클
07/21/2023

SEND_DATA 동사는 TP(파트너 트랜잭션 프로그램)로 전송하기 위해 로컬 LU(논리 단위) 송신 버퍼에 데이터를 배치합니다.

다음 구조체는 SEND_DATA 동사에서 사용하는 동사 제어 블록(VCB)을 설명합니다.

구문

  
struct send_data {  
    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       rts_rcvd;  
       unsigned char       data_type;  
    unsigned short int  dlen;  
    unsigned char FAR * dptr ;  
    unsigned char       type;  
    unsigned char       reserv4;  
};

구성원

opcode
제공된 매개 변수입니다. 동사 작업 코드 AP_B_SEND_DATA 지정합니다.

opext
제공된 매개 변수입니다. 동사 연산 확장 AP_BASIC_CONVERSATION 지정합니다.

reserv2
예약된 필드입니다.

primary_rc
반환된 매개 변수입니다. 동사를 완료할 때 APPC에서 설정하는 기본 반환 코드를 지정합니다. 유효한 반환 코드는 발행된 APPC 동사에 따라 다릅니다. 이 동사의 유효한 오류 코드는 반환 코드를 참조하세요.

secondary_rc
반환된 매개 변수입니다. 동사를 완료할 때 APPC에서 설정하는 보조 반환 코드를 지정합니다. 유효한 반환 코드는 발행된 APPC 동사에 따라 다릅니다. 이 동사의 유효한 오류 코드는 반환 코드를 참조하세요.

tp_id
제공된 매개 변수입니다. 로컬 TP를 식별합니다.

이 매개 변수의 값은 호출하는 TP의 TP_STARTED 또는 호출된 TP의 RECEIVE_ALLOCATE 반환됩니다.

conv_id
제공된 매개 변수입니다. 대화 식별자를 제공합니다.

이 매개 변수의 값은 호출하는 TP의 ALLOCATE 또는 호출된 TP의 RECEIVE_ALLOCATE 반환됩니다.

rts_rcvd
반환된 매개 변수입니다. 수신 요청 표시기를 제공합니다.

AP_YES 파트너 TP가 로컬 TP가 대화를 RECEIVE 상태로 변경하도록 요청하는 REQUEST_TO_SEND 발급했음을 나타냅니다. RECEIVE 상태로 변경하기 위해 로컬 TP는 PREPARE_TO_RECEIVE, RECEIVE_AND_WAIT 또는 RECEIVE_AND_POST 사용할 수 있습니다.
AP_NO 파트너 TP가 REQUEST_TO_SEND 발급하지 않았다는 것을 나타냅니다.

data_type
제공된 매개 변수입니다. 동기화 지점이 지원되는 경우 보낼 데이터 형식을 지정합니다. 유효한 매개 변수는 다음과 같습니다.

AP_APPLICATION

AP_USER_CONTROL_DATA

AP_PS_HEADER

dlen
제공된 매개 변수입니다. 로컬 LU의 송신 버퍼에 넣을 데이터 바이트 수를 지정합니다. 범위는 0에서 65535까지입니다.

dptr
제공된 매개 변수입니다. 로컬 LU의 송신 버퍼에 넣을 데이터를 포함하는 버퍼의 주소를 지정합니다.

Microsoft Windows 운영 체제의 경우 데이터 버퍼는 정적 데이터 영역 또는 전역적으로 할당된 영역에 상주할 수 있습니다. 데이터 버퍼는 이 영역 내에 완전히 맞아야 합니다.

type
제공된 매개 변수입니다. TP가 한 API 호출 내에서 데이터를 보내고 다른 함수를 수행할 수 있도록 허용합니다. 예를 들어 SEND_DATA CONFIRM로 설정된 형식 과 결합하여 SEND_DATA 발급한 다음 CONFIRM와 동일한 목표를 달성할 수 있습니다.
AP_SEND_DATA_CONFIRM SEND_DATA 뒤에 CONFIRM에 해당합니다.
AP_SEND_DATA_FLUSH 플러시 뒤에 SEND_DATA 해당합니다.
AP_SEND_DATA_DEALLOC_ABEND SEND_DATA 뒤에 AP_ABEND_PROGdealloc_typeDEALLOCATE에 해당합니다.
AP_SEND_DATA_DEALLOC_FLUSH SEND_DATA 뒤에 AP_FLUSHdealloc_typeDEALLOCATE에 해당합니다.
AP_SEND_DATA_DEALLOC_SYNC_LEVEL SEND_DATA 뒤에 AP_SYNC_LEVEL dealloc_typeDEALLOCATE에 해당합니다.
AP_SEND_DATA_P_TO_R_FLUSH AP_FLUSH ptr_typePREPARE_TO_RECEIVE 뒤에 SEND_DATA 해당합니다.
AP_SEND_DATA_P_TO_R_SYNC_LEVEL SEND_DATA 다음에 PREPARE_TO_RECEIVE ptr_type AP_SYNC_LEVEL 및 잠금 이 AP_SHORT 설정된 에 해당합니다.

reserv4
예약된 필드입니다.

반환 코드

AP_OK
기본 반환 코드입니다. 동사가 성공적으로 실행되었습니다.

AP_PARAMETER_CHECK
기본 반환 코드입니다. 매개 변수 오류로 인해 동사가 실행되지 않았습니다.

AP_BAD_CONV_ID

보조 반환 코드; conv_id 값이 APPC에서 할당한 대화 식별자와 일치하지 않습니다.

AP_BAD_LL

보조 반환 코드; 논리 레코드의 논리적 레코드 길이 필드에 잘못된 값(0x0000, 0x0001, 0x8000 또는 0x8001 포함됨) 논리적 레코드에 대한 자세한 내용은 트랜잭션 프로그램 정보를 참조하세요.

AP_BAD_TP_ID

보조 반환 코드; tp_id 값이 APPC에서 할당한 TP 식별자와 일치하지 않습니다.

AP_INVALID_DATA_SEGMENT

보조 반환 코드; 데이터 버퍼에 대해 지정된 길이가 버퍼를 포함하도록 할당된 세그먼트보다 길었다.

AP_SEND_DATA_INVALID_TYPE

보조 반환 코드; 지정된 형식이 APPC에서 인식되지 않았습니다.

AP_SEND_DATA_CONFIRM_SYNC_NONE

보조 반환 코드; NONE의 sync_level 할당된 대화에는 CONFIRM 형식이 허용되지 않습니다.

AP_STATE_CHECK
기본 반환 코드입니다. 동사가 잘못된 상태에서 발행되었으므로 실행되지 않았습니다.

AP_SEND_DATA_NOT_SEND_STATE

보조 반환 코드; 로컬 TP가 SEND_DATA 발급했지만 대화가 SEND 상태가 아니었습니다.

AP_SEND_DATA_NOT_LL_BDY

보조 반환 코드; TP가 시작되었지만 논리 레코드 보내기를 완료하지 않았습니다. 이는 형식 매개 변수가 다음 중 하나일 때만 발생합니다.

AP_SEND_DATA_CONFIRM

AP_SEND_DATA_DEALLOC_FLUSH

AP_SEND_DATA_DEALLOC_SYNC_LEVEL

AP_SEND_DATA_P_TO_R_FLUSH

AP_SEND_DATA_P_TO_R_SYNC_LEVEL

AP_ALLOCATION_ERROR
기본 반환 코드; APPC에서 대화를 할당하지 못했습니다. 대화 상태가 RESET로 설정됩니다.

이 코드는 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_COMM_SUBSYSTEM_NOT_LOADED
기본 반환 코드; 동사를 처리하는 동안 필수 구성 요소를 로드하거나 종료할 수 없습니다. 따라서 통신을 수행할 수 없습니다. 정정 작업은 시스템 관리자에게 문의하세요

이 반환 코드를 ALLOCATE와 함께 사용하면 로컬 LU를 지원하는 통신 시스템을 찾을 수 없음을 나타낼 수 있습니다. 예를 들어 TP_STARTED 지정된 로컬 LU 별칭이 잘못되었거나 구성되지 않았습니다. lu_alias 또는 mode_name 8자 미만인 경우 이러한 필드가 오른쪽의 공백으로 채워져 있는지 확인해야 합니다. 이 오류는 ALLOCATE 요청을 충족할 수 있는 노드가 없으므로 이러한 매개 변수가 공백으로 채워지지 않으면 반환됩니다.

ALLOCATE가 여러 노드로 구성된 호스트 통합 서버 클라이언트 시스템에 대해 이 반환 코드를 생성하는 경우 다음과 같이 두 개의 보조 반환 코드가 있습니다.

0xF0000001

보조 반환 코드; 노드가 시작되지 않았습니다.

0xF0000002

보조 반환 코드; 하나 이상의 노드가 시작되었지만 로컬 LU( TP_STARTED 발급될 때)가 활성 노드에서 구성되지 않았습니다. 문제는 다음 중 하나일 수 있습니다.
로컬 LU가 있는 노드가 시작되지 않았습니다.
로컬 LU가 구성되지 않았습니다.

AP_CONV_FAILURE_NO_RETRY
기본 반환 코드; 세션 프로토콜 오류와 같은 영구적인 조건으로 인해 대화가 종료되었습니다. 시스템 관리자는 시스템 오류 로그를 검사하여 오류의 원인을 확인해야 합니다. 오류가 수정될 때까지 대화를 다시 시도하지 마세요.

AP_CONV_FAILURE_RETRY
기본 반환 코드; 일시적인 오류로 인해 대화가 종료되었습니다. TP를 다시 시작하여 문제가 다시 발생하는지 확인합니다. 이 경우 시스템 관리자는 오류 로그를 검사하여 오류의 원인을 확인해야 합니다.

AP_CONVERSATION_TYPE_MIXED
기본 반환 코드; TP는 기본 및 매핑된 대화 동사를 모두 실행했습니다. 단일 대화에서 하나의 형식만 발급할 수 있습니다.

AP_INVALID_VERB_SEGMENT
기본 반환 코드입니다. VCB가 데이터 세그먼트의 끝을 넘어 확장되었습니다.

AP_PROG_ERROR_PURGING
기본 반환 코드; RECEIVE, PENDING, PENDING_POST, CONFIRM, CONFIRM_SEND 또는 CONFIRM_DEALLOCATE 상태인 동안 파트너 TP는 err_type AP_PROG 설정된 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_PROG
기본 반환 코드; 대화의 할당이 취소된 이유는 다음과 같습니다.
파트너 TP는 dealloc_type AP_ABEND_PROG 설정된 DEALLOCATE를 발급했습니다.
파트너 TP가 ABEND를 발견하여 파트너 LU가 DEALLOCATE 요청을 보냅니다.

AP_DEALLOC_ABEND_SVC
기본 반환 코드; 파트너 TP가 AP_ABEND_SVC 설정된 dealloc_typeDEALLOCATE를 발급했기 때문에 대화의 할당이 취소되었습니다.

AP_DEALLOC_ABEND_TIMER
기본 반환 코드; 파트너 TP가 AP_ABEND_TIMER 설정된 dealloc_typeDEALLOCATE를 발급했기 때문에 대화의 할당이 취소되었습니다.

AP_SVC_ERROR_PURGING
기본 반환 코드; 파트너 TP(또는 파트너 LU)는 receive, PENDING_POST , CONFIRM, CONFIRM_SEND 또는 CONFIRM_DEALLOCATE 상태에 있는 동안 err_type AP_SVC 설정된 SEND_ERROR 동사를 발급했습니다. 파트너 TP로 전송된 데이터가 제거되었을 수 있습니다.

설명

TP가 이 동사를 발급할 때 대화는 SEND 상태여야 합니다. primary_rc 따라 상태 변경 내용은 다음 표에 요약되어 있습니다.

primary_rc	새 상태
AP_OK	변경 내용 없음
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_PROG_ERROR_PURGING	RECEIVE
AP_SVC_ERROR_PURGING	RECEIVE

파트너 TP가 수신 동사를 발급하지 않았기 때문에 SEND_DATA 무기한 대기할 수 있습니다. 이 경우 송신 버퍼가 채워질 수 있습니다.

로컬 LU의 송신 버퍼에서 수집된 데이터는 다음 중 하나가 발생할 때 파트너 LU(및 파트너 TP)로 전송됩니다.

송신 버퍼가 채워 줍니다.
로컬 TP는 FLUSH, CONFIRM 또는 DEALLOCATE (또는 LU의 송신 버퍼를 플러시하는 기타 동사)를 발급합니다.

다음을 통해 공유

SEND_DATA

구문

구성원

반환 코드

설명

추가 리소스