使用 wsadmin 脚本编制的 AdminTask 对象的 AdministrativeJobs 命令组

您可以使用 Jython 脚本编制语言,通过 wsadmin 工具来对管理作业进行配置和管理。

deleteJob

deleteJob 命令会从作业管理器中删除现有作业。如果在您调用此命令时作业处于正在运行状态,那么不论是否删除了此作业,系统都会返回作业结果。

目标对象

无。

必需参数

-jobToken
指定要删除的作业的唯一标识。(字符串,必需)

返回值

此命令不会返回输出。

批处理方式示例用法

  • 使用 Jython 字符串:
    AdminTask.deleteJob('-jobToken myToken')
  • 使用 Jython 列表:
    AdminTask.deleteJob('-jobToken', 'myToken')

交互方式示例用法

  • 使用 Jython:
    AdminTask.deleteJob('-interactive')

getJobTargets

getJobTargets 命令会显示相关作业的目标。此命令返回的作业目标可能会被注销或删除。

目标对象

无。

必需参数

-jobToken
指定相关作业的唯一标识。(字符串,必需)

返回值

此命令会返回相关作业的目标的节点名。

批处理方式示例用法

  • 使用 Jython 字符串:
    AdminTask.getJobTargets('-jobToken myToken')
  • 使用 Jython 列表:
    AdminTask.getJobTargets('-jobToken', 'myToken')

交互方式示例用法

  • 使用 Jython:
    AdminTask.getJobTargets('-interactive')

getJobTargetStatus

getJobTargetStatus 命令会显示相关作业的最新作业目标状态。

目标对象

无。

必需参数

-jobToken
指定相关作业的唯一标识。(字符串,必需)

可选参数

-targetList
指定目标节点名的列表。(String [ ],可选)

返回值

此命令会返回目标的最新作业状态。状态可能是:NOT_ATTEMPTED、DISTRIBUTED、ASYNC_IN_PROGRESS、SUCCEEDED、PARTIALLY_SUCCEEDED、FAILED、DELAYED 或 REJECTED。

批处理方式示例用法

  • 使用 Jython 字符串:
    AdminTask.getJobTargetStatus('-jobToken myToken')
  • 使用 Jython 列表:
    AdminTask.getJobTargetStatus('-jobToken', 'myToken')

交互方式示例用法

  • 使用 Jython:
    AdminTask.getJobTargetStatus('-interactive')

getJobTargetHistory

getJobTargetHistory 命令会显示相关作业的作业目标历史记录。

目标对象

无。

必需参数

-jobToken
指定相关作业的唯一标识。(字符串,必需)
-target
指定相关目标的节点名。(字符串,必需)
-maxReturn
指定要返回的最大结果数目。(整数,必需)

可选参数

-startingTime
指定此命令开始返回作业目标历史记录的时间。(字符串,可选)
-endingTime
指定此命令停止返回作业目标历史记录的时间。(字符串,可选)
-ascending
指定是按升序还是降序返回结果。指定 true,按升序显示结果,或指定 false,按降序显示结果。(布尔值,可选)

返回值

此命令会返回属性列表,其中,第一个属性指定匹配项数,而第二个属性指定目标上的作业历史记录。每个列表都包含时间戳记、状态、消息以及结果属性。

批处理方式示例用法

  • 使用 Jython 字符串:
    AdminTask.getJobTargetHistory('-jobToken 2846493472984754 -target 3820J37H3017N294 
     -maxReturn 20')
  • 使用 Jython 列表:
    AdminTask.getJobTargetHistory('-jobToken', '2846493472984754', '-target', 
     '3820J37H3017N294', '-maxReturn', '20')

交互方式示例用法

  • 使用 Jython:
    AdminTask.getJobTargetHistory('-interactive')

getJobTypes

getJobTypes 命令会显示相关端点的支持作业类型。

目标对象

无。

可选参数

-targetList
指定目标的节点名列表。(String [ ],可选)
-group
指定目标的组名。(字符串,可选)

返回值

此命令会返回每个已指定目标所支持的作业类型列表。

批处理方式示例用法

  • 使用 Jython 字符串:
    AdminTask.getJobTypes('-target myProfileKey')
  • 使用 Jython 列表:
    AdminTask.getJobTypes('-target', 'myProfileKey')

交互方式示例用法

  • 使用 Jython:
    AdminTask.getJobTypes('-interactive')

getJobTypeMetadata

getJobTypeMetadata 命令会显示与特定作业类型相关联的元数据。

目标对象

无。

必需参数

-jobTypeList
指定相关作业类型的列表。(String [ ],可选)

返回值

此命令会返回属性列表,其中包括 namelabeldescriptionjob-properties 以及 job-parameters 属性。

批处理方式示例用法

  • 使用 Jython 字符串:
    AdminTask.getJobTypeMetadata('-jobTypeList inventory')
  • 使用 Jython 列表:
    AdminTask.getJobTypeMetadata('-jobTypeList', 'inventory')

交互方式示例用法

  • 使用 Jython:
    AdminTask.getJobTypeMetadata('-interactive')

getOverallJobStatus

getOverallJobStatus 命令会显示相关的单个特定作业或一组作业的总体作业状态。

目标对象

无。

可选参数

-jobTokenList
指定一个或多个相关作业的唯一标识。(String [ ],可选)

返回值

此命令会返回一个或多个相关作业的作业状态信息。REJECTED 属性指定作业管理器已拒绝且未运行的作业数。系统会在总体作业状态中显示以下信息:
  • STATE 属性指定作业的当前状态。
  • TOTAL_RESULTS 属性指定作业总数。
  • DISTRIBUTED 属性指定分布式作业数。
  • ASYNC_IN_PROGRESS 属性指定进展中的异步作业数。
  • SUCCEEDED 属性指定成功作业数。
  • PARTIALLY_SUCCEEDED 属性指定部分完成的作业数。例如,当某个节点表示多个服务器,但是该节点上仅某些服务器成功完成该作业时,可出现部分成功。
  • FAILED 属性指定失败作业数。
  • NOT_ATTEMPTED 属性指定系统尚未尝试的作业数。

批处理方式示例用法

  • 使用 Jython 字符串:
    AdminTask.getOverallJobStatus('-jobTokenList myJobToken')
  • 使用 Jython 列表:
    AdminTask.getOverallJobStatus('-jobTokenList', 'myJobToken')

交互方式示例用法

  • 使用 Jython:
    AdminTask.getOverallJobStatus('-interactive')

queryJobs

queryJobs 命令会在作业管理器中查询每个已提交的作业。

目标对象

无。

必需参数

-query
指定要用来查询作业的搜索表达式。(字符串,必需)
创建作业查询时,请遵循以下准则:
  • 此查询由键、运算符以及值或值列表组成。您可以指定单一值,或一个以逗号分隔的值列表。
  • 用空格和 AND 运算符分隔多个表达式。
  • 支持以下区分大小写的键:
    jobToken
    指定要查询的特定作业的作业标记。
    group
    指定要查询的节点组名。
    description
    指定要查询的作业的描述。如果描述包含多个词,请为描述加上单引号或双引号,例如 description = "job description"
    activationDateTime
    指定系统激活作业的日期和时间,例如 2006-05-03T10:30:45-0000。activationDateTime 键值的 -0000 部分表示 RFC 822 格式。您可以指定 Z 作为格林威治标准时间 (GMT) 的捷径,例如 2006-05-03T10:30:45Z。如果未指定时区,那么系统会使用服务器的时区。
    expirationDateTime
    指定作业的到期日期和时间,例如 2006-05-03T10:30:45-0000。activationDateTime 键值的 -0000 部分表示 RFC 822 格式。您可以指定 Z 作为格林威治标准时间 (GMT) 的捷径,例如 2006-05-03T10:30:45Z。如果未指定时区,那么系统会使用服务器的时区。
    state
    指定作业的状态。有效值包括 ASYNC_IN_PROGRESSSUCCEEDEDPARTIALLY_SUCCEEDEDFAILEDDELAYEDREJECTED 以及 NOT_ATTEMPTED
    target
    指定作业的目标节点。使用此键来返回特定节点的作业。此命令会返回特定节点的作业,以及该节点所属的节点组。每个查询只能指定一个 targetID。
  • 支持以下运算符:
    表 1. queryJobs -query 运算符. 在查询中使用运算符。
    字符
    = 等于。通过使用 = NULL 来指定值为空。
    != 不等于。通过使用 != NULL 来指定值不为空
    > 大于
    < 小于
    >= 大于或等于
    <= 小于或等于
-maxReturn
指定要返回的最大匹配项数。(整数,必需)

返回值

此命令会返回属性列表,其中,第一个属性指定查询所产生的匹配项数,而第二个属性指定与该查询相匹配的作业标记列表,如以下样本所示:
[ [result [{activationDateTime=2008-03-11T11:56:48-0500, 
 expirationDateTime=2008-05-10T11:56:48-0500, jobToken=120525460839085191, 
 description=testSubmitJobToValidBaseTargetList}{activationDateTime=2008-03-11T14:05:33-0500, 
 expirationDateTime=2008-05-10T14:05:33-0500, jobToken=120526233387582472,
 description=testSubmitJobToValidBaseTargetList}]] [size 2] ]

批处理方式示例用法

  • 使用 Jython 字符串:
    print AdminTask.queryJobs('-query activationDateTime>= "2006-01-01" activationDateTime<= 
     "2007-01-01" -maxReturn 20') 
    print AdminTask.queryJobs('[-query "target = node3" -maxReturn 2]')
  • 使用 Jython 列表:
    AdminTask.queryJobs('-query', 'activationDateTime>= "2006-01-01" activationDateTime<= 
     "2007-01-01"', '-maxReturn', '20')
    print AdminTask.queryJobs(['-query', '"target = node3"', '-maxReturn', '2'])

交互方式示例用法

  • 使用 Jython 字符串:
    AdminTask.queryJobs('-interactive')

resumeJob

resumeJob 命令会恢复先前启动或暂挂的作业。

目标对象

无。

必需参数

-jobToken
指定相关作业的唯一标识。(字符串,必需)

返回值

此命令不会返回输出。

批处理方式示例用法

  • 使用 Jython 字符串:
    AdminTask.resumeJob('-jobToken myToken')
  • 使用 Jython 列表:
    AdminTask.resumeJob('-jobToken', 'myToken')

交互方式示例用法

  • 使用 Jython:
    AdminTask.resumeJob('-interactive')

submitJob

submitJob 命令会将新的管理作业提交到作业管理器。

目标对象

无。

必需参数

-jobType
指定要提交的作业的类型。(字符串,必需)

可选参数

-group
指定目标的组名。(字符串,可选)
-targetList
指定目标节点的列表。(String [ ],可选)
-jobParams
指定要提交的作业的必要参数。(属性,可选)
-username
指定在安全性处于已启用状态下用于提交作业的用户名。(字符串,可选)
-password
指定在安全性处于已启用状态下用于提交作业的用户名的密码。(字符串,可选)
-description
指定作业的描述。(字符串,可选)
-activationDateTime
使用格式“2006-05-03T10:30:45-0000”指定作业的激活日期和时间。activationDateTime 参数值的“-0000”部分表示 RFC 822 格式。您可以指定“Z”作为格林威治标准时间 (GMT) 的捷径,例如“2006-05-03T10:30:45Z”。如果未指定时区,那么系统会使用服务器的时区。(字符串,可选)
-expirationDateTime
指定作业的截止日期。(字符串,可选)
-executionWindow
指定作业的重现时间间隔。(字符串,可选)
-executionWindowUnit
指定 executionWindow 参数所设置值的重现时间间隔计量单位。指定 DAILY(以每天运行作业一次)、WEEKLY(以每周运行作业一次)、MONTHLY(以每月运行作业一次)或 YEARLY(以每年运行作业一次)。另外,您可以指定 CONNECTION 以在节点每次连接至作业管理器以轮询作业时运行作业。如果指定 CONNECTION,请不要设置 executionWindow 参数。(字符串,可选)
-email
指定系统将作业通知发送到的电子邮件地址。(字符串,可选)

返回值

此命令会返回新提交作业的作业标记。

批处理方式示例用法

  • 使用 Jython 字符串:
    AdminTask.submitJob('[-jobType createApplicationServer -target profileKey -jobParams 
     "[serverName myServer]" ]') 
  • 使用 Jython 列表:
    AdminTask.submitJob(['-jobType', 'createApplicationServer', '-target', 'profileKey', 
     '-jobParams', '"[serverName myServer]"']) 

交互方式示例用法

  • 使用 Jython:
    AdminTask.submitJob('-interactive')

suspendJob

suspendJob 命令会暂挂先前提交的作业。

目标对象

无。

必需参数

-jobToken
指定要暂挂的作业的唯一标识。(字符串,必需)

返回值

此命令不会返回输出。

批处理方式示例用法

  • 使用 Jython 字符串:
    AdminTask.suspendJob('-jobToken myToken')
  • 使用 Jython 列表:
    AdminTask.suspendJob('-jobToken', 'myToken')

交互方式示例用法

  • 使用 Jython:
    AdminTask.suspendJob('-interactive')

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_7adminjobs
文件名:rxml_7adminjobs.html