This is the first screen when the user launches the application.

a) When the user launches the application he won’t get any dsjob.exe path. The user
has to specify the path himself. For this he will use the ‘Get dsjob Path’ button.

1
 By using this button he can specify any path on which his dsjob.exe is placed
depending on his installation.

The above step is just a onetime step during first run. Once the user has specified the
dsjob.exe path that will be saved in a text file. Subsequent runs will read the path
from that file only.

The above screen shows the user is selecting the dsjob.exe. Once the user selects this path
it will be saved to a text file.

b) The user can also specify the path to the dssearch.exe utility. One he sets this
path, the Search button functionality also starts working as shown below

2
3
The above screen shows the user entered a domain, server (where the datastage server is
running), username and password.

The the user clicks ‘Get Projects’ button. The ‘Get Projects’ button gets grayed out. The
dsjob.exe utility runs in the background and gets the projects on given domain and server.
The projects are populated in the Projects dropdown.

The user selects a Project. In the above screenshot, Project1 is selected.

The user selects the ‘Get Jobs’ button. All the jobs in the selected project - Project1 are
fetched from datastage server and populated in the drop down as shown in the below
screenshot. During this whole process ‘Get Jobs’ button is grayed out so that user can’t
press ‘Get Jobs’ again

4
When the jobs drop down is populated, one job gets selected automatically and
immediately the parameters information is fetched for it. In the above screenshot,
fetch_data_from_oracle_table_file is the selected job and it has two parameters, age and
salary.

5
Enter some values for the parameters as shown above and. Select one option - NORMAL,
RESET or VALIDATE. Press ‘Execute dsjob’ button. The job will be executed as shown
below on the datastage server

6
7
Once the job is executed, logs of the jobs are displayed in the bottom Job Report box

After the logs are fetched and displayed, the utility parses the log and looks for following
items/ values

Job start time

Job end time
Job elapsed time
Job status

and stores these values in an access databases as can be seen below. The below
screenshots show the tables in the access database

8
9
If the ‘Extract Stage Level Analysis Data’ checkbox is checked, the utility will

Extract the stage level analysis data and store it in access database as shown below
screenshots

10
11
12
13
As can be seen above, the stage level data such as

Stage_name,
Stage_start_date_time
Stage_end_data_time
No. of rows processed

is stored in database

14
Now, the user will launch the Graphical Job Run Times form.

And come on the below screen

Here the user will again select a Project, select the Jobs in the project. The utility will
query the database to automatically find the data regarding the selected Job. It will
automatically set the From Date and To Date.

15
The user will select the dates between which he want to view the graph.The graph will
show how much time (in seconds) the job has taken for all its executions

Once he has made the selections he will press ‘Draw Chart’ button and the bar chart will
be displayed with jobs data

16
The above screen shows that the job was executed 8 times between selected dates and it
shows the time it took to complete

We can also see the Line chart

And Area chart

17
The chart can also been seen in 3D

The user can select ‘Graphical Stage Run Times’

18
And come to below form. The user will select ‘Project1’, a job in a Project1 and any
stage in the job

19
And press the Draw Chart button

The user will get the run times of select Stage

20
The utility also has validations built in it. If a wrong datastage server is entered, it will
give the below error message

If a wrong username/password is entered, it will give below error message

21
22
If you click ‘Get Jobs’ without selecting any project, you will get below message

23
You can reset a job with this utility

You can validate a job with this utility

24
25