datastage server job之dsjob 命令

Datastage 的job可以通过dsjob命令来调用job或者获得job的信息，以及运行的报告和日志。
安装DataStage 的目录下 例如C:\Ascential\DataStage\Engine\bin>
dsjob的的语法如下：
Command Syntax:
dsjob [-file <file> <server> | [-server <server>][-user <user>][-passwod <password>]]
<primary command> [<arguments>]
Valid primary command options are:
-run 运行job
-stop 停止运行中的job
-lprojects 列出server中所有的工程
-ljobs 列出指定project中的所有的job
-linvocations列出指定job中的所有的invocation
-lstages 列出指定job中的所有的stage
-llinks 列出指定job中的所有的link
-projectinfo 列出指定project的信息
-jobinfo 列出指定job的信息
-stageinfo 列出指定stage的信息
-linkinfo 列出指定link的信息
-lparams 列出指定job的所有的parameter
-paraminfo 列出指定parameter的信息
-log 获得job的所有的日志
-logsum 获得job的所有的日志
-logdetail 获得job的所的详细日志
-lognewest
-report 获得job的所的详细日志
-jobid
-file的参数找了一下，也没找到什么好的解释，望高手能够解释一下。
-server datastage 工程名称
-user 用户名称
-password 密码
-primary command



-run
Invalid arguments: dsjob -run
[-mode <NORMAL | RESET | VALIDATE>]
NORMAL 正常运行
RESET 重置
VALIDATE 验证job是否可行
[-param <name>=<value>]
设置变量值
[-warn <n>]
warn 警告多少条记录以后job停止运行
[-rows <n>]
rows 运行过多少记录以后job停止运行
[-wait]
wait 等待多长时间停止运行
[-opmetadata <TRUE | FALSE>]
[-disableprjhandler]
[-disablejobhandler]
[-jobstatus]
Jobstatus 运行的状态
[-userstatus]
[-useid]
<project> <job|jobid>
1 dsjob -server 10.240.12.67 -user peace.zhao -password Yanzhang0717 -run -mode NORMAL sysup1_MPHASIS_1 Sequential
最简单的运行
2 C:\Ascential\DataStage\Engine\bin>dsjob -server 10.240.12.67 -user peace.zhao -password Yanzhang0717 -run -mode NORMAL -jobstatus sysup1_MPHASIS_1 Sequential
Waiting for job...
Finished waiting for job
Job Status : (1)
Status code = 1
3 C:\Ascential\DataStage\Engine\bin>dsjob -server 10.240.12.67 -user peace.zhao -password Yanzhang0717 -run -mode NORMAL -param input=7.txt -param output=8.txt -j
obstatus sysup1_MPHASIS_1 Sequential
Waiting for job...
Finished waiting for job
Job Status : (1)
Status code = 1

-stop
Invalid arguments: dsjob -stop [-useid] <project> <job|jobid>
停止正在运行的job
-lprojects
列出所有的server中的job
C:\Ascential\DataStage\Engine\bin>dsjob -server 10.240.12.67 -user peace.zhao -password Yanzhang0717 -lprojects
Empty
Study
sysup1_MPHASIS
sysup1_MPHASIS_1
sysup1_MPHASIS_2
sysup1_MPHASIS_3
tttt
up_20090204
yes
Status code = 0

-lprojects
-ljobs
-linvocations
-lstages
-llinks
-lparams
功能和用法与-lprojects相似
-projectinfo 获得project的信息
C:\Ascential\DataStage\Engine\bin>dsjob -projectinfo sysup1_MPHASIS_1
Host Name : 10.240.12.67
Project Name : sysup1_MPHASIS_1
Status code = 0

-jobinfo
C:\Ascential\DataStage\Engine\bin>dsjob -jobinfo sysup1_MPHASIS_1 Sequential
Job Status : RUN OK (1)
Job Controller : not available
Job Start Time : Mon Jul 06 15:04:33 2009
Job Wave Number : 3
User Status : not available
Job Control : 0
Interim Status : NOT RUNNING (99)
Invocation ID : not available
Last Run Time : Mon Jul 06 15:04:42 2009
Job Process ID : 0
Invocation List : Sequential
Status code = 0

-linkinfo
-paraminfo
与获得project 和job信息相同
-report
获得job运行的报告
C:\Ascential\DataStage\Engine\bin>dsjob –report
Invalid arguments: dsjob -report [-useid] <project> <job|jobid> [report type>]
report type = BASIC | DETAIL | XML



C:\Ascential\DataStage\Engine\bin>dsjob -report sysup1_MPHASIS_1 Sequential BASIC
**************************************************
ジョブのステータスレポート: Sequential
作成日時: 2009-07-06 15:26:27
ジョブ開始時刻 = 2009-07-06 15:04:33
ジョブ終了時刻 = 2009-07-06 15:04:42
ジョブ経過時間 = 00:00:09
ジョブステータス = 1(正常終了)
Status code = 0

C:\Ascential\DataStage\Engine\bin>dsjob -report sysup1_MPHASIS_1 Sequential DETAIL
**************************************************
ジョブのステータスレポート: Sequential
作成日時: 2009-07-06 15:27:00
ジョブ開始時刻 = 2009-07-06 15:04:33
ジョブ終了時刻 = 2009-07-06 15:04:42
ジョブ経過時間 = 00:00:09
ジョブステータス = 1(正常終了)
ステージ: Sequential_File_1.IDENT1、入力行数 7768800
ステージ開始時刻 = 2009-07-06 15:04:36、終了時刻 = 2009-07-06 15:04:41、経
過時間 = 00:00:05
リンク: DSLink2、行数 7768800
リンク: DSLink2、行数 7768800
Status code = 0

C:\Ascential\DataStage\Engine\bin>dsjob -report sysup1_MPHASIS_1 Sequential XML
<?xml version="1.0" encoding="UTF-8"?>
<Job Name="Sequential"
Desc=""
Status="1"
WaveNo="3"
StartDateTime="2009-07-06T15:04:33"
EndDateTime="2009-07-06T15:04:42"
ElapsedTime="00:00:09"
ElapsedSecs="9">
<ParamSet>
<Param Name="input"
Type="0"
Desc=""
Value="7.txt"/>
<Param Name="output"
Type="0"
Desc=""
Value="8.txt"/>
</ParamSet>
<ComponentSet>
<Stage Name="Sequential_File_1.IDENT1"
StageStatus="2"
StageType="CTransformerStage"
Desc=""
StartDateTime="2009-07-06T15:04:36"
EndDateTime="2009-07-06T15:04:41"
ElapsedTime="00:00:05"
ElapsedSecs="5">
<InputLinks>
<Link Name="DSLink2"
LinkType="1"
Desc=""
Stage="Sequential_File_0"/>
</InputLinks>
<OutputLinks>
<Link Name="DSLink2"
LinkType="3"
Desc=""
Stage="Sequential_File_0"/>
</OutputLinks>
<InstanceSet>
<Instance Id=""
CPU="3.25"
PID="6008">
<Link Name="DSLink2"
RowCount="7768800"/>
<Link Name="DSLink2"
RowCount="7768800"/>
</Instance>
</InstanceSet>
</Stage>
</ComponentSet>
</Job>
Status code = 0
日志的操作
-log 向指定的job中写日志
C:\Ascential\DataStage\Engine\bin>dsjob -log
Invalid arguments: dsjob -log
[-info | -warn]
<project> <job>
Log message is read from stdin.

-logsum
Invalid arguments: dsjob -logsum
[-type <INFO | WARNING | FATAL | REJECT | STARTED | RESET | BATCH>]
[-max <n>]
[-useid]
<project> <job|jobid>
获得运行时job的信息
Max 获得最近的 条记录
C:\Ascential\DataStage\Engine\bin>dsjob -logsum -type INFO -max 10 sysup1_MPHAS
IS_1 Sequential
40 INFO Mon Jul 06 15:01:34 2009
Sequential..Sequential_File_1: プロジェクト デフォルト NLS マップ JPN-SJ
IS を使用します
41 INFO Mon Jul 06 15:01:34 2009
ステージ Sequential..Sequential_File_1.IDENT1 の検証を完了しました。
44 INFO Mon Jul 06 15:04:33 2009
環境変数の設定: (...)
45 INFO Mon Jul 06 15:04:33 2009
Sequential: NLS 国別情報を JP-JAPANESE,JP-JAPANESE,JP-JAPANESE,JP-JAPANE
SE,JP-JAPANESE へ設定
46 INFO Mon Jul 06 15:04:34 2009
Sequential..Sequential_File_1.IDENT1: DSD.StageRun アクティブ ステージを
開始しています。トレース モード = 0。
47 INFO Mon Jul 06 15:04:34 2009
Sequential..Sequential_File_1.IDENT1: NLS 国別情報を JP-JAPANESE,JP-JAPA
NESE,JP-JAPANESE,JP-JAPANESE,JP-JAPANESE へ設定
48 INFO Mon Jul 06 15:04:34 2009
Sequential..Sequential_File_0: プロジェクト デフォルト NLS マップ JPN-SJ
IS を使用します
49 INFO Mon Jul 06 15:04:34 2009
Sequential..Sequential_File_1: プロジェクト デフォルト NLS マップ JPN-SJ
IS を使用します
50 INFO Mon Jul 06 15:04:41 2009
Sequential..Sequential_File_1.IDENT1: DSD.StageRun アクティブ ステージを
終了します。 (...)
52 INFO Mon Jul 06 15:32:32 2009
dd (...)
Status code = 0
-logdetail
C:\Ascential\DataStage\Engine\bin>dsjob -logdetail
Invalid arguments: dsjob -logdetail [-useid] <project> <job|jobid> <first event
id> [<last event id>]
first event id 第一个log id
last event id 最后一个log id
如果last event id为空则默认为first event id的详细信息
C:\Ascential\DataStage\Engine\bin>dsjob -logdetail sysup1_MPHASIS_1 Sequential 1
0 11
Event Id: 10
Time : Mon Jul 06 14:38:07 2009
Type : STARTED
User : MPHASISORTC\peace.zhao
Message :
ジョブ Sequential をリセットしています。
Event Id: 11
Time : Mon Jul 06 14:38:07 2009
Type : INFO
User : MPHASISORTC\peace.zhao
Message :
ステージ Sequential..Sequential_File_1.IDENT1 をリセットしています。
-lognewest 获得指定日志类型的最后一个log id
C:\Ascential\DataStage\Engine\bin>dsjob -lognewest
Invalid arguments: dsjob -lognewest [-useid] <project> <job|jobid> [<event type>
]
event type = INFO | WARNING | FATAL | REJECT | STARTED | RESET | BATCH

C:\Ascential\DataStage\Engine\bin>dsjob -lognewest sysup1_MPHASIS_1 Sequential
INFO
Newest id = 52
Status code = 0