The pwxcmd command handler determines the IP address and port number to which to send the command from the CMDNODE statement that has the service name specified on the command. The CMDNODE statement is in the DBMOVER configuration file on the Linux, UNIX, or Windows system from which you issue the pwxcmd command.

The PowerExchange process that is the target of the command acquires its service name as follows:

The PowerExchange process listens for any pwxcmd command on the port that you specified in the relevant SVCNODE statement.

If no SVCNODE statement corresponds to the service name, PowerExchange issues warning message PWX-32534 and disables pwxcmd input.

The pwxcmd command handler passes the service type specified on the CMDNODE statement to the command-handling service for the PowerExchange process. The service refuses the connection if the service type is incorrect. For example, a PowerExchange Listener service refuses the connection if the service type is CONDENSE.

The pwxcmd program waits 60 seconds for the command-handling service to issue a return code to indicate that the command completed. If the command does not complete within this time period, the pwxcmd program displays a timeout message.

The return codes are either PowerExchange message numbers or a return code from the processing of the command.