부록I. IBM Debug Tool DTCN 및 DTSP 프로파일 관리자 플러그인 설치
Debug Tool에는 IBM Debug Tool DTCN 및 DTSP 프로파일 관리자 플러그인이 제공되어, 원격 디버거의 디버그 Perspective에
다음 보기를 추가합니다.
- DTCN 프로파일 보기는
z/OS® 시스템에서 DTCN 프로파일을 작성 및
관리하는 데 도움을 줍니다. 16
- DTSP 프로파일 보기는 z/OS 시스템에서 TEST 런타임 옵션 데이터셋(EQAUOPTS)을 작성 및 관리하는 데 도움이 됩니다.
이 플러그인을 설치하려면 다음 단계를 수행하십시오.
- 시스템 관리자가 Debug Tool Customization Guide에 설명된 다음 태스크를 완료했는지 확인하십시오.
- 『DTCN 프로파일 보기 및 API 지원 추가』
- 『DTSP 프로파일 보기에 대한 지원 추가』
- 다음 데이터셋을 z/OS 시스템에서 워크스테이션으로 2진 형식으로 전송합니다.
hlq.SEQABIN(EQACDPLG)
- 파일의 이름을 com.ibm.pdt.debugtool.profile_2.0.0.jar로 바꿉니다.
- 파일을 다음 Eclipse 기반 애플리케이션의 지정된 디렉토리로 이동합니다.
- CICS Explorer™
- CICS_Explorer_install_directory₩dropins
- Eclipse
- Eclipse_install_directory₩dropins
- System z용 Rational Developer
- C:₩Program Files₩IBM₩SDP₩plugins
- Eclipse 기반 애플리케이션을 다시 시작하십시오. 플러그인의 이전 버전을 설치한 경우에는 Eclipse 기반 애플리케이션을 다시 시작할 때 -clean 옵션을 지정하십시오.
- 다음 단계를 수행하여 DTCN 프로파일 보기와 z/OS 시스템 간의 연결을 설정하는 데 필요한 설정을 지정하십시오.
- 창 > 보기 표시 > 기타...를 클릭하십시오.
- 창 상단의 텍스트 상자에 "DTCN"을 입력하십시오.
DTCN 프로파일을 선택하고 확인을 클릭하십시오.
- 창 > 환경 설정을 클릭하십시오.
- 목록에서 디버그 도구 > DTCN(CICS)을 클릭하십시오.
- 다음 모든 필드에 입력하십시오.
- 호스트 이름
- Debug Tool Customization Guide에서 『CICS TCPIPSERVICE 자원 정의』에 설명된 대로 z/OS 시스템의 TCP/IP 이름 또는 주소입니다.
- 포트 번호
- Debug Tool Customization Guide에서 『CICS TCPIPSERVICE 자원 정의』에 설명된 대로 z/OS 시스템의 포트 번호입니다.
- 사용자 Id
- CICS 시스템에 로그온하는 데 사용하는 ID입니다.
- 패스워드
- CICS 시스템에 로그온하는 데 사용하는 패스워드입니다.
- 테스트 연결을 클릭하십시오. 테스트가 성공했음을 표시하는 메시지가 표시되면 확인을 클릭하여 환경 설정 창을 닫으십시오. 그렇지 않으면 입력한 정보를 검토하고, 실수가 있으면 정정한 다음 연결 테스트를 재시도하십시오. 실수를 찾아내는 데 도움이 되는 진단 정보를 보려면 추적 파일(DTCN 프로파일 또는 DTSP 프로파일 보기의 추적 파일 찾기 참조)을 검토할 수도 있습니다.
- 다음 단계를 수행하여 DTSP 프로파일 보기와 z/OS 시스템 간의 연결을 설정하는 데 필요한 설정을 지정하십시오.
- 창 > 보기 표시 > 기타...를 클릭하십시오.
- 창 상단의 텍스트 상자에 "DTSP"를 입력하십시오.
DTSP 프로파일을 선택하고 확인을 클릭하십시오.
- 창 > 환경 설정을 클릭하십시오.
- 목록에서 디버그 도구 > DTSP(비CICS)를 클릭하십시오.
- 다음 모든 필드에 입력하십시오.
- 호스트 이름
- Debug Tool Customization Guide의 『IBM Debug Tool DTCN 및 DTSP 프로파일 관리자에서 서버 컴포넌트 설치』의 지시사항에 따라서 시스템 관리자가 설정한 z/OS 시스템의 TCP/IP 이름 또는 주소입니다.
- 포트 번호
- Debug Tool Customization Guide의 『IBM Debug Tool DTCN 및 DTSP 프로파일 관리자에서 서버 컴포넌트 설치』의 지시사항에 따라서 시스템 관리자가 설정한 z/OS 시스템의 포트 번호입니다.
- 사용자 Id
- z/OS 시스템에 로그온하는 데 사용하는 ID입니다. DTSP 프로파일은 프로파일 이름 패턴 필드에 있는 &userid 토큰에서 이 ID를 대체합니다.
- 패스워드
- z/OS 시스템에 로그온하는 데 사용하는 패스워드입니다.
- 프로파일 이름 패턴
- Debug Tool Customization Guide의 『이름 지정 패턴 수정』의 지시사항에 따라 시스템 관리자가 설정한 기본 이름 지정 패턴과 일치하는 이름 지정 패턴을 지정합니다. 이름 지정 패턴에는 &userid 토큰이 포함되어야 하고 &pgmname 토큰은 포함되면 안됩니다.
주:
- 테스트 연결을 클릭하십시오. 테스트가 성공했음을 표시하는 메시지가 표시되면 확인을 클릭하여 환경 설정 창을 닫으십시오. 그렇지 않으면 입력한 정보를 검토하고, 실수가 있으면 정정한 다음 연결 테스트를 재시도하십시오. 실수를 찾아내는 데 도움이 되는 진단 정보를 보려면 추적 파일(DTCN 프로파일 또는 DTSP 프로파일 보기의 추적 파일 찾기 참조)을 검토할 수도 있습니다.
보기에서 아무 곳이나 마우스 오른쪽 단추로 클릭하면 사용 가능한 조치 목록을 볼 수 있습니다. 연결 설정을 변경해야 하는 경우에는 보기의 아무 영역을 마우스 오른쪽 단추로 클릭하고 환경 설정을 선택하십시오.
DTCN 프로파일 또는 DTSP 프로파일 보기의 추적 파일 찾기
DTCN 프로파일 또는 DTSP 프로파일 보기에서 조치를 수행할 때에는 보기는 다음 파일에 조치 및 조치 결과에 대한 정보를 저장합니다.
- DTCN 프로파일 보기의 경우 .debugtool.dtcn.trace
- DTSP 프로파일 보기의 경우 .debugtool.dtsp.trace
보기는 이러한 파일을 작업공간의 ₩.metadata 폴더에 저장합니다.
(작업공간의 경로 이름을 찾으려면 Eclipse 기반 애플리케이션에서 파일 > 작업공간 전환 > 기타...를 클릭하십시오.) 다음 주제는 공통 조치를 수행한 후에 파일에 포함되는 내용의 예제 및 해당 조치의 결과를 보여줍니다.
예제: .debugtool.dtcn.trace 파일
다음 예제는 z/OS용 Debug Tool 버전 10의 프로파일 작성 요청을 전송한 후에 파일에 포함되는 내용을 보여줍니다.
15 Oct 2009 16:06:11 PDT
Request URI: http://tlba07me.torolab.ibm.com:33000/dtcn/smith02?clientversion=0102
Request method: PUT
<?xml version="1.0"?>
<profile>
<terminalid></terminalid>
<transactionid></transactionid>
<program>
<loadname></loadname>
<pgmname></pgmname>
</program>
<userid>smith02</userid>
<netname></netname>
<clientip></clientip>
<commareaoffset>0</commareaoffset>
<commareadata></commareadata>
<containername></containername>
<containeroffset>0</containeroffset>
<containerdata></containerdata>
<urmdeb>NO</urmdeb>
<activation>ACTIVE</activation>
<trigger>TEST</trigger>
<level>ALL</level>
<sesstype>TCP</sesstype>
<sessaddr>9.30.247.101</sessaddr>
<sessport>8001</sessport>
<commandfile>*</commandfile>
<preferencefile>*</preferencefile>
<otheropts></otheropts>
</profile>
Server response code = 201
Server response msg = Profile_Created_OK
Server response details = <?xml version="1.0"?><profile><profileversion>0102</prof
ileversion><serviceid>DBGTPROF</serviceid><clientversion>0102</clientversion><serv
erversion>0102</serverversion></profile>
추적의 마지막 행은 한 행입니다. 그러나 이 예제에서는 행의 전체 내용을 볼 수 있도록 행이 줄바꿈되어 있습니다.
예제: .debugtool.dtsp.trace 파일
다음 예제는 DTSP(비CICS) 환경 설정 페이지에서 테스트 연결을 클릭한 후에 파일에 포함되는 내용을 보여줍니다.
Test Connection button clicked -----
getSocketIO parameters are below.
Host: tlba07me.torolab.ibm.com
Port: 5555
UserId: vikram
Pattern: &userid.dbgtool.eqauoptsStart Service successful. The message was:
Connected to DebugToolProvider DTSP query response: File exists.
Connection was successful ---
다음 예제는 업데이트 마법사에서 완료를 클릭한 후에 파일에 포함되는 내용을 보여줍니다.
---- DTSP Finish button clicked ----
Profile dataset: vikram2.dbgtool.eqauopts
UEWizard: Read successful.
DT_Update request worked fine. ------
Retrieving Profile -----
GetOtherProfiles: Socket is good -----
GetOtherProfiles: Hashmap contains {otheropts=sto(ff), sessport=8002,
sessaddr=9.65.111.33, level=ERROR, preferencefile=*, commandfile=*,
trigger=TEST, sesstype=TCPIP, profiledataset=vikram2.dbgtool.eqauopts}
System z®용
Rational® Developer 버전 7.6.1부터는
CICS® 디버그 구성을 사용하여
DTCN 프로파일을 관리할 수 있습니다. CICS 디버그 구성에
대해서 자세히 알아보려면 System z용
Rational Developer 버전 7.6.1, Information Center에서
『CICS 애플리케이션
디버깅』 주제를 참조하십시오. CICS 디버그 구성을 사용하기로 선택한 경우에는 이 주제의 나머지 지시사항을 따를 필요가 없습니다.