AdminTask 오브젝트에 대한 애플리케이션 관리 명령 그룹
wsadmin 도구를 사용하여 애플리케이션을 관리하는 데 Jython 또는 Jacl 스크립트 언어를 사용할 수 있습니다. AppManagementCommands 그룹의 명령 및 매개변수는 SQLJ(SQL Java™) 프로파일 또는 IBM Optim PureQuery Runtime 바인드 파일을 표시하고 처리하기 위해 사용할 수 있습니다.
AdminTask 오브젝트에 대한 AppManagementCommands 명령 그룹에는
다음 명령이 포함됩니다.
listSqljProfiles
listSqljProfiles 명령은 지정된 애플리케이션의 EAR(Enterprise Archive) 파일을 구문 분석하고 SQLJ 파일의 목록을 리턴합니다. SQLJ 프로파일에는 .ser 파일 이름 확장자가 있습니다. EAR 파일에 SQLJ 프로파일은 아니지만 .ser 파일 이름 확장자를 가지고 있는 파일이 있는 경우 이 파일도 나열할 수 있습니다.매개변수 및 리턴값
- -appName
- 설치된 애플리케이션의 이름입니다. 먼저 애플리케이션을 설치한 후 이 애플리케이션에 대해 사용자 정의 및 바인딩을 실행해야 합니다. 이 매개변수는 필수입니다.
예제
일괄처리 모드 사용 예제:
- JACL 사용:
$AdminTask listSqljProfiles {-appName application_name}
- Jython 사용:
print AdminTask.listSqljProfiles('-appName application_name')
대화식 모드 사용 예제:
- JACL 사용:
$AdminTask listSqljProfiles -interactive
- Jython 사용:
print AdminTask.listSqljProfiles('-interactive')
processSqljProfiles
processSqljProfiles 명령은 SQLJ 프로파일의 DB2® 사용자 정의를 작성합니다. 기본적으로, 명령은 선택적으로 DB2 패키지를 바인드하도록 SQLJ 프로파일 바인더를 호출합니다.
연결이 끊기지 않도록
하려면 세션 제한시간을 더 길게 구성하십시오. 시스템 출력 로그에서 총 처리 시간을 확인하고,
해당 시간을 새 제한시간 값의 기초로 사용하십시오. 기본 제한시간 값을 확장하려면 사용 중인 연결 유형에 해당하는 wsadmin
특성 파일을 변경하십시오.
bprac- SOAP 연결 유형의 경우, soap.client.props 파일에서 다음 항목을 변경하십시오.
com.ibm.SOAP.requestTimeout=180
- JSR160RMI 및 RMI 연결 유형의 경우, sas.client.props 파일에서 다음 항목을 변경하십시오.
com.ibm.CORBA.requestTimeout=180
- IPC 연결 유형의 경우, ipc.client.props 파일에서 다음 항목을 변경하십시오.
com.ibm.IPC.requestTimeout=180
바인딩 또는 사용자 정의가 발생하는지 확인할 수 있는
두 가지 방법이 있습니다.
- 사용자 정의 프로세스를 수행한 경우, 변경된 애플리케이션 EAR 파일을 보기 위해
명령행에서 조회를 실행할 수 있습니다.
조회는 변경사항이 없는 경우 0을, 서버에서 변경사항이 발생한 경우 1을 리턴합니다. 변경사항이 저장되지 않은 구성 파일을 보려면 다음을 실행하십시오.wsadmin>print AdminConfig.hasChanges()
.wsadmin>print AdminConfig.queryChanges()
- 바인딩 또는 처리가 성공했는지 여부를 판별하려면 시스템 출력(System Out) 로그를 보십시오.
대상 오브젝트
설치된 애플리케이션 SQLJ 프로파일입니다. 이 프로파일은 단일의 직렬 .ser 파일이거나 .grp 그룹 파일로 그룹화되는 프로파일입니다. 이 대상 오브젝트는 필수입니다.매개변수 및 리턴값
- -appName
- 설치된 애플리케이션의 이름입니다. 먼저 애플리케이션을 설치한 후 이 애플리케이션에 대해 사용자 정의 및 바인딩을 실행해야 합니다. 이 매개변수는 필수입니다.
- -classpath
- 애플리케이션 서버에 필요한 SQLJ 드라이버 JAR 파일을 찾을 위치를 알려주는 경로입니다. 이 매개변수는 선택적입니다.
- -dburl
- 네트워크에서 DB2 서버의 위치입니다. 이 매개변수는 선택적입니다.
- -user
- DB2 데이터베이스에 대한 액세스를 수행하는 계정의 사용자 이름입니다. 이 매개변수는 선택적입니다.
- -password
- DB2 데이터베이스에 액세스하는 계정의 비밀번호입니다. 이 매개변수는 선택적입니다.
- -options
- db2sqljcustomize 명령과 함께 사용되는 추가 옵션은 이전에 나열된 매개변수를 제외하고 -options 매개변수 아래에 삽입할 수도 있습니다. 이 필드는 선택적입니다. db2sqljcustomize 명령에 대한 추가 정보는 db2sqljcustomize - SQLJ 프로파일 사용자 정의 프로그램 참조하십시오.
- -profiles
- SQLJ 프로파일 .ser 파일 또는 .grp 파일의 위치입니다. 이 매개변수는 필수입니다.
예제
일괄처리 모드 사용 예제:
Jacl 사용:
$AdminTask processSqljProfiles {-appName FVT -classpath {C:/IBM/SQLLIB/java/db2jcc.jar } -url jdbc:db2://server.domain.ibm.com:50000/JTEST1 -user dbuser1 -password ***** -options "-rootpkgname MYPKG" -profiles {c:/temp/ApplicationSerNames.grp }}
Jython 사용:
AdminTask.processSqljProfiles('[-appName Application -classpath ["C:/IBM/SQLLIB/java/db2jcc.jar"] -dbURL "jdbc:db2://server.domain.ibm.com:50000/JTEST1" -user dbuser1 -password ***** -options [-rootpkgname MYPKG] -profiles ["c:/temp/ApplicationSerNames.grp"]]')
대화식 모드 사용 예제:
wsadmin>print AdminTask.processSqljProfiles('-interactive') Process serialized SQLJ
profiles. Process the serialized SQLJ profiles in an installed application. Customize the profiles with run time information and
bind static SQL packages in a database. Refer to the Database SQLJ customize and bind documentation. Do only bind
실패했습니다. (bindOnly): false *Application name. (appName): Application Classpath to SQLJ tools. (classpath):
C:/IBM/SQLLIB/java/db2jcc.jar Database connection URL. (dbURL): Database connection user name. (user): Database connection
비밀번호(password): Options for SQLJ tools. (options): *SQLJ profile names. (profiles): c:/temp/ApplicationSerNames.grp
Process serialized SQLJ profiles. F (Finish) C (Cancel) Select [F, C]: [F] WASX7278I: Generated command line:
AdminTask.processSqljProfiles('[-bindOnly false -appName Application -classpath [C:/IBM/SQLLIB/java/db2jcc.jar] -profiles
[c:/temp/ApplicationSerNames.grp ]]')
listPureQueryBindFiles
listPureQueryBindFiles 명령은 지정된 애플리케이션의 EAR 파일을 구문 분석하고 발견되는 .bindprops 및 .pdqxml 파일의 목록을 리턴합니다. PureQuery 바인드 옵션 파일에는 .bindprops 파일 이름 확장자가 있습니다. 바인드 파일에는 .pdqxml 파일 이름 확장자가 있습니다. EAR 파일에 pureQuery 바인드 파일이 아니지만 .bindprops 또는 .pdqxml 파일 이름 확장자가 있는 파일이 있는 경우 이 파일도 나열될 수 있습니다.매개변수 및 리턴값
- -appName
- 설치된 애플리케이션의 이름입니다. 이 매개변수는 필수입니다.
예제
일괄처리 모드 사용 예제:
JACL 사용:
$AdminTask listPureQueryBindFiles {-appName application_name}
Jython 사용:
print AdminTask.listPureQueryBindFiles('-appName application_name')
대화식 모드 사용 예제:
JACL 사용:
$AdminTask listPureQueryBindFiles -interactive
Jython 사용:
print AdminTask.listPureQueryBindFiles('-interactive')
출력은 로컬 운영 체제에 특정한 구문으로 표시합니다.
processPureQueryBindFiles
processPureQueryBindFiles 명령은 pureQuery 바인드 파일 목록에서 DB2 pureQuery 바인드 유틸리티를 호출합니다.
이러한 제한시간 초과가 발생하지 않도록,
wsadmin 요청 제한시간을 더 길게 구성하십시오. 사용자 정의 및 바인딩 프로세스가 성공하면 시스템 출력 로그를 사용하여
총 처리 시간을 예측하십시오. 이 시간을 새 제한시간 값의 기초로 사용하십시오.
기본 제한시간 값을 확장하려면 사용 중인 연결 유형에 해당하는 wsadmin
특성 파일을 변경하십시오.
bprac- SOAP 연결 유형의 경우, soap.client.props 파일에서 다음 항목을 변경하십시오.
com.ibm.SOAP.requestTimeout=180
- JSR160RMI 및 RMI 연결 유형의 경우, sas.client.props 파일에서 다음 항목을 변경하십시오.
com.ibm.CORBA.requestTimeout=180
- IPC 연결 유형의 경우, ipc.client.props 파일에서 다음 항목을 변경하십시오.
com.ibm.IPC.requestTimeout=180
바인딩이 발생했는지 여부를 확인하려면 시스템 출력 로그에서 바인드 처리가 성공했는지를 판별하십시오.
매개변수 및 리턴값
- -appName
- 처리할 pureQuery 바인드 파일을 포함하는 설치된 애플리케이션의 이름입니다. 먼저 애플리케이션을 설치한 후 이 애플리케이션에 대해 바인딩을 실행해야 합니다.
- -classpath
- IBM Optim PureQuery Runtime 바인드 유틸리티 및 해당 종속 항목(pdq.jar, pdqmgmt.jar, db2jcc4.jar 또는 db2jcc.jar, db2jcc_license_cisuz.jar 또는 db2jcc_license_cu.jar)을 포함하는 JAR(Java Archive) 파일에 대한 경로의 목록입니다. 파일 구분 기호로 / 또는 \\\\를 사용하십시오. JAR 파일에 대한 경로를 구분하기 위해 공백을 사용하십시오.
- -dburl
- 데이터베이스에 연결하기 위한 URL입니다. 형식은 jdbc:db2://server_name:port/database_name입니다.
- -user
- DB2 데이터베이스에 대한 액세스를 수행하는 계정의 사용자 이름입니다.
- -password
- DB2 데이터베이스에 액세스하는 계정의 비밀번호입니다.
- -options
- IBM Optim PureQuery Runtime 바인드 유틸리티에 필요한 추가 옵션입니다. 바인드 옵션을 -bindoptions "bind_options_string"으로 제공하십시오. IBM Optim PureQuery Runtime 바인드 유틸리티에 대한 추가 정보는 pureQuery 바인드 유틸리티에 대한 주제를 참조하십시오.
- -files
- 처리할 pureQuery 바인드 파일의 이름 목록입니다. 바인드 파일 경로 이름은 이 이름을 포함하는 애플리케이션 EAR 파일에 상대적이어야 합니다. 파일 구분 기호로 / 또는 \\\\를 사용하십시오. 여러 프로파일 경로를 지정하는 경우 공백을 사용하여 구분하십시오.
예제
일괄처리 모드 사용 예제:
Jacl 사용:
$AdminTask processPureQueryBindFiles {-appName MyApp -classpath {/pdq_home/pdq.jar /pdq_home/pdqmgmt.jar /db2_home/SQLLIB/java/db2jcc4.jar /db2_home/SQLLIB/java/db2jcc_license_cu.jar } -url jdbc:db2://hostname:50000/databasename -user dbuser1 -password dbpswrd1 -options {-bindoptions "BLOCKING NO"} -files {META-INF/xyz.bindprops META-INF/abc.bindprops }}
Jython 사용:
print AdminTask.processPureQueryBindFiles('[-appName MyApp -classpath [/pdq_home/pdq.jar /pdq_home/pdqmgmt.jar /db2_home/SQLLIB/java/db2jcc4.jar /db2_home/SQLLIB/java/db2jcc_license_cu.jar ] -url jdbc:db2://hostname:50000/databasename -user dbuser1 -password dbpswrd1 -options [-bindoptions "BLOCKING NO"] -files [META-INF/xyz.bindprops META-INF/abc.bindprops ]]')
대화식 모드 사용 예제:
print AdminTask.processPureQueryBindFiles('-interactive') Process pureQuery bind files.
Process the pureQuery bind files in an installed application. Bind static SQL packages in a database. Refer to the pureQuery
Bind utility documentation. *Application name. (appName): MyApp Classpath to pureQuery Bind utility. (classpath):
/pdq_home/pdq.jar /pdq_home/pdqmgmt.jar /db2_home/SQLLIB/java/db2jcc4.jar /db2_home/SQLLIB/java/db2jcc_license_cu.jar *Database
connection URL. (url): jdbc:db2://hostname:50000/databasename Database connection user name. (user): dbuser1 Database connection
비밀번호(password): dbpswrd1 Options for the pureQuery Bind utility. (options): -bindoptions "BLOCKING NO" *pureQuery bind file
names. (files): META-INF/xyz.bindprops META-INF/abc.bindprops Process pureQuery bind files. F (Finish) C (Cancel) Select [F,
C]: [F] WASX7278I: Generated command line: AdminTask.processPureQueryBindFiles('[-appName MyApp -classpath [/pdq_home/pdq.jar
/pdq_home/pdqmgmt.jar /db2_home/SQLLIB/java/db2jcc4.jar /db2_home/SQLLIB/java/db2jcc_license_cu.jar ] -url
jdbc:db2://hostname:50000/databasename -user dbuser1 -password ***** -options [-bindoptions "BLOCKING NO"] -files
[META-INF/xyz.bindprops META-INF/abc.bindprops ]]')