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

STOPTASK Command

STOPTASK Command

Stops an individual PowerExchange Listener task based on the application name that you specify.
To determine the name of the active task, issue the DISPLAY ACTIVE or LISTTASK command. In the command output, look for the PWX-00712 message for the task. Record the task name that is in the message. You must enter this value in the STOPTASK command.
During change data extraction, the STOPTASK command waits to stop the task until either the end UOW is encountered or the commit threshold is reached. For information about controlling commit processing and commit thresholds, see
PowerExchange Interfaces for PowerCenter
.
Alternatively, you can issue a pwxcmd stoptask command from a Linux, UNIX, or Windows system to a PowerExchange Listener that runs on any type of supported system. Also, in the PowerExchange Navigator on Windows, you can enter the STOPTASK command in the
Database Row Test
dialog box.

Syntax on i5/OS

On i5/OS, use the following command syntax:
SNDLSTCMD LSTMSGQ(
datalib/listener
) LSTCMD(STOPTASK) STOPTASK(
application_name
)
Where:
  • The
    datalib
    variable is the user-specified name for the PowerExchange data library that was entered at installation.
  • The
    listener
    variable is the name of the message queue used for the listener that you want to access. By default this is LISTENER. If you are running additional listeners, this value should match the value specified on the LISTENER statement in the DBMOVER.CFG file, where necessary.
  • application_name
    is the name for the active extraction process that you want to stop. This name is included in a PWX-00712 message of the DISPLAY ACTIVE command output.

Syntax on Linux, UNIX, and Windows

On Linux, UNIX, or Windows, use the following command syntax:
STOPTASK
application_name
or
S
application_name
The
application_name
is the name for the active extraction process that you want to stop. This name is included in a PWX-00712 message of the DISPLAY ACTIVE command output.
On Windows, if you want to issue the command from the PowerExchange Navigator, enter the STOPTASK command in the
Database Row Test
dialog box. Select
TASK_CNTL
in the
DB Type
list, and select
Stop Task
in the
Fetch
box. The
SQL Statement
box displays
stoptask taskid=
. Enter a task ID.

Syntax on z/OS

On z/OS, use the following command syntax:
F
task_name
,STOPTASK {APPL=
application_name
|TASKID=
task_id
}
Where:
  • task_name
    is the name of the PowerExchange Listener started task or batch job. Usually, the PowerExchange Listener runs as a started task.
  • application_name
    is the name for the active extraction process that you want to stop. This name is included in a PWX-00712 message of the LISTTASK command output.
  • task_id
    is the numeric identifier for the PowerExchange Listener task that you want to stop. This ID is included in a PWX-00712 message of the LISTTASK command output.

0 COMMENTS

We’d like to hear from you!