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