단일 서비스 프로젝트에 영향을 주는 릴리스 정보, 알려진 문제점, 제한사항 및 해결 방법

IMS SOAP 게이트웨이 단일 서비스 프로젝트에서 다중 세그먼트 메시지 지원

엔터프라이즈 서비스 도구 IMSTM SOAP 게이트웨이 단일 서비스 프로젝트에서 다중 세그먼트 메시지 전달 프로그램(MPP)을 지원합니다. 일반적으로 다음 전제조건을 모두 사용할 수 있는 경우 System z®용 Rational® Developer 버전 7.5에서 생성된 아티팩트를 배치할 수 있습니다.
  • IMS™ SOAP 게이트웨이 V10.2
  • IMS V10R1 IMS 연결
  • IMS V10R1 IMS 연결 APAR PK69366 PTF
  • z/OS®용 엔터프라이즈 COBOL APAR PK65058 PTF

System z용 IBM Rational Developer COBOL 컴파일 XML 변환에서는 갱신된 메시지 번호 IGZ0280S - IGZ0298S 및 새 메시지 번호 IGZ0299S - IGZ0303S를 발행할 수 있는 오류 점검 기능이 개선되었습니다.

문제점: bottom-up 및 meet-in-middle 시나리오에서 CICS®, IMS 및 Batch 런타임에 대한 System z용 IBM® Rational Developer 엔터프라이즈 서비스 도구 컴파일 XML 변환은 리턴 코드 280 - 303과 함께 종료될 수 있습니다. 변환기에서 리턴하는 Language Environment® 메시지는 이전 내용이거나 시스템 로그 또는 콘솔에 "예외 메시지 가져오기 실패" 텍스트를 표시합니다.

솔루션: System z용 Rational Developer의 COBOL 컴파일 XML 변환에서는 갱신된 메시지 번호 IGZ0280S - IGZ0298S 및 새 메시지 번호 IGZ0299S - IGZ0303S를 발행할 수 있는 오류 점검 기능이 개선되었습니다. APAR PK65058용 PTF를 적용하십시오.

CICS용 웹 서비스 시나리오에서 추가 맵핑 지원

CICS용 웹 서비스 시나리오에서는 추가 맵핑 레벨 및 런타임 레벨(2.2)을 지원합니다. 이 레벨에서 생성된 아티팩트를 사용하려면 APAR PK69738이 적용된 CICS TS 3.2가 필요합니다.

PL/I에서 XML 유형 파생에 대한 정보

테이블 6의 "PL/I에서 파생된 XML 유형" 주제에서 PL/I에서 XML 유형에는 오류가 있으므로 무시해야 합니다.

복사본으로 인해 엔터프라이즈 서비스 도구 마법사가 중단됨

문제점: 엔터프라이즈 서비스 도구 마법사는 필요한 복사본이 없으면 중단됩니다. 이는 COBOL 임포터 환경 설정 페이지에서 오류 메시지 언어가 en_US 이외의 다른 언어로 설정되는 경우 발생합니다.

솔루션: > 환경 설정 > 임포터 > COBOL > 추가 COBOL 옵션을 선택하여 오류 메시지 언어를 변경합니다.

Meet-In-Middle 소스 파일 가져오기

문제점: meet-in-middle개발 시나리오에서는 소스 파일 가져오기 마법사에서 파일 시스템으로 가져오기 옵션을 지원하지 않습니다.

해결 방법: 필요한 모든 파일을 일반 프로젝트로 복사한 후 소스 파일 가져오기 마법사에서 작업공간을 선택하여 가져오기를 수행하십시오.

Bottom-Up에서 이전 WSDL/XSD 파일과 새 WSDL 파일 및 XSD 파일 충돌

문제점: Bottom-up 개발 시나리오에서 새로 생성된 변환기와 함께 생성된 WSDL 파일 및 XSD 파일의 이전 버전을 사용하면 런타임 시 오류가 발생할 수 있습니다. 예를 들어, 다음 런타임 오류 메시지가 발생할 수 있습니다.
IGZ0282S XML 문서에
변환기에서 인식하는 요소 이름이 없으므로 PGMNAME 프로그램에서는 XML에서
데이터 구조로의 변환을 완료할 수 없습니다. 

솔루션: 변환기에서 생성한 WSDL/XSD는 항상 변환기와 연결되어야 합니다.

COBOL COMP-3 (PACKED DECIMAL) 유형에 대한 XML 스키마 데이터 유형 맵핑

문제점: 온라인 도움말 주제 "COBOL에서 파생된 XML 유형"에서 COMP-3 (PACKED DECIMAL) 행은 다음과 같아야 합니다.
표 1. COBOL에서 XML 유형 파생
COBOL 유형 COBOL UsageValue + COBOL ModelType 특성 해당 XSD 유형
packed-decimal, comp-3 -> packedDecimal packedDecimal 소수점이 지정된 경우:
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
   <xsd:minInclusive value="xx.x"/>
   <xsd:maxInclusive value="yy.y"/>
</xsd:restriction>
</xsd:simpleType>
소수점이 지정되지 않은 경우:
<xsd:simpleType>
   <xsd:restriction base="xsd:short">
     <xsd:minInclusive value="xxx"/>
     <xsd:maxInclusive value="yyy"/>
   </xsd:restriction>
</xsd:simpleType>

스키마를 포함, 가져오기 또는 재정의하는 원격(z/OS Unix) WSDL 파일 가져오기가 포함되는 시나리오가 지원되지 않음

문제점: CICS용 웹 서비스 단일 서비스 프로젝트에서 새 서비스 구현 작성(top-down) 시나리오 또는 기존 서비스 인터페이스로 맵핑(meet-in-middle) 시나리오를 실행하는 중에 스키마를 포함, 가져오기 또는 재정의하는 WSDL 파일(원래는 원격 위치에서 가져옴)을 사용하면 오류가 발생하여 실패하게 됩니다.

해결 방법: 필요한 모든 파일을 워크스테이션이나 작업공간의 일반 프로젝트로 복사하고 RMB -> 가져오기 -> 소스 파일을 사용하여 "CICS용 웹 서비스 프로젝트"로 로컬 WSDL 파일을 가져온 다음 top-down 시나리오를 실행하십시오.

단일 서비스 마법사가 생성한 COBOL 변환 루틴은 z/OS에서만 실행됨

워크스테이션 COBOL 컴파일러가 컴파일 및 런타임 시 모두 XML PARSE 문을 지원하지만, 단일 서비스 마법사가 생성한 COBOL 프로그램은 z/OS® 환경에서만 실행되도록 디자인되었습니다.

XML 요소 중첩 깊이

문제점: XML에서 언어 구조로의 변환기는 다음 예외 메시지를 리턴합니다.
IGZ0291S
최대 XML 요소 중첩 깊이를 초과했으므로
프로그램 program-name에서 XML에서 데이터 구조로의 변환을 완료할 수 없습니다. 문자 컨텐츠가
character-content인 요소 element-name에서 오류가 발생했습니다.

해결 방법: XML에서 언어 구조로의 변환기는 특정 XML 요소의 중첩 깊이를 처리할 수 없습니다. 원래 COBOL 구조 레벨 이상의 중첩 레벨에 허용치가 있지만 이를 초과할 수 있습니다. 스키마에 없는 요소가 요청 XML 문서에 있으면 중첩 레벨이 너무 깊은 경우 요소로 인해 이 상황이 발생할 수 있습니다.

COBOL 데이터 구조의 FILLER 항목

문제점: 이름이 지정되지 않은 그룹 및 기본 항목은 상위 항목이 기본 항목과 함께 필터 아웃되므로 데이터 구조 선택 페이지나 맵핑 세션 편집기에서 선택하는 데 사용할 수 없습니다.

해결 방법: COBOL 데이터 구조를 편집하여 변환해야 하는 그룹 및/또는 기본 데이터 항목에 이름을 지정하십시오. COBOL 그룹에 이름을 지정하면 FILLER 이외의 기본 항목을 선택할 수 있게 됩니다.

OPT 컴파일러 옵션 충돌

문제점: JCL에서 TEST 옵션을 컴파일 옵션으로 지정하면 드라이버 및 변환기 프로그램에서 생성된 PROCESS문의 OPT 컴파일러 옵션이 TEST 옵션과 충돌합니다.

해결 방법: 생성된 XML 변환 프로그램을 디버그하려면, 웹 서비스 마법사의 "생성 옵션" 페이지에서 "컴파일러 관련 환경 설정 지정" 그룹의 "최적화" 선택란을 선택 취소하십시오.

OCCURS DEPENDING ON 항목을 포함하는 COBOL 그룹의 맵핑 자동 일치

문제점: COBOL 데이터 항목이 ODO 항목이거나 이 항목을 포함하고 있으면, 맵핑 일치 조치를 시도하기 전에 수동으로 ODO 오브젝트를 맵핑하지 않는 경우 호환 가능한 XML 구조로 "맵핑 일치" 조치를 수행할 수 없습니다.

해결 방법: 맵핑 일치 조치를 시도하기 전에 맵핑 규칙에 따라 수동으로 ODO 오브젝트를 맵핑하십시오. (XML 문서에서, COBOL ODO 오브젝트 항목에 맵핑된 요소는 해당 COBOL ODO 주제에 맵핑된 XML 요소 앞에 나타나야 합니다.)

XML 지원 마법사에서 특정 텍스트 입력 필드의 대소문자 구분

문제점: 폴더 및 파일 이름 항목은 Windows®용 Eclipse에서 대소문자가 구분됩니다.

해결 방법: 폴더 및 파일 이름을 일관성 있게 입력했는지 확인하십시오. 예를 들어, Workbench에서 폴더 이름이 MyFolder로 표시되면, 폴더 이름을 입력하는 입력 필드에 MyFolder를 입력해야 합니다. myfolder를 입력할 경우, 올바르지 않거나 존재하지 않는 폴더 이름이라고 표시될 수 있습니다.

올바르지 않은 포인터로 인해 무한 루프가 발생함

문제점: XML 변환기 또는 드라이브에 널(null)이 아닌 올바르지 않은 포인터를 제공하면 무한 루프가 발생합니다.

해결 방법: XML 변환기는 호출자가 전달한 널(null) 포인터를 발견하고 보고합니다. 널(null)이 아닌 올바르지 않은 포인터의 경우, XML 변환기에 보호 예외(SOC4)가 발생하여 리턴될 가능성이 큽니다.

CICS용 SOAP 및 CICS용 웹 서비스에서 DBCS 데이터 구성원에 대한 지원

엔터프라이즈 서비스 도구 단일 서버 프로젝트에서 DBCS 데이터 항목을 지원하려면 요청 및 응답 XML 문서가 UTF-16 또는 UTF-8로 인코드되어야 합니다. 웹 서비스의 대상 런타임이 CICS용 SOAP인 경우 UTF-8 또는 UTF-16로 된 XML을 XML 변환기 드라이버로 교환하도록 기능을 구성하십시오. 기본적으로 CICS용 웹 서비스 런타임은 UTF-8로 된 XML을 클라이언트와 교환하며 XML 변환기 드라이버는 XML을 UTF-16 CICS와 교환합니다. UNICODE가 필요한 경우, 현재 XML 변환기에 가장 효과적으로 사용할 수 있는 것은 UTF-16입니다. 두 런타임에 대해, UNICODE 및 DBCS 호스트 코드 페이지 간의 변환을 지원하는 변환 이미지와 함께 UNICODE의 z/OS 지원을 구성해야 하는 경우가 있습니다.

생성 > XML 파일 메뉴 항목이 XSD 스키마 제한사항을 준수하지 않음

문제점: 생성 -> XML 파일 메뉴 항목이 XSD 스키마의 제한사항을 준수하지 않습니다. 엔터프라이즈 서비스 도구로 작성된 XSD에서 XML 파일 생성 조치를 사용하면 올바르지 않은 XML 파일이 생성될 수 있습니다.

해결 방법: 태그 컨텐츠가 XSD 스키마에 지정된 제한사항을 준수하도록 생성된 XML 파일을 편집하십시오.

XML 및 웹 서비스 일괄처리 프로세서: 구성 XML에 있는 올바르지 않은 항목으로 인해 일괄처리 프로세서 도중 널(null) 포인터 예외 발생

문제점: 옵션 XML 파일에 올바르지 않은 항목(Container.xml, PlatformProperties.xml, ServicesSpecification.xml)이 포함되면 일괄처리 프로세서의 실행 중에 널 포인터 예외가 발생할 수 있습니다.

해결 방법: 옵션 XML 파일에서 형식에 따라 항목을 올바르게 지정하십시오.

XML 및 웹 서비스 일괄처리 프로세서: 입력 언어 파일 위치에서 디렉토리 지정

COBOL 입력 파일의 위치는 importDirectory 속성에서 드라이브 스펙으로 시작되는 절대 경로로 지정될 수 있습니다(예: C:\mypath\test).

상대 경로가 필요한 경우에는(예: xsebatch 구성 파일에서 파일 위치를 변경하지 않고 구성 파일 및 COBOL 소스 코드를 다시 찾을 수 있도록 하기 위해) 다음을 수행하십시오.
표 2.
디렉토리: 설명:
C:\workspace\account_details 기본 프로젝트
C:\workspace\account_details\cobol_src 가져올 COBOL 소스 파일이 있는 서브디렉토리
C:\workspace\account_details\xsebatch_config xsebatch에 대한 XML 구성 파일이 있는 서브디렉토리
그러면 cobol_src 디렉토리에서 DFH0ACTD.cbl이라고 하는 COBOL 소스 파일에 대해 다음의 InputOutputMessage 요소를 사용할 수 있습니다.
<InputOutputMessage importFile="../cobol_src/DFH0ACTD.cbl"></InputOutputMessage>

또는 xsebatch가 호출되는 디렉토리와 같은 디렉토리에 COBOL 소스 파일이 있을 수 있습니다.

XML 및 웹 서비스 일괄처리 프로세서: 대소문자를 혼합하여 데이터 이름 지정

COBOL 데이터 이름에서는 대소문자를 구분하지 않지만 스펙 XML 파일에서는 대소문자를 정확하게 구분하여 지정해야 합니다. 예를 들어, COBOL 데이터 소스에서 데이터 이름을 MY-Data라고 하는 경우, 서비스 스펙 xml에서는 nativeTypeName 속성을 nativeTypeid="MY-Data"로 설정해야 합니다. 대소문자를 정확하게 구분하여 지정하지 않으면 데이터 이름을 찾을 수 없으며, 기본적으로 첫 번째 사용 가능한 레벨 01 데이터 이름이 사용됩니다.

숫자 상수 LOW-VALUES 및 HIGH-VALUES에 대한 제한사항

숫자 상수 LOW-VALUE(S) 및 HIGH-VALUE(S)는 단일 서비스 마법사에서 사용하는 COBOL 데이터 구조에 있을 수 있지만, 단일 서비스 마법사에서 시맨틱 의미가 무시되어 엔터프라이즈 서비스 도구 단일 서비스 마법사가 생성한 아티팩트로 전달되지 않습니다.

엔터프라이즈 서비스 도구 단일 서비스 프로젝트 이름의 GB18030 문자

문제점: 엔터프라이즈 서비스 도구 단일 서비스 프로젝트 이름에 GB18030 코드 페이지의 문자를 사용하면 프로젝트의 파일에서 엔터프라이즈 서비스 도구 단일 서비스 마법사를 실행할 때 오류가 발생합니다.

해결 방법: 엔터프라이즈 서비스 도구 단일 서비스 프로젝트의 이름을 지정하는 경우 GB18030 문자를 사용하지 마십시오.

임시 파일이 항상 정리되지는 않음

문제점: 엔터프라이즈 서비스 도구 단일 서비스 마법사를 실행한 후 엔터프라이즈 서비스 도구 단일 서비스 프로젝트 폴더에 임시 파일(예: ~DF45B.tmp)이 남아 있는 경우도 있습니다.

해결 방법: 엔터프라이즈 서비스 도구 단일 서비스 마법사를 실행한 후 엔터프라이즈 서비스 도구 단일 서비스 프로젝트에서 비슷한 이름의 파일이 표시되면 해당 파일을 안전하게 삭제할 수 있습니다.

임시 프로젝트가 항상 정리되지는 않음

문제점: 이전 맵핑 파일의 이주 프로세스에서는 참조된 맵핑 소스 파일이 해당 맵핑 파일과 동일한 폴더에 있어야 합니다. 이 요구사항이 충족되지 않으면 다음 오류 메시지가 표시되고 맵핑 이주 도구가 실패합니다. "자원 [파일 이름].맵핑이 로컬이 아닙니다".

해결 방법: 엔터프라이즈 서비스 도구 단일 서비스 마법사를 실행한 후 작업공간에서 비슷한 이름의 프로젝트가 표시되면 해당 프로젝트를 안전하게 삭제할 수 있습니다.

버전 6.0 맵핑 파일(.cmx files)을 이주할 때 .cmx 파일에서 참조하는 소스 파일은 같은 폴더에 있어야 함

문제점: 이전 맵핑 파일의 이주 프로세스에서는 참조된 맵핑 소스 파일이 해당 맵핑 파일과 동일한 폴더에 있어야 합니다. 이 요구사항이 충족되지 않으면 다음 오류 메시지가 표시되고 맵핑 이주 도구가 실패합니다. "자원 [파일 이름].맵핑이 로컬이 아닙니다".

해결 방법: 참조된 소스 파일을 이주되는 맵핑 파일과 동일한 폴더로 이동하십시오.

웹 서비스 마법사에서 원격 위치 찾아보기 사용 시 Workbench가 잠김

문제점: 웹 서비스 마법사 페이지에서 대상 폴더(Converter 폴더, WSDL 또는 WSBIND 폴더)의 원격 위치로 찾아보기를 수행하면 연결 이름이 길 경우(예: ctfmvs08.rtp.raleigh.ibm.com) 시간이 오래 걸리거나 Workbench가 잠길 수 있습니다.

해결 방법: 연결 이름을 ctfmvs08과 같은 짧은 이름으로 바꾸십시오.

생성된 XML 스키마의 글로벌 요소 이름이 해석 및 컴파일 XML 변환 유형 간에 일치하지 않음

문제점: 해석 및 컴파일 XML 변환의 기본 생성으로 생성된 XML 스키마에 있는 웹 서비스 메시지 루트 요소 이름이 일치하지 않습니다. 아래의 해결 방법 섹션에 설명된 대로 컴파일 XML 변환의 생성 기본값을 해석 변환과 일치하도록 변경해야 합니다. 이렇게 하면 WSDL 파일을 다시 공개하거나 웹 서비스 클라이언트의 코드를 변경하지 않고 나중에 필요에 따라 변환 유형을 해석에서 컴파일로 변경할 수 있습니다.

해결 방법: 컴파일 XML 변환의 아티팩트를 생성할 때, 마법사를 사용하여 해석 XML 변환과 일치하도록 루트 요소 이름을 변경할 수 있습니다. 이 새 옵션 "루트 요소 이름"은 생성 옵션 페이지에 있는 WSDL 및 XSD 옵션 탭의 요청 및 응답 XML 스키마 특성 그룹에 있습니다.

예를 들어, A-B-C라는 COBOL 그룹에서는 해석 변환 아티팩트의 메시지 루트 요소 이름이 "a_b_c"가 됩니다. 기본 컴파일 변환 아티팩트의 루트 요소 이름은 "ABC"입니다. 이전에 설명한 것과 같이 해석 변환에 대해 생성된 WSDL와 일치하도록 마법사에서 "ABC"를 "a_b_c"로 변경할 수 있습니다.

DBCS 문자는 생성된 XML 변환기 파일의 이름에 사용할 수 없음

문제점: DBCS 문자를 z/OS에서 파티션된 데이터 세트 구성원의 이름에 사용할 수 없습니다.

해결 방법: XML 변환기 파일의 이름을 지정할 때 DBCS 문자를 생략하십시오. 또한 마법사에서 제안된 기본 파일 이름에 DBCS 문자가 포함되지 않았는지 확인하십시오.