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.
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