Initialize_Conversation(CPI-C)
8 바이트 대화 식별자를 가져오고 대화 특성에 대한 초기 값을 설정하기 위해 호출 프로그램에서 Initialize_Conversation 호출(함수 이름 cminit)을 실행합니다.
구문
CM_ENTRY Initialize_Conversation(
unsigned char FAR *conversation_ID,
unsigned char FAR *sym_dest_name,
CM_INT32 FAR *return_code
);
매개 변수
conversation_ID
반환된 매개 변수입니다. 대화의 식별자를 지정합니다. 후속 CPI-C 호출에서 사용됩니다.
sym_dest_name
제공된 매개 변수입니다. 심볼 대상 이름(구성 파일에서 로드되거나 Set_CPIC_Side_Information 호출로 정의된 측면 정보 항목과 연결된 이름)을 지정합니다.
이 매개 변수는 8바이트 ASCII 문자열입니다. 허용되는 문자는 다음과 같습니다.
대문자
숫자 0~9
이 매개 변수는 8개의 공백으로 설정할 수도 있습니다. 이 경우 호출 프로그램은 할당을 실행하기 전에 다음 호출을 실행해야 합니다.
-
return_code
이 호출에서 반환된 코드입니다. 유효한 반환 코드는 이 항목의 뒷부분에 나와 있습니다.
반환 코드
CM_OK
기본 반환 코드; 호출이 성공적으로 실행되었습니다.
CM_PROGRAM_PARAMETER_CHECK
기본 반환 코드; sym_dest_name 지정된 값이 측면 정보 테이블의 기호 대상 이름과 일치하지 않으며 공백이 아닙니다.
CM_PRODUCT_SPECIFIC_ERROR
기본 반환 코드; 제품별 오류가 발생하여 제품 오류 로그에 기록되었습니다.
상태 변경
대화가 RESET 상태입니다.
return_code CM_OK 경우 대화가 INITIALIZE 상태로 변경됩니다. 다른 반환 코드의 경우 대화 상태는 변경되지 않은 상태로 유지됩니다.
설명
초기 값은 CPI-C 기본값이거나 기호 대상 이름과 연결된 측면 정보에서 파생됩니다. 초기 값 및 측면 정보에 대한 자세한 내용은 CPI-C 프로그램에 대한초기 대화 특성 및 측면 정보를 참조하세요.
초기 값은 Set_ 호출에 의해 변경될 수 있습니다.
사이드 정보에 잘못된 값이 포함되어 있거나 Set_ 호출이 대화 특성을 잘못된 값으로 설정하는 경우 할당 호출에서 오류가 반환됩니다.
CPI-C 애플리케이션이 둘 이상의 동시 대화를 호출하려고 하면 모든 대화에서 단일 로컬 APPC 논리 단위(LU)만 사용됩니다. 이렇게 하면 둘 이상의 종속 LU 6.2 RU에서 동시 대화를 방지하여 후속 Initialize_Conversation(CMALLC) 호출이 첫 번째 대화의 할당을 취소할 때까지 기다립니다.
CPI-C 애플리케이션이 둘 이상의 동시 대화를 호출해야 하는 경우 호스트 통합 서버와 원격 시스템 간에 독립적인 LU 6.2를 사용해야 합니다.
이 호출을 성공적으로 실행하면 CPI-C에서 대화 식별자를 생성합니다. 이 식별자는 호출 프로그램에서 이 대화에 대해 발급된 다른 모든 CPI-C 호출에 필요한 매개 변수입니다.
정상적인 상황에서 CPI-C 애플리케이션은 두 개의 서로 다른 로컬 APPC RU를 사용하여 두 개의 동시 대화를 호출할 수 없습니다. 레지스트리 키는 설정 시 CPI-C가 모든 Initialize_Conversation(cminit) 호출에서 새 TP_STARTED 동사를 실행하도록 강제하는 것을 사용할 수 있습니다. 이는 각 호출에 대해 APPC 리소스 위치를 강제 적용하는 데 필요합니다. 이 동작을 강제로 적용하기 위해 정의해야 하는 레지스트리 키는 다음과 같습니다.
\HKLM\CurrentControlSet\Services\SnaBase\Parameters\Client\GETNEWTPID