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')
输出以特定于本地操作系统的语法显示。 可用概要文件的列表可直接添加至扩展名为 .grp 的组文件。

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 文件:
    wsadmin>print AdminConfig.hasChanges()
    查询返回0如果没有更改,并且1如果在服务器上发生更改。 要查看具有未保存更改的配置文件,请运行以下命令:
    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
包含待处理 pureQuery 绑定文件的已安装应用程序的名称。 在对应用程序运行绑定之前,必须安装该应用程序。
-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 ]]')