批处理作业的命令行界面
命令行界面与 作业调度程序 交互以提交和处理 批处理作业。 它与 lrcmd.sh 或 lrcmd.bat 脚本一样位于 app_server_root/bin 目录并可以从 WebSphere® 单元中的任意位置启动。
使用 lrcmd 脚本来执行以下命令:
命令 | 参数 | 描述 | 其他信息 |
---|---|---|---|
显示 lrcmd 的用法信息。 | 无 | 该命令显示 lrcmd 命令的用法信息。 | 示例:lrcmd |
将作业提交至 作业调度程序。 |
|
指定 XML 作业控制语言 (xJCL) 文件时,-xJCL=<xjcl_filename> 会指定要从文件系统提交和选择性保存的 xJCL 的路径。可选参数:
该命令的两个变体都将返回所提交作业的作业标识。 |
示例:
|
取消先前提交的作业。 |
|
此命令会取消先前提交的作业的启动或取消运行中作业的执行。 使用 -jobid=<jobid> 作为由 作业调度程序 指定给作业的作业标识。作业标识由最初提交作业的 lrcmd -cmd=submit 命令返回。-cmd=status 命令也可以用于识别特殊作业的作业标识。 可选参数:
|
示例: lrcmd -cmd=cancel -jobid=myjob:2 -host=myLRShost -port=9083 |
重新启动作业。 |
|
此命令会重新启动已取消的作业。只能重新启动处于可重新启动状态的作业。 使用 -jobid=<jobid> 作为由 作业调度程序 指定给作业的作业标识。作业标识由最初提交作业的 lrcmd -cmd=submit 命令返回。-cmd=status 命令也可以用于识别特殊作业的作业标识。 可选参数:
|
只能重新启动与批处理应用程序相关联的 批处理作业。使用 -cmd=cancel 命令取消批处理作业时,该批处理作业的状态将切换到可重新启动状态。 当该作业重新启动时,将从上次成功落实的检查点恢复处理。 示例: lrcmd -cmd=restart -jobid=myjob:2 -host=myLRShost -port=9081 |
清除作业信息。 |
|
此命令会从 作业调度程序 和 网格端点 清除作业信息。 作业完成之后,作业调度程序将维护该作业的相关信息。 purge 命令将从作业调度程序和网格端点数据库中永久删除作业信息。该命令还清除作业的作业日志。 使用 -jobid=<jobid> 作为由 作业调度程序 指定给作业的作业标识。作业标识由最初提交作业的 lrcmd -cmd=submit 命令返回。-cmd=status 命令也可以用于识别特殊作业的作业标识。 可选参数:
|
作业完成之后,作业调度程序 将维护该作业的相关信息。
purge 命令将从 作业调度程序 和 网格端点 数据库中永久删除作业信息。
该命令还清除作业的作业日志。 示例: lrcmd -cmd=purge -jobid=myjob:2 |
将 xJCL 保存至作业存储库。 |
|
此命令会将 xJCL 文档保存在作业存储库中以供将来的 -cmd=submit 命令使用。
可选参数:
|
示例:
|
从作业存储库中移除作业。 |
|
此命令会从作业存储库中移除先前保存的 xJCL 文档。 使用 -job=<job_name> 指定先前将文件保存到作业存储库时指定给作业的名称。
|
示例: lrcmd -cmd=remove -jobid=myjob:2 -host=myhost -port=9083 |
显示 批处理作业 的状态。 |
或
|
此命令会显示 作业调度程序 数据库中一个或多个作业的相关状态信息。 可选参数:-job=<jobid>,如果已指定此参数,那么将指示仅显示指定作业的作业信息。 |
示例:
|
暂挂作业。 |
|
此命令会将网格批处理作业的启动暂挂指定的秒数。除非手动恢复(例如,使用 lrcmd -cmd=resume),否则作业将在指定的秒数过后自动恢复运行。 使用 -jobid=<jobid> 作为由 作业调度程序 指定给作业的作业标识。作业标识由最初提交作业的 lrcmd -cmd=submit 命令返回。-cmd=status 命令也可以用于识别特殊作业的作业标识。 可选参数: 使用 -seconds=<seconds> 指示作业启动处于暂挂状态的秒数。如果未指定,那么将使用缺省值 15 秒。如果指定 -seconds=0,那么除非手动恢复,否则作业将不启动。
|
示例: lrcmd -cmd=submit -xJCL=myxjcl.xml(返回作业标识 myjob:23)。作业 myjob:23 开始执行之后,可以使用以下命令将该作业暂挂一段时间(比如 5 分钟):lrcmd -cmd=suspend -jobid=myjob:23 -seconds=300 -port=81 -host=myODRHost 在 5 分钟到期之前,可使用以下命令来恢复作业的执行:lrcmd -cmd=resume -jobid=myjob:23 |
恢复启动先前已暂挂的作业。 |
|
此命令会恢复启动先前已暂挂的批处理作业。 使用 -jobid=<jobid> 作为由 作业调度程序 指定给作业的作业标识。作业标识由最初提交作业的 lrcmd -cmd=submit 命令返回。-cmd=status 命令也可以用于识别特殊作业的作业标识。 |
请参阅 -cmd=suspend 的描述。 |
显示作业的输出。 |
|
显示指定的作业执行期间由 作业调度程序 和 网格端点 生成的输出。 使用 -jobid=<jobid> 作为由 作业调度程序 指定给作业的标识。作业标识由最初提交作业的 lrcmd -cmd=submit 命令返回。-cmd=status 命令也可以用于识别特殊作业的作业标识。 |
(无) |
显示批处理作业的返回码。 |
|
显示由网格批处理作业生成的总体返回码。 使用 -jobid=<jobid> 作为由 作业调度程序 指定给作业的标识。作业标识由最初提交作业的 lrcmd -cmd=submit 命令返回。-cmd=status 命令也可以用于识别特殊作业的作业标识。
|
(无) |
将重现的作业请求提交至 作业调度程序。 |
或
|
将重现的作业请求提交至作业调度程序。作业调度程序将按照由参数指示的时间间隔向指定的 xJCL 提交 批处理作业。
可选参数:
|
示例:
|
修改现有的重现作业请求。 |
|
Arguments:
可选参数:
|
示例: lrcmd -cmd=modifyRecurringRequest -request=MyWeeklyReport -xJCL=C:\\myNewXJCL -port=80 lrcmd -cmd=modifyRecurringRequest -request=MyWeeklyReport -startDate=2006-02-02 -startTime=22:30:00 -xJCL=C:\\myFebXJCL -port=80 |
命令 | 参数 | 描述 | 附加信息 |
---|---|---|---|
显示 lrcmd 的用法信息。 | 无 | 此命令显示 lrcmd 命令的用法信息。 | 示例:lrcmd |
停止执行先前提交的作业。 |
|
此命令会在发生检查点时停止执行先前提交的作业。 使用 -jobid=<jobid> 作为由 作业调度程序 指定给作业的作业标识。 可选参数:
|
示例:
|
显示作业定义 xJCL 中引用的符号变量。 |
|
此命令会显示作业定义 xJCL 中引用的符号变量。 使用 -jobid=<jobid> 作为由 作业调度程序 指定给作业的作业标识。 可选参数:
|
示例:
|
保存作业日志。 |
|
此命令会将与所请求的作业标识相关联的作业日志保存到本地文件系统。 使用 -jobid=<job_id> 作为由 作业调度程序 指定给作业的作业标识。作业标识由最初提交作业的 lrcmd -cmd=submit 命令返回。 使用 -fileName=<fileName> 指示本地文件系统上用于保存压缩作业日志数据的文件的名称。如果该文件存在,那么将替换该文件。文件名 <fileName> 不得包含嵌入空白。 可选参数:
|
示例:
|
获取作业日志。 |
|
显示与所请求的作业标识相关联的作业日志。 使用 -jobid=<job_id> 作为由 作业调度程序 指定给作业的作业标识。作业标识由最初提交作业的 lrcmd -cmd=submit 命令返回。 可选参数:
|
示例:
|
清除作业日志 |
|
移除与所请求的作业标识和日志时间戳记相关联的作业日志。例如,作业日志条目将保留在以下文件中:/opt/IBM/WebSphere/AppServer/profiles/scheduler/joblogs/PostingsSampleEar_99/14022007_164535/part.0.log。
该条目跟踪移除作业日志的原因。
|
示例:
|
显示所请求的作业标识的作业日志元数据。 |
|
作业日志元数据指示与所请求的作业标识相关联的日志时间戳记。元数据或时间戳记会识别作业的唯一实例。可以存在来自具有相同作业号的多个不同作业的日志。 使用 -jobid=<job_id> 作为由作业调度程序指定给作业的作业标识。作业标识由最初提交作业的 lrcmd -cmd=submit 命令返回。 |
示例:
|
显示作业日志部件列表。 |
|
显示与所请求的作业标识和日志时间戳记相关联的作业日志部件列表。使用 getLogMetaData 命令来返回时间戳记以与 -logTimeStamp=<timestamp> 配合使用。 使用 -jobid=<job_id> 作为由作业调度程序指定给作业的作业标识。作业标识由最初提交作业的 lrcmd -cmd=submit 命令返回。 |
示例:
|
显示作业日志部件。 |
|
显示与所请求的作业标识、日志时间戳记和日志部件相关联的作业日志部件。 使用 -jobid=<job_id> 作为由作业调度程序指定给作业的作业标识。作业标识由最初提交作业的 lrcmd -cmd=submit 命令返回。 使用 -logTimeStamp=<logTimeStamp> 指示时间戳记(即,子目录名称),该时间戳记用于识别要返回其部件列表信息的作业日志。 该时间戳记由 -cmd=getLogMetaData 返回。 使用 -logPart=<logPart> 指示与所请求的作业标识和要返回的时间戳记相关联的作业日志部分。日志部件信息由 -cmd=getLogPartList 返回。 |
示例:
|
显示与所请求的作业标识相关联的作业日志的大小。 |
|
此命令返回作业日志的大小(以字节计)。 使用 -jobid=<job_id> 作为由作业调度程序指定给作业的作业标识。作业标识由最初提交作业的 lrcmd -cmd=submit 命令返回。 使用 -logTimeStamp=<logTimeStamp> 指示时间戳记(即,子目录名称),该时间戳记用于识别要返回其部件列表信息的作业日志。 该时间戳记由 -cmd=getLogMetaData 返回。 |
示例:
|
返回作业日志自上次修改以来的时限(以秒计)。 |
|
显示时限
使用 -jobid=<jobid> 作为由 作业调度程序 指定给作业的标识。作业标识由最初提交作业的 lrcmd -cmd=submit 命令返回。-cmd=status 命令也可以用于识别特殊作业的作业标识。 使用 -logTimeStamp=<logTimeStamp> 指示时间戳记(即,子目录名称),该时间戳记用于识别要返回其部件列表信息的作业日志。 该时间戳记由 -cmd=getLogMetaData 返回。 |
示例:
|
用于检索批处理作业输出的示例:
lrcmd -cmd=output -jobid=mybatchjob:63 -host=myLRSHost -port=9081
结果示例:
CWLRB4940I: com.ibm.websphere.batch.wsbatch : -cmd=output -jobid=mybatchjob:63
CWLRB5000I: Wed Jun 15 17:55:36 EDT 2005 : com.ibm.websphere.batch.wsbatch : response to output
CWLRB1740I: [Wed Jun 15 17:55:36 EDT 2005] Job [mybatchjob:63] is in job setup.
CWLRB1760I: [Wed Jun 15 17:55:37 EDT 2005] Job [mybatchjob:63] is submitted for execution.
CWLRB2420I: [Wed Jun 15 17:55:37 EDT 2005] Job [mybatchjob:63] Step [Step1] is in step setup.
CWLRB2440I: [Wed Jun 15 17:55:38 EDT 2005] Job [mybatchjob:63] Step [Step1] is dispatched.
CWLRB2460I: [Wed Jun 15 17:55:38 EDT 2005] Job [mybatchjob:63] Step [Step1] is in step breakdown.
CWLRB2600I: [Wed Jun 15 17:55:38 EDT 2005] Job [mybatchjob:63] Step [Step1] completed normally rc=0.
CWLRB2420I: [Wed Jun 15 17:55:39 EDT 2005] Job [mybatchjob:63] Step [Step2] is in step setup.
CWLRB2440I: [Wed Jun 15 17:55:39 EDT 2005] Job [mybatchjob:63] Step [Step2] is dispatched.
CWLRB2460I: [Wed Jun 15 17:55:40 EDT 2005] Job [mybatchjob:63] Step [Step2] is in step breakdown.
CWLRB2600I: [Wed Jun 15 17:55:40 EDT 2005] Job [mybatchjob:63] Step [Step2] completed normally rc=4.
End