使用 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 [ ],可选)
返回值
此命令会返回属性列表,其中包括 name、label、description、job-properties 以及 job-parameters 属性。
批处理方式示例用法
- 使用 Jython 字符串:
AdminTask.getJobTypeMetadata('-jobTypeList inventory')
- 使用 Jython 列表:
AdminTask.getJobTypeMetadata('-jobTypeList', 'inventory')
交互方式示例用法
- 使用 Jython:
AdminTask.getJobTypeMetadata('-interactive')
getOverallJobStatus
getOverallJobStatus 命令会显示相关的单个特定作业或一组作业的总体作业状态。
目标对象
无。
可选参数
- -jobTokenList
- 指定一个或多个相关作业的唯一标识。(String [ ],可选)
返回值
- 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_PROGRESS、SUCCEEDED、PARTIALLY_SUCCEEDED、FAILED、DELAYED、REJECTED 以及 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 参数。(字符串,可选)
- 指定系统将作业通知发送到的电子邮件地址。(字符串,可选)
返回值
此命令会返回新提交作业的作业标记。
批处理方式示例用法
- 使用 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')