Shared Content for Data Engineering 10.4.0
- All Products
runMapping <-DomainName|-dn> domain_name <-ServiceName|-sn> service_name <-UserName|-un> user_name <-Password|-pd> password [<-SecurityDomain|-sdn> security_domain] [<-ResilienceTimeout|-re> timeout_period_in_seconds] <-Application|-a> application_name <-Mapping|-m> mapping_name [<-Wait|-w> true|false] [<-ParameterFile|-pf> parameter_file_path] [<-ParameterSet|-ps> parameter_set_name] [<-OperatingSystemProfile|-osp> operating_system_profile_name] [<-NodeName|-nn> node_name] [<-OptimizationLevel|-ol> optimization_level] [<-PushdownType|-pt> pushdown_type] [<-CustomProperties|-cp> custom_properties] [<-RuntimeInstanceName|-rin> runtime_instance_name]
Required. 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.
Required. Name of the Data Integration Service to run the mapping. The application that contains the mapping must be deployed to a Data Integration Service.
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.
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.
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.
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 perioud with both methods, the -re option takes precedence.
Required. Name of the application that contains the mapping.
Required. Name of the mapping to run.
Optional. Indicates whether infacmd waits for the mapping to complete before returning to the shell or command prompt. If true, infacmd returns to the shell or command prompt after the mapping completes. You cannot run subsequent commands until the mapping completes. If false, infacmd returns to the shell or command prompt immediately. You do not have to wait for the mapping to complete before running the next command. Default is false.
Optional. Name and path of the parameter file. Do not enter a parameter file and a parameter set.
Optional. Name of a parameter set to use at run time. The parameter set option overrides any parameter set deployed with the application. Do not enter a parameter set and a parameter file.
Optional. Name of the operating system profile to run the mapping.
If you do not use this option when the Data Integration Service is enabled to use operating system profiles, the Data Integration Service runs the mapping with the default profile.
Optional. Name of the node in a Data Integration Service grid to dispatch the mapping job to. A Data Integration Service process must be running on the node.
If you do not use this option, the mapping job is dispatched to the node where the master Data Integration Service process runs.
Optional. Controls the optimization methods that the Data Integration Service applies to the mapping. Enter the numeric value that is associated with the optimization level that you want to configure. Enter one of the following values:
Default is -1 (Auto).
Optional. Controls the pushdown type that the Data Integration Service applies to a mapping. Enter one of the following values:
This option overrides the pushdown type set in the mapping run-time properties or in a parameter file or parameter set.
If you do not use this option, the Data Integration Service applies the pushdown type set in the mapping run-time properties or in a parameter file or parameter set.
Optional. Define custom properties for a mapping at the request of Informatica Global Customer Support.
Enter custom properties as name-value pairs separated by semicolons. For example:
To enter a value that contains a space or other non-alphanumeric character, enclose the value in quotation marks.
Optional. Name of the run-time instance of the mapping. The name must be unique.
The run-time instance name cannot contain slash characters.
You must specify a run-time instance name in runMapping to persist mapping outputs and run the commands listMappingPersistedOutputs and deleteMappingPersistedOutputs.
You can set the value as follows to standardize run-time instance names:
If all the mappings in an application use the same persisted mapping outputs, use the application name.
If the mappings use different persisted mapping outputs, use a combination of the application name, mapping name, and parameter set or file name.
Updated November 11, 2021