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

CreateListenerService

CreateListenerService

Creates a PowerExchange Listener Service in a domain. By default, the Listener Service is disabled when you create it. Run the infacmd isp EnableService command to enable the service.
The infacmd pwx CreateListenerService command uses the following syntax:
CreateListenerService [<-DomainName|-dn> domain_name] [<-UserName|-un> user_name] [<-Password|-pd> password] [<-SecurityDomain|-sdn> security_domain] [<-Gateway|-hp> gateway_host1:port gateway_host2:port...] [<-ResilienceTimeout|-re> timeout_period_in_seconds] <-ServiceName|-sn> service_name <-NodeName|-nn> node_name [<-LicenseName|-ln> license_name] [<-BackupNode|-bn> backup_node] <-StartParameters|-sp> start_parameters <-SvcPort|-sp> service_port
The following table describes infacmd pwx CreateListenerService options and arguments:
Option
Argument
Description
-DomainName
-dn
domain_name
Name of the Informatica domain. You can set the domain name with the -dn option or the environment variable INFA_DEFAULT_DOMAIN. If you set a domain name with both methods, the -dn option takes precedence.
-UserName
-un
user_name
Required if the domain uses Native or LDAP authentication. User name to connect to the domain. You can set the user name with the -un option or the environment variable INFA_DEFAULT_DOMAIN_USER. If you set a user name with both methods, the -un option takes precedence.
Optional if the domain uses Kerberos authentication. To run the command with single sign-on, do not set the user name. If you set the user name, the command runs without single sign-on.
-Password
-pd
password
Required if you specify the user name. Password for the user name. The password is case sensitive. You can set a password with the -pd option or the environment variable INFA_DEFAULT_DOMAIN_PASSWORD. If you set a password with both methods, the password set with the -pd option takes precedence.
-SecurityDomain
-sdn
security_domain
Required if the domain uses LDAP authentication. Optional if the domain uses native authentication or Kerberos authentication. Name of the security domain to which the domain user belongs. You can set a security domain with the -sdn option or the environment variable INFA_DEFAULT_SECURITY_DOMAIN. If you set a security domain name with both methods, the -sdn option takes precedence. The security domain name is case sensitive.
If the domain uses native or LDAP authentication, the default is Native. If the domain uses Kerberos authentication, the default is the LDAP security domain created during installation. The name of the security domain is the same as the user realm specified during installation.
-Gateway
-hp
gateway_host1:port gateway_host2:port ...
Required if -DomainName is not specified. The host names and port numbers for the gateway nodes in the domain.
ResilienceTimeout
-re
timeout_period_in_seconds
Optional. Amount of time in seconds that infacmd attempts to establish or
re-establish
a connection to the domain. You can set the resilience timeout period with the -re option or the environment variable INFA_CLIENT_RESILIENCE_TIMEOUT. If you set a the resilience timeout period with both methods, the -re option takes precedence.
-ServiceName
-sn
service_name
Required. Name of the Listener Service.
The name is not case sensitive. The name cannot exceed 128 characters or contain carriage returns, tabs, spaces, or the following characters:
/ * ? < > " |
-NodeName
-nn
node_name
Required. Name of the node where you want the Listener Service to run.
-LicenseName
-ln
license_name
Optional. License to assign to the service. If you do not select a license now, you can assign a license to the service later. Required before you can enable the service.
-BackupNode
-bn
backup_node
Optional. If the PowerCenter environment is configured for high availability, this option specifies the name of the backup node.
-StartParameters
-sp
start_parameters
Parameters to include when you start the Listener Service. Separate the parameters with the space character.
The
node_name
parameter is required.
You can include the following parameters:
  • node_name
    Required. Node name that identifies the Listener Service. This name must match the name in the LISTENER statement in the DBMOVER configuration file.
  • config=
    directory
    Optional. Specifies the full path and file name for any dbmover.cfg configuration file that you want to use instead of the default dbmover.cfg file. This alternative configuration file takes precedence over any alternative configuration file that you specify in the PWX_CONFIG environment variable.
  • license=
    directory
    /
    license_key_file
    Optional. Specifies the full path and file name for any license key file that you want to use instead of the default
    license.key
    file. The alternative license key file must have a file name or path that is different from that of the default file. This alternative license key file takes precedence over any alternative license key file that you specify in the PWX_LICENSE environment variable.
In the config and license parameters, you must provide the full path only if the file does
not
reside in the installation directory. Include quotes around any path and file name that contains spaces.
-SvcPort
-sp
service_port
Required. Port on which the Listener Service listens for commands from the Service Manager.

0 COMMENTS

We’d like to hear from you!