옵션 파일을 사용하여 클라이언트 최적화를 위해 StaticBinder 유틸리티를 실행하기 위한 구문

명령 및 옵션 파일을 사용하여 pureQueryXML 파일의 이름과 이 파일을 기반으로 하는 DB2® 패키지 또는 DBRM 파일 작성을 위한 옵션을 지정할 수 있습니다.pureQueryXML 파일이 하나만 있는 경우에도 옵션 파일을 사용할 수 있습니다.

명령에 pureQueryXML 파일을 나열하고 옵션 파일에서는 defaultOptions 엔트리만 사용할 수 있습니다.

명령과 옵션 파일에서 pureQueryXML 파일을 나열할 수 있습니다. 파일이 명령과 옵션 파일 모두에 나열되는 경우 StaticBinder 유틸리티는 파일을 처리합니다. 파일이 옵션 파일에는 나열되지만 명령에는 나열되지 않는 경우 StaticBinder 유틸리티는 파일을 처리하지 않습니다. 파일이 명령에 나열되지만 옵션 파일에는 나열되지 않는 경우 StaticBinder 유틸리티는 명령행의 옵션과 옵션 파일의 defaultOptions 엔트리로 파일을 처리합니다.

명령행에서 StaticBinder 유틸리티를 실행하고 옵션 파일을 사용하는 경우, 유틸리티는 다음 우선순위 순서대로 옵션을 인식합니다.
  1. 명령행의 옵션
  2. 개별 pureQueryXML 파일에 대한 옵션과 지정된 옵션 파일에 있는 명령문 세트
  3. 지정된 옵션 파일의 디폴트 옵션
구문 도표 읽기시각적 구문 도표 생략
                                        (1)   
>>-java--com.ibm.pdq.tools.StaticBinder------------------------->

>--+---------------------------------------------------------------------------------------------------------------+-->
   |  (2)                                                                                                          |   
   '------- -url--jdbc--:--db2--:--//--server--+---------+--/--database-- -username--user-ID-- -password--password-'   
                                               '-:--port-'                                                             

>--+-----------------------------------------------------------------+-->
   |                 .---------------------------------------------. |   
   |                 V                                             | |   
   '- -pureQueryXml----+-pureQueryXML-file-----------------------+-+-'   
                       '-pureQueryXML-file--:--base-package-name-'       

>-- -optionsFile--file-name--+-----------------------------+---->
                             |                   .-FALSE-. |   
                             '- -differenceOnly--+-TRUE--+-'   

>--+--------------------------+--+-----------------------+------>
   |                .-FALSE-. |  |                   (3) |   
   '- -showDetails--+-TRUE--+-'  '-| Trace options |-----'   

>--+-------------------------------+---------------------------->
   '- -verifyPackages--+-DETAIL--+-'   
                       '-SUMMARY-'     

>--+--------------------------+--------------------------------><
   |                .-FALSE-. |   
   '- -validateXml--+-TRUE--+-'   

주:
  1. 임의의 순서로 옵션을 지정할 수 있습니다.
  2. 명령에 URL, 사용자 ID 및 암호를 지정하지 않는 경우, DBRM 파일만 작성하지 않으려면 옵션 파일에서 지정해야 합니다.
  3. 구문의 경우 해당 옵션의 설명을 참조하십시오.

옵션에 대한 설명

-optionsFile file-name
바인드하려는 SQL문을 포함하는 pureQueryXML 파일을 나열하는, 절대 또는 상대 경로를 포함하는 파일의 이름입니다.
-password password
데이터 소스에 연결하는 데 사용하는 암호입니다.
-pureQueryXml pureQueryXML-file|pureQueryXML-file:base-package-name
패키지로 바인드할 SQL문 세트들을 포함하는 pureQueryXML 파일이나 패키지로 바인드할 단일 SQL문 세트를 지정합니다. 두 개 이상의 값을 지정할 수 있습니다.
pureQueryXML-file
pureQueryXML 파일의 이름입니다. 예: C:\directory\captureFile.pdqxml
이 파일의 확장자는 .pdqxml 또는 .xml이어야 합니다.파일은 응용프로그램의 클래스 경로에 있는 자원이거나 파일의 전체 또는 상대 경로를 제공해야 합니다.
pureQueryXML-file:base-package-name
pureQueryXML 파일의 이름이고 바인드할 패키지의 기본 이름입니다(예: C:\directory\captureFile.pdqxml:MYPKGA).

파일 확장자는 .pdqxml 또는 .xml이어야 합니다. 파일은 응용프로그램의 클래스 경로에 있는 자원이거나 파일의 전체 또는 상대 경로를 제공해야 합니다.

패키지의 기본 이름은 pureQueryXML 파일에서 패키지를 설명하는 package 요소의 name 속성 값입니다. 기본 이름은 다음 두 파트로 구성됩니다.
  • 루트 패키지 이름
  • Configure 유틸리티가 루트 패키지 이름에 추가한 문자(Configure 유틸리티가 pureQueryXML 파일을 마지막으로 처리할 때 sqlLimit 옵션의 값으로 인해)
단일 명령에서 -pureQueryXml-optionsFile과 함께 사용하는 경우 많은 결과가 가능합니다. 명령에서 pureQueryXML 파일 및 명령문 세트를 지정할 때 옵션 파일 사용을 참조하십시오.
Trace options
메시지를 로그할 파일 및 로그할 정보 레벨을 지정할 수 있습니다.
구문 도표 읽기시각적 구문 도표 생략
>>-+------------------------+--+---------------------------+---><
   '- -traceFile--file-name-'  |               .-OFF-----. |   
                               '- -traceLevel--+-ALL-----+-'   
                                               +-SEVERE--+     
                                               +-WARNING-+     
                                               +-INFO----+     
                                               +-CONFIG--+     
                                               +-FINE----+     
                                               +-FINER---+     
                                               '-FINEST--'     

-traceFile file-name
조작에 대한 정보를 로그하는데 사용하려는 절대 또는 상대 경로 및 파일 이름을 지정합니다.
파일이 이미 존재한다면 pureQuery는 새 메시지를 파일의 기존 컨텐츠에 추가합니다.디폴트로, 엔트리는 System.err에 기록됩니다.
-traceLevel OFF|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST|ALL
로그할 정보 유형을 지정합니다. 디폴트 레벨은 OFF입니다. 로그 엔트리를 기록할 파일을 지정하지 않고 이 옵션을 OFF가 아닌 다른 값으로 설정하는 경우, 엔트리는 System.err에 기록됩니다.
-url connection-URL
데이터베이스를 연결하기 위한 유형 4 JDBC URL입니다.
-username user ID
데이터 소스에 연결하는 데 사용하는 사용자 ID입니다.
-verifyPackages DETAIL|SUMMARY
StaticBinder 유틸리티가 pureQueryXML 파일과 연관된 SQL문으로 존재하거나 존재하지 않는 패키지의 보고서를 작성할 것인지 여부를 지정합니다. 이 옵션을 사용하면 StaticBinder 유틸리티가 패키지를 바인드하지 않습니다.

예를 들어, myApp.pdqxml이라는 pureQueryXML에서 구성 유틸리티를 실행했다고 가정합니다. 유틸리티를 실행했을 때 -collection, -pkgVersion 및 -rootPkgName 옵션에 대한 값이 제공되었으며 유틸리티는 이들 값을 pureQueryXML 파일에 저장했습니다. 이 파일의 이름을 지정하는 StaticBinder 유틸리티를 실행하면 유틸리티가 DB2 패키지를 작성합니다.

나중에 StaticBinder 유틸리티가 pureQueryXML 파일에서 작성한 패키지 목록을 볼 수 있습니다. 유틸리티를 실행 시, -verifyPackages 옵션을 사용하여 DETAIL 값을 지정하고 다시 파일 이름을 제공할 수 있습니다.

-collection, -pkgVersion 및 -rootPkgName 옵션 값이 StaticBinder 유틸리티를 이전에 실행했을 때와 같다면, 유틸리티가 해당 패키지를 찾아 나열합니다.

하지만 먼저 StaticBinder 유틸리티를 실행하고 -collection, -pkgName 및 -rootPkgName 값을 변경한 후 구성 유틸리티를 myApp.pdqxml에서 실행하면, StaticBinder 유틸리티가 이들 옵션의 새 값과 일치되는 패키지를 찾지 못합니다. 보고서에서 StaticBinder 유틸리티는 찾고 있는 패키지가 없다고 보고합니다.

구성 유틸리티를 pureQueryXML 파일에서 실행한 다음 StaticBinder 유틸리티를 실행한 후, 파일에서 다시 구성 유틸리티를 실행하지 않고 -collection, -pkgVersion 및 -rootPkgName에 대해 다른 값을 제공하지 않았다는 전제 하에서 -verifyPackages 옵션이 동작합니다.

이 옵션은 -bindOptions 옵션과 함께 지정할 수 있습니다. 하지만 StaticBinder 유틸리티는 패키지를 바인드하지 않습니다. 패키지를 작성할 때 이 옵션을 사용하여 콜렉션을 지정한 경우 -bindOptions만을 사용하여 검증할 패키지 콜렉션을 지정하십시오.

세부사항
-collection, -pkgVersion 및 -rootPkgName 값을 기본으로 하는 다음 정보를 설명하는 보고서를 작성합니다.
  • 존재하지 않는 패키지.
  • 존재하는 패키지. 각 패키지에 대해 보고서는 이름, 일관성 토큰, 시간소인 및 분리 레벨을 나열합니다.
  • 존재하거나 존재하지 않는 패키지 수.
요약
-collection, -pkgVersion, 및 -rootPkgName의 값을 부여하는 존재하거나 존재하지 않는 패키지를 나열하는 보고서를 작성합니다.
-validateXml TRUE|FALSE
XML 스키마 유효성 확인이 pureQueryXML 스키마를 사용하여 입력 pureQueryXML 파일에서 수행되는지 여부를 지정합니다. 값이 TRUE인 경우 유효성 확인이 수행됩니다. 값이 FALSE이거나 옵션이 지정되지 않은 경우 유효성 확인이 수행되지 않습니다. 디폴트값은 FALSE입니다.

XML 스키마 유효성 확인의 성공 또는 실패가 판별되며 각 입력 파일에 대해 보고됩니다. 하나의 입력 파일이 실패하는 경우, StaticBinder 처리는 중지되지 않으며 연속되는 파일이 처리됩니다.

pureQueryXML 파일이 스키마 유효성 확인을 실패하는 경우 해당 파일 내의 패키지는 바운드되지 않습니다. 첫 번째 스키마 유효성 확인 오류 및 해당 파일의 바인드 실패가 보고됩니다.

현재 릴리스 또는 이전 버전 pureQueryXML 파일만 유효성 확인됩니다(버전 4 또는 3). 이전 버전 pureQueryXML이 발견되는 경우, 유효성 확인은 해당 파일에서 수행되지 않습니다.


피드백