644 DB2 Cube Views: A Primer
Configure the client
There are three steps involved in configuring the client to accept process
metadata from the Process MetaBroker:
1. Configure the Listener to accept DataStage job run XML files
2. Create a MetaStage Directory
3. Configure RunImport to import the DataStage job runs
The detailed steps are:
1. First, we must ensure that the Listener configuration file has the correct
startup parameters for our environment on the client machine. To do this,
navigate to the installation directory of the Listener on the client machine and
open the file listener.cfg. By default on Windows, the directory is:
C:\Program Files\Ascential\MetaStage\Listener\listener.cfg
All default settings for the Listener are acceptable however you may choose to
reconfigure the following variables shown in Table A-3.:
Table A-3 Listener configuration variables
If you change any variable in the Listener configuration file you must stop and
start the MetaStage Listener using Services Manager under Windows Control
Panel so that changed variables will take effect.
2. Secondly, if you have not done so already, you must create a MetaStage
Directory (Directory) so that the RunImport configuration file can reference
the Directory name.
a. Run the MetaStage Directory Administrator. You will see the Directory
Administrator dialog shown in Figure A-4.
Variable Default value Description
LogDirectory C:\Program
Files\Ascential\MetaSta
ge\Listener\Logs
LogDirectory is the file system
subdirectory where Listener log file(s)
are located
Port 2379 Port is the TCP/IP port on which the
Listener listens for the Process
MetaBroker.
RunsDirectory C:\Program
Files\Ascential\MetaSta
ge\Listener\Runs
RunsDirectory is the name and path of
the subdirectory where XML run files
will be written.
Appendix A. DataStage: operational process metadata configuration and DataStage job example 645
Figure A-4 Directory Administrator
b. Click New. You will now be asked to select a data source in which to create
the MetaStage Directory shown in Figure A-5.
Figure A-5 Select data source
646 DB2 Cube Views: A Primer
Choose the Machine Data Source tab and either create a new data
source name (DSN) or create a new DSN. Before you click
OK, make note
of the DSN you chose or created. This name will become the name of your
MetaStage directory. You will need to use this value later when configuring
the RunImport. You will be asked to enter any login details and then click
OK. When the Directory Administrator completes you will have an empty
MetaStage Directory to work with.
3. Finally, before the client is ready to accept process metadata, we must ensure
that the RunImport configuration file has the correct startup parameters on
our client machine. To do this, navigate to the installation directory of the
RunImport on the client machine and open the file runimport.cfg. By default
on Windows, the directory is:
C:\Program Files\Ascential\MetaStage\Listener\runimport.cfg
All default settings for the RunImport are acceptable however you may
choose to reconfigure the variables shown in Table A-4.
Table A-4 RunImport configuration parameters
Variable Default value Description
LogDirectory C:\Program
Files\Ascential\MetaStag
e\Listener\Logs
LogDirectory is the file system
subdirectory where RunImport log
file(s) are located
MetaStageDirectory <Enter the Directory
name selected or created
here>
MetaStageDirectory is the name
of the MetaStage Directory to
import metadata into. The Run
Importer imports to only one
directory at a time. Change this
entry whenever you need to
import process metadata to a
different directory.
User User is the user name required to
access the MetaStage directory
as specified in Figure 43.
EncryptedPassword Password is the password
required to access the MetaStage
directory. When the Run Importer
runs, the password is encrypted in
the configuration file.

Get DB2 Cube Views: A Primer now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.