Command Reference > infacmd ms Command Reference > ListMappingParams
  

ListMappingParams

Lists the parameters for a mapping and creates a mapping parameter file that you can use when you run a mapping. The command returns an XML file with default values that you can update. Enter the parameter file name when you run the mapping with infacmd ms RunMapping.
The infacmd ms ListMappingParams command uses the following syntax:
ListMappingParams

<-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

[<-OutputFile|-o> output file_to_write_to]
The following table describes infacmd ms ListMappingParams options and arguments:
Option
Argument
Description
-DomainName
-dn
domain_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.
-ServiceName
-sn
service_name
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.
-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.
-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 perioud with both methods, the -re option takes precedence.
-Application
-a
application_name
Required. Name of the application that contains the mapping.
-Mapping
-m
mapping_name
Required. Name of the mapping.
- OutputFile
- o
output file_to_write_to
Optional. Path and file name of the parameter file to create. If you do not specify a file, the command displays the parameters in the command prompt.

ListMappingParams Output

The ListMappingParams command returns a parameter file as an XML file with default values that you can update.
For example, you run the ListMappingParams command on application "MyApp" and mapping "MyMapping." Mapping "MyMapping" has one parameter "MyParameter." The ListMappingParams command returns an XML file in the following format:
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<root xmlns="http://www.informatica.com/Parameterization/1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema">
<!--
<application name="MyApp">
<mapping name="MyMapping">
<!-- Specify deployed application specific parameters here. -->
</mapping>
</application>
-->
<project name="MyProject">
<mapping name="MyMapping">
<parameter name="MyParameter">DefaultValue</parameter>
</mapping>
</project>
</root>

The output XML file has the following top-level elements:
Application element
When you define a parameter within the application top-level element, the Data Integration Service applies the parameter value when you run the specified mapping in the specified application. You must include at least one project element within an application/mapping element.
By default, this top-level element is in comments. Remove the comments (!-- and -->) to use this element.
Project element
When you define a parameter within a project top-level element, the Data Integration Service applies the parameter value to the specified mapping in the project in any deployed application. The service also applies the parameter value to any mapping that uses the objects in the project.
If you define the same parameter in a project and an application top-level element in the same parameter file, the parameter value defined in the application element takes precedence.