Commands for controlling InfoSphere DataStage jobs

You can start and stop jobs, and retrieve information about job runs by using the dsjob command.

The command options used with the dsjob command give you access to the same functionality as the InfoSphere® DataStage® API functions described in API Functions or the BASIC functions described in InfoSphere DataStage BASIC Interface.

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
  • Generating a report

All output from the dsjob command is in plain text without column headings on lists, or any other sort of description. This enables the command to be used in shell or batch scripts without extra processing.

The InfoSphere DataStage CLI returns a completion code of 0 to the operating system upon successful execution, or one of the InfoSphere DataStage API error codes on failure. See Error Codes. The return code is also printed to the standard error stream in all cases. On UNIX servers, a code of 255 is returned if the error code is negative or greater than 254, to see the "real" return code in these cases, capture and process the standard error stream.

Note that, on UNIX servers, DSJOB has a runtime dependency on the libvmdsapi.so shared library.