CICS 또는 IMS 호스트 애플리케이션에 대한 메타데이터 아티팩트 디자인

이 가이드에서는 CICS 또는 IMS 호스트 애플리케이션에 대한 메타데이터 아티팩트 디자인 방법을 보여 줍니다. 그런 다음 이러한 메타데이터 아티팩트 를 HIDX(Host Integration Server Definition XML) 파일로 저장하여 Azure Logic Apps의 CICS 및 IMS 기본 제공 서비스 공급자 기반 커넥터와 함께 사용할 수 있습니다.

사전 요구 사항

• Visual Studio 다운로드 및 설치. 설치 후 Visual Studio에서 C++를 사용하여 데스크톱 개발 이라는 워크로드도 설치해야 합니다. 그렇지 않으면 HRESULT 0x800A007C 예외 오류가 발생합니다.

• Azure Logic Apps용 HIS Designer 다운로드하여 설치합니다. 유일한 필수 구성 요소는 Microsoft .NET Framework 4.8입니다.

• Azure Logic Apps에서 플랫 파일 프로세서에 대한 Visual Studio 지원을 사용하도록 설정합니다. 이 작업의 경우, 다음 단계를 따릅니다.

  1. Visual Studio를 엽니다. 도구 모음에서 도구 메뉴를 열고 옵션을 선택합니다.

  2. 옵션 목록에서 호스트 통합 서버를 확장하고 호스트 파일을 선택합니다.

  3. 호스트 환경 탭에서 플랫 파일 프로세서 및 Logic Apps에 대한 지원 포함을 선택합니다.

     

호스트 애플리케이션 프로젝트 만들기

Visual Studio에서 호스트 애플리케이션 프로젝트 템플릿을 사용하여 메타데이터 아티팩트 만들기를 수행할 수 있습니다. 그런 다음, Azure Logic Apps용 표준 워크플로에서 CICS 및 IMS 기본 제공 서비스 공급자 기반 커넥터와 함께 이러한 아티팩트 를 사용할 수 있습니다. 새 호스트 애플리케이션 프로젝트를 만들려면 다음 단계를 수행합니다.

1. Visual Studio의 파일 메뉴에서 새 새>프로젝트를 선택합니다.

2. 프로젝트 템플릿 목록에서 호스트 애플리케이션>다음을 선택합니다.

3. 새 프로젝트 구성 상자에서 원하는 세부 정보를 변경하고 만들기를 선택합니다.

   

.NET 클라이언트 정의 추가

Azure Logic Apps에서 CICS 및 IMS 커넥터를 지원하려면 .NET 클라이언트 정의를 추가해야 합니다.

1. 솔루션 탐색기 새 호스트 애플리케이션 프로젝트의 바로 가기 메뉴를 열고추가 .NET 클라이언트 정의 추가>를 선택합니다.

2. 새 항목 추가 상자가 나타나면 Name 속성에서 .NET 클라이언트 정의의 이름을 입력하고 추가를 선택합니다.

   이러한 단계는 NetClnt1 예제로 계속됩니다.

3. .NET 클라이언트 정의 마법사가 시작되면 라이브러리 상자에서 만들려는 .NET 클라이언트 라이브러리를 식별하는 데 사용할 인터페이스의 이름을 제공합니다.

   이 예제에서는 인터페이스 이름 IInterface1을 계속 사용합니다.

   

4. 완료되면 다음을 선택합니다.

5. 원격 환경 상자에서 다음 정보를 제공하여 사용할 원격 메인프레임 또는 미드레인지 환경과 프로그래밍 모델을 식별합니다.

   매개 변수	값 또는 작업
   공급업체	Microsoft
   프로토콜	적절한 네트워크 프로토콜을 선택하여 메인프레임 또는 미드레인지 시스템에 액세스합니다. - Tcp - HTTP(HTTP) - LU 6.2 (Azure Logic Apps 커넥터에 지원되지 않음)
   대상 환경	대상 시스템을 선택합니다. - Cics - Ims - 시스템 i - 시스템 Z - System i Distributed Program Call
   프로그래밍 모델	프로그래밍 모델을 선택합니다.
   호스트 언어	사용 중인 언어 선택: COBOL 또는 RPG
   32K 인/아웃 허용	LINK 모델을 사용할 때 COMMAREA 데이터 영역의 전체 32K를 사용하려면 이 옵션을 선택합니다.

6. 완료되면 만들기를 선택합니다.

마법사를 완료하면 메타데이터 아티팩트 만들기 또는 가져오기를 위해 기본 디자인 보기가 나타납니다. 이 작업의 경우 다음 섹션으로 계속 진행합니다.

메타데이터 아티팩트 디자인

이 섹션에서는 메타데이터 아티팩트 만들기를 수동으로 만드는 방법을 보여줍니다. 대신 호스트 정의를 가져오려면 호스트 정의 가져오기를 참조하세요.

다음 표에서는 기본 디자인 뷰의 구성 요소를 나열합니다.

구성 요소	설명
구성 요소 노드	메타데이터 아티팩트 루트입니다. 클라이언트 라이브러리 및 원격 환경에 대한 정보를 저장합니다.
인터페이스 노드	구성 요소의 모든 메서드를 그룹화합니다.
데이터 테이블 폴더	어셈블리의 데이터 테이블을 그룹화합니다.
구조체 폴더	공유 특성을 사용하여 변수를 그룹화합니다.
Unions 폴더	COBOL 공용 구조체에 해당하는 를 나타냅니다.

메서드 추가

메타데이터 아티팩트에 대해 Azure Logic Apps의 워크플로에 메인프레임 프로그램 비즈니스 논리를 노출하는 메서드를 추가할 수 있습니다.

1. 기본 디자인 보기에서 새 인터페이스의 바로 가기 메뉴를 열고 메서드 추가를 선택합니다.

   

2. 메서드의 바로 가기 메뉴를 열고 속성을 선택합니다. 메서드 속성 아티클을 기반으로 메서드의 속성에 대한 값을 제공합니다.

매개 변수 또는 반환 값 추가

메서드를 추가한 후 매개 변수와 반환 값을 정의하여 Azure Logic Apps의 메인프레임 프로그램과 워크플로 간에 데이터를 전달하고 받을 수 있습니다.

1. 기본 디자인 보기에서 새 메서드의 바로 가기 메뉴를 열고 매개 변수 추가를 선택합니다.

   

2. 매개 변수의 바로 가기 메뉴를 열고 속성을 선택합니다. 다음 표에 따라 매개 변수의 속성에 대한 값을 제공합니다.

   속성	설명 또는 값
   배열인 경우	true이면 최대 7개의 차원과 16,777,215개의 요소가 있는 배열을 지원하는 배열 차원을 설정해야 합니다. 배열 속성에 대한 값도 입력해야 합니다.
   데이터 형식	매개 변수의 .NET 데이터 형식
   이름	매개 변수의 이름
   매개 변수 방향	메서드 매개 변수의 방향: In, In/Out 또는 Out
   오류 처리	오류를 트리거하거나, 반올림하거나, 자립니다.
   호스트 데이터 형식	매개 변수의 COBOL 또는 RPG 데이터 형식
   정밀도	매개 변수의 데이터 정밀도
   후행 필러	길이가 지정된 최대값보다 작은 매개 변수의 경우 필러 크기를 지정해야 합니다.

   

3. 새 메서드의 바로 가기 메뉴를 열고 반환 값 추가를 선택합니다.

   

4. 반환 값의 바로 가기 메뉴를 열고 속성을 선택합니다. 다음 표에 따라 반환 값의 속성에 대한 값을 제공합니다.

   속성	설명 또는 값
   배열입니다.	true이면 최대 7개의 차원과 16,777,215개의 요소가 있는 배열을 지원하는 배열 차원을 설정해야 합니다. 배열 속성에 대한 값도 입력해야 합니다.
   반환 형식	반환 값의 .NET 데이터 형식
   다음에 배치된 반환 값	매개 변수를 기준으로 반환 값의 위치를 나타냅니다.
   TICS 작업 영역 사용	영구 연결을 통해 유지되고 데이터의 시작 부분에 배치되는 256 바이트 작업 영역을 사용하도록 지정하는 부울 값입니다.
   오류 처리	오류를 트리거하거나, 반올림하거나, 자립니다.
   호스트 데이터 형식	반환 값의 COBOL 또는 RPG 데이터 형식
   정밀도	매개 변수의 데이터 정밀도
   후행 필러	길이가 지정된 최대값보다 작은 매개 변수의 경우 필러 크기를 지정해야 합니다.

   

데이터 테이블 추가

1. 기본 디자인 보기에서 DataTables 바로 가기 메뉴를 열고 DataTable 추가를 선택합니다.

   

2. 새 데이터 테이블의 바로 가기 메뉴를 열고 DataTable 열 추가를 선택합니다. 필요에 따라 이 단계를 반복합니다.

3. 새 열의 바로 가기 메뉴를 열고 속성을 선택합니다. 다음 표에 따라 각 열의 속성에 대한 값을 제공합니다.

   속성	설명 또는 값
   데이터 형식	열의 .NET 데이터 형식
   이름	열의 이름
   오류 처리	오류를 트리거하거나, 반올림하거나, 자립니다.
   호스트 데이터 형식	열의 COBOL 또는 RPG 데이터 형식
   정밀도	열의 데이터 정밀도
   후행 필러	길이가 지정된 최대값보다 작은 열의 경우 필러 크기를 지정해야 합니다.

   

구조체 추가

1. 기본 디자인 보기에서 구조체 바로 가기 메뉴를 열고 구조체 추가를 선택합니다.

   

   디자이너는 하나의 멤버를 사용하여 구조를 만듭니다.

2. 다른 멤버를 추가하려면 새 구조체의 바로 가기 메뉴를 열고 구조체 멤버 추가를 선택합니다. 필요에 따라 이 단계를 반복합니다.

3. 멤버의 바로 가기 메뉴를 열고 속성을 선택합니다. 다음 표에 따라 각 멤버의 속성에 대한 값을 제공합니다.

   속성	설명 또는 값
   배열입니다.	true이면 최대 7개의 차원과 16,777,215개의 요소가 있는 배열을 지원하는 배열 차원을 설정해야 합니다. 배열 속성에 대한 값도 입력해야 합니다.
   데이터 형식	멤버의 .NET 데이터 형식
   이름	멤버의 이름
   오류 처리	오류를 트리거하거나, 반올림하거나, 자립니다.
   호스트 데이터 형식	멤버의 COBOL 또는 RPG 데이터 형식
   정밀도	멤버의 데이터 정밀도
   후행 필러	길이가 지정된 최대값보다 작은 멤버의 경우 필러 크기를 지정해야 합니다.

   

공용 구조체 추가

1. 기본 디자인 보기에서 공용 구조체 바로 가기 메뉴를 열고 공용 구조체 추가를 선택합니다.

   

   디자이너는 두 멤버가 있는 공용 구조체를 만듭니다.

2. 다른 멤버를 추가하려면 새 공용 구조체의 바로 가기 메뉴를 열고 공용 구조체 구성원 추가를 선택합니다. 필요에 따라 이 단계를 반복합니다.

3. 멤버의 바로 가기 메뉴를 열고 속성을 선택합니다. 다음 표에 따라 각 멤버의 속성에 대한 값을 제공합니다.

   속성	설명 또는 값
   배열입니다.	true이면 최대 7개의 차원과 16,777,215개의 요소가 있는 배열을 지원하는 배열 차원을 설정해야 합니다. 배열 속성에 대한 값도 입력해야 합니다.
   데이터 형식	멤버의 .NET 데이터 형식입니다. 이 값에는 이전 섹션에 정의된 구조체가 포함될 수 있습니다.
   이름	멤버의 이름
   오류 처리	오류, 둥글게 또는 자르기를 트리거합니다.
   호스트 데이터 형식	멤버의 COBOL 또는 RPG 데이터 형식
   정밀도	멤버의 데이터 정밀도
   후행 필러	길이가 지정된 최대값보다 작은 멤버의 경우 필러 크기를 지정해야 합니다.

   

4. 완료되면 다음 섹션으로 계속 이동하여 메타데이터의 디자인을 저장하는 라이브러리를 만듭니다.

HIDX(호스트 통합 정의 XML) 또는 메타데이터 아티팩트 만들기

이 섹션에서는 메타데이터 아티팩트의 디자인을 저장하는 라이브러리를 만드는 방법을 설명합니다.

1. 메타데이터 아티팩트 생성하려면 Visual Studio 파일 메뉴 또는 도구 모음에서 모두 저장을 선택합니다. (키보드: Ctrl+Shift+S 누르기)

   

2. 생성된 HIDX 파일을 찾으려면 호스트 애플리케이션의 폴더로 이동합니다.

   

관련 콘텐츠

• 호스트 정의 가져오기