DataStage command-line tools

CPDCTL and the dsjob tool are command-line interfaces (CLI) you can use to manage your DataStage® resources in IBM Cloud Pak® for Data.

Use the command-line tools to reuse any DataStage scripts that exist on your system.

You can use the following command-line tools to run DataStage tasks:

CPDCTL: cpdctl dsjob or cpdctl datastage
cpd-cli: cpd-cli datastage

The documentation for the cpdctl dsjob command-line tool, including the full list of commands, can be found at the dsjob README.

Resources

For additional information on cpd-cli installation, configuration, available commands, supported outputs, and usage scenarios, refer to the cpd-cli command reference.

For more information on the CPDCTL commands, see IBM Cloud Pak for Data Command Line Interface.

To create a profile and enable dsjob use the following scripts.

For IBM Cloud Pak for Data:

#!/bin/bash
export DSJOB_URL=<CP4D CLUSTER URL>
export CPDCTL_ENABLE_DSJOB=true
export DSJOB_USER=<USER>
export DSJOB_PWD=<PASSWD>


cpdctl config user set CP4D-user --username $DSJOB_USER --password $DSJOB_PWD
cpdctl config profile set CP4D-profile --url $DSJOB_URL --user CP4D-user
cpdctl config profile use CP4D-profile

If you have multiple profiles, you can run a command against a specific profile with either cpdctl project list --profile <PROFILE> or CPD_PROFILE=<PROFILE> cpdctl project list. For example, to run multiple commands in a profile without changing your default profile, you can run the following commands.

export CPD_PROFILE=<PROFILE-1>
cpdctl project list
cpdctl ....
export CPD_PROFILE=<PROFILE-2>
cpdctl project list
cpdctl ....
unset CPD_PROFILE <go back to default profile>