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: VSAM RRDS Data Maps with Multiple Records and Tables

This example describes a control file that creates two VSAM RRDS data maps. The imported copybook metadata includes REDEFINES statements, and the data maps that are created contain multiple records and tables.

This example is similar to the one for creating SEQ data maps with multiple records and tables. For more information about how the REDEFINES statements in the COBOL copybook result in multiple records and tables, see Example: SEQ Data Map with Multiple Records and Tables.

Because the control file sets the value of GlobalMapType to RRDS, the example creates RRDS data maps.

Command Line

To run this example on the Informatica services machine, enter the following command at the command line:

Informatica_services_installation_directory\isp\bin\infacmd pwx createDatamaps -datamapOutputDir Output -controlFile vsam_advanced.xml -logFile Output\vsam_advanced.log -verbosity INFO

Control File

The control file for this example, vsam_advanced.xml, contains the following lines:


<?xml version="1.0" encoding="UTF-8"?>
<!-- 
NOTE: Metadata file paths in this sample control file are relative to current directory. 
If 'infacmd' command is issued from a different directory, all relative file paths must be replaced with absolute file paths.
-->

<!-- xmlSchemaVersion set to 1.0 -->
<DatamapGeneration xmlSchemaVersion="1.0" xmlns="http://com.informatica.cmd.pwx.createdatamaps/DatamapGeneration">
	<vsamGen>
	
		<!-- Global settings for copybooks -->
		<globalCopybookParserConfig>
			<startColumn>7</startColumn>
			<endColumn>72</endColumn>
			<maxRedefines>2</maxRedefines>
		</globalCopybookParserConfig>
		
		<!-- Global settings for datamap file name and contents -->
		<globalGenConfig>
			<schemaName>VSAMADV</schemaName>
			<datamapName>TRAIN6</datamapName>
		</globalGenConfig>
		
		<!-- Global access method for VSAM datamaps -->
		<globalMapType>RRDS</globalMapType>
		
		<datamapInstances>
			
			<!-- Datamap 1: maxRedefines is 2 from global settings, resulting in 2 datamap records -->
			<vsamDatamapInstance>
				<importCopybookDetails>
					<filePath>
						<windowsPath>metadata\train61.cob</windowsPath>
					</filePath>
				</importCopybookDetails>
				<datamapProperties>
					<vsamFileName>
						<zosPath>COM.INFA.RRDS1</zosPath>
					</vsamFileName>
				</datamapProperties>
			</vsamDatamapInstance>
			
			<!-- Datamap 2: maxRedefines value overridden to 6, resulting in 6 datamap records -->
			<vsamDatamapInstance>
				<genConfig>
					<datamapName>TRN6REDEF</datamapName>
				</genConfig>
				<importCopybookDetails>
					<filePath>
						<windowsPath>metadata\train61.cob</windowsPath>
					</filePath>
					<parserConfig>
						<maxRedefines>6</maxRedefines>
					</parserConfig>
				</importCopybookDetails>
				<datamapProperties>
					<vsamFileName>
						<zosPath>COM.INFA.RRDS2</zosPath>
					</vsamFileName>
				</datamapProperties>
			</vsamDatamapInstance>
		</datamapInstances>
		
	</vsamGen>
</DatamapGeneration>

COBOL Copybook

This example imports metadata from the train61.cob copybook. For the contents of this copybook, see Example: Simple SEQ Data Map.

Log File

The log file for this example, vsam_advanced.log, contains the following lines:


2013-12-05 15:30:30 INFO [MDO_34613] Configuration for this run: location=, user name=, datamap directory=Output, control file=vsam_advanced.xml
2013-12-05 15:30:38 INFO [MDAdapter_34100] Finding metadata. Path filter = COM.INFA.RRDS1
2013-12-05 15:30:38 INFO [MDAdapter_34100] Finding metadata. Path filter = metadata\train61.cob
2013-12-05 15:30:38 INFO [MDAdapter_34101] Fetching file metadata\train61.cob
2013-12-05 15:30:38 INFO [MDO_34612] Copybook 'MASTER_REC' has 6 possible layouts (Maximum configured limit is 2).
2013-12-05 15:30:39 INFO [JDMX2_34801] 2 records imported.
2013-12-05 15:30:39 INFO [JDMX2_34802] 18 fields imported.
2013-12-05 15:30:39 INFO [JDMX2_34803] 2 tables imported.
2013-12-05 15:30:39 INFO [MDO_34619] Datamap file 'Output\VSAMADV.TRAIN6.dmp' was written.
2013-12-05 15:30:39 INFO [MDAdapter_34100] Finding metadata. Path filter = COM.INFA.RRDS2
2013-12-05 15:30:39 INFO [MDAdapter_34100] Finding metadata. Path filter = metadata\train61.cob
2013-12-05 15:30:39 INFO [MDAdapter_34101] Fetching file metadata\train61.cob
2013-12-05 15:30:39 INFO [MDO_34612] Copybook 'MASTER_REC' has 6 possible layouts (Maximum configured limit is 6).
2013-12-05 15:30:39 INFO [JDMX2_34801] 6 records imported.
2013-12-05 15:30:39 INFO [JDMX2_34802] 54 fields imported.
2013-12-05 15:30:39 INFO [JDMX2_34803] 6 tables imported.
2013-12-05 15:30:39 INFO [MDO_34619] Datamap file 'Output\VSAMADV.TRN6REDEF.dmp' was written.
2013-12-05 15:30:44 INFO [MDO_34614] Run complete: 2 datamap(s) created. 0 error and 0 warning messages.

Data Map Files

This example creates data maps with the following file names and relative paths:

Output\VSAMADV.TRAIN6.dmp

Output\VSAMADV.TRN6REDEF.dmp

Examples

Download Guide

Watch

Comments

Communities

Knowledge Base

Success Portal