English
  • Shared Content for Data Engineering 10.2 HotFix 2
  • All Products

Table of Contents

Search

  1. Preface
  2. Command Line Programs and Utilities
  3. Installing and Configuring Command Line Utilities
  4. Using the Command Line Programs
  5. Environment Variables for Command Line Programs
  6. Using infacmd
  7. infacmd as Command Reference
  8. infacmd aud Command Reference
  9. Infacmd bg Command Reference
  10. infacmd cluster Command Reference
  11. infacmd cms Command Reference
  12. infacmd dis Command Reference
  13. Infacmd es Command Reference
  14. infacmd ihs Command Reference
  15. infacmd ipc Command Reference
  16. infacmd isp Command Reference
  17. infacmd ldm Command Reference
  18. infacmd mrs Command Reference
  19. infacmd ms Command Reference
  20. infacmd oie Command Reference
  21. infacmd ps Command Reference
  22. infacmd pwx Command Reference
  23. infacmd rms Command Reference
  24. infacmd rtm Command Reference
  25. infacmd sch Command Reference
  26. infacmd search Command Reference
  27. infacmd sql Command Reference
  28. infacmd tdm Command Reference
  29. infacmd wfs Command Reference
  30. infacmd ws Command Reference
  31. infacmd xrf Command Reference
  32. infacmd Control Files
  33. infasetup Command Reference
  34. pmcmd Command Reference
  35. pmrep Command Reference
  36. Working with pmrep Files

Command Reference

Command Reference

Back Next

SwitchConnection

SwitchConnection

Changes the name of an existing connection. When you use SwitchConnection, the Repository Service replaces the relational database connections for all sessions using the connection in one of the following locations:
  • Source connection
  • Target connection
  • Connection Information property in Lookup transformations
  • Connection Information property in Stored Procedure transformations
  • $Source Connection Value session property
  • $Target Connection Value session property
If the repository contains both relational and application connections with the same name and you specified the connection type as relational in
all
 locations in the repository, the Repository Service replaces the relational connection.
For example, you have a relational and an application source, each called ITEMS. In a session, you specified the name ITEMS for a relational source connection instead of Relational:ITEMS. When you use SwitchConnection to replace the relational connection ITEMS with another relational connection,
pmrep
 does not replace any relational connection in the repository because it cannot determine the connection type for the source connection entered as ITEMS.
The SwitchConnection command uses the following syntax:
switchconnection 

-o <old_connection_name> 

-n <new_connection_name>
The following table describes
pmrep
 SwitchConnection options and arguments:
Option
Argument
Description
-o
old_connection_name
Required. Name of the connection you want to change.
-n
new_connection_name
Required. New connection name.