Connect
Connects to a repository. The first time you use pmrep in either command line or interactive mode, you must use the Connect command. All commands require a connection to the repository except for the following commands:
- •Exit
- •Help
- •ListAllPrivileges
In the command line mode, pmrep uses the information specified by the last call to connect to the repository. If pmrep is called without a successful connection, it returns an error. In command line mode, pmrep connects to and disconnects from the repository with every command.
To use pmrep to perform tasks in multiple repositories in a single session, you must issue the Connect command each time you want to switch to a different repository. In the interactive mode, pmrep retains the connection until you exit pmrep or connect again. If you call Connect again, pmrep disconnects from the first repository and then connects to the second repository. If the second connection fails, the previous connection remains disconnected and you will not be connected to any repository. If you issue a command that requires a connection to the repository, and you are not connected to that repository, pmrep uses the connection information specified in the last successful connection made to the repository from any previous session of pmrep. pmrep retains information from the last successful connection until you use the Cleanup command.
The Connect command uses the following syntax:
connect
-r <repository_name>
{-d <domain_name> |
{-h <portal_host_name>
-o <portal_port_number>}}
[{ <user_name>
[-s <user_security_domain>]
[-x <password> |
-X <password_environment_variable>]} |
-u <connect_without_user_in_kerberos_mode>]
[-t <client_resilience>]
The following table describes pmrep Connect options and arguments:
Option | Argument | Description |
---|
-r | repository_name | Required. Name of the repository you want to connect to. |
-d | domain_name | Required if you do not use -h and -o. Name of the domain for the repository. If you use the -d option, do not use the -h and -o options. |
-h | portal_host_name | Required if you do not use -d. If you use the -h option, then you must also use the -o option. Gateway host name. |
-o | portal_port_number | Required if you do not use -d. If you use the -o option, then you must also use the -h option. Gateway port number. |
-n | user_name | Optional. User name used to connect to the repository. |
-s | user_security_domain | Required if you use LDAP authentication. Name of the security domain that the user belongs to. Default is Native. |
-x | password | Required if you use the -n option and you do not use the -X option. Password for the user name. The password is case sensitive. Use the -x or -X option, but not both. |
-X | password_ environment_variable | Required if you use the -n option and you do not use the -x option. Password environment variable. Use the -x or -X option, but not both. |
-u | connect_without _user_ in_kerberos_mode | Required. Connects to a Repository Service without a user name and password when the Informatica domain uses Kerberos authentication. Use the -u option to connect to the Repository Service if the repository has no content. |
-t | client_resilience | Optional. Amount of time in seconds that pmrep attempts to establish or reestablish a connection to the repository. If you omit the ‑t option, pmrep uses the timeout value specified in the INFA_CLIENT_RESILIENCE_TIMEOUT environment variable. If no value is specified in the environment variable, the default of 180 seconds is used. |