AdminTask 对象的应用程序管理命令组
要通过 wsadmin 工具管理应用程序,可以使用 Jython 或 Jacl 脚本语言来实现。 使用 AppManagement命令组中的命令和参数可用来显示和处理 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
processSqlj"概要文件" 命令用于创建 SQLJ 概要文件的 DB2® 定制。 缺省情况下,该命令可选择调用 SQLJ 概要文件绑定程序以绑定 DB2 程序包。注: 如果您正在处理大型企业应用程序,或者正在处理许多 SQLJ 概要文件,那么该进程可能比 wsadmin 工具的缺省超时时间更长。 wsadmin 工具的缺省连接超时设置为 3 分钟。 如果达到缺省超时,但是与服务器断开连接,那么
wsadmin 控制台会发出 Timeout 语句。 可以检查系统输出日志,以了解定制和绑定进程的最终结果及该进程所用时间量。 请不要在前面的命令完成之前再次启动 processSqljProfiles 命令,否则,结果可能不可预测。
要防止此断开连接的情况,请将会话超时配置为较长的时间段。 请参阅系统输出日志以了解总处理时间并将该时间段用作新超时值的基础。 要延长缺省超时值,请更改与正在使用的连接类型对应的
wsadmin 属性文件:
- 对于 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
processPureQueryBind文件命令调用 pureQuery 绑定文件列表上的 DB2 pureQuery 绑定实用程序。最佳实践: 如果您正在处理大型企业应用程序,或者正在使用 wsadmin 来处理许多 pureQuery 绑定文件,那么该过程的时间可能超过 wsadmin 工具的缺省超时时间。 wsadmin 工具的缺省连接超时设置为 3 分钟。 如果达到缺省超时,但是服务器上运行的进程尚未完成,那么
wsadmin 控制台会发出 Timeout 语句。 可以检查服务器上的系统输出日志,以了解绑定进程的最终结果及该进程完成的时间。 请不要在前面的命令完成之前再次启动
processPureQueryBindFiles 命令,否则,结果可能不可预测。
要防止此超时情况,请将 wsadmin 请求超时配置为较长的时间段。 在定制和绑定进程成功完成之后,请使用系统输出日志来估计总处理时间。 将此时间段用作新超时值的基础。 要延长缺省超时值,请更改与正在使用的连接类型对应的
wsadmin 属性文件:
- 对于 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
- -classpath
- 包含 IBM Optim PureQuery Runtime 绑定实用程序及其依赖关系的 Java 归档 (JAR) 文件的路径列表: 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 ]]')