Compile from the client command line

You can compile IBM® InfoSphere® DataStage® jobs from the command line on the InfoSphere DataStage client by using the dscc command. You can also use the dscc command to compile buildops or routines, or to provision InfoSphere QualityStage® objects such as rule sets.

Syntax

The dscc command has the following syntax:
dscc.exe /af authfile | 
/url domainURL /h hostname [/u username [/p password]] | 
/d domain /h hostname [/u username [/p password]]
project
[/j job_name [/f] [/mfcgb base_directory] [/mful upload_profile] [/ouc] [/qspa]]
[/jt job_type [/f] [/mfcgb base_directory] [/mful upload_profile] [/ouc] [/qspa]]
[/qs qualitystage_objects]
[/r routine_name]
[/rcf]
[/bo buildop_name]
[/rd report_name]

Parameters

/?
Specify this parameter to show a complete list of options.
/af
Specify the name of the credentials file that contains the connection details. This file can be encrypted. The dscc command is one of the commands that supports the authfile option.

For important formatting details about the credentials file, see ../../com.ibm.swg.im.iis.found.admin.common.doc/topics/encrypt_credfile.html.

/bo
Specify the buildop (custom parallel stage) to compile. Use * to specify all buildops or \folderName\* to specify all the buildops in the folder named folderName.
/d
Specify the host name of the services tier. This parameter can also have a port number in the form domain:port_number.
/f
Specify this parameter to force compile for parallel jobs. This parameter ensures that all parallel job transformers are recompiled even if they appear unchanged since the last compilation.
/h
Specify the host name of the engine tier. A port number may be specified for the connection using hostname:port. The port defaults to 31538 if it is not specified.
/j
Specify the name of the job to compile. Use jobname to specify a single job, * to compile all jobs in the project, or category_name\* to compile all jobs in that category (categories within that category are included). You can specify parallel jobs, server jobs, or sequence jobs.
/jt
Specify this parameter to compile all jobs in the project that match the selected job_type. The default value of -1 specifies that the client compile all types of job. Use 0 to specify all server jobs, 1 was used to specify all mainframe jobs, but mainframe jobs are not supported in this version. Specify 2 to specify all sequence jobs, or 3 to specify all parallel jobs.
/ouc
Specify this parameter to compile only uncompiled jobs.
/p
Specify the password to use when you are attaching to the project.
project
Specify the name of the project to access.
/qs
Specify the InfoSphere QualityStage rule sets to provision. Use * to provision all rule sets or \folderName\* to provision all rule sets in the folder named folderName.
/qspa
Specify this parameter with a job compilation to provision all IBM InfoSphere QualityStage rule sets that the job compilation references.
/r
Specify the name of the routine or routines to be compiled.
  • Use routinename to specify a single routine.
  • Use * to compile all routines in the project.
  • Use category_name\* to compile all routines in that category (categories within that category are not included).
  • Use \folderName\* to compile all the routines in the folder named folderName
/rcf
Specify this parameter to have the system return a -1 if anything fails to compile or deploy.
/rd
Specify the name and destination for a compilation report. Specify DESKTOP\filename to write it to your desktop or .\filename to write it to the current working directory.
/rt
Specify the type of report to produce. Use X to produce a report in xml or T to produce a report in text format. T is the default type.
/u
Specify the user name to use when you attach to the project.
/url
Specify the full format URL for the domain to log on to. The URL includes the protocol, host, and port information for the domain in this format: https://domain:port. The port defaults to 9443 if it is not specified.

If you specify only the host name details, you are prompted for the user name and password. (The password is hidden as you type in the command window.) If you specify the host name and user name details, you are prompted for the password.

The following compiles the job mybigjob in the project dstageprj:
dscc /h r101 /u fellp /p plaintextpassword dstageprj /J mybigjob