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 autotune Command Reference
  10. Infacmd bg Command Reference
  11. infacmd ccps Command Reference
  12. infacmd cluster Command Reference
  13. infacmd cms Command Reference
  14. infacmd dis Command Reference
  15. infacmd dps Command Reference
  16. infacmd edl Command Reference
  17. Infacmd es Command Reference
  18. infacmd ihs Command Reference
  19. infacmd ipc Command Reference
  20. infacmd isp Command Reference
  21. infacmd ldm Command Reference
  22. infacmd mas Command Reference
  23. infacmd mi Command Reference
  24. infacmd mrs Command Reference
  25. infacmd ms Command Reference
  26. infacmd oie Command Reference
  27. infacmd ps Command Reference
  28. infacmd pwx Command Reference
  29. infacmd roh Command Reference
  30. infacmd rms Command Reference
  31. infacmd rtm Command Reference
  32. infacmd sch Command Reference
  33. infacmd search Command Reference
  34. infacmd sql Command Reference
  35. infacmd tdm Command Reference
  36. infacmd tools Command Reference
  37. infacmd wfs Command Reference
  38. infacmd ws Command Reference
  39. infacmd xrf Command Reference
  40. infacmd Control Files
  41. infasetup Command Reference
  42. pmcmd Command Reference
  43. pmrep Command Reference
  44. Working with pmrep Files

UpdateConnection

UpdateConnection

Updates the user name, password, connect string, and attributes for a database connection.
The command returns an “operation successfully completed” or returns “operation failed” message. A failure might occur for the following reasons:
  • The database type is not supported.
  • The connection object does not exist.
  • pmrep
    cannot acquire a lock on the object.
  • One of the required parameters is missing.
The UpdateConnection command uses the following syntax:
updateconnection -t <connection_subtype> -d <connection_name> [{[-u <new_user_name>] [{-p <new_password> | -P <new_password_environment_variable> [-w (use parameter in password) | -x (do not use parameter in password)]}]} | -K <connection_to_the_Kerberos_server>] [-c <new_connection_string>] [-a <attribute_name> -v <new_attribute_value>] [-s <connection type application, relational, ftp, loader or queue > ] [-l <code page>]
The following table describes
pmrep
UpdateConnection options and arguments:
Option
Argument
Description
-t
connection_subtype
Required. Displays the connection subtype.
For example, for a Relational connection, connection subtypes include Oracle, Sybase, and Microsoft SQL Server.
For FTP connections, the valid subtype is FTP.
For a list of predefined connection subtypes, see Connection Subtypes.
The connection subtype in the -t option must be valid for the associated connection type specified with the -s option.
-d
connection_name
Required. Database connection name.
-u
new_user_name
Optional. User name used for authentication when you connect to the relational database.
-p
new_password
Optional. Password used for authentication when you connect to the relational database. Use the -p or -P option, but not both.
To specify a parameter in the password, add the $Param prefix for the -p option and ensure that you use the -w option. Do not use a dollar sign ($) anywhere else in the -p option, and enter the parameter password without spaces. For example,
-p '$Param_abc' -w
-P
new_password_
environment_variable
Optional. Password environment variable used for authentication when you connect to the relational database. Use the -p or -P option, but not both.
-w
-
Optional. Enables you to use a parameter in the password option.
pmrep
uses the password specified with the -p or -P option as the name of the session parameter at run time.
Valid only if you use the -p or -P option.
If you do not use a parameter in the password option,
pmrep
uses the user password specified with the -p or -P option.
-x
-
Optional. Disables the use of password parameters if you use the parameter in password.
pmrep
uses the password specified with the -p or -P option.
-K
-
Optional. Indicates that the database that you are connecting to runs on a network that uses Kerberos authentication.
-c
new_connection_string
Optional. Connect string the Integration Service uses to connect to the relational database.
-a
attribute_name
Optional. Name of the attribute.
-v
new_attribute_value
Required if you use the -a option. New attribute value of the connection. Enter “yes” to enable new attributes, and “no” to disable new attributes.
-s
connection type application, relational, ftp, loader or queue
Optional. Type of connection. A connection can be one of the following types:
  • Application
  • FTP
  • Loader
  • Queue
  • Relational
Default is relational.
The connection subtype in the -t option must be valid for the associated connection type specified with the -s option.
-l
code page
Optional. Code page associated with the connection.
For more information about connection subtypes, see Connection Subtypes.


Updated August 15, 2019