z/OS Connect는 z/OS 운영 체제에 있는 비즈니스 자산을 호출하는 데 사용되는 요청 및 응답 페이로드를
선택적으로 변환하는 기능을 제공합니다. z/OS Connect는 BBGLS2JS 및 BBGJS2LS라는 두 가지
새 유틸리티를 제공합니다.
시작하기 전에
바인딩 및 스키마 파일을 작성하기 전에 설정이 다음 전제조건을 충족하는지 확인하십시오.
- 고급 언어 데이터 구조체는 다음 기준을 충족해야 합니다.
- 데이터 구조체는 소스 프로그램과 별도로 정의되어야 합니다(예: COBOL 카피북에서).
- PL/I 또는 COBOL 애플리케이션 프로그램이 입력과 출력에 대해 다른 데이터 구조체를 사용하는 경우,
데이터 구조체는 파티션이 지정된 데이터 세트에 있는 두 개의 다른 멤버에서 정의되어야 합니다. 입력과 출력에 동일한 구조체가 사용되는 경우에는
단일 멤버에서 구조체가 정의되어야 합니다.
- C 및 C++의 경우 데이터 구조체는 파티션이 지정된 데이터 세트에서 동일한 멤버에 있을 수 있습니다.
- 언어 구조체는 파티션된 데이터 세트에서 사용할 수 있어야 합니다.
- OMVS(Open Multiple Virtual Storage)에 BBGLS2JS 또는 BBGJS2LS가 실행하는 데
사용할 사용자 ID를 정의해야 합니다.
- 사용자 ID에는 z/OS® UNIX 및 PDS 라이브러리에 대한 읽기 권한과
LOGFILE, WSBIND 및 JSON-SCHEMA-REQUEST와 JSON-SCHEMA-RESPONSE 출력 매개변수에 지정된 디렉토리에 대한
쓰기 권한이 있어야 합니다.
- 사용자 ID에는 Java™를 실행하기에 충분히 큰 스토리지 할당이 있어야 합니다. 지원되는 모든 버전의 Java를
사용할 수 있습니다. BBGLS2JS/BBGJS2LS 유틸리티는 기본적으로 USS 환경의
JAVA_HOME이 지정하는 Java 버전을 사용합니다. 그렇지 않으면 ID는 PATH문에서 지정하는 Java 버전을 사용합니다.
이 태스크 정보
BBGLS2JS 유틸리티는 COBOL 카피북 또는 PLI, 또는 C 구조체 파일을 읽고
바인딩 파일 및 JSON 스키마 파일을 생성합니다.
BBGJS2LS 유틸리티는 JSON 스키마를 읽고 해당 바인딩 파일 및 언어 구조체 파일(COBOL 카피북 또는 PL/I,
또는 C 구조체 헤더 파일)을 생성합니다. 이 유틸리티는 CICS Transaction Server Mobile Extensions 기능팩의 일부인
기존 DFHLS2JS 및 DFHJS2LS 도구와 유사합니다. 입력 매개변수는 동일하지만 기호 매개변수는 다릅니다.
프로시저
- BBGLS2JS JCL 프로시저를 얻으십시오. BBGLS2JS 및 BBGJS2LS JCL 프로시저는 GitHub에서 사용 가능합니다. JCL을 사용하는 방법에 대한 정보는
GitHub의 readme 파일을 참조하십시오. JCL 프로시저를 이 위치에서 z/OS 시스템에 있는 JCL 프로시저 라이브러리의
BBGLS2JS라는 멤버로 복사하십시오.
- BBGLS2JS 프로시저를 사용하여 언어 구조체에서 z/OS Connect 서비스 바인딩 파일을 생성하십시오. BBGLS2JS 프로시저를 호출하려면 JCL에 입력 매개변수를 제공해야 합니다.
프로시저를 사용하는 데 도움이 되는 입력 매개변수 및 예제 작업에 대한 정보는 BBGLS2JS 참조 문서를
참조하십시오. BBGLS2JS 프로시저를 제출하는 경우, 유틸리티는 WSBIND 매개변수로 지정한 위치에
서비스 바인딩 파일을 생성합니다. 생성된 JSON 스키마는 JSON-SCHEMA-REQUEST 및 JSON-SCHEMA-RESPONSE 매개변수로 지정한 위치에 놓입니다.
- 생성된 JSON 스키마를 검토하십시오. 이러한 스키마는 z/OS Connect 서비스와 상호작용하기 위한 입력 및 출력
데이터 형식을 정의하는 데 사용됩니다. 애플리케이션 개발자는 애플리케이션을 작성할 때
이러한 스키마를 사용하여 서비스를 호출하고 JSON 요청 페이로드를 전달해야 합니다.
참고: 생성된 스키마를 변경하면 WSBIND에 있는 생성된 바인딩 파일이 유효하지 않게 됩니다. 예를 들어,
스키마를 변경하여 스키마 내에 있는 필드의 이름을 바꾸려면 BBGJS2LS를 사용하여
새 바인딩 파일 및 새 언어 구조체 세트를 생성해야 합니다. 새 언어 구조체를 사용하려면 애플리케이션 프로그램을 다시 컴파일해야 합니다.