Preface
Introduction to PowerExchange Utilities
- PowerExchange Utilities Overview
- PowerExchange Utilities by Operating System
- PowerExchange Utilities Syntax Conventions
- Environment Variable Incompatibilities Between PowerExchange and PowerCenter
  - Setting the PowerExchange Environment and Starting a Utility
- PowerExchange Sample JCL
createdatamaps - Data Map Creation Utility
- createdatamaps Utility Overview
- Requirements and Considerations for COBOL Copybooks and DBDs
- createdatamaps Command Syntax
- Creating, Editing, and Testing a Data Map
- Control Files for Data Map Generation
  - Rules for Control Files
  - Control File Structure
- Schema File for Describing Control Files
- Schema File Reference
- Log File for Data Maps Creation Utility
  - JAXB Error Messages
- Redefinitions and Record IDs in COBOL Copybooks
- Copybook and DBD Metadata for IMS Data Maps
- Column Name Filters
- Unavailable Data Map Properties
- Examples
DTLCCADW - Adabas PCAT Utility
- DTLCCADW Utility Overview
- DTLCCADW Utility Functions
DTLCUIML - IMS Log Marker Utility
- DTLCUIML Utility Overview
- DTLCUIML Utility Parameters
- DTLCUIML Utility Reports
DTLINFO - Release Information Utility
- DTLINFO Utility Overview
- Supported Operating Systems for the DTLINFO Utility
- Control Statement Syntax for the DTLINFO Utility
- Control Statement Parameters for the DTLINFO Utility
- Running the DTLINFO Utility on i5/OS
- Running the DTLINFO Utility on Linux, UNIX, and Windows
- Running the DTLINFO Utility on z/OS
- DTLINFO Utility on i5/OS Examples
  - DTLINFO Utility on i5/OS - Example 1
  - DTLINFO Utility on i5/OS - Example 2
- DTLINFO Utility on Linux, UNIX, and Windows Examples
  - DTLINFO Utility on Linux, UNIX, and Windows - Example 1
  - DTLINFO Utility on Linux, UNIX, and Windows - Example 2
- DTLINFO Utility on z/OS Examples
  - DTLINFO Utility on z/OS - Example 1
  - DTLINFO Utility on z/OS - Example 2
DTLREXE - Remote Execution Utility
- DTLREXE Utility Overview
- Supported Operating Systems for the DTLREXE Utility
- Control Statement Syntax for the DTLREXE Utility
- Control Statement Parameters for the DTLREXE Utility
- Running the DTLREXE Utility on i5/OS
- Running the DTLREXE Utility on Linux and UNIX
- Running the DTLREXE Utility on Windows
- Running the DTLREXE Utility on z/OS
- DTLREXE Utility Usage Notes
- DTLREXE Utility on z/OS Example
  - DTLREXE Utility on z/OS Example JCL
  - DTLREXE Utility on z/OS Output Data Set
DTLUAPPL - Restart Token Utility
- DTLUAPPL Utility Overview
- Supported Operating Systems for the DTLUAPPL Utility
- DTLUAPPL Control Statement Syntax
- Connection Statement
- ADD and MOD Statements
- END APPL Statement
- PRINT APPL Statement
- Running the DTLUAPPL Utility on i5/OS
- Running the DTLUAPPL Utility on Linux, UNIX, and Windows
- Running the DTLUAPPL Utility on z/OS
- DTLUAPPL Utility Examples
DTLUCBRG - Batch Registration Utility
- DTLUCBRG Utility Overview
- Supported Operating Systems for the DTLUCBRG Utility
- DTLUCBRG Utility Parameters
- DTLUCBRG Code Page Processing
  - Code Page Processing for DB2 Registrations in Local Mode on z/OS
- Running the DTLUCBRG Utility
- DTLUCBRG Utility Example Reports
  - DTLUCBRG Utility with RPTCOLS=N Report Description
  - DTLUCBRG Utility with RPTCOLS=Y Report Description
- DTLUCBRG Utility Usage Notes
DTLUCDEP - CDEP Maintenance Utility
- DTLUCDEP Utility Overview
- Supported Operating Systems for the DTLUCDEP Utility
- Control Statement Syntax for the DTLUCDEP Utility
- Control Statement Parameters for the DTLUCDEP Utility
  - CDEP Definition Examples
- Running the DTLUCDEP Utility on i5/OS
- Running the DTLUCDEP Utility on Linux, UNIX, and Windows
- Running the DTLUCDEP Utility on z/OS
- DTLUCDEP Utility on i5/OS Example
- DTLUCDEP Utility on Linux, UNIX, and Windows Example
- DTLUCDEP Utility on z/OS Example
DTLUCSR2 - IDMS SR2 and SR3 Records Utility
- DTLUCSR2 Utility Overview
- Running the DTLUCSR2 Utility
DTLUCUDB - DB2 for Linux, UNIX, and Windows CDC Utility
- DTLUCUDB Utility Overview
- Running the DTLUCUDB Utility
  - DTLUCUDB Utility Syntax
  - Command Options for the DTLUCUDB Utility
- Gathering Diagnostic Information to Resolve a DB2 Capture Problem
DTLULCAT and DTLULOGC - IDMS Log Catalog Utilities
- DTLULCAT and DTLULOGC Utilities Overview
- Running the DTLULCAT Utility
- Running the DTLULOGC Utility
- Manually Manipulating the Log Catalog
- Guidelines for Adding Logs to the Catalog with the DTLULCAT and DTLULOGC Utilities
DTLURDMO - Data Map Utility
- DTLURDMO Utility Overview
- Supported Operating Systems for the DTLURDMO Utility
- Control Statement Overview for the DTLURDMO Utility
- Control Statement Syntax for the DTLURDMO Utility
- Control Statements and Parameters for the DTLURDMO Utility
- Scope of Operands
- Running the DTLURDMO Utility on i5/OS
- Running the DTLURDMO Utility on Linux, UNIX, and Windows
- Running the DTLURDMO Utility on z/OS
- DTLURDMO Control Statement Examples
- DTLURDMO Report Examples
DTLUTSK - Task Control Utility
- DTLUTSK Utility Overview
- DTLUTSK Command Line Utility on i5/OS
- DTLUTSK Command Line Utility on Linux, UNIX, and Windows
  - Displaying DTLUTSK Utility Help
- DTLUTSK Job on z/OS
  - Example JCL for a DTLUTSK Job on z/OS
  - Example Output from a DTLUTSK Job on z/OS
- DTLUTSK Command Line Utility on z/OS
- Running the DTLUTSK Utility in the PowerExchange Navigator
- DTLUTSK Utility Security
EDMLUCTR - Log Scan and Print Utility
- EDMLUCTR Utility Overview
- Supported Operating Systems for the EDMLUCTR Utility
- Control Statement Syntax for the EDMLUCTR Utility
- Control Statement Parameters for the EDMLUCTR Utility
  - -SEL Statement
  - -MASK Statement
- Running the EDMLUCTR Utility
- EDMLUCTR Utility Usage Notes
- EDMLUCTR Utility Examples
EDMXLUTL - Event Marker Utility
- EDMXLUTL Utility Overview
- Creating an Event Marker in Batch Mode
- EDMXLUTL Utility JCL Statements
- EDMXLUTL Utility Control Statements
- EDMXLUTL Utility EVENT Command
  - EVENT Command Syntax
  - EVENT Command Usage
- Keyword Sets for the BASEEDM Category
  - MARK Keyword Set
  - NOTIFY Keyword Set
- EDMXLUTL Utility Example
HOSTENT - TCP/IP Address Reporter Utility
- HOSTENT Utility Overview
- Supported Operating Systems for the HOSTENT Utility
- Running the HOSTENT Utility on i5/OS
- Running the HOSTENT Utility on Linux and UNIX
- Running the HOSTENT Utility on z/OS
- HOSTENT Utility Usage Notes
  - HOSTENT Utility Resolver Details
- HOSTENT Utility Output
- HOSTENT Utility on i5/OS Example
- HOSTENT Utility on Linux and UNIX Example
- HOSTENT Utility on z/OS Example
PWXCATMY - MySQL Catalog Utility
- PWXCATMY Utility Overview
- Supported Operating Systems for the PWXCATMY Utility
- PWXCATMY Operation Types
- Command Syntax and Parameters
PWXUCCLPRT - Print Log Summary Utility
- PWXUCCLPRT Utility Overview
- Supported Operating Systems for the PWXUCCLPRT Utility
- Command Syntax for the PWXUCCLPRT Utility
- PWXUCCLPRT Utility Parameters
  - PWXUCCLPRT INPUT Statement Parameters
  - PWXUCCLPRT OUTPUT Statement Parameters
- Example PWXUCCLPRT Parameter File
- Examples of PWXUCCLPRT Output
PWXUCDCT - Logger for Linux, UNIX, and Windows Utility
- PWXUCDCT Utility Overview
- Supported Operating Systems for the PWXUCDCT Utility
- Control Statement Syntax for PWXUCDCT Commands
- PWXUCDCT Commands and Parameters
  - Commands
  - Parameter Descriptions
- Running the PWXUCDCT Utility
- Usage Notes for the PWXUCDCT Utility
- Examples of PWXUCDCT Utility Commands
PWXUCREG - Capture Registration Suspend Utility
- PWXUCREG Utility Overview
- PWXUCREG Usage Considerations
- Supported Operating Systems for the PWXUCREG Utility
- Suspending Change Capture for Registered Sources Temporarily
- General Syntax for PWXUCREG Commands
- Summary of PWXUCREG Commands
- Global SET_CONTROL_VALUE Parameters
- Registration-specific Command Parameters
- Running the PWXUCREG Utility
- Examples of PWXUCREG Utility Commands
  - Example 1. Suspending a Capture Registration
  - Example 2. Reactivating a Capture Registration
PWXUCRGP - Capture Registrations Print Utility
- PWXUCRGP Utility Overview
- Supported Operating Systems for the PWXUCRGP Utility
- Control Statement Syntax for the PWXUCRGP Utility
- PWXUCRGP Parameters
- Running the PWXUCRGP Utility
- PWXUCRGP Report Levels of Detail
- Examples of PWXUCGRP Reports
PWXUDMX - Data Maps Update Time ECSA Memory Utility
- PWXUDMX Utility Overview
- Supported Operating Systems for the PWXUDMX Utility
- Running the PWXUDMX Utility on z/OS
- PWXUDMX Commands and Parameters
PWXUGSK - SSL Reporting Utility for z/OS
- PWXUGSK Utility Overview
- Supported Operating Systems for the PWXUGSK Utility
- PWXUGSK Control Statement Syntax
- PWXUGSK Commands and Parameters
- Running the PWXUGSK Utility
- PWXUGSK Utility Reports
PWXUMAP - Map List Utility
- PWXUMAP Utility Overview
- Supported Operating Systems for the PWXUMAP Utility
- General Syntax for the PWXUMAP Utility
- PWXUMAP Commands and Parameters
- Running the PWXUMAP Utility
- Examples of PWXUMAP Reports
- PWXUMAP Utility Usage Notes
PWXUSSL - PowerExchange SSL Reporting Utility
- PWXUSSL Utility Overview
- Supported Operating Systems for the PWXUSSL Utility
- Control Statement Syntax for PWXUSSL Commands
- PWXUSSL Commands and Parameters
- Running the PWXUSSL Utility
- PWXUSSL Utility Reports

Utilities Guide

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

Back Next

Example 1. Suspending a Capture Registration

You need to perform a cascade delete operation for a single registered source but do not want the ECCR to capture these deletes.

To stop change capture temporarily, you plan to suspend the capture registration named b800tbl that is associated with the source. You run a PWXUCREG job that contains a SUSPEND_REGISTRATION command. Later, you will reactivate the capture registration to resume capture processing.

Use the following JCL to run a PWXUCREG job that suspends the capture registration:

//PWXURSUS JOB  'PWXUCREG',MSGLEVEL=(1,1),MSGCLASS=X,NOTIFY=&SYSUID,  
//          CLASS=A                                                   
//LIBSRCH   JCLLIB ORDER=DTLUSR.V951.RUNLIB                   
//          SET HLQ=DTLUSR.V951                                       
//          SET RUNLIB=DTLUSR.V951.RUNLIB                     
//STEP1     EXEC PGM=PWXUCREG                                         
//STEPLIB   DD  DISP=SHR,DSN=&HLQ..LOADLIB                            
//*                                                                   
//DTLAMCPR  DD  DISP=SHR,DSN=&HLQ..CCT                                
//DTLMSG    DD  DISP=SHR,DSN=&HLQ..DTLMSG                             
//DTLCFG    DD  DISP=SHR,DSN=&RUNLIB(DBMOVER)                         
//DTLKEY    DD  DISP=SHR,DSN=&RUNLIB(LICENSE)                         
//DTLSGN    DD  DISP=SHR,DSN=&RUNLIB(SIGNON)                          
//DTLLOG    DD  SYSOUT=*                                              
//SYSUDUMP  DD  SYSOUT=*                                              
//SYSOUT    DD  SYSOUT=*                                              
//SYSPRINT  DD  SYSOUT=*                                              
//PWXSYSIN  DD  *                                                     
SET_CONTROL_VALUE,SYSTEM_CONSOLE_MESSAGES_COMMAND=Y;
SUSPEND_REGISTRATION,                                                
DATABASE_INSTANCE=R11G4,                                              
REGISTRATION_NAME=b800tb1                                            
/*

The JCL includes the global SYSTEM_CONSOLE_MESSAGES_COMMAND=Y parameter in the SET_CONTROL_VALUE command to write messages related to suspension processing to the z/OS system console.

If the JCL is successfully processed, the following messages are printed to both the job log and z/OS system console:

16.22.35 JOB03118 ---- TUESDAY,   23 OCT 2012 ----                                                                              
16.22.35 JOB03118  IRR010I  USERID DTLUSR   IS ASSIGNED TO THIS JOB.                                                            
16.22.35 JOB03118  ICH70001I DTLUSR   LAST ACCESS AT 14:01:58 ON TUESDAY, OCTOBER 23, 2012                                      
16.22.35 JOB03118  £HASP373 PWXURSUS STARTED - INIT 3    - CLASS A - SYS MHZ1                                                   
16.22.35 JOB03118  IEF403I PWXURSUS - STARTED - TIME=16.22.35                                                                   
16.22.37 JOB03118  PWX-03716 PWXUCREG: Registration "b800tb1", version "1", instance "R11G4", status changed from "Active" to   
                            "Suspended"  .                                                                                      
16.22.37 JOB03118  -                                              --TIMINGS (MINS.)--            -----PAGING COUNTS----         
16.22.37 JOB03118  -STEPNAME PROCSTEP    RC   EXCP   CONN    TCB    SRB  CLOCK   SERV  WORKLOAD  PAGE  SWAP   VIO SWAPS         
16.22.37 JOB03118  -STEP1                00   1020    417    .00    .00     .0   5542  BATCH        0     0     0     0         
16.22.38 JOB03118  IEF404I PWXURSUS - ENDED - TIME=16.22.38                                                                     
16.22.38 JOB03118  -PWXURSUS ENDED.  NAME-                     TOTAL TCB CPU TIME=   .00  TOTAL ELAPSED TIME=    .0             
16.22.38 JOB03118  £HASP395 PWXURSUS ENDED                                                                                      
------ JES2 JOB STATISTICS ------                                                                                               
  23 OCT 2012 JOB EXECUTION DATE                                                                                                
           24 CARDS READ                                                                                                        
          142 SYSOUT PRINT RECORDS                                                                                              
            0 SYSOUT PUNCH RECORDS                                                                                              
            8 SYSOUT SPOOL KBYTES                                                                                               
         0.04 MINUTES EXECUTION TIME  
                                                                                        


PWX-33314 TIMEOUTS configuration parameter is deprecated                                                                                
                                                                                                                                        
PWX-15799 DD:PWXSYSIN <> PARM INPUT FILE: START>>> .                                                                                    
PWX-15799 SET_CONTROL_VALUE,SYSTEM_CONSOLE_MESSAGES_COMMAND=Y;.                                                                         
PWX-15799 SUSPEND_REGISTRATION,.                                                                                                        
PWX-15799 DATABASE_INSTANCE=R11G4,.                                                                                                     
PWX-15799 REGISTRATION_NAME=b800tb1.                                                                                                    
PWX-15799 ;.                                                                                                                            
PWX-15799 DD:PWXSYSIN <> PARM INPUT FILE: END(COMPLETE).                                                                                
                                                                                                                                        
                                                                                                                                        
PWX-03716 PWXUCREG: Registration "b800tb1", version "1", instance "R11G4", status changed from "Active" to "Suspended".               
                                                                                                                                        
PWX-03717 PWXUCREG: Number of registrations processed 1  .                                                                              
                                                                                                                                        
PWX-03712 PWXUCREG: Registration "b800tb1", type "DCM", instance "R11G4", version "1", current status "S".                              
PWX-03713 PWXUCREG: Registration "b800tb1", suspended at "2012/10/23 16:22:37.235636", current time "2012/10/23 16:22:37.727037".       
PWX-03714 PWXUCREG: Registration "b800tb1", activated at "2012/10/19 09:46:26.007478", current time "2012/10/23 16:22:37.727037".       
                                                                                                                                        
PWX-03724 PWXUCREG: Number of registrations displayed 1.

Message PWX-03716 indicates that the utility successfully changed the registration status to Suspended. Messages PWX-03712 through PWX-03714 are printed because you accepted the default value of Y for global DISPLAY_REGISTRATION_AFTER_COMMAND parameter. These messages report registration information such as the current registration status, the suspension timestamp in current system time, and the activation timestamp from a previous ACTIVATE_REGISTRATION command.

Rename Saved Search

Table of Contents

Utilities Guide

Utilities Guide

Example 1. Suspending a Capture Registration

Example 1. Suspending a Capture Registration