호스트 애플리케이션용 BizTalk 어댑터 구성
호스트 애플리케이션 구성용 BizTalk 어댑터 대화 상자를 사용하여 원격 IBM CICS, IMS 또는 iSeries 시스템에 대한 연결을 정의하고 관리할 수 있습니다. 연결 문자열 속성 값 필드를 클릭하면 시작됩니다. 호스트 애플리케이션 구성용 BizTalk 어댑터 대화 상자를 사용하여 TI .NET 어셈블리를 추가할 수 있습니다. 이를 매핑의 일부로 사용하여 매핑 가져오기, 내보내기 및 삭제, 연결 문자열 편집, TI .NET 어셈블리의 속성 확인 작업을 수행할 수 있습니다.
호스트 애플리케이션 구성 대화 상자 구성 요소에는 도구 모음, 메뉴, 데이터 그리드 및 결과 창이 포함됩니다. 이 항목에는 수행 가능한 다양한 작업을 설명하는 다음과 같은 섹션이 포함됩니다.
이전 버전의 Host Integration Server에서 업그레이드
도구 모음 및 메뉴 명령
도구 모음과 상황에 맞는 메뉴를 통해 연결 문자열을 만들고 관리하는 명령에 액세스할 수 있습니다. 데이터 그리드의 아무 곳이나 마우스 오른쪽 단추로 클릭하여 상황에 맞는 메뉴를 표시할 수 있습니다. 예를 들어 연결 문자열을 마우스 오른쪽 단추로 클릭하면 매핑을 보고, 편집하고, 삭제하고, 가져오고, 내보낼 수 있습니다. 연결 문자열을 두 번 클릭하여 편집 모드에서 표시할 수 있습니다. DELETE 키는 현재 선택한 항목을 삭제하고 F1 키는 온라인 도움말을 엽니다.
다음 목록에서는 수행할 수 있는 작업을 설명합니다.
GAC(전역 어셈블리 캐시)에서 TI .NET 어셈블리를 추가하거나 로컬 파일 경로를 사용하여 매핑에 어셈블리를 추가합니다. 열은 어셈블리에서 리플렉션된 기본값으로 채워집니다. 필요한 값을 입력하지 않으면 기본 연결 문자열을 사용할 수 없습니다.
선택한 매핑을 삭제합니다. 삭제를 확인하는 대화 상자가 나타납니다.
매핑을 선택한 후 매핑의 연결 문자열 부분을 편집합니다. 연결 문자열 대화 상자를 시작하여 연결 문자열을 편집합니다.
매핑을 XML로 내보내면 매핑을 백업할 수 있습니다. 나중에 매핑 가져오기 기능을 사용하여 매핑을 복원할 수 있습니다. Import/Export 기능을 사용하여 엔드포인트 간에 매핑을 공유할 수 있습니다.
매핑 또는 RE 가져오기를 사용하면 호스트 애플리케이션 구성용 BizTalk 어댑터 대화 상자에서 내보낸 XML을 가져올 수 있습니다. 매핑을 선택한 후 TI 관리자에서 내보낸 RE 정의를 가져올 수도 있습니다.
TI .NET 어셈블리의 속성 보기에 어셈블리 속성이 표시됩니다. XML 태그는 이 어셈블리가 지원하는 입출력 문서의 이름을 표시합니다. 메서드 이름은 태그 이름의 일부이지만 매핑을 찾을 때 사용되지 않습니다. 모든 속성이 읽기 전용입니다.
DataGrid 매핑 창
DataGrid 매핑 대화 상자에는 다음 항목이 포함되어 있습니다.
상태(완전 또는 불완전). 연결 문자열에 연결 정보가 없는 경우 빨간색 동그라미에 흰색 느낌표가 있는 경고가 나타납니다. 누락된 정보를 추가하면 경고가 사라집니다.
매핑의 일부로 사용되는 TI 어셈블리의 ClassName 및 Interface 이름.
어셈블리 이름. GAC에서 어셈블리가 로드되는 경우에는 어셈블리의 강력한 이름이고, 로컬 어셈블리인 경우에는 어셈블리의 전체 경로입니다. 이 필드는 어셈블리가 추가될 때 자동으로 채워지며 읽기 전용입니다.
원격 환경은 연결 문자열을 정의합니다. 이는 BizTalk 호스트 애플리케이션 어댑터에서 요청을 수신하는 원격 시스템의 특징을 나타냅니다. 연결 문자열은 원격 환경 유형, 프로그래밍 모델, 원격 호스트 ID, 네트워크 전송 및 원격 호스트와 통신할 때 사용되는 기타 설정으로 구성됩니다.
원격 엔드포인트 원격 IBM 호스트의 DNS 이름 또는 IP 주소입니다.
결과 창 현재 선택한 매핑의 연결 문자열 값을 표시합니다.
매핑 만들기 및 관리
이 섹션에서는 사용자가 수행할 수 있는 작업을 설명합니다.
어셈블리를 추가하여 연결 문자열 만들기
도구 모음에서 폴더 아이콘을 클릭한 다음, GAC의 어셈블리 추가 또는 로컬 어셈블리 추가를 선택합니다. GAC의 어셈블리 추가는 선택할 수 있는 GAC의 모든 어셈블리를 나열하는 대화 상자를 시작합니다. 로컬 어셈블리 추가를 선택하는 경우 로컬에 설치된 어셈블리를 찾아볼 수 있습니다.
또한 메뉴의 GAC 추가 또는 로컬 어셈블리 추가 옵션을 사용하여 어셈블리를 추가할 수도 있습니다.
연결 문자열 삭제
삭제할 매핑을 선택합니다. 선택한 매핑을 삭제하려면 도구 모음에서 [X] 아이콘을 클릭합니다. 삭제를 확인할 수 있도록 대화 상자가 표시됩니다.
메뉴에서 매핑 삭제 옵션을 사용하여 매핑을 삭제할 수도 있습니다.
연결 문자열 편집
연결 문자열은 RE 인스턴스를 하이드레이션하는 데 사용됩니다. 어셈블리가 지정된 경우 기본값으로 채워집니다. 선택한 매핑을 두 번 클릭하거나 편집을 선택하거나 연결 문자열 편집 메뉴를 선택하여 연결 문자열 대화 상자를 시작합니다. 그러면 지정된 RE에 대한 연결 문자열을 편집할 수 있습니다. 필수 값을 입력하지 않으면 오류 플래그가 표시됩니다.
RE 개체는 최소 필수 속성 값의 유효성을 검사합니다. 필수 속성 값이 설정되지 않은 경우 연결 문자열 셀에 플래그가 지정됩니다. 필수 속성은 이 항목의 연결 문자열 설정 및 매핑 섹션에 나열되어 있습니다. RE 유효성 검사는 범위 내에서 제한되고 잘못된 값은 TI 런타임 오류를 유발할 수 있습니다.
대화 상자에는 편집할 수 있는 속성 및 편집할 수 없는 속성이 그리드로 표시됩니다. 하단의 읽기 전용 텍스트 상자에는 속성 그리드에 입력한 값에 따라 생성되는 연결 문자열이 표시됩니다. 속성은 개체 자체에 정의된 값을 사용하여 RE 개체에 정의된 공용 메서드를 기반으로 수집됩니다. 속성 값을 원활하게 편집할 수 있도록 일부 형식 변환기 및 속성 편집기가 제공됩니다.
원격 환경은 호스트에 연결하는 데 필요한 속성을 표시합니다. 이러한 속성은 속성 그리드에 별표(*)로 표시됩니다. 하나 이상의 속성이 누락된 경우 빨간색 동그라미에 흰색 느낌표가 있는 경고가 데이터 그리드에 표시됩니다. 이 경고는 런타임에 재정의를 사용하여 누락된 속성을 제공할 수 있음을 알립니다.
보안 설정은 미리 정의된 보안 열거에 의해 제어되며, OR 연산자로 이를 결합하여 새 보안 설정을 구성할 수 있습니다.
끔 플래그는 클라이언트, 패키지 및 사용자 전용입니다. 다른 세 가지 중 하나를 선택하면 끔이 지워집니다. 끔을 선택하면 다른 세 가지 옵션이 모두 지워집니다.
SSOApplication 편집기는 이전 릴리스에서 약간 변경된 후 포팅되었습니다. 속성 그리드에서 직접 관련 응용 프로그램을 지정하거나 편집기를 사용하여 이미 생성된 애플리케이션을 선택할 수 있습니다.
연결 문자열 설정 및 매핑
다음 표에서는 호스트 환경 및 프로그래밍 모델을 정의할 때 지원되는 속성을 보여 줍니다. 별표는 필수 속성을 나타냅니다.
기본값은 RE 개체 자체를 사용하여 설정되며 제한된 유효성 검사가 수행됩니다.
SNA 사용자 데이터
| 속성 | 값 |
|---|---|
| 속성 | 값 |
| CodePage | 37 |
| 로캘 | 1033 |
| **LocalLUName* | |
| **ModeName* | PA62TKNU |
| 이름 | SNAUserData. 읽기 전용입니다. |
| **RemoteLUName* | |
| 보안 | 끄기 |
| SSOApplication | |
| SynLevel2Supported | 거짓 |
| TimeOut | 0 |
*필수 필드입니다.
SNA 링크
| 속성 | 값 |
|---|---|
| 속성 | 값 |
| AdministrationFlags | 0 |
| CodePage | 37 |
| 로캘 | 1033 |
| **LocalLUName* | |
| MirrorTranId | CSMI |
| **ModeName* | PA62TKNU |
| 이름 | SNALink. 읽기 전용입니다. |
| **RemoteLUName* | |
| 보안 | 끄기 |
| SSOApplication | |
| SyncLevel2Supported | 거짓 |
| TimeOut | 0 |
*필수 필드입니다.
HTTP 사용자 데이터
| 속성 | 값 |
|---|---|
| 속성 | 값 |
| AliasTransactionId | |
| AllowRedirects | 거짓 |
| CodePage | 37 |
| **HttpPort* | |
| **Ipaddress* | |
| 로캘 | 1033 |
| 이름 | HttpUserData. 읽기 전용입니다. |
| 보안 | 끄기 |
| SSOApplication | |
| TimeOut | 0 |
| UserAgent | |
| UseSsl | 거짓 |
*필수 필드입니다.
HTTP 링크
| 속성 | 값 |
|---|---|
| 속성 | 값 |
| AliasTransactionId | |
| AllowRedirects | 거짓 |
| CodePage | 37 |
| 변환기 | |
| **HttpPort* | |
| **Ipaddress* | |
| 로캘 | 1033 |
| MirrorProgramName | |
| 이름 | HttpLink. 읽기 전용입니다. |
| 보안 | 끄기 |
| SSOApplication | |
| TimeOut | 0 |
| UseConverter | 거짓 |
| UserAgent | |
| UseSsl | 거짓 |
*필수 필드입니다.
IMS LU6.2
| 속성 | 값 |
|---|---|
| 속성 | 값 |
| CodePage | 37 |
| 로캘 | 1033 |
| **LocalLUName* | |
| **ModeName* | PA62TKNU |
| 이름 | IMSLU62. 읽기 전용입니다. |
| **RemoteLUName* | |
| 보안 | 끄기 |
| SSOApplication | |
| TimeOut | 0 |
*필수 필드입니다.
IMS 연결
| 속성 | 값 |
|---|---|
| 속성 | 값 |
| CodePage | 37 |
| ImsFormatModName | |
| **Ipaddress* | |
| ItocExitName | |
| 로캘 | 1033 |
| 이름 | IMSConnect. 읽기 전용입니다. |
| OtmaSystemId | |
| 보안 | 끄기 |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*필수 필드입니다.
TRM 사용자 데이터/링크
| 속성 | 값 |
|---|---|
| 속성 | 값 |
| CodePage | 37 |
| ConcurrentServerTransactionId | MSCS |
| **Ipaddress* | |
| 로캘 | 1033 |
| 이름 | TRMUserData. 읽기 전용입니다. |
| 보안 | 끄기 |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*필수 필드입니다.
ELM 사용자 데이터/링크
| 속성 | 값 |
|---|---|
| 속성 | 값 |
| CodePage | 37 |
| **Ipaddress* | |
| 로캘 | 1033 |
| 이름 | ELMUserData. 읽기 전용입니다. |
| 보안 | 끄기 |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*필수 필드입니다.
분산 프로그램 호출
| 속성 | 값 |
|---|---|
| 속성 | 값 |
| CodePage | 37 |
| **Ipaddress* | |
| 로캘 | 1033 |
| 이름 | DistributedProgramCall. 읽기 전용입니다. |
| 보안 | 끄기 |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*필수 필드입니다.
시스템 Z 소켓 사용자 데이터/링크
| 속성 | 값 |
|---|---|
| 속성 | 값 |
| CodePage | 37 |
| **Ipaddress* | |
| 로캘 | 1033 |
| 이름 | SystemzSocketsUserData. 읽기 전용입니다. |
| 보안 | 끄기 |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*필수 필드입니다.
시스템 I 소켓 사용자 데이터
| 속성 | 값 |
|---|---|
| CodePage | 37 |
| **Ipaddress* | |
| 로캘 | 1033 |
| 이름 | SystemSocketUserData. 읽기 전용입니다. |
| 보안 | 끄기 |
| SSOApplication | *TCPPorts |
| TimeOut | 0 |
*필수 필드입니다.
매핑 가져오기
호스트 애플리케이션 구성용 BizTalk 어댑터에서 내보낸 매핑을 가져오려면 매핑 또는 RE 가져오기 아이콘을 클릭합니다. 매핑 가져오기를 선택하거나 파일 메뉴에서 매핑 가져오기를 선택합니다. 그런 다음, 호스트 애플리케이션 구성용 BizTalk 어댑터 대화 상자에서 내보낸 XML을 찾아볼 수 있습니다. 가져올 파일을 선택합니다. 가져오기 프로세스에서 기존 매핑을 덮어쓰지 않습니다.
RE 정의 가져오기
TI 관리자에서 내보낸 RE 정의를 가져오는 데 사용됩니다. 매핑을 선택한 후 매핑 또는 RE 가져오기 아이콘을 클릭합니다. RE 가져오기를 선택하거나 파일 메뉴에서 RE 가져오기를 선택합니다. 그런 다음, TI 관리자에서 내보낸 XML을 찾아볼 수 있습니다. 선택할 수 있는 RE 정의를 나열하는 대화 상자가 표시됩니다. 선택한 매핑과 동일한 프로그램 모델을 가진 RE 정의만 표시됩니다.
매핑 내보내기
매핑을 XML 파일로 내보내려면 XML로 매핑 내보내기 아이콘을 클릭하거나 파일 메뉴에서 매핑 내보내기를 선택합니다. 그런 다음, 파일을 저장할 수 있는 위치를 찾아볼 수 있습니다. 매핑 가져오기 기능을 사용하여 이 파일을 가져올 수 있습니다.
어셈블리 속성
이 어셈블리에서 지원하는 입출력 문서의 XML 태그 이름뿐만 아니라 어셈블리의 관련 속성도 볼 수 있습니다. 메서드 이름은 태그 이름의 일부이지만 매핑을 찾을 때 사용되지 않습니다. 모든 속성이 읽기 전용입니다. 매핑을 선택한 후 어셈블리 속성 아이콘을 클릭하거나 메뉴에서 어셈블리 속성 표시를 선택합니다.
이전 버전의 Host Integration Server에서 업그레이드
이 섹션에서는 연결 문자열을 사용하도록 기존 BAHA 애플리케이션을 마이그레이션하는 방법을 설명합니다.
BAHA에서 기본 RE가 사용된 경우, TI 관리자를 사용하여 구성을 내보낸 다음, 연결 문자열 대화 상자를 사용하여 구성을 가져옵니다.
기본값이 아닌 RE가 사용된 경우, 배포 개체를 TI 관리자의 새 RE와 연결하고 TI 관리자에서 구성을 내보냅니다. 연결 문자열 대화 상자를 사용하여 구성을 가져옵니다.
호스트 유형 대화 상자가 제거되었기 때문에 BizTalk Server 관리에서 RE를 전환하려면 연결 문자열을 사용해야 합니다.
BizTalk Server 관리를 통한 RE 재정의는 지원되지 않습니다. 메시지 컨텍스트를 사용하여 RE 재정의를 구현할 수 있지만 이 방법은 권장하지 않습니다. 연결 문자열을 사용하는 것이 좋습니다.
기본이 아닌 SSO 애플리케이션이 지정된 경우, TI 관리자를 사용하여 기본이 아닌 SSO 애플리케이션에 RE를 연결하고 정적 RE를 계속 사용할 수 있습니다. 또는 연결 문자열에 지정할 수도 있습니다.
TI 관리자에서 내보낸 XML 가져오기
마이그레이션을 수행하고 있지 않다면 TI 관리자가 필요하지 않습니다. RE 및 WIP 개체의 정의를 연결 문자열 대화 상자에서 가져올 수 있는 XML 파일로 내보낼 수 있습니다.
경고
매핑에 사용되는 TI .NET 어셈블리에는 컨텍스트 매개 변수 포함 속성이 True로 설정되어 있어야 합니다. 그렇지 않으면 TI 메서드 호출이 런타임에 실패합니다.
호스트 애플리케이션 구성용 BizTalk 어댑터는 Host Integration Server 2009에 도입된 동적 RE 기능을 사용합니다. 동적 RE를 사용하면 호스트 연결 정보가 알려진 경우 TI 런타임에 필요한 호스트 정보를 메서드를 호출하기 직전에 지정할 수 있습니다. 해당 메서드를 호출하기 전에 .NET 클라이언트 어셈블리를 배포하고 TI 관리자의 미리 정의된 RE와 연결해야 하는 것은 아닙니다.
BAHA의 경우 연결 정보를 구문 분석되는 연결 문자열로 작성하고, 런타임에 생성된 RE 개체로 설정할 수 있습니다. 호스트 애플리케이션 어댑터를 호스트하는 포트가 구성된 경우 RE에 대한 정보를 지정할 수 있습니다. BizTalk 관리 기능을 통해 관리되는 포트 구성 정보의 일부로 저장됩니다. 이 접근법에서는 BAHA를 사용하여 .NET 애플리케이션을 호스트 애플리케이션과 통합하는 경우 TI 디자이너를 사용하여 TI .NET 클라이언트 어셈블리를 만들기만 하면 됩니다. 다른 모든 작업은 BizTalk Server에서 수행할 수 있습니다.
다음 표에서는 도구 모음 메뉴 및 동작에 대해 설명합니다.
| 도구 모음/메뉴 | 동작 |
|---|---|
| 어셈블리를 추가하여 연결 문자열 만들기 | GAC에서 또는 로컬 파일 경로를 사용하여 TI .NET 어셈블리를 추가하거나 어셈블리를 매핑에 추가합니다. 모든 열은 어셈블리에서 리플렉션된 기본값으로 채워집니다. 필요한 값을 입력하지 않으면 기본 연결 문자열을 사용할 수 없습니다. |
| 연결 문자열 삭제 | 선택한 매핑을 삭제합니다. 삭제를 확인하는 대화 상자가 표시됩니다. |
| 연결 문자열 편집 | 매핑을 선택한 후 연결 문자열 대화 상자를 시작하여 연결 문자열을 편집하는 방식으로 매핑의 연결 문자열 부분을 편집합니다. |
| XML로 매핑 내보내기 | 내보내기를 통해 매핑을 백업할 수 있습니다. 나중에 매핑 가져오기 기능을 사용하여 매핑을 가져올 수 있습니다. Import/Export 기능을 사용하여 엔드포인트 간에 매핑을 쉽게 공유할 수 있습니다. |
| 매핑 또는 RE 가져오기 | 호스트 애플리케이션 구성용 BizTalk 어댑터 대화 상자에서 내보낸 XML을 가져오는 데 사용됩니다. 또한 매핑을 선택한 후 TI 관리자에서 내보낸 RE 정의를 가져오는 데에도 사용됩니다. |
| TI .NET 어셈블리의 속성 보기 | 어셈블리의 관련 속성과 이 어셈블리에서 지원하는 입출력 문서의 XML 태그 이름을 표시합니다. 메서드 이름은 태그 이름의 일부이지만 매핑을 찾을 때 사용되지 않습니다. 모든 속성이 읽기 전용입니다. |