Data_tech_talk TUESDAY, JULY 24, 2012

Using DataStage DSjob Commands We  can start and stop jobs, and retrieve information about job runs by using the dsjob command.

There is a single command, dsjob, with a large range of options. These options are described in the following topics:

The logon clause Starting a job

Stopping a job

Listing projects, jobs, stages, links, and parameters

Setting an alias for a job

Retrieving information

Accessing log files

Steps to use  Dsjob Command from windows Client Machine.

1.  All Program –Run-Type cmd , the cmd window pops ups. Type cd /IBM/InformationServer/Clients/Classic. 

2.  Type dsjob, you should get the screen below

 

By default, the InfoSphere DataStage CLI connects to the engine on the local system using the user name and password of the user running the command.

 We can specify a different domain, engine, user name, or password using the logon clause, [-domain domain_name ][ -user username ][-password password ][-server enginename ]

For  dsjob command only:-domain NONE -user username -password password -server enginename

domain_name  specifies the domain to log on to. For dsjob, you can set -domain NONE to log on to the engine rather than the domain. In this case the user name and password are for the engine, not for the domain.

enginename specifies a different engine to log on to.

username specifies a different user name to use when logging on.

password specifies a different password to use when logging on.

If you don’t give the credentials in the command line or credentials file and specify only the –domain & -server options, then  system will prompts for the user name and password   Example

1.       Basic Command for starting the Job dsjob –run [ -mode [ NORMAL | RESET | VALIDATE | RESTART ] ][ -param name=value ][ -paramfile filename ][ -warn n ][ -rows n ][ -wait ][ -stop ][ -jobstatus ][ -userstatus ][ -local ][ -opmetadata [ TRUE | FALSE ] ][ -disableprjhandler ][ -disablejobhandler ][useid] project job | job_id 2 . Stopping the jobs

dsjob -stop [useid] project job|job_id  C:\IBM\InformationServer\Clients\Classic>dsjob -domain <domainname> -server <servername> -user <username> -password <password> –stop  PROJECTNAME  JOBNAMEExample :- 

 

Listing projects, jobs, stages, links, and parameters 

Requirements Command

Listing projects dsjob -lprojectsListing jobs dsjob -ljobs projectListing jobs with specific job statuses dsjob -ljobs [-status status_list] projectListing stages dsjob -lstages [useid] project job|job_idListing links dsjob -llinks [useid] project job|job_id

stageListing parameters dsjob -lparams [useid] project job|job_idListing invocations dsjob -linvocations [useid] project job|

job_id** project is the name of the project containing the jobs to list.

status_list is a list of job status values as defined in the dsapi.h file.useid specify this if you intend to use a job alias (jobid) rather than a job name (job) to identify the job.job_id is an alias for the job that has been set using the dsjob -jobid command.job is the name of the job whose parameters are to be listed. To identify a job invocation, use the format job.invocation_id.job_id is an alias for the job that has been set using the dsjob -jobid command.