빌드, 배치 및 승격 지원에 대한 ISPF 게이트웨이 구성

Developer for IBM® Enterprise Platforms 클라이언트 액세스 라이센스에 사용할 수 있는 빌드, 배치 및 승격 컴포넌트를 지원하도록 ISPF 게이트웨이를 구성할 수 있습니다.

ISPF는 클라이언트 애플리케이션의 인터페이스(ISPF 게이트웨이라고 함)를 제공하여 z/OS® 호스트에 연결하고 TSO 및 ISPF 명령을 실행합니다. ISPF 게이트웨이는 HFS에서 모듈 및 파일을 로드할 때 ISPF의 일부로 설치됩니다. 일반적으로 이 파일은 /usr/lpp/ispf/bin에 설치됩니다. 빌드, 배치 및 승격 컴포넌트는 SMP/E 설치의 일부로 작성됩니다. 설정에 따라 ISPF 게이트웨이에서 제공한 스크립트 및 컴포넌트를 추가로 수정할 필요가 없습니다. 기본 설정 및 기본값 수정 프로시저는 나중에 설명됩니다.

다음 컴포넌트가 포함됩니다.

ISPF 게이트웨이 환경 파일: ISPZXENV
ISPF 게이트웨이의 사용자 정의할 수 있는 설정을 포함하는 ISPF 게이트웨이 환경 파일.
ISPZXENV 파일은 z/OS의 일부로 제공됩니다. 기본적으로 이 파일은 /usr/lpp/ispf/bin에 설치됩니다. 그러나 설치 후 이 디렉토리는 일반적으로 READ 전용만 표시됩니다. 이 환경 파일은 ISPF 게이트웨이에서 실행되어 실행될 ISPF 게이트웨이에 필요한 특정 환경 변수 값을 얻습니다. 기본적으로 이 변수는 다음과 같습니다.
STEPLIB
기본적으로 STEPLIB = 'ISP.SISPLPA:ISP.SISPLOAD'로 설정됩니다.
CGI_ISPCONF
기본적으로 CGI_ISPCONF = '/etc/ispf'로 설정됩니다.
CGI_ISPWORK
기본적으로 CGI_ISPWORK = '/var/ispf'로 설정됩니다.

변수를 기본값이 아닌 다른 값으로 설정하려면, ISPZXENV를 /etc/ispf와 같은 쓰기 가능한 구성 디렉토리로 복사하여 변수를 필수 값으로 설정하십시오. 그런 다음, 기본 ISPF bin 경로 전에 해당 위치를 읽도록 startispf.sh에서 경로 환경 변수를 변경해야 합니다(나중에 설명함).

예를 들어 다음과 같습니다.
export PATH=/etc/ispf:$PATH  

ISPF 게이트웨이 작업 디렉토리(기본적으로 /var/ispf)에서 모든 사용자에 대한 읽기 및 쓰기 권한이 있는 WORKAREA라고 하는 기존 디렉토리가 작성되어 있어야 합니다. ISPF 게이트웨이를 사용하는 경우 /var/ispf/WORKAREA/<userid>/* 형식의 임시 디렉토리가 작성됩니다. ISPF에서 제공하는 대로 기본 ISPF 게이트웨이 설치를 사용하는 경우, 이 디렉토리는 일반적으로 /var/ispf/WORKAREA입니다. 디렉토리가 존재하지 않는 경우, ISPF 계획 및 사용자 정의(GC34-4814)에서 게이트웨이 설치 및 사용자 정의 장의 지시사항을 따르십시오.

ISPF 게이트웨이 시작 스크립트 : startispf.sh
배치 및 승격을 위해 ISPF 게이트웨이를 시작하는 쉘 스크립트
ISPF 게이트웨이를 시작하려면, Rational Team Concert™는 배치 및 프로모션 Ant 태스크에서 호출된 쉘 스크립트를 제공합니다. 이 스크립트는 /usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/ispfgateway에 설치됩니다. 표준 사용자 정의의 일부로 이 스크립트는 BLZCPBTK 작업이 Rational Team Concert 구성 디렉토리(일반적으로 /etc/jazz40/ccm )에 복사합니다. 설정에 따라 일부 환경 변수를 설정하도록 이 쉘 스크립트를 수정해야 할 수 있습니다.
PATH
PATH 변수는 ISPF 게이트웨이 홈 디렉토리를 가리켜야 합니다.
export PATH=$PATH:/usr/lpp/ispf/bin             
ISPZXENV를 수정하면 PATH를 다음에 설정해야 합니다.
export PATH=$PATH:/etc/ispf:/usr/lpp/ispf/bin

ISPF.conf에서 다른 라이브러리 연결을 사용해야 하는 경우 startispf.sh 스크립트, ISPF.conf 파일 및 ISPZXENV 파일의 여러 사본을 작성하여 사용자 설치에서 여러 프로젝트 및 스트림이 지원되도록 구성하십시오. ISPZXENV 파일의 각 사본에서 CGI_ISPFCONF 변수를 관련된 ISPF.conf 파일의 위치를 지시하도록 설정하십시오. startispf.sh 스크립트의 각 사본에서 PATH 변수를 관련된 ISPF.conf 파일의 해당 사본을 지시하도록 설정하십시오. 그런 다음 특정 프로젝트에 필요한 환경에 해당되는 startispf.sh 스크립트를 사용하십시오.

엔터프라이즈 확장기능 빌드 시작 스크립트 : startbfa.sh
엔터프라이즈 확장기능 빌드를 사용하여 Rational® Build Agent를 시작하는 쉘 스크립트입니다.
엔터프라이즈 확장기능 빌드는 프로그램, ISPF 명령 또는 실행 파일이나 TSO 명령 또는 실행 파일을 차례로 시작하는 빌드를 시작하기 위한 메커니즘을 제공합니다. 빌드에 의해 시작되는 오브젝트가 ISPF 할당 라이브러리인 경우, 필수 오브젝트에 대한 액세스를 제공하도록 빌드를 구성해야 합니다. startbfa.sh에서 Rational Build Agent가 ISPF 게이트웨이를 시작할 수 있도록 ISPF 제공 파일의 위치를 나열해야 합니다. 기본적으로 해당 파일은 /usr/lpp/ispf에 있으며 _CMDSERV_BASE_HOME 변수를 사용하여 startbfa.sh에 지정됩니다. ISPF 게이트웨이 2진 파일이 다른 위치에 설치된 경우, 이 변수를 변경해야 합니다. 예를 들어 다음과 같습니다.
#                                                  
# Specify the home directory for the ISPF programs.
#                                                  
export _CMDSERV_BASE_HOME=/usr/lpp/ispf                   

ISPF 프로그램과 실행 파일은 나중에 설명된 대로 ISPF 게이트웨이 구성 파일(ISPF.conf)에 할당되어야 합니다. 또한 Rational Build Agent는 ISPF.conf에도 액세스해야 합니다. 액세스 권한은 ISPF 게이트웨이 환경 파일(ISPZXENV)에 설정됩니다. 빌드에 ISPF 기능을 사용할 계획이고 기본 위치 /usr/lpp/ispf/bin을 사용하지 않는 경우, 쓰기 가능 구성 디렉토리에 ISPZXENV의 사본을 작성하고 Rational Build Agent를 해당 위치에 지정해야 합니다. 빌드 특성 teamz.build.ant.myISPFBinPath를 ISPZXENV 파일이 포함된 디렉토리 위치로 설정하십시오. 빌드 정의에서 특성 탭을 사용하여 특성을 추가하거나 값을 편집할 수 있습니다. 자세한 정보는 z/OS 빌드 관리를 참조하십시오

ISPF 게이트웨이 구성 파일: ISPF.conf
ISPF 게이트웨이의 사용자 정의할 수 있는 설정을 포함하는 ISPF 게이트웨이 구성 파일.
ISPF.conf 파일은 z/OS의 일부로 제공됩니다. ISPF 게이트웨이 구성 파일은 작성된 태스크의 ISPF 세션을 시작하는 데 필요한 할당을 제공합니다. 빌드, 배치 및 승격 기능이 모듈을 시작하여 특정 태스크를 수행하려면, ISPF 연결에서 모듈을 사용할 수 있어야 합니다. 기본적으로 다음과 같이 이 할당이 설정됩니다.
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC 
ispmlib=ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=ISP.SISPLOAD
배치 및 승격 작업의 경우, Rational Team Concert 제품 로드 라이브러리(hlq.SBLZLOAD) 및 제품 메시지 라이브러리(hlq.SBLZMENU)를 ISPLLIB 및 ISPMLIB 연결에 추가하십시오. 수정된 할당은 다음 예제와 유사합니다.
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD

해석 배치 모듈 실행

고유의 배치 프로세스 또는 기능을 추가하려는 경우, 배치 모듈의 해석 버전을 실행할 수 있습니다. 배치 컴포넌트는 다음 프로그램을 실행합니다.
표 1. 배치 컴포넌트에 의해 실행되는 프로그램
프로그램 기능 설명
BLZPKGZP 배치 패키징 Manifest 파일을 사용하여 지정된 컨텐츠의 .zip 파일을 작성합니다.
BLZBKPZP 배치 백업 패키지 파일을 사용하여, 배치에서 겹쳐쓰는 모듈의 백업 사본을 작성합니다.
BLZDEPZP 배치 배치 Manifest 파일을 사용하여 지정된 .zip 파일의 컨텐츠를 배치합니다.
Rational Team Concert 배치 태스크는 이러한 프로그램을 호출하여 설명된 기능을 수행합니다. 이러한 프로그램을 수정하려는 경우, hlq.SBLZSAMP 라이브러리에 있는 제공된 샘플을 수정하여 이를 수행한 후 ISPF.conf에서 수정된 버전을 가리킬 수 있습니다. 따라서 hlq.SBLZSAMP에서 직접 수정한 경우 ISPF.conf 할당은 다음 예제와 유사합니다.
sysproc=ISP.SISPCLIB,BLZ.SBLZSAMP 
sysexec=ISP.SISPEXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD
명령에 백분율 기호 % 접두부가 없는 경우, ISPF는 먼저 ISPLLIB 연결을 확인합니다. 따라서 hlq.SBLZLOAD 데이터 세트에서 변경한 모듈을 제거하거나 이름을 바꿔야 합니다.

ISPF 게이트웨이 구성 파일에 고유의 EXEC 라이브러리 추가

엔터프라이즈 확장기능 빌드의 경우, ISPF 호출 메소드를 사용하는 경우, 고유의 EXEC 라이브러리를 ISPF.conf의 SYSEXEC 또는 SYSPROC 연결에 추가해야 합니다. EXEC 이름을 지정하거나 SELECT CMD(exec)를 지정한 경우, ISPF는 해당 연결의 필수 EXEC에 액세스해야 합니다. 따라서 필수 EXEC 라이브러리를 포함하도록 ISPF.conf를 지정해야 합니다. 예를 들어, 다음과 같습니다.
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC,MY.PROJECT.EXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD

ISPF 게이트웨이에 대한 자세한 정보는 ISPF 계획 및 사용자 정의(GC34-4814)에서 ISPF 계획 및 사용자 정의에서 TSO/ISPF 클라이언트 게이트웨이 장을 참조하십시오.

ISPF 게이트웨어 구성 문제점 해결

ISPF 게이트웨이가 올바르게 구성되었는지 확인하십시오. ISPF 게이트웨이를 사용하는 Rational Team Concert 기능을 실행하는 사용자 ID는 http://publibfp.dhe.ibm.com/epubs/pdf/ispzpc80.pdf의 ISPF 계획 및 사용자 정의(GC34-4814)에 설명된 필수 권한이 있어야 합니다.

Rational Team Concert startispf.sh 스크립트는 /tmp 디렉토리에 액세스해야 하는 UNIX System Services 명령을 사용합니다. startispf.sh 스크립트를 시작하는 빌드 사용자 ID는 /tmp 디렉토리에 대한 액세스 권한이 있어야 합니다. /etc/jazz40/ccm/startispf.sh에 다음 행을 추가하여 임시 디렉토리로서의 /tmp 사용을 대체할 수 있습니다.
export TMPDIR=/yourTemporaryDir
여기서 yourTemporaryDir은 빌드 사용자가 쓰기 액세스 권한이 있는 디렉토리입니다.

피드백