Command Reference

10.5.8
- 10.5.6
- 10.5.5
- 10.5.4
- 10.5.3
- 10.5.2
- 10.5.1
- 10.5
- 10.4.1
- 10.4.0 HotFix 1
- 10.4.0

Back Next

Configuring PowerExchange Processes to Receive pwxcmd Commands

To send pwxcmd commands to a PowerExchange process, configure the PowerExchange process to receive pwxcmd commands.

Also, on the Linux, UNIX, or Windows system from which you issue pwxcmd commands, configure a connection to the PowerExchange process.

To configure a PowerExchange process to receive pwxcmd commands, complete the following configuration tasks:

On the system where the PowerExchange process runs:

Configure the PowerExchange process to receive pwxcmd commands.

To configure a PowerExchange Listener process to receive pwxcmd commands, define a LISTENER statement and an SVCNODE statement in the DBMOVER configuration file.

To configure a PowerExchange Condense or PowerExchange Logger for Linux, UNIX, and Windows process, define a CONDENSENAME statement and an SVCNODE statement. For a PowerExchange Condense process, define the CONDENSENAME statement in the CAPTPARM configuration file or member. For a PowerExchange Logger for Linux, UNIX, and Windows process, define a CONDENSENAME statement in the pwxccl.cfg file. For information about the CONDENSENAME statement, see the CDC guide for the operating system. For information about the LISTENER and SVCNODE statements, see the PowerExchange Reference Manual
.

To configure a PowerExchange ECCR to receive pwxcmd commands, define a SVCNODE statement in the DBMOVER configuration file. The statement specifies the ECCR name and port number for pwxcmd commands. Eligible ECCRs include ADABAS, IDMS, and IMS log-based ECCRs, and Datacom table-based ECCRs.

To configure an Adabas ECCR on z/OS, add the following PARM to the EXEC statement in the PowerExchange Adabas ECCR JCL:

EXEC PGM=DTLCCADA,PARM=(ADA82)

The ECCR JCL is usually in the PROCLIB member named prefixAD1EC, which was created during installation. If you do not include PARM=(ADA82), the pwxcmd command handler will not start when you issue a pwxcmd command.

Optionally, configure security for pwxcmd commands. You can configure PowerExchange to verify that the user has authorization to access PowerExchange or issue the command.

To configure security, define a SECURITY statement in the DBMOVER configuration file and complete other configuration tasks.

For more information about pwxcmd command security, see the PowerExchange Reference Manual
.

On i5/OS, if you are upgrading to PowerExchange 9.0.1, complete the following tasks to enable the PowerExchange Listener to run and authorize users to issue pwxcmd commands to a PowerExchange process.

To enable the PowerExchange Listener to run, issue the following upgrade command:

CHGJOBD JOBD(datalib/DTLLIST) ALWMLTTHD(*YES)

Where datalib is the user-defined name for the PowerExchange data library specified at installation.

Also, verify that the QMLTTHDACN system value is set to a value that enables functions that might not be threadsafe to run. If the QMLTTHDACN system value is set to 3, or to the

Do not perform the function

value in the iSeries Navigator, PowerExchange does not start. Set the QMLTTHDACN system value to 1 or 2, or to the

Perform the function that is not threadsafe

value in the iSeries Navigator.

To create security objects, issue the following upgrade command:

CALL PGM(dtllib/CRTDTLENVA) PARM('datalib')

Where dtllib is the name of the PowerExchange software library that you specified at installation and datalib is the name for the PowerExchange data library that you specified at installation. To authorize a user to issue a specific pwxcmd command, grant the user access to the security object for the command.

Start the PowerExchange processes to which you want to send pwxcmd commands.

On the Linux, UNIX, or Windows system from which you issue pwxcmd commands, configure connections to the PowerExchange processes to which you want to send pwxcmd commands.

To configure a connection, define a CMDNODE statement in the dbmover.cfg file. For more information about the CMDNODE statement, see the PowerExchange Reference Manual
.

To configure a PowerExchange log-based ECCR to receive pwxcmd commands, the CMDNODE statement must specify the ECCR name, host name, and TCP/IP port number. The ECCR name and port number must match the values specified in the corresponding SVCNODE statement in the DBMOVER configuration file on the specified host.

pwxcmd Commands

Example 1: Configuring a PowerExchange Listener to Receive pwxcmd Commands

Example 2: Configuring a PowerExchange Condense Process to Receive pwxcmd Commands

Example 3: Configuring a PowerExchange Logger Process to Receive pwxcmd Commands

Example 4: Configuring a PowerExchange Log-Based or Datacom ECCR to Receive pwxcmd Commands