StartTask
开始任务。
StartTask 命令在命令行模式下使用以下语法:
pmcmd StartTask
<<-service|-sv> service [<-domain|-d> domain] [<-timeout|-t> timeout]>
<<-user|-u> username|<-uservar|-uv> userEnvVar>
<<-password|-p> password|<-passwordvar|-pv> passwordEnvVar>
[<<-usersecuritydomain|-usd> usersecuritydomain|<-usersecuritydomainvar|-usdv> userSecuritydomainEnvVar>]
[<-folder|-f> folder]
<-workflow|-w> workflow
[<-paramfile> paramfile]
[-wait|-nowait]
[<-recovery|-norecovery>]
[<-runinsname|-rin> runInsName]
taskInstancePath
StartTask 命令在交互模式下使用以下语法:
pmcmd StartTask
[<-folder|-f> folder]
<-workflow|-w> workflow
<-paramfile> paramfile]
[-wait|-nowait]
[<-recovery|-norecovery>]
[<-runinsname|-rin> runInsName]
taskInstancePath
下表描述了 pmcmd StartTask 选项和参数:
选项 | 参数 | 说明 |
---|
-service -sv | 服务 | 必需。 集成服务名称。 |
-domain -d | 域 | 可选。 域名。 |
-timeout -t | 超时 | 可选。 pmcmd 尝试连接到集成服务所用的时间,以秒为单位。 如果忽略 -timeout 选项,则 pmcmd 使用在环境变量 INFA_CLIENT_RESILIENCE_TIMEOUT 中指定的超时值。 如果未设置环境变量,则 pmcmd 使用默认超时值。 默认值为 180。 |
-user -u | 用户名 | 如果不指定用户名环境变量,则在命令行模式下为必需项。 用户名。 在交互模式下不使用。 |
-uservar -uv | userEnvVar | 指定用户名环境变量。 如果不指定用户名,则在命令行模式下为必需项。 在交互模式下不使用。 |
-password -p | 密码 | 如果不指定密码环境变量,则在命令行模式下为必需项。 密码。 在交互模式下不使用。 |
-passwordvar -pv | passwordEnvVar | 如果不指定密码,则在命令行模式下为必需项。 密码环境变量。 在交互模式下不使用。 |
-usersecuritydomain -usd | 用户安全域 | 在命令行模式下为可选项。 使用 LDAP 身份验证时需要。 用户所属的安全域的名称。 在交互模式下不使用。 默认为“本地”。 |
-usersecuritydomainvar -usdv | userSecuritydomainEnvVar | 在命令行模式下为可选项。 安全域环境变量。 在交互模式下不使用。 |
-folder -f | 文件夹 | 如果工作流名称在存储库中不唯一,则为必需项。 包含工作流的文件夹的名称。 |
-workflow -w | 工作流 | 必需。 工作流的名称。 |
-paramfile | 参数文件 | 可选。 确定在任务或工作流运行时要使用的参数文件。 它会替代工作流或任务的已配置参数文件。 |
-wait -nowait | - | 可选。 配置等待模式: - - wait。 只有在集成服务完成上一命令后,才可输入新的 pmcmd 命令。
- - nowait。 只有在集成服务接收上一命令后,才可输入新的 pmcmd 命令。
默认值为 nowait。 |
-recovery -norecovery | - | 可选。 如果任务是会话,则集成服务将基于配置的恢复策略运行会话。 - - 恢复。 对于为恢复启用的实时会话,集成服务将恢复失败的会话并停止运行工作流中运行的其余任务。
恢复选项与工作流管理器中的“恢复任务”选项相同。 此选项不适用于未启用恢复的会话。 - - 未恢复。 对于启用恢复的实时会话,集成服务不会处理恢复数据。 集成服务在重新启动任务之前会清除操作状态,并清除恢复文件或表。 对于未启用恢复的会话,集成服务会清除操作状态并重新启动任务。
未恢复选项与工作流管理器中的“冷启动任务”选项相同。
如果不为恢复启用的会话提供任何选项,则集成服务将在恢复模式下运行会话。 如果不为未启用恢复的会话提供任何选项,则集成服务将在未恢复模式下运行会话。 |
-runinsname -rn | runInsName | 运行实例的工作流名称,该实例包含要启动的任务。 如果您正在运行并发工作流,则可使用此选项。 |
- | taskInstancePath | 必需。 指定任务名称以及它在工作流中的显示位置。 如果任务在工作流中,则仅输入任务名称。 如果任务在 worklet 中,则输入 WorkletName.TaskName。 输入 taskInstancePath 作为完全限定字符串。 |
将参数文件用于 starttask
启动任务时,可以输入目录和参数文件的名称。 集成服务将使用指定文件中的参数运行任务。
对于 UNIX shell 用户,在参数文件名两侧加上单引号:
-paramfile '$PMRootDir/myfile.txt'
对于 Windows 命令提示符用户,参数文件名的开头或结尾不能包含空格。 如果名称包含空格,则在文件名两侧加上双引号:
-paramfile "$PMRootDir\my file.txt"
写入包含其他计算机上的参数文件的 pmcmd 命令时,请使用反斜杠 (\) 和美元符号 ($)。 这将确保定义变量的计算机展开进程变量。
pmcmd starttask -sv MyIntService -d MyDomain -uv USERNAME -pv PASSWORD ‑f east -w wSalesAvg -paramfile '\$PMRootDir/myfile.txt' taskA