Command Reference

10.0
- 10.5.5
- 10.5.4
- 10.5.3

Back Next

Starting the PowerExchange Listener

The method of starting the PowerExchange Listener varies by operating system.

On i5/OS, Linux, UNIX, and Windows systems, you can include optional CONFIG and LICENSE parameters in the command that starts the dtllst program to specify alternative configuration and license key files that you want to use instead of the original DBMOVER configuration and license key files. Usually, you define the alternative files at a location or under a file name that is different from that of the original files. This practice prevents your customized files from being overwritten when you upgrade or reinstall the product. If you also specify alternative configuration and license key files in the PWX_CONFIG and PWX_LICENSE environment variables, the files identified in the CONFIG and LICENSE parameters override the files identified in the environment variables.

You cannot use the pwxcmd program to start the PowerExchange Listener.

Starting the PowerExchange Listener on i5/OS

On i5/OS, use the SBMJOB command to invoke the DTLLST program.

Before you execute the SBMJOB command, verify that the following prerequisites are met:

The QMLTTHDACN system value is set to 1 or 2. For more information about the QMLTTHDACN system value, see the IBM i Information Center for i5/OS.

The JOBD description includes the ALWMLTTHD(*YES) parameter to allow multiple threads.

Use the following command syntax:

SBMJOB CMD(CALL PGM(dtllib/DTLLST) PARM(‘node_name’ ‘[CONFIG=library/file(myconfig_member)]’ ‘[LICENSE=library/file(mylicense_key_member)]’) JOB(job_name) JOBD(datalib/DTLLIST) PRTDEV(*JOBD) OUTQ(*JOBD) CURLIB(*CRTDFT) INLLIBL(*JOBD)

This syntax contains the following variables:

dtllib is the name of the PowerExchange software library that was entered at installation.

node_name is the PowerExchange Listener node name that was specified in the LISTENER statement of the datalib/CFG(DBMOVER) configuration member.

job_name is the name of the PowerExchange Listener job or started task.

datalib is the user-specified name for the PowerExchange data library that was entered at installation.

You can enter the SBMJOB command at the command line.

Alternatively, you can execute the SBMJOB command by using an automated scheduler, a CL program, or a REXX procedure. For example, include the SBMJOB command in a REXX member named STARTLST and then use the following statement to start the PowerExchange Listener:

STRREXPRC SRCMBR(STARTLST) SRCFILE(datalib/REXX)

You cannot use the pwxcmd program to start the PowerExchange Listener.

Starting the PowerExchange Listener on Linux and UNIX

On Linux or UNIX, you can start the PowerExchange Listener in the following ways:

Run the dtllst program from the command prompt.

Run the startlst script that was shipped with PowerExchange. The startlst script deletes the detail.log file and starts the PowerExchange Listener.

To run the dtllist program, use one of the following syntax constructions, depending on the PowerExchange Listener run mode that you want to use:

To run PowerExchange Listener in foreground mode, use the following syntax:

dtllst node_name [config=directory/myconfig_file] [license=directory/mylicense_key_file]

To run the PowerExchange Listener in background mode, add an ampersand (&) at the end:

dtllst node_name [config=directory/myconfig_file] [license=directory/mylicense_key_file] &

To run the PowerExchange Listener permanently, even if the session is disconnected or the user logs out, add the prefix nohup:

nohup dtllst node_name [config=directory/myconfig_file] [license=directory/mylicense_key_file] &

The node_name variable is the PowerExchange Listener node name that was specified in the LISTENER statement of your default or override dbmover.cfg file.

You can include the command in the startlst script or run it from the command prompt.

Starting the PowerExchange Listener on Windows

On Windows, you can start the PowerExchange Listener in one of the following ways:

Start and manage the PowerExchange Listener service through the

Start

menu.

Start and manage the PowerExchange Listener service through the dtllstsi program.

Start the PowerExchange Listener manually by invoking the dtllst program with the start option from the command prompt. Your product license must allow this mode of operation.

To start the dtllst program manually from the Command Prompt window, use the following syntax:

dtllst node_name [config=directory\myconfig_file] [license=directory\mylicense_key_file]

The node_name variable is the PowerExchange Listener node name that was specified in the LISTENER statement of your default or override dbmover.cfg file.

Starting the PowerExchange Listener on z/OS

On z/OS, you can start the PowerExchange Listener in the following ways:

Issue the standard MVS START (S) command to run the PowerExchange Listener as a started task.

Submit the JCL in the STARTLST member of the RUNLIB library. You can include the JCL as part of a batch job.

To issue the MVS START (S) command, use the following syntax:

S task_name

The task_name variable is the name of the PowerExchange Listener started task or batch job. Usually, the PowerExchange Listener runs as a started task. This command starts the started task from a system PROCLIB library.

To start the PowerExchange Listener as a batch job, submit the JCL in the STARTLST member of the RUNLIB.

Common Parameters

When you run dtllst on i5/OS, Linux, UNIX, or Windows, you can include the following optional parameters to specify alternative configuration and license key files:

CONFIG: On Linux, UNIX, or Windows, specifies the full path and file name for any dbmover.cfg configuration file that you created and want to use instead of the default install_directory/dbmover.cfg file. This alternative configuration file takes precedence over any alternative configuration file that you specified in the PWX_CONFIG environment variable.; On i5/OS, specifies the library, file name, and member name for the alternative configuration member that you want to use instead of the default datalib/CFG(DBMOVER) member.
LICENSE: On Linux, UNIX, or Windows, specifies the full path and file name for any license key file that you created and want to use instead of the default license.key file. This alternative license key file takes precedence over any alternative license key file that you specified in the PWX_LICENSE environment variable.; On i5/OS, specifies the library, file name, and member name for the alternative license key member.

In the CONFIG and LICENSE parameters, the full path is required only if the file does not
reside at the default location.

Usage Notes

After the PowerExchange Listener starts, the following message indicates that the PowerExchange Listener is ready for communication:

PWX00607 - “Listener node” VRM “n.n.n Build Vnnn” started.

On i5/OS, Linux, UNIX, and Windows, the following additional messages are displayed to identify the dbmover.cfg configuration file and the license.key file that the PowerExchange Listener is using:

PWX-00595 Using “config” “override_config_file”
PWX-00595 Using “license” “override_license_key_file”

If you set the PWX_CONFIG and PWX_LICENSE environment variables or specified the config and license parameters in the command to override the default configuration and license files, the following messages are also displayed to alert you of the override action:

PWX-00369 The default “config” filename has been overridden.
PWX-00369 The default “license” filename has been overridden.

If you run PowerExchange and PowerCenter on the same machine and under the same user account, you must create separate environments for PowerExchange and PowerCenter. To create the appropriate PowerExchange environment and start the PowerExchange Listener, run the pwxsettask.sh or pwxsettask.bat script.

On Linux or UNIX, use the following syntax:

pwxsettask.sh dtllst node_name ["config=directory/config_file"] ["license=directory/license_key_file"]

The quotation marks are optional on Linux or UNIX.

On Windows, use the following syntax:

pwxsettask dtllst node_name ["config=directory/config_file"] ["license=directory/license_key_file"]

The quotation marks are required on Windows.

For more information, see Environment Variable Incompatibilities Between PowerExchange and PowerCenter.

PowerExchange Listener Commands

PowerExchange Listener Service on Windows

DTLLSTSI Command

Download Guide

Watch

Comments

Communities

Knowledge Base

Success Portal

0 COMMENTS

We’d like to hear from you! Log in to comment.

Rename Saved Search

Table of Contents

Command Reference

Command Reference

Starting the PowerExchange Listener

Starting the PowerExchange Listener

Starting the PowerExchange Listener on i5/OS

Starting the PowerExchange Listener on Linux and UNIX

Starting the PowerExchange Listener on Windows

Starting the PowerExchange Listener on z/OS

Common Parameters

Usage Notes