datastage server job之dsjob 命令

Datastage 的job可以通过dsjob命令来调用job或者获得job的信息，以及运行的报告和日志。
安装DataStage 的目录下 例如C:\Ascential\DataStage\Engine\bin>
dsjob的的语法如下：
Command Syntax:
dsjob [-file | [-server ][-user ][-passwod ]]
[]
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 验证job是否可行
[-param =]
设置变量值
[-warn ]
warn 警告多少条记录以后job停止运行
[-rows ]
rows 运行过多少记录以后job停止运行
[-wait]
wait 等待多长时间停止运行
[-opmetadata ]
[-disableprjhandler]
[-disablejobhandler]
[-jobstatus]
Jobstatus 运行的状态
[-userstatus]
[-useid]

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]
停止正在运行的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 �Creport
Invalid arguments: dsjob -report [-useid] [report type>]
report type = BASIC | DETAIL | XML



C:\Ascential\DataStage\Engine\bin>dsjob -report sysup1_MPHASIS_1 Sequential BASIC
**************************************************
ジョブのステ�`タスレポ�`ト: Sequential
作成日�r: 2009-07-06 15:26:27
ジョブ�_始�r刻 = 2009-07-06 15:04:33
ジョブ�K了�r刻 = 2009-07-06 15:04:42
ジョブ�U�^�r�g = 00:00:09
ジョブステ�`タス = 1(正常�K了)
Status code = 0

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

C:\Ascential\DataStage\Engine\bin>dsjob -report sysup1_MPHASIS_1 Sequential XML

Desc=""
Status="1"
WaveNo="3"
StartDateTime="2009-07-06T15:04:33"
EndDateTime="2009-07-06T15:04:42"
ElapsedTime="00:00:09"
ElapsedSecs="9">

Type="0"
Desc=""
Value="7.txt"/>
Type="0"
Desc=""
Value="8.txt"/>


StageStatus="2"
StageType="CTransformerStage"
Desc=""
StartDateTime="2009-07-06T15:04:36"
EndDateTime="2009-07-06T15:04:41"
ElapsedTime="00:00:05"
ElapsedSecs="5">

LinkType="1"
Desc=""
Stage="Sequential_File_0"/>


LinkType="3"
Desc=""
Stage="Sequential_File_0"/>


CPU="3.25"
PID="6008">
RowCount="7768800"/>
RowCount="7768800"/>





Status code = 0
日志的操作
-log 向指定的job中写日志
C:\Ascential\DataStage\Engine\bin>dsjob -log
Invalid arguments: dsjob -log
[-info | -warn]

Log message is read from stdin.

-logsum
Invalid arguments: dsjob -logsum
[-type ]
[-max ]
[-useid]

获得运行时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
�h境�涫�の�O定: (...)
45 INFO Mon Jul 06 15:04:33 2009
Sequential: NLS 国�e情�螭� JP-JAPANESE,JP-JAPANESE,JP-JAPANESE,JP-JAPANE
SE,JP-JAPANESE へ�O定
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 国�e情�螭� JP-JAPANESE,JP-JAPA
NESE,JP-JAPANESE,JP-JAPANESE,JP-JAPANESE へ�O定
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 アクティブ ステ�`ジを
�K了します。 (...)
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] 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] [
]
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