zBuilder 사용자 빌드 환경 설정하기

Dependency Based Build(DBB)는 세 개의 환경 설정 페이지를 사용하여 사용자 빌드 조작을 구성합니다. 이 주제에서는 이러한 페이지 및 각 페이지에서 설정할 수 있는 환경 설정에 대해 설명합니다.

원격 빌드 작업 중에 이러한 환경 설정이 어떻게 함께 작동하는지에 대한 정보는 이진 파일의 무결성 유지하기를 참조하십시오.

Dependency Based Build

팁: Dependency Based Build 환경설정 페이지의 ZAPP 옵션은 원격 시스템의 두 폴더 이름, 즉 사용자 빌드 작업 공간(필수)과 로그 파일 위치(선택)를 요청합니다. 그러나 폴더 이름은 검색하지 않습니다. 폴더 이름을 조회해야 하는 경우, 환경설정 창을 열기 전에 원격 시스템에 연결하여 텍스트 파일이나 메모장에 복사하세요.

DBB 환경 설정은 사용자 빌드 구성 및 런타임 옵션에 대한 기본값을 설정합니다. 이 페이지를 열려면 환경 설정 창의 탐색 분할창에서 Dependency Based Build를 선택하십시오. 그런 다음 ZAPP 사용자 빌드에 대한 환경설정 설정을 열려면 사용자 빌드 방법 목록에서 ZAPP을 선택합니다.

사용할 z/OS 시스템을 선택합니다: 이 필드는 기본적으로 원격 시스템 보기에서 첫 번째 z/OS 시스템으로 설정됩니다. DBB가 설치된 z/OS 시스템의 원격 연결 이름을 지정합니다. 어떤 z/OS 시스템을 사용해야 할지 잘 모르겠다면 시스템 또는 빌드 관리자에게 문의하세요.

사용자 빌드 상위 수준 한정자: z/OS 시스템에서 빌드 파일에 사용할 상위 수준 한정자를 지정합니다. ZAPP 파일에 변수가 ${dbbHlq} 포함된 경우, 여기에 지정한 값이 해당 변수를 대체합니다.
  • 이 필드에 값을 지정하면 해당 값이 사용자 빌드 상위 수준 한정자에 사용됩니다.
    • 값을 입력하면 ZAPP User Variables 에 새 변수가 나타납니다.
    • dbbHlq 키가 포함된 환경설정이 생성됩니다. 이 기본 설정은 수정하거나 제거할 수 없습니다.
      주:
      • 17.0 에서 IBM® Developer for z/OS17.0.4 까지의 버전에서, dbbHlq 가 zapp.yaml 파일에 고정값으로 지정되어 있는 경우, Dependency Based Build 환경 설정에서 해당 항목에 dbbHlq 설정된 값은 고정값과 일치해야 합니다. 그렇지 않으면 ZAPP 변수 불일치 오류가 발생합니다.
        ${dbbHlq}예를 들어, Dependency Based Build 파일 내의 ` dbbHlq ` 값이 인 IBMUSER.TEST 경우, 해당 zapp.yaml 파일은 대신 을 IBMUSER.TEST 사용해야 합니다.
      • 17.0.5 를 예로 IBM Developer for z/OS 들면, 파일에 zapp.yaml 가 하드코딩되어 있는 경우 dbbHlq , 이는 다른 모든 지정된 값보다 우선하며, 불일치 오류는 보고되지 않습니다.

사용자 빌드 작업 영역 : 빌드 파일을 업로드할 z/OS UNIX 폴더를 지정합니다.

원격 사용자 빌드 로그 폴더 : z/OS UNIX 파일 시스템에서 로그를 다운로드할 폴더를 지정합니다. 이 기본 설정은 빌드 엔지니어가 z/OS 시스템에서 기본 로그 위치를 재정의하는 경우에만 설정해야 합니다. 이 필드에 위치를 지정해야 하는지 확인하려면 빌드 엔지니어에게 문의하세요.

로컬 로그 폴더: 로컬 파일 시스템에서 로그 파일을 다운로드할 폴더를 지정합니다. 기본값은 z/OS 프로젝트의 logs 폴더입니다.
팁:
로컬 로그 폴더에 업데이트된 로그 파일이 표시되지 않으면 해당 폴더가 리포지토리의 .gitignore 파일에 추가되었기 때문일 수 있습니다. 다음 단계 중 하나를 수행하여 로그 파일을 볼 수 있습니다:
  • Git 리포지토리 보기에서 폴더를 찾습니다.
  • .gitignore 파일에서 폴더 이름을 제거합니다. 이 작업을 수행하면 로그 폴더에 많은 로그 파일이 추가됩니다.

사용자 빌드 중에 사용할 파일 확장자 및 해당 데이터 세트 규정자 지정: 로컬 파일 확장자를 원격 데이터 세트 하위 레벨 규정자에 맵핑하려면 이 테이블을 사용하십시오.

DBB 제한시간까지의 시간(초): 제한시간 초과 전에 DBB 서버에서 응답할 때까지 로컬 프로세스가 대기하는 시간을 지정하십시오.

오류 피드백 지원: 오류 피드백을 생성하려면 이 확인란을 선택합니다. 오류 및 경고 항목이 원격 오류 목록 보기에 추가됩니다.
참고: 다음 옵션은 IBM Developer for z/OS17.0 에서 17.0.3 를 통해 이용 가능합니다.

사용자 빌드를 위한 카피북 다시 로드 : 사용자 빌드를 위한 카피북 다시 로드 옵션을 사용할 수 있습니다. 이 옵션을 선택하면 캐시된 데이터를 사용할 수 있는 경우에도 시스템에서 카피북을 다시 구문 분석하도록 강제합니다.

DBB 환경 설정 페이지에서 사용자 빌드에 대한 사본 다시 로드 확인란을 선택하여 사본을 수동으로 다시 구문 분석할 수 있습니다.

카피북에 ZIP 업로드를 사용 설정합니다: 이 옵션을 선택하면 카피북이 단일 아카이브로 압축되어 업로드되므로 빌드 중 성능이 향상됩니다. 필요한 USS 명령(unzip, rm, chtag, iconv)을 사용할 수 없는 경우, 시스템은 카피북을 개별적으로 업로드하는 방식으로 돌아갑니다. 기본적으로 이 옵션이 선택됩니다.

Git 원격 통합

Git 원격 통합 환경 설정은 Dependency Based Build 사용자 빌드 조작이 로컬 Git 저장소에서 원격 시스템으로 전송되는 파일에 대한 파일 인코딩 및 컨텐츠 유형 정보를 유지보수하는 방법을 정의합니다. 이 페이지를 열려면 환경 설정 창의 탐색 창에서 팀 > Git > 원격 통합을 선택하십시오.

속성 파일: 로컬 Git 저장소에서 원격 시스템으로의 파일 전송에 사용되는 호스트 인코딩 및 컨텐츠 유형 정보가 포함된 파일을 지정하십시오. 파일 위치는 빌드되는 파일과 동일한 작업 트리에 있다고 가정합니다.

변경사항에 대해 속성 파일의 스캔 사용: 이 옵션이 선택되면 제품이 속성 파일을 모니터하여 Git 저장소에서 파일 및 파일 인코딩과 컨텐츠 유형 정보에 대한 변경사항을 발견합니다. 변경사항이 발견되면 제품이 해당 변경사항으로 로컬 파일의 지속적 특성을 업데이트합니다.

로컬 인코딩 및 컨텐츠 유형 속성이 스캔된 속성보다 우선합니다.: 이 옵션을 선택하면 로컬 파일 특성 창의 로컬 컨텐츠 세부사항 페이지에 지정된 인코딩 및 컨텐츠 유형 정보가 속성 파일에서 감지된 설정보다 우선합니다.
참고: ‘로컬 콘텐츠 세부 정보’ 페이지에서 로컬 인코딩 및 콘텐츠 유형 정보를 지정하려면 ‘팀 > 원격 통합 > 속성 정보에 대한 로컬 파일 지정 활성화’ 환경 설정 옵션을 활성화해야 합니다.

팀 원격 통합

팀 원격 통합 환경 설정은 로컬 시스템에서 DBB 사용자 빌드 조작 중에 원격 시스템으로 전송되는 2진 파일의 기본 레코드 길이를 정의하고 기본값의 로컬 대체를 사용 가능하게 합니다. 이 페이지를 열려면 ‘환경 설정’ 창의 탐색 창에서 ‘팀’ > ‘원격 통합’을 선택하십시오.

2진 파일 레코드 길이의 기본 설정은 모든 파일 유형에 레코드 길이를 80으로 지정합니다. 특정 파일 유형에 대한 항목을 추가하려면 다음을 수행하십시오.
  1. 패턴 셀에서 *를 클릭하고 값을 *.groovy 같은 다른 파일 이름 패턴으로 변경합니다.
  2. 레코드 길이 셀에서 80을 클릭하고 값을 파일 유형에 적합한 숫자로 변경하십시오.
  3. 적용을 클릭합니다.
  4. 테이블에서 두 번째 행을 누른 후 추가를 누르십시오. 패턴 * 및 레코드 길이 80이 있는 새 행이 테이블에 추가됩니다.
    팁: 추가 버튼은 적용을 클릭한 다음 새 행을 클릭할 때까지 사용할 수 없습니다.
  5. 필요에 따라 새 행을 수정한 후 적용을 클릭하고 세 번째 행을 클릭한 후 추가를 클릭하십시오.
  6. 테이블에 필요한 모든 파일 패턴 및 레코드 길이가 테이블에 포함될 때까지 이러한 단계를 계속하십시오. 테이블의 마지막 행에는 항상 패턴 * 및 레코드 길이 80이 포함됩니다.
이 프로시저의 결과는 사용자가 추가하는 파일 패턴에 지정된 레코드 길이를 지정한 후 정의된 파일 패턴과 일치하지 않는 나머지 2진 파일에 레코드 길이(80)를 지정하는 것입니다.

패턴 및 레코드 길이: 이 테이블을 사용하여 로컬 시스템에서 파일 이름 패턴의 기본 레코드 길이를 정의할 수 있습니다. 기본적으로 모든 로컬 2진 파일의 레코드 길이는 80입니다. 추가, 제거, 위로, 아래로 단추를 클릭하여 테이블 행을 편집하고 다시 정렬하십시오.

속성 정보의 로컬 파일 스펙 사용: 기본 레코드 길이의 로컬 오버라이드를 사용하려면 이 옵션을 선택하십시오. 이 옵션을 활성화하면 파일 속성 창의 로컬 콘텐츠 세부 정보 페이지를 사용하여 파일 콘텐츠 유형(텍스트 또는 바이너리), 원격 인코딩 및 바이너리 파일의 레코드 길이를 설정할 수

다음에 수행할 작업

zBuilder 용 사용자 빌드 시작