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