Table of Contents

Search

  1. Preface
  2. Introduction to PowerExchange Utilities
  3. createdatamaps - Data Map Creation Utility
  4. DTLCCADW - Adabas PCAT Utility
  5. DTLCUIML - IMS Log Marker Utility
  6. DTLINFO - Release Information Utility
  7. DTLINFOX - Enhanced Release Information Utility
  8. DTLREXE - Remote Execution Utility
  9. DTLUAPPL - Restart Token Utility
  10. DTLUCBRG - Batch Registration Utility
  11. DTLUCDEP - CDEP Maintenance Utility
  12. DTLUCSR2 - IDMS SR2 and SR3 Records Utility
  13. DTLUCUDB - DB2 for Linux, UNIX, and Windows CDC Utility
  14. DTLULCAT and DTLULOGC - IDMS Log Catalog Utilities
  15. DTLURDMO - Data Map Utility
  16. DTLUTSK - Task Control Utility
  17. EDMLUCTR - Log Scan and Print Utility
  18. EDMUOPTS - Service Aid Utility
  19. EDMXLUTL - Event Marker Utility
  20. HOSTENT - TCP/IP Address Reporter Utility
  21. PWXCATMY - MySQL Catalog Utility
  22. PWXUCCLPRT - Print Log Summary Utility
  23. PWXUCDCT - Logger for Linux, UNIX, and Windows Utility
  24. PWXUCREG - Capture Registration Utility
  25. PWXUMAP - Map List Utility
  26. PWXUCRGP - Capture Registrations Print Utility
  27. PWXUDMX - Data Maps Update Time ECSA Memory Utility
  28. PWXUGSK - SSL Reporting Utility
  29. PWXUSSL - PowerExchange SSL Reporting Utility
  30. WRKJRNLCKE- Journal Lock Table Utility for IBM i

XM_COPY GETREGTAG Statement

XM_COPY GETREGTAG Statement

The GETREGTAG statement specifies the target registration from which to obtain the registration tag. If you defined BI/CI fields in extraction maps and do not want to re-create them manually after using REG_COPY with CREATEXMAP=Y, you can get the correct registration tag from the registration that was copied to the target.
The GETREGTAG statement has the following parameters:
DBTYPE
A three-character mnemonic that indicates the data source type. Options are:
  • ADA
    for Adabas
  • AS4
    for DB2 for i (i5/OS)
  • DB2
    for DB2 for z/OS
  • DCM
    for Datacom
  • IDL
    for IDMS log-based
  • IMS
    for IMS
  • MSS
    for Microsoft SQL Server
  • MYS
    for MySQL
  • ORA
    for Oracle
  • PGS
    for PostgreSQL
  • UDB
    for DB2 for Linux, UNIX, and Windows
  • VSM
    for VSAM
Use
DB2
only for DB2 on z/OS. Use
AS4
or
UDB
for DB2 products on other platforms.
INPUT=
alternative_registration_data set_or_folder
Optional. Specifies an alternative data set or folder where the registrations are kept.
INSTANCE
The source instance for your registrations. The value type depends on the source database type that you specify in the DBTYPE parameter.
Based on the DBTYPE option, enter one of the following values:
  • For
    ADA
    , enter an Adabas nucleus name.
  • For
    AS4
    , enter a DB2 for i (i5/OS) instance value that matches the INST parameter value in the AS4J CAPI CONNECTION statement in the DBMOVER member of the
    dtllib
    /CFG file. If you use PowerExchange Condense, this instance value must also match the DBID parameter value in the CAPTPARM member.
  • For
    DB2
    , enter a DB2 subsystem ID (SSID).
  • For
    DCM
    , enter a Datacom Multi-User Facility (MUF) name.
  • For
    IDL
    , enter an IDMS log-based CDC instance value that matches the
    registration_logsid
    parameter in the LOGSID statement in the DBMOVER configuration member.
  • For
    IMS
    , enter an IMS subsystem ID that matches the
    ims_ssid
    parameter value in the IMSID statement in the DBMOVER configuration member.
  • For
    MSS
    , optionally enter a unique user-defined instance identifier for the SQL Server database server and database name combination defined in the MSSOPTS DBSERVER and DBNAME parameters. Maximum length is seven characters. This identifier is incorporated into the names of the extraction maps that the utility creates. If you use the PowerExchange Logger for Linux, UNIX, and Windows, ensure that the instance identifier matches the DBID parameter value in the Logger configuration file. If you do not enter this instance value, PowerExchange generates a unique instance identifier that is composed of all or part of the publication database name followed by a 3-digit number if a number is required to make the identifier unique.
    This INSTANCE parameter is useful in migration scenarios. If you need to deploy change capture from one environment to another, such as from test to production, and you do
    not
    define an instance identifier, PowerExchange uses the generated instance identifier in the new environment. The generated instance identifier might be different than the one in the original source environment. To avoid having to update the extraction map names in PowerCenter workflows and edit the DBID parameter value for the PowerExchange Logger, enter an instance identifier in the INSTANCE parameter that matches the instance identifier in the original environment when creating registrations for the new environment.
    In this migration scenario, ensure that the dbmover.cfg configuration files in the original environment and new environment specify unique paths in CAP_PATH and CAPT_XTRA statements.
  • For
    MYS
    , enter a unique, user-defined instance identifier for the MySQL database server. Maximum length is seven characters. This identifier is used to identify a set of registrations for tables in the database on the MySQL server. This identifier is also incorporated into the names of the extraction maps that the utility creates. If you use the PowerExchange Logger for Linux, UNIX, and Windows, ensure that this instance identifier matches the DBID parameter value in the Logger configuration file.
  • For
    ORA
    , enter the user-defined collection ID for the Oracle instance that matches the
    collection_id
    parameter in the ORACLEID statement in the PowerExchange DBMOVER configuration member.
  • For
    PGS
    , enter a unique, user-defined instance identifier for the PostgreSQL database server and database name combination defined in the PGSOPTS DBSERVER and DBNAME parameters. Maximum length is seven characters. This identifier is incorporated into the names of the extraction maps that the utility creates. If you use the PowerExchange Logger for Linux, UNIX, and Windows, ensure that the instance identifier matches the DBID parameter value in the Logger configuration file. If you do not enter this instance value, PowerExchange generates a unique instance identifier that is composed of all or part of the database name followed by a three-digit number.
  • For
    UDB
    , enter a DB2 for Linux, UNIX, and Windows database name.
  • For
    VSM
    , enter a VSAM collection identifier.
LOC=SOURCE|TARGET
Read registrations from source or target locations as previously defined. To read registrations from source locations, specify SOURCE. To read registrations from target locations, specify TARGET. Default is TARGET.

0 COMMENTS

We’d like to hear from you!