Release Guide > New Features (10.0) > Command Line Programs
  

Command Line Programs

This section describes new and changed commands in version 10.0.

infacmd bg Command

The following table describes a new infacmd bg command:
Command
Description
upgradeRepository
Upgrades the Business Glossary data in the Model repository. Run this command after you upgrade the domain.

infacmd dis Commands

The following table describes new infacmd dis commands:
Command
Description
addParameterSetEntries
Adds entries to a parameter set for a mapping or workflow that is deployed as an application.
deleteParameterSetEntries
Deletes entries from a parameter set for a mapping or workflow that is deployed as an application. You can delete specific parameter set entries or you can delete all of the parameter set entries.
listApplicationObjects
Lists the objects that an application contains.
listComputeOptions
Lists Data Integration Service properties for a node with the compute role.
listParameterSetEntries
Lists the entries in a parameter set.
listParameterSets
List the parameter sets in an application.
updateComputeOptions
Updates Data Integration Service properties for a node with the compute role. Use the command to override Data Integration Service properties for a specific compute node.
updateParameterSetEntries
Updates entries in a parameter set for a mapping or workflow in an application. Enter parameter name-value pairs to update, separated by spaces.
stopBlazeService
Stops the components of the Blaze engine from running.
The following table describes changes to infacmd dis command options:
Command
Description
UpdateServiceOptions
The following options are added for memory allocation:
  • - MappingServiceOptions.MaxMemPerRequest
  • - ProfilingServiceOptions.MaxMemPerRequest
  • - SQLServiceOptions.MaxMemPerRequest
  • - WSServiceOptions.MaxMemPerRequest
Use these options to specify the maximum amount of memory, in bytes, that the Data Integration Service can allocate for a mapping, profile, SQL service, or web service request.
The following options are added for workflow operations:
  • - Modules.WorkflowOrchestrationService
    • Use the option to enable or disable the module that runs workflows.
  • - WorkflowOrchestrationServiceOptions.DBName
    • Use the option to specify the connection name of the database that stores run-time metadata for workflows.
The ExecutionOptions.OutOfProcessExecution option can be set to the following values:
  • - IN_PROCESS. Runs jobs in the Data Integration Service process.
  • - OUT_OF_PROCESS. Runs jobs in separate DTM processes on the local node.
  • - OUT_OF_PROCESS_REMOTE. Runs jobs in separate DTM processes on remote nodes.
Previously, the option could be set to true (IN_PROCESS) or false (OUT_OF_PROCESS).
The following options are moved from the UpdateServiceProcessOptions command to the UpdateServiceOptions command:
  • - ExecutionOptions.MaxExecutionPoolSize
  • - ExecutionOptions.MaxMemorySize
  • - ExecutionOptions.MaxMappingParallelism
  • - ExecutionOptions.DisHadoopPrincipal
  • - ExecutionOptions.DisHadoopKeytab
  • - ExecutionOptions.TemporaryDirectories
  • - ExecutionOptions.DisHomeDirectory
  • - ExecutionOptions.CacheDirectory
  • - ExecutionOptions.SourceDirectory
  • - ExecutionOptions.TargetDirectory
  • - ExecutionOptions.RejectFilesDirectory
  • - ExecutionOptions.HadoopInfaHomeDir
  • - ExecutionOptions.HadoopDistributionDir
  • - ExecutionOptions.DisHadoopDistributionDir
The following email server options are moved to the isp UpdateSMTPOptions command for scorecard notifications:
  • - EmailServerOptions.SMTPServerHost
  • - EmailServerOptions.SMTPServerPort
  • - EmailServerOptions.SMTPServerUser
  • - EmailServerOptions.SMTPServerPassword
  • - EmailServerOptions.SenderEmailId
The following email server options are removed for scorecard notifications:
  • - EmailServerOptions.SMTPSwitchAuthenticationOn
  • - EmailServerOptions.SMTPSwitchTLSOn
  • - EmailServerOptions.SMTPSwitchSSLOn
The following email server options are moved to the es UpdateSMTPOptions command for workflow notifications:
  • - EmailServerOptions.SMTPServerHost
  • - EmailServerOptions.SMTPServerPort
  • - EmailServerOptions.SMTPServerUser
  • - EmailServerOptions.SMTPServerPassword
  • - EmailServerOptions.SMTPSwitchAuthenticationOn
  • - EmailServerOptions.SenderEmailId
  • - EmailServerOptions.SMTPSwitchTLSOn
  • - EmailServerOptions.SMTPSwitchSSLOn
The following email server options are removed:
  • - EmailServerOptions.SMTPServerConnectionTimeout
  • - EmailServerOptions.SMTPServerCommunicationTimeout
The following options are removed for workflow operations:
  • - HumanTaskServiceOptions.HTConnectionName
  • - Modules.HumanTaskService
  • - Modules.WorkflowService
  • - WorkflowServiceOptions.HTDataIntegrationServiceName
UpdateServiceProcessOptions
The ExecutionOptions.MaxSessionSize option is obsolete. The remaining execution options are moved to the UpdateServiceOptions command.

infacmd es Commands

The new infacmd es program manages the Email Service.
The following table describes the new infacmd es commands:
Command
Description
ListServiceOptions
Returns a list of properties that are configured for the Email Service.
UpdateServiceOptions
Updates Email Service properties.
UpdateSMTPOptions
Updates the email server properties for the Email Service.

infacmd hts Commands

All infacmd hts commands are obsolete.
The following table describes the obsolete infacmd hts commands and identifies the commands that you can use to perform the corresponding actions in version 10.0:
Command
Description
CreateDB
Creates the database tables that store run-time metadata for Human tasks.
In version 10.0, all run-time metadata for workflows is stored in a common set of tables. Use infacmd wfs CreateTables to create the workflow metadata tables.
DropDB
Drops the database tables that store run-time metadata for Human tasks.
In version 10.0, all run-time metadata for workflows is stored in a common set of tables. Use infacmd wfs DropTables to drop the workflow metadata tables.
Exit
Stops a Human task and passes the records that the task identifies to the next stage in the workflow.
Use infacmd wfs BulkComplete to stop a Human task and to pass the records that the task identifies to the next stage in the workflow.

infacmd isp Commands

The following table describes new infacmd isp commands:
Command
Description
GetSystemLogDirectory
Prints the system log directory.
ListNodeRoles
Lists all roles on a node in the domain.
UpdateNodeRole
Updates the role on a node in the domain. You can enable or disable the service role or the compute role on a node.
The following table describes changes to infacmd isp command options:
Command
Description
AddDomainNode
The following options are added:
  • - EnableServiceRole
  • - EnableComputeRole
Use these options to enable the service role or the compute role on a node when you add the node to the domain.
AddNodeResource
The following options are added:
  • - ResourceCategory. Use this option to specify that the resource is for the PowerCenter Integration Service.
  • - ResourceValue. This option is reserved for future use.
CreateConnection
The connection options for the Hadoop connection are added.
DisableNodeResource, EnableNodeResource, ListNodeResources, and RemoveNodeResource
The ResourceCategory option is added. Use this option to specify that the resource is for the PowerCenter Integration Service.
GetLog
The following service types are added for the ServiceType option:
  • - ES. Email Service
  • - SCH. Scheduler Service
  • - RMS. Resource Manager Service
GetNodeName
The Outputfile option is added. Use this option with a file name and path to print the node name in a file.
ListNodes
The NodeRole option is added. Use this option to list nodes with a specified role.
ListServices
The following service types are added for the ServiceType option:
  • - ES. Email Service
  • - SCH. Scheduler Service
  • - RMS. Resource Manager Service
PurgeMonitoring
The NumDaysToRetainDetailedStat option is added. Use this option to configure the number of days of detailed historical data that are retained in the Model repository when the Data Integration Service purges statistics.
UpdateMonitoringOptions
The DetailedStatisticsExpiryTime option is added. Use this option to configure when the Data Integration Service purges detailed statistics from the Model repository.
The valid StatisticsExpiryTime values are changed. Minimum is 0. Maximum is 366. Default is 180.

infacmd mrs Commands

The following table describes new infacmd mrs commands:
Command
Description
CheckInObject
Checks in a single object that is checked out. The object is checked in to the Model repository.
CreateFolder
Creates a folder in a project in a Model repository.
CreateProject
Creates a project in the default Model repository.
DeleteFolder
Deletes a folder from a project in a Model repository.
DeleteProject
Deletes a project in a Model repository.
ListCheckedOutObjects
Displays a list of objects that are checked out by a user.
ListFolders
Lists the names of all of the folders in the project folder path that you specify.
ListLockedObjects
Displays a list of objects that are locked by a user.
PopulateVCS
Synchronizes the Model repository with a version control system.
ReassignCheckedOutObject
Reassigns the ownership of a checked-out object to another user.
RenameFolder
Renames a folder in a project.
UndoCheckout
Reverts the checkout of a Model repository object.
UnlockObject
Unlocks a Model repository object that is locked by a user.
The following table describes changes to infacmd mrs command options:
Command
Description
UpdateServiceOptions
The following options are added:
  • - VCS.Host
  • - VCS.Port
  • - VCS.User
  • - VCS.Password
  • - VCS.Type
  • - VCS.MRSPath
Use these options to configure versioning for the Model repository.

infacmd ms Commands

The following table describes new infacmd ms commands:
Command
Description
GetRequestLog
Writes the mapping log to the specified file.
UpgradeMappingParameterFile
Converts a parameter file you created in a previous Informatica version to a parameter file format that is valid for Informatica version 10.0.
The following table describes updated infacmd ms command options:
Command
Description
RunMapping
The following options are added:
  • - OptimizationLevel. Use to control the optimization methods that the Data Integration Service applies to a mapping.
  • - PushdownType. Use to control the pushdown type that the Data Integration Service applies to a mapping.
  • - CustomProperties. Use to define custom properties for a mapping at the request of Informatica Global Customer Support.

infacmd rms Commands

The new infacmd rms program manages the Resource Manager Service.
The following table describes the new infacmd rms commands:
Command
Description
ListComputeNodeAttributes
Lists the compute node attributes that have been overridden for the specified node or for all nodes.
ListServiceOptions
Lists the properties for the Resource Manager Service.
SetComputeNodeAttributes
Overrides the compute node attributes for the specified node.
UpdateServiceOptions
Updates Resource Manager Service properties.

infacmd sch Commands

The new infacmd sch program manages the Scheduler Service.
The following table describes the new infacmd sch commands:
Command
Description
CreateSchedule
Creates a schedule for one or more deployed mapping or workflow objects.
DeleteSchedule
Deletes one or more schedules.
ListSchedule
Returns a list of jobs that are running on a schedule.
ListServiceOptions
Returns a list of the properties that are configured for the Scheduler Service.
ListServiceProcessOptions
Returns a list of the properties that are configured for a Scheduler Service process.
PauseAll
Pauses all schedules.
PauseSchedule
Pauses a schedule.
ResumeAll
Resumes all schedules.
ResumeSchedule
Resumes a schedule.
UpdateSchedule
Updates a schedule configuration.
UpdateServiceOptions
Updates the properties for the Scheduler Service.
UpdateServiceProcessOptions
Updates the properties for a Scheduler Service process.
Upgrade
Upgrades the Scheduler Service configuration.

infacmd wfs Commands

The following table describes new infacmd wfs commands:
Command
Description
BulkComplete
Stops operations for a Human task and passes the records that the task identifies to the next stage in the workflow.
CreateTables
Creates the database tables that store run-time metadata for workflows.
DropTables
Drops the database tables that store run-time metadata for workflows.
ListMappingPersistedOutputs
Lists the state of each persisted Mapping output from a Mapping task instance that the command specifies.
SetMappingPersistedOutputs
Updates the persisted mapping outputs for a Mapping task instance that you specify or sets the persisted mapping outputs to null values.
UpgradeParameterFile
Upgrades a parameter file to verify that the parameter values in the file are valid in the current release. When you run the command, you identify a parameter file to upgrade and you specify a target file to contain the valid parameter values.
The following table describes updated infacmd wfs command options:
Command
Description
abortWorkflow
The RuntimeInstanceID option is renamed to InstanceId. The option identifies the workflow instance to abort.
The Wait option is removed.
cancelWorkflow
The RuntimeInstanceID option is renamed to InstanceId. The option identifies the workflow instance to cancel.
The Wait option is removed.
recoverWorkflow
The RuntimeInstanceID option is renamed to InstanceId. The option identifies the workflow instance to recover.
The Wait option is removed.
startWorkflow
The ParameterSet option is added.
The option specifies the name of parameter set that the workflow use at run time.

infasetup Commands

The following table describes the new SystemLogDirectory option:
Command
Description
DefineDomain
DefineGatewayNode
DefineWorkerNode
UpdateGatewayNode
UpdateWorkerNode
The SystemLogDirectory option is added. Use this option to designate a custom location for logs.
For more information, see the Informatica 10.0 Command Reference.