Table of contents

Commands for controlling data transformation jobs

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

Note: You must have the PX runtime enabled to use the pxjob command. For more information, see Enabling Dynamic Workload Management.

There is a single command, pxjob, 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
  • Managing log files
  • Generating a report

All output from the pxjob 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 DataStage CLI returns a completion code of 0 to the operating system upon successful execution, or one of the 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.