Requesting a job report from the command line

The dsdesign command is a Microsoft Windows application that you use to request the generation of a job report from the command line on an InfoSphere® DataStage® client machine.

Important: If you generate a job report from the command line, the report is not available for viewing through the reporting console.

Syntax

The dsdesign command includes the following syntax:

dsdesign.exe /AF=authfile | 
/D=domain /H=hostname [/U=username [/P=password]]
project (job_name | job_sequence_name | /SC shared_container_name)
/R
[/RP=report_pathname]
[/RT=stylesheet_pathname]
[/RX]
authfile
Name of the encrypted credentials file that contains the connection details.
domain | domain:port_number
Name of the application server. This parameter can also have a port number.
hostname
The host name of the InfoSphere Information Server engine that generates the report.
username
The user name to use for connecting to the application server.
password
The password for the username that you are using to connect to the application server.
project
Name of the project that contains the job, job sequence, or shared container.
job_name | job_sequence_name | shared_container_name
Name of the job, job sequence, or shared container that you want to generate a report for. The report is generated in HTML format.
/R
Flag indicating that you want to generate a report.
report_pathname
Subdirectory where the report is written to. This subdirectory is named after the job. If you do not specify a directory, the report is written to a subdirectory in the client directory. For example, C:\IBM\InformationServer\Clients\Classic\myjob.
stylesheet_pathname
Path name that indicates an alternate XSLT stylesheet. If you do not specify a stylesheet, the default stylesheet is used.
/RX
Flag indicating that you want to retain the intermediate XML file.

If you do not use the /AF option and you want to run the command without any user interaction, you must supply all of the connection details on the command line. If all of the connection details are not supplied on the command line, the Logon dialog is displayed. The Logon dialog is pre-filled with the values from the command line. Any missing values are pre-filled with the values from your most recent successful connection, except for the Password field which you must supply. The password is not displayed as you type in the Logon dialog.

The following command creates the ServerJob1.htm report in the C:\JobReports\ServerJob1 directory.

dsdesign /D=domain:9443 /H=R101 /U=william /P=wombat
dstage ServerJob1 /R /RP=C:\JobReports

The following command creates the ServerJob1.htm report and the ServerJob1.xml intermediate file. Each of these files is saved in the C:\JobReports\ServerJob1 directory.

dsdesign /D=domain:9443 /H=R101 /U=william /P=wombat
dstage ServerJob1 /R /RP=C:\JobReports /RX