다음을 통해 공유

Deallocate(CPI-C)

할당 취소 호출(함수 이름 cmdeal)은 두 프로그램 간의 대화를 할당 취소합니다.

구문

  
CM_ENTRY Deallocate(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *return_code              
);

매개 변수

conversation_ID
제공된 매개 변수입니다. 대화의 식별자를 지정합니다. 이 매개 변수의 값은 Initialize_Conversation 또는 Accept_Conversation 반환되었습니다.

return_code
이 호출에서 반환된 코드입니다. 유효한 반환 코드는 이 항목의 뒷부분에 나와 있습니다.

반환 코드

CM_OK
기본 반환 코드; 호출이 성공적으로 실행되었습니다. 대화의 할당이 취소되었습니다.

CM_OPERATION_NOT_ACCEPTED
기본 반환 코드; 이 대화에 대한 이전 작업이 완료되지 않았습니다.

CM_OPERATION_INCOMPLETE
기본 반환 코드; 작업이 완료되지 않았으며(처리 모드는 차단 해제에만 해당) 아직 진행 중입니다. 프로그램은 Wait_For_Conversation 실행하여 작업 완료를 기다리거나 Cancel_Conversation 작업 및 대화를 취소할 수 있습니다. Specify_Windows_Handle 호출된 경우 애플리케이션은 Microsoft® Windows® 메시지의 알림을 기다리며 Wait_For_Conversation 호출하지 않아야 합니다.

CM_PROGRAM_PARAMETER_CHECK
기본 반환 코드; conversation_ID 지정한 값이 잘못되었습니다.

CM_PROGRAM_STATE_CHECK
기본 반환 코드; 할당 취소 형식이 정상적인 할당 취소(CM_DEALLOCATE_SYNC_LEVEL, CM_DEALLOCATE_FLUSH, CM_DEALLOCATE_CONFIRM)를 나타내는 경우 다음 상태 오류가 발생할 수 있습니다.

  • 대화가 SEND 또는 SEND_PENDING 상태가 아닙니다.

  • 기본 대화의 경우 대화가 SEND 상태이지만 프로그램에서 논리적 레코드 보내기를 완료하지 않았습니다.

    deallocate_type CM_DEALLOCATE_CONFIRM 또는 CM_DEALLOCATE_SYNC_LEVEL 설정되고 대화 동기화 수준이 CM_CONFIRM 설정된 경우 다음 반환 코드를 반환할 수 있습니다.

    CM_PRODUCT_SPECIFIC_ERROR
    기본 반환 코드; 제품별 오류가 발생하여 제품 오류 로그에 기록되었습니다.

    CM_CONVERSATION_TYPE_MISMATCH
    기본 반환 코드; LU(파트너 논리 단위) 또는 프로그램은 할당 요청에 지정된 대화 유형(기본 또는 매핑됨)을 지원하지 않습니다.

    CM_PIP_NOT_SPECIFIED_CORRECTLY
    기본 반환 코드; 할당 요청이 비 CPI-C LU 6.2 TP(트랜잭션 프로그램)에 의해 거부되었습니다. 파트너 프로그램에는 CPI-C에서 지원하지 않는 하나 이상의 PIP 데이터 변수가 필요합니다.

    CM_SECURITY_NOT_VALID
    기본 반환 코드; 할당 요청에 지정된 사용자 식별자 또는 암호가 파트너 LU에서 수락되지 않았습니다.

    CM_SYNC LEVEL_NOT_SUPPORTED_PGM
    기본 반환 코드; 파트너 프로그램은 할당 요청에 지정된 동기화 수준을 지원하지 않습니다.

    CM_TPN_NOT_RECOGNIZED
    기본 반환 코드; 파트너 LU가 할당 요청에 지정된 프로그램 이름을 인식하지 못합니다.

    CM_TP_NOT_AVAILABLE_NO_RETRY
    기본 반환 코드; 파트너 LU는 영구 조건으로 인해 할당 요청에 지정된 프로그램을 시작할 수 없습니다. 오류의 원인이 원격 노드에 기록될 수 있습니다. 오류가 수정될 때까지 할당을 다시 시도하지 마세요.

    CM_TP_NOT_AVAILABLE_RETRY
    기본 반환 코드; 파트너 LU는 임시 조건으로 인해 할당 요청에 지정된 프로그램을 시작할 수 없습니다. 오류의 원인이 원격 노드에 기록될 수 있습니다. 할당을 다시 시도하세요.

    CM_PROGRAM_ERROR_PURGING
    기본 반환 코드; 다음 중 하나가 발생했습니다.

  • RECEIVE 또는 CONFIRM 상태인 동안 파트너 프로그램이 Send_Error. 전송되었지만 아직 수신되지 않은 데이터는 제거됩니다.

  • 오류 방향이 CM_RECEIVE_ERROR 설정된 SEND_PENDING 상태에서 파트너 프로그램이 Send_Error. 데이터가 제거되지 않았습니다.

    CM_RESOURCE_FAILURE_NO_RETRY
    기본 반환 코드; 다음 중 하나가 발생했습니다.

  • 대화는 영구적 인 조건으로 인해 조기에 종료되었습니다. 오류가 수정될 때까지 다시 시도하지 마세요.

  • 파트너 프로그램은 정상적으로 종료하기 전에 대화의 할당을 취소하지 않았습니다.

    CM_RESOURCE_FAILURE_RETRY
    기본 반환 코드; 모뎀 오류와 같은 임시 조건으로 인해 대화가 조기에 종료되었습니다. 대화를 다시 시도합니다.

    CM_DEALLOCATED_ABEND
    기본 반환 코드; 다음 이유 중 하나로 인해 대화의 할당이 취소되었습니다.

  • 원격 프로그램에서 형식 매개 변수가 CM_DEALLOCATE_ABEND 설정된 Deallocate 를 실행했거나 원격 프로그램 비정상 종료 조건으로 인해 원격 LU가 실행되었습니다. 호출이 실행되었을 때 원격 프로그램에 대한 대화가 RECEIVE 상태이면 로컬 프로그램에서 전송하고 원격 프로그램에서 아직 받지 못한 정보가 제거됩니다.

  • 원격 TP는 정상적으로 종료되었지만 종료하기 전에 대화의 할당을 취소하지 않았습니다. 원격 LU의 노드 서비스가 원격 TP를 대신하여 대화의 할당을 취소했습니다.

    CM_DEALLOCATED_ABEND_SVC
    기본 반환 코드; 다음 이유 중 하나로 인해 대화의 할당이 취소되었습니다.

  • 파트너 프로그램에서 형식 매개 변수가 ABEND_SVC 설정된 Deallocate 를 발급했습니다.

  • 파트너 프로그램은 종료하기 전에 대화의 할당을 취소하지 않았습니다.

    로컬 프로그램에서 이 호출을 실행할 때 파트너 프로그램에 대한 대화가 RECEIVE 상태이면 로컬 프로그램에서 보낸 데이터와 파트너 프로그램에서 아직 받지 못한 데이터가 제거됩니다.

    CM_DEALLOCATED_ABEND_TIMER
    기본 반환 코드; 파트너 프로그램에서 형식 매개 변수가 ABEND_TIMER 설정된 Deallocate 를 실행했기 때문에 대화의 할당이 취소되었습니다. 로컬 프로그램에서 이 호출을 실행할 때 파트너 프로그램에 대한 대화가 RECEIVE 상태이면 로컬 프로그램에서 보낸 데이터와 파트너 프로그램에서 아직 받지 못한 데이터가 제거됩니다.

    CM_SVC_ERROR_PURGING
    기본 반환 코드; SEND 상태인 동안 파트너 프로그램 또는 파트너 LU는 형식 매개 변수가 SVC로 설정된 Send_Error 발급했습니다. 파트너 프로그램에 전송된 데이터가 제거되었을 수 있습니다.

    상태 변경

    대화 할당 취소 형식 매개 변수의 값에 따라( Set_Deallocate_Type 설정) 프로그램이 할당 취소를 실행할 때 다음 표에 표시된 상태 중 하나에 대화 가 있을 수 있습니다.

할당 취소 형식 허용되는 상태
CM_DEALLOCATE_FLUSH SEND 또는 SEND_PENDING
CM_DEALLOCATE_CONFIRM SEND 또는 SEND_PENDING
CM_DEALLOCATE_SYNC_LEVEL SEND 또는 SEND_PENDING
CM_DEALLOCATE_ABEND RESET을 제외한 모든

다음 표에 요약된 상태 변경 내용은 return_code 매개 변수의 값을 기반으로 합니다.

return_code 새 상태
CM_OK RESET
CM_PROGRAM_ERROR_PURGING RECEIVE
CM_SVC_ERROR_PURGING RECEIVE
CM_CONVERSATION_TYPE_MISMATCH RESET
CM_PIP_NOT_SPECIFIED_CORRECTLY RESET
CM_SECURITY_NOT_VALID RESET
CM_SYNC_LEVEL_NOT_SUPPORTED_PGM RESET
CM_TPN_NOT_RECOGNIZED RESET
CM_TP_NOT_AVAILABLE_NO_RETRY RESET
CM_TP_NOT_AVAILABLE_RETRY RESET
CM_RESOURCE_FAILURE_NO_RETRY RESET
CM_RESOURCE_FAILURE_RETRY RESET
CM_DEALLOCATED_ABEND RESET
CM_DEALLOCATED_ABEND_SVC RESET
CM_DEALLOCATED_ABEND_TIMER RESET
나머지 변경 내용 없음

설명

대화를 할당 취소하기 전에 이 호출은 현재 대화 동기화 수준 및 할당 취소 유형에 따라 Flush 또는 Confirmed 호출과 동일한 작업을 수행합니다. 할당 취소 형식은 Set_Deallocate_Type 의해 설정됩니다.

파트너 프로그램은 다음 매개 변수 중 하나를 통해 할당 취소 알림을 받습니다.

  • status_received CM_CONFIRM_DEALLOC_RECEIVED

  • return_code CM_DEALLOCATED_NORMAL

  • return_code CM_DEALLOCATED_ABEND

    이 호출이 성공적으로 실행되면 conversation_ID 더 이상 유효하지 않습니다.

    기본 대화의 경우 대화 할당 취소 유형이 CM_DEALLOCATE_ABEND 설정되고 로그 데이터 길이가 0보다 큰 경우 로컬 LU는 로그 데이터( Set_Log_Data 지정됨)를 로컬 오류 로그 및 파트너 LU에 씁니다.

    할당 취소가 실행되면 로그 데이터 길이가 0으로 설정되고 로그 데이터가 null로 설정됩니다.

  • Last updated on