Using the Product in a DB2 Environment › Background DB2 Catalog Extraction › Synchronous Data Gatherer › Manually Starting and Stopping Harvester Exits

Manually Starting and Stopping Harvester Exits

The Synchronous Data Gatherer harvesting exits can be started or stopped by using a server MODIFY command.

To start a Harvester exit on a given processor

Enter the following command on a z/OS console:

F server,HARVESTER,START,ssid,exit

where

• server is the server name.
• ssid is the DB2 subsystem ID.
• exit is the Harvester exit name (DB2E1, DB2E2, or DB2E3).

HARVESTER can be abbreviated as HAR.

Example:

F MATUNER,HARVESTER,START,DIA3,DB2E1

The following messages will be displayed on the z/OS console:

TS0020I CA MAT Synchronous Data Gatherer Harvesting has been activated. MATUNER START
TS0003I CA MAT Token = 1200C3B4CD11A96C7594282CB500000001040003
TS0019I CA MAT Synchronous Data Gatherer command processing completed. MATUNER START

If the exit is already active for any server, the following messages will be displayed:

TS0019I CA MAT Synchronous Data Gatherer command processing completed. MATUNER START
TN3431I Harvester command processed for: START,DIA3,DB2E1

To stop a Harvester exit on a given processor

Enter the following command on a z/OS console:

F server,HARVESTER,STOP,ssid,exit

where

• server is the server name.
• ssid is the DB2 subsystem ID.
• exit is the Harvester exit name (DB2E1, DB2E2, or DB2E3).

Example:

F MATUNER,HARVESTER,STOP,DIA3,DB2E1

The following messages will be displayed on the z/OS console:

TS0021I CA MAT Synchronous Data Gatherer Harvesting has been deactivated. MATUNER STOP
TS0003I CA MAT Token = 1200C3B4CD11A96C7594282CB500000001040003
TS0019I CA MAT Synchronous Data Gatherer command processing completed. MATUNER STOP
TN3431I Harvester command processed for: STOP,DIA3,DB2E1

If the exit is active for another server, the following messages will be displayed:

TS0019I CA MAT Synchronous Data Gatherer command processing completed. MATUNER STOP
TN3431I Harvester command processed for: STOP,DIA3,DB2E1

If the exit has not been started, the following messages will be displayed:

TS0023I CA MAT Synchronous Data Gatherer Harvesting has not been started. MATUNER STOP
TS0019I CA MAT Synchronous Data Gatherer command processing completed. MATUNER STOP
TN3431I Harvester command processed for: STOP,DIA3,DB2E1

To list active and inactive Harvester exits on a given processor

Enter the following command on a z/OS console:

F server,HARVESTER,LIST

where server is the server name.

A display similar to the following will be sent to the z/OS console:

TS0031I CA MAT Synchronous Data Gatherer System DIA3     is active.
TS0031I CA MAT Synchronous Data Gatherer Target DIA3DBM1 is active.
TS0031I CA MAT Synchronous Data Gatherer HVCode DB2E3    is inactive.
TS0031I CA MAT Synchronous Data Gatherer Server TRI85MM  is inactive.
TS0031I CA MAT Synchronous Data Gatherer HVCode DB2E1    is active.
TS0031I CA MAT Synchronous Data Gatherer Server TRI85KM  is active.