워크벤치의 편집기에서 이 파일을 열려면 파일을 더블 클릭하십시오. 파일은 Java™ 프로젝트의 pureQueryFolder 폴더에 위치합니다.
이 파일에서 프로젝트의 모든 pureQueryXML 파일에 적용되는 옵션을 지정할 수 있습니다. 또한 개별 pureQueryXML 파일에 특정한 옵션을 지정할 수도 있습니다.
이 파일에 주석을 추가할 수 있습니다. 각 주석은 # 기호로 시작하십시오.
항목을 작성하거나 편집할 때 CTRL+SPACE(또는 이 디폴트값을 변경한 경우 사용자 고유 키 입력)를 입력하여 지원을 사용할 수 있습니다.
구문 다이어그램을 쉽게 이해하려면 구문 다이어그램 읽는 방법을 참조하십시오.
파일을 저장하면, 워크벤치는 그 파일에 대해 Configuration 유틸리티를 실행하고 SQL 아웃라인 보기를 새로 고칩니다. 사용자가 아직 바인드 조작을 수행하지 않았으므로, 보기는 계속 바인드되지 않은 패키지만 표시합니다.
다음 다이어그램은 파일에 나열된 모든 pureQueryXML 파일에 대한 디폴트 옵션 설정에 허용되는 구문을 보여줍니다.
>>-defaultOptions--=--+-----------------------------------+-----> | .-NULLID----------. | '- -collection--+-collection-name-+-' >--+--------------------------------+---------------------------> '- -pkgVersion-- -+-AUTO-------+-' '-version-ID-' >--+--------------------------------------------------------+---> '- -allowStaticRowsetCursors--+-READ_ONLY--------------+-' +-READ_ONLY_SCROLLABLE---+ +-READ_ONLY_FORWARD_ONLY-+ '-NEVER------------------' >--+---------------------------------------+--------------------> | .-FALSE-. | '- -forceSingleBindIsolation--+-TRUE--+-' >--+------------------------+--+-----------------------+------->< | .-100----. | | (1) | '- -sqlLimit--+-number-+-' '-| Trace options |-----'
다음 구문 다이어그램은 파일에 나열된 개별 pureQueryXML 파일에 대한 옵션 설정에 허용되는 구문을 보여줍니다.
>>-pureQueryXML-file--+-----------------------------------+-----> | .-NULLID----------. | '- -collection--+-collection-name-+-' >--+--------------------------------+---------------------------> '- -pkgVersion-- -+-AUTO-------+-' '-version-ID-' >-- -rootPkgName--package-name-stem-----------------------------> >--+--------------------------------------------------------+---> '- -allowStaticRowsetCursors--+-READ_ONLY--------------+-' +-READ_ONLY_SCROLLABLE---+ +-READ_ONLY_FORWARD_ONLY-+ '-NEVER------------------' >--+-----------------------------+------------------------------> | .-FALSE-. | '- -cleanConfigure--+-TRUE--+-' >--+---------------------------------------+--------------------> | .-FALSE-. | '- -forceSingleBindIsolation--+-TRUE--+-' >--+------------------------+--+-----------------------+------->< | .-100----. | | (1) | '- -sqlLimit--+-number-+-' '-| Trace options |-----'
파일 이름에 추가하여 파일의 절대 경로를 지정해야 합니다.
IBM Data Server Driver for JDBC and SQLJ 등록 정보에서 행 세트 커서가 사용되어야 한다고 표시되면 z/OS용 DB2만 행 세트 커서를 사용합니다. 다른 유형의 데이터 소스에서 캡처하거나 행 세트 커서가 사용 가능하지 않다면 캡처한 명령문은 행 세트 커서를 사용하지 않습니다.
행 세트 커서가 포워드 온리(forward-only) 커서를 사용하지 않는 경우, 유형 4 연결은 내부적으로 유사한 메커니즘을 사용하여 네트워크 트래픽을 최소화할 수 있습니다.
이 옵션은 다음 4개의 값 중 하나입니다.
이들 조건이 참인 경우 이 옵션을 사용하지 않아도 됩니다.
이들 조건 중 하나가 참인 경우 pureQuery는 명령문을 갱신할 수 있는 것으로 간주합니다.
행 세트 커서를 지원하지 않는 데이터 소스에 대해 명령문을 정적으로 실행하면, pureQuery는 행 세트 커서를 사용하도록 지정된 명령문에 대해 행 세트 커서를 사용하려고 시도하지 않습니다.
이 옵션을 지정하지 않은 경우, 명령문을 캡처했을 때 JDBC 및 SQLJ용 IBM 데이터 서버 드라이버가 행 세트 커서를 사용한 명령문에 대해 디폴트로 pureQuery는 행 세트 커서를 사용합니다.
처리 동안 sqlLimit, groupSQLByString 및 groupSQLBySpecialRegister와 같이 지정된 옵션에 따라 모든 SQL문이 명령문 세트로 구성됩니다. 출력 파일의 명령문 세트는 입력 파일의 명령문 세트와 다를 수 있습니다.
값에 -rootPkgName 옵션을 입력해야 합니다.
이 값이 디폴트값입니다. 값에 -rootPkgName 옵션을 입력해야 합니다.
이름 지정되지 않은 명령문 세트의 경우, 구성은 지정된 모든 옵션을 적용합니다.
configureStatus REQUIRED인 이름 지정된 명령문 세트의 경우 -collection, -pkgVersion , -forceSingleBindIsolation 및 -markDDLForBind와 같은 일부 옵션이 적용됩니다. 일관성 토큰이 갱신됩니다.
configureStatus 플래그가 AUTO로 설정된 이름 지정된 명령문 세트의 경우, 구성 유틸리티가 명령문 세트를 수정해야 한다고 판별하는 경우에만 구성에 옵션이 적용됩니다. 명령문 세트가 수정되지 않으면 일관성 토큰은 갱신되지 않습니다.
configureStatus 플래그가 FINAL로 설정된 이름 지정된 명령문 세트의 경우, 구성 유틸리티는 명령문 세트에 문제점이 발견된 경우 오류를 표시합니다. 오류에는 상향식 순서가 아닌 섹션 번호와 SELECT문과 연관되지 않은 위치 갱신 명령문이 포함됩니다. 구성 유틸리티는 명령문 세트에서 명령문이 제거되어야 하는 경우 경고를 표시합니다. 예를 들어, -removeSQLInactiveForDays 옵션이 지정되고 명령문의 시간소인이 제거 기준과 일치하는 경우 명령문 세트에서 명령문이 제거될 수 있습니다. 해당 명령문과 연관된 특수 레지스터 값이 변경되는 경우, 명령문은 다른 명령문 세트로 이동할 수 있습니다.
-isolationLevel 옵션을 사용하여 단일 명령문 세트를 두 개 또는 세 개의 다른 패키지(각 패키지는 다른 분리 수준에 있음)에 바인드하려는 경우, 명령문 세트가 표시되는 pureQueryXML 파일에 대해 Configure 유틸리티를 실행할 때 -forceSingleBindIsolation 옵션을 사용하지 마십시오.
예를 들어, StaticBinder 유틸리티에 대한 옵션 파일에서 다음 두 엔트리를 포함시켰다고 가정하겠습니다.
C:/dir/captureFile.pdqxml:MYPKGA = -isolationLevel UR C:/dir/captureFile.pdqxml:MYPKGA = -isolationLevel CS
captureFile.pdqxml 파일에 대해 Configure 유틸리티를 실행할 때 -forceSingleBindIsolation 옵션을 사용한 경우 StaticBinder 유틸리티는 다음 조치를 수행합니다.
결과는 CS 분리 수준에서 바인드된 단일 MYPKGA 패키지입니다.
결과가 두 개의 MYPKGA 패키지(하나는 UR 분리 수준에서 다른 하나는 CS 분리 수준에서)가 되도록 하려면, captureFile.pdqxml에 대해 Configure 유틸리티를 실행할 때 -forceSingleBindIsolation 옵션을 사용하지 마십시오.
DB2에서는 패키지의 여러 버전이 동시에 존재할 수 있으므로 같은 이름으로 지정된 패키지의 이전 버전을 바꾸지 않고 새 패키지를 바인드할 수 있습니다. 새 패키지에서 문제점이 발생하는 경우 해당 패키지의 이전 버전을 사용할 수 있습니다.
이 옵션을 지정하지 않으면 연속 바인드에서 오는 데이터베이스 패키지가 버전 없이 작성됩니다.
런타임 시 버전 검증은 버전 이름이 아닌 일관성 토큰을 기반으로 합니다.
package-name-stem은 사용 중인 DB2 데이터베이스에서 설정한 제한조건 내에 있어야 합니다.
DB2 패키지를 작성하지 않고 DBRM 파일을 생성하는 pureQuery StaticBinder 유틸리티를 사용하려는 경우, package-name-stem은 대문자여야 하며 6자를 초과해서는 안됩니다. pureQueryXml 파일에 DDL문을 포함하거나 패키지당 명령문 수(sqlLimit로 지정된)에 도달하면 구성 유틸리티는 이름 어간에 문자를 추가합니다. StaticBinder 유틸리티를 사용하여 DBRM 파일과 package-name-stem의 조합을 생성하면, 구성 유틸리티의 활동 때문에 추가 문자 및 분리 레벨이 8자보다 길며 StaticBinder 유틸리티가 예외로 처리합니다.
디폴트값은 100입니다.
처음 100개의 SQL문을 포함한 패키지 | 다음 n개의 SQL문을 포함한 패키지(100 < n < 200) | |
---|---|---|
CS 분리 레벨 | myPackageA1 | myPackageB1 |
RR 분리 레벨 | myPackageA2 | myPackageB2 |
RS 분리 레벨 | myPackageA3 | myPackageB3 |
UR 분리 레벨 | myPackageA4 | myPackageB4 |
숫자는 패키지의 분리 레벨을 지정하고 문자는 sqlLimit 값으로 인해 작성된 패키지 수 및 pureQueryXML 파일의 명령문 수를 지정합니다. 문자는 영문자 순입니다. z자에 도달하고 패키지를 더 작성해야 하는 경우, AA, AB, AC 등으로 문자가 계속 추가됩니다. 데이터베이스의 이름이 너무 길어지면 루트 패키지 이름의 길이를 줄이거나 sqlLimit의 값을 늘리십시오. 단일 분리 레벨로 패키지를 작성하려는 경우 -forceSingleBindIsolation 옵션을 사용하여 분리 레벨을 표시하는 번호를 제거할 수도 있습니다.
DB2 패키지를 나타내는 명령문 세트를 작성할 때 구성 유틸리티가 SQL문 한계를 초과하는 경우입니다. 커서를 조작하는 모든 SQL문은 해당 커서에 대한 DECLARE CURSOR문과 같은 패키지에 있어야 합니다. 예를 들어, 응용프로그램에서 같은 커서를 참조하는 15개의 다른 UPDATE문을 실행하는 경우, 15개 명령문 모두 해당 커서의 DECLARE CURSOR문이 있는 DB2 패키지에 있어야 합니다.
응용프로그램의 성능을 최상으로 하기 위해 sqlLimit를 400보다 높은 값으로 설정하지 마십시오.
>>-+------------------------+--+---------------------------+--->< '- -traceFile--file-name-' | .-OFF-----. | '- -traceLevel--+-ALL-----+-' +-SEVERE--+ +-WARNING-+ +-INFO----+ +-CONFIG--+ +-FINE----+ +-FINER---+ '-FINEST--'