Command Reference > pmrep Command Reference > CreateConnection
  

CreateConnection

Creates a source or target connection in the repository. The connection can be a relational, application, or an FTP connection. Relational database connections for each relational subtype require a subset of all CreateConnection options and arguments. For example, Oracle connections do not accept the -z, -d, or -t options. Use the -k option to specify attributes for application connections.
The CreateConnection command uses the following syntax:
createconnection

-s <connection_type>

-n <connection_name>

[{-u <user_name>

[-p <password> |

-P <password_environment_variable>]}|

-K <connection_to_the_Kerberos_server>]

[-c <connect_string> (required for Oracle, Informix, DB2, Microsoft SQL Server, ODBC, and NetezzaRelational)]

[-l <code_page>]

[-r <rollback_segment> (valid for Oracle connection only)]

[-e <connection_environment_SQL>]

[-f <transaction_environment_SQL>]

[-z <packet_size> (valid for Sybase ASE and MS SQL Server connection)]

[-b <database_name> (valid for Sybase ASE, Teradata and MS SQL Server connection)]

[-v <server_name> (valid for Sybase ASE and MS SQL Server connection)]

[-d <domain_name> (valid for MS SQL Server connection only)]

[-t (enable trusted connection, valid for MS SQL Server connection only)]

[-a <data_source_name> (valid for Teradata connection only)]

[-x (enable advanced security, lets users give Read, Write and Execute permissions only for themselves.)]

[-k <connection_attributes> (attributes have the format name=value;name=value; and so on)]

[-y (Provider Type (1 for ODBC and 2 for OLEDB), valid for MS SQL Server connection only)]

[-m (UseDSN, valid for MS SQL Server connection only)]
The following table describes pmrep CreateConnection options and arguments:
Option
Argument
Description
-s
connection_type
Required. Type of connection.
A connection can be one of the following types:
  • - Application
  • - FTP
  • - Relational
For example, to create a Salesforce connection, use the following syntax:
-s "salesforce connection"
-n
connection_name
Required. Name of the connection.
-u
user_name
Required for some connection types. User name used for authentication.
-p
password
Required for some connection types. Password used for authentication when you connect to the relational database. Use the -p or -P option, but not both. If you specify a user name and you do not specify -p or -P, pmrep prompts you for the password.
-P
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. If you do not use the -p or -P option, pmrep prompts you for the password.
-K
connection_to_the_Kerberos_server
Optional. Indicates that the database that you are connecting to runs on a network that uses Kerberos authentication.
-c
connect_string
Connect string the Integration Service uses to connect to the relational database.
-l
code_page
Required for some connection types. Code page associated with the connection.
-r
rollback_segment
Optional. Valid for Oracle connections. The name of the rollback segment. A rollback segment records database transactions that allow you to undo the transaction.
-e
connection_
environment_sql
Optional. Enter SQL commands to set the database environment when you connect to the database. The Integration Service executes the connection environment SQL each time it connects to the database.
-f
transaction_
environment_sql
Optional. Enter SQL commands to set the database environment when you connect to the database. The Integration Service executes the transaction environment SQL at the beginning of each transaction.
-z
packet_size
Optional. Valid for Sybase ASE and Microsoft SQL Server connections. Optimizes the ODBC connection to Sybase ASE and Microsoft SQL Server.
-b
database_name
Optional. Name of the database. Valid for Sybase ASE and Microsoft SQL Server connections.
-v
server_name
Optional Name of the database server. Valid for Sybase ASE and Microsoft SQL Server connections.
-d
domain_name
Optional Valid for Microsoft SQL Server connections. The name of the domain. Used for Microsoft SQL Server.
-t
-
Optional. Valid for Microsoft SQL Server connections. If enabled, the Integration Service uses Windows authentication to access the Microsoft SQL Server database. The user name that starts the Integration Service must be a valid Windows user with access to the Microsoft SQL Server database.
-a
data_source_name
Optional Teradata ODBC data source name. Valid for Teradata connections.
-x
-
Enables enhanced security. Grants you read, write, and execute permissions. Public and world groups are not granted any permissions. If this option is not enabled, all groups and users are granted read, write, and execute permissions.
-k
connection_attributes
Enables user-defined connection attributes. Attributes have the format <name>=<value>;<name>=<value>.
Note: Do not add a space before the attribute name.
-y
-
Enables the provider type value. You can specify the following provider types:
  • - 1 for ODBC
  • - 2 for Oledb(Deprecated)
-m
-
Enables the Use DSN attribute.
The PowerCenter Integration Service retrieves the database and server names from the DSN.

Specifying the Database Type

When you create a connection, you must enter a database type using the string associated with that database type in pmrep. The strings are not case sensitive. Use quotes when entering a string with spaces in an argument.
The following table describes the required pmrep database type strings according to database:
Database
Database Type String
HTTP Transformation
Http Transformation
IBM DB2 for Linux, UNIX, and Windows
DB2
Informix
Informix
JMS
JMS Connection
JNDI
JNDI Connection
LMAPI Target
LMAPITarget
Microsoft SQL Server
Microsoft SQL Server
ODBC
ODBC
Oracle
Oracle
PeopleSoft DB2
PeopleSoft DB2
PeopleSoft Informix
PeopleSoft Informix
PeopleSoft MS SQL Server
PeopleSoft MsSqlserver
PeopleSoft Oracle
PeopleSoft Oracle
PeopleSoft Sybase
PeopleSoft Sybase
PowerChannel for DB2
PowerChannel for DB2
PowerChannel for MS SQL Server
PowerChannel for MS SQL Server
PowerChannel for ODBC
PowerChannel for ODBC
PowerChannel for Oracle
PowerChannel for Oracle
DB2 for i5/OS, PowerExchange bulk data movement
PWX DB2i5OS
DB2 for i5/OS, PowerExchange change data capture
PWX DB2i5OS CDC Change
DB2 for i5/OS, PowerExchange change data capture
PWX DB2i5OS CDC Real Time
DB2 for Linux, UNIX, and Windows, PowerExchange bulk data movement
PWX DB2LUW
DB2 for Linux, UNIX, and Windows, PowerExchange change data capture
PWX DB2LUW CDC Change
DB2 for Linux, UNIX, and Windows, PowerExchange change data capture
PWX DB2LUW CDC Real Time
DB2 for z/OS, PowerExchange bulk data movement
PWX DB2zOS
DB2 for z/OS, PowerExchange change data capture
PWX DB2zOS CDC Change
DB2 for z/OS, PowerExchange change data capture
PWX DB2zOS CDC Real Time
Microsoft SQL Server, PowerExchange bulk data movement
PWX MSSQLServer
Microsoft SQL Server, PowerExchange change data capture
PWX MSSQL CDC Change
Microsoft SQL Server, PowerExchange change data capture
PWX MSSQL CDC Real Time
Nonrelational, PowerExchange bulk data movement
PWX NRDB Batch
Nonrelational, PowerExchange change data capture
PWX NRDB CDC Change
Nonrelational, PowerExchange change data capture
PWX NRDB CDC Real Time
Nonrelational Lookup, PowerExchange
PWX NRDB Lookup
Oracle, PowerExchange bulk data movement
PWX Oracle
Oracle, PowerExchange change data capture
PWX Oracle CDC Change
Oracle, PowerExchange change data capture
PWX Oracle CDC Real Time
Sybase, PowerExchange bulk data movement
PWX Sybase
Salesforce
Salesforce Connection
SAP BW
SAP BW
SAP BWOHS READER
SAP_BWOHS_READER
SAP R3
SAP R3
SAP RFC/BAPI Interface
SAP RFC/BAPI Interface
SAP/ALE IDoc Reader
SAP_ALE_IDoc_Reader
SAP/ALE IDoc Writer
SAP_ALE_IDoc_Writer
Siebel DB2
Siebel DB2
Siebel Informix
Siebel Informix
Siebel MS SQL Server
Siebel MsSqlserver
Siebel Oracle
Siebel Oracle
Siebel Sybase
Siebel Sybase
Sybase
Sybase
Teradata
Teradata
Teradata FastExport
Teradata FastExport Connection
Web Services Consumer
Web Services Consumer
webMethods Broker
webMethods Broker

Specifying the Database Code Page

The -l option specifies the code page for the database connection. Enter the code page name you want to assign to the database connection. For example, to assign the US-ASCII code page to the database connection, enter the code page name “US-ASCII.”
Changing the database connection code page can cause data inconsistencies if the new code page is not compatible with the source or target database connection code pages. Also, if you configure the Integration Service for data code page validation, changing the database connection code page can cause sessions to fail if the source database connection code page is not a subset of the target database connection code page.