Hi, I'm Bolo!
What would you like to know?
ASK BOLOPreview
Please to access Bolo.

Table of Contents

Search

  1. Preface
  2. Introduction to PowerExchange Commands
  3. Adabas Log-Based ECCR Commands
  4. Batch VSAM ECCR Commands
  5. CICS/VSAM ECCR Commands
  6. Datacom Table-Based ECCR Commands
  7. DB2 for z/OS ECCR Commands
  8. IDMS Log-Based ECCR Commands
  9. IMS Synchronous ECCR Commands
  10. IMS Log-Based ECCR Commands
  11. PowerExchange Agent Commands
  12. PowerExchange Condense Commands
  13. PowerExchange Listener Commands
  14. PowerExchange Logger for z/OS Commands
  15. PowerExchange Logger for Linux, UNIX, and Windows Commands
  16. pwxcmd Commands

Command Reference

Command Reference

CLOSE and CLOSE FORCE Commands

CLOSE and CLOSE FORCE Commands

Stops the PowerExchange Listener job or task after the following subtasks complete:
  • Bulk data movement subtasks
  • CDC subtasks, which stop at the next commit of a unit of work (UOW)
  • PowerExchange Listener subtasks
For long-running subtasks on the PowerExchange Listener, use the CLOSE FORCE option to force the cancellation of all user subtasks and stop the PowerExchange Listener. The PowerExchange Listener waits 30 seconds for running tasks to complete and then stops any tasks that continue to run before shutting down.
Alternatively, issue the pwxcmd close and closeforce commands from a Linux, UNIX, or Windows system to a PowerExchange Listener running on any system.

Syntax on i5/OS

On i5/OS, use the following command syntax:
SNDLSTCMD
datalib
CLOSE [CLOSEOPT(FORCE)]
The
datalib
variable is the user-specified name for the PowerExchange data library that you entered at installation.
Alternatively, issue the pwxcmd close and closeforce commands from a Linux, UNIX, or Windows system to a PowerExchange Listener running on an i5/OS system.

Syntax on Linux and UNIX

If the PowerExchange Listener is running in foreground mode, press C and then press Enter to perform a controlled shutdown. Press Ctrl + C to perform a forced shutdown. However, instead of pressing Ctrl + C to kill the PowerExchange Listener process, issue one of the following commands at the command prompt:
  • If the PowerExchange Listener is running in foreground mode and you want to perform a CLOSE operation, issue the following command:
    C
  • If the PowerExchange Listener is running in foreground mode and you want to perform a CLOSE FORCE operation, issue the following command:
    C F
  • If the PowerExchange Listener is running in background mode, use the standard Linux or UNIX operating system commands. Find the PowerExchange Logger process ID and then issue the “kill” command for that process. This controlled shutdown is like a CLOSE operation.
    • To list process IDs, enter the following command at the command prompt:
      ps -ef | grep dtllst
    • To stop the PowerExchange Listener process by sending a CLOSE command, enter the following command:
      kill
      process_ID
    • To stop the PowerExchange Listener process by sending a CLOSE FORCE command, enter the following command:
      K
      ill
      process_ID
    • If the PowerExchange Listener process does not respond to a CLOSE FORCE command, perform a clean shutdown and kill the process by entering the following command:
      kill -9
      process_ID
Alternatively, you can issue the pwxcmd close and closeforce commands from a Linux, UNIX, or Windows system to a PowerExchange Listener running on a Linux or UNIX system.

Syntax on Windows

On Windows, enter the following commands in the command prompt window on which you are running the PowerExchange Listener
dtllst
program interactively.
  • To perform a CLOSE operation, enter one of the following commands:
    {CLOSE|C}
  • To perform a CLOSE FORCE operation, enter one of the following commands:
    {CLOSE FORCE|C F}
If the PowerExchange Listener process does not respond to a CLOSE FORCE command, you can press Ctrl + C. The first time you press Ctrl + C, a CLOSE command is sent to the PowerExchange Listener service. The second time you press Ctrl + C, PowerExchange sends a CLOSE FORCE command to the PowerExchange Listener service.
Alternatively, issue the pwxcmd close and closeforce commands from a Linux, UNIX, or Windows system to a PowerExchange Listener running on any Windows system.

Syntax on z/OS

On z/OS, use the following command syntax:
F
task_name
,CLOSE [FORCE]
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.
Alternatively, issue the pwxcmd close and closeforce commands from a Linux, UNIX, or Windows system to a PowerExchange Listener running on a z/OS system.

Usage Notes

Review the following notes before using the command:
  • The CLOSE command performs a controlled shutdown and generates the following messages:
    PWX-00618 Standard Close in progress. PWX-00619 All tasks closed. PWX-00623 Listener shutdown complete.
  • When you specify the FORCE parameter, PowerExchange completes the following processing:
    1. Checks if any PowerExchange Listener subtasks are active.
    2. If active subtasks exist, polls the number of active subtasks every second until 30 seconds have elapsed.
    3. During this period, PowerExchange ends any subtasks that are waiting for TCP/IP network input and issues the following message:
      PWX-00653 Operator close met while waiting for TCPIP input
    4. Cancels any remaining active subtasks.
    5. Stops the PowerExchange Listener.
    On i5/OS and z/OS systems, PowerCenter workflow tasks shut down after they read the next record. However, PowerExchange utility and row-test subtasks remain active after the 30-second wait period expires. To cancel a PowerExchange utility or row-test subtask and the associated PowerExchange Listener task, use the appropriate operating system command.
  • On z/OS, the CLOSE FORCE command is similar to the z/OS STOP command. Informatica does not recommend using the z/OS CANCEL command because it stops the PowerExchange Listener without first waiting for active subtasks to shut down. In this case, the PowerExchange Listener port remains unavailable until TCP/IP completes cleanup processing. If you start a PowerExchange Listener job before the cleanup completes, an error message indicates that the port is in use.

0 COMMENTS

We’d like to hear from you!