AdminTask 对象的应用程序管理命令组
要通过 wsadmin 工具管理应用程序,可以使用 Jython 或 Jacl 脚本语言来实现。AppManagementCommands 组中的命令和参数可用于显示和处理 SQL Java™ (SQLJ) 概要文件或 IBM Optim PureQuery Runtime 绑定文件。
AdminTask 对象的 AppManagementCommands 命令组包括以下命令:
listSqljProfiles
listSqljProfiles 命令解析所指定应用程序的企业归档 (EAR) 文件并返回 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® 定制。(可选)缺省情况下,该命令会调用 SQLJ 概要文件绑定程序来绑定 DB2 包。
要防止此断开连接的情况,请将会话超时配置为较长的时间段。请参阅系统输出日志以了解总处理时间并将该时间段用作新超时值的基础。要延长缺省超时值,请更改与正在使用的连接类型对应的
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()
- 查看系统输出日志,以确定绑定或处理是否已成功。
目标对象
已安装的应用程序 SQLJ 概要文件。这些概要文件是单个的连续 .ser 文件或在 .grp 组文件中分组的概要文件。此目标对象是必需的。参数和返回值
- -appName
- 已安装的应用程序的名称。在对应用程序运行定制和绑定之前,必须安装该应用程序。此参数是必需的。
- -classpath
- 用于向应用程序服务器说明何处查找必需 SQLJ 驱动程序 JAR 文件的路径。此参数是可选的。
- -dburl
- 网络上 DB2 服务器的位置。此参数是可选的。
- -user
- 执行对 DB2 数据库的访问的帐户的用户名。此参数是可选的。
- -password
- 对 DB2 数据库进行访问的帐户的密码。此参数是可选的。
- -options
- 通过 -options 参数(先前列示的参数除外),可插入与 db2sqljcustomize 命令配合使用的其他选项。此参数是可选的。有关 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
processing. (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. (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
- Java 归档 (JAR) 文件的路径的列表,这些文件 包含 IBM Optim PureQuery Runtime 绑定实用程序及其 依赖项:pdq.jar、pdqmgmt.jar、db2jcc4.jar、db2jcc.jar、db2jcc_license_cisuz.jar 或 db2jcc_license_cu.jar。请使用 / 或 \\\\ 作为文件分隔符。使用空格来分隔 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. (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 ]]')