Referencia de comando > Referencia de comando pmcmd > StartTask
  

StartTask

Inicia una tarea.
El comando StartTask emplea la siguiente sintaxis en el modo de línea de comandos:
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
El comando StartTask emplea la siguiente sintaxis en el modo interactivo:
pmcmd StartTask

[<-folder|-f> folder]

<-workflow|-w> workflow

<-paramfile> paramfile]

[-wait|-nowait]

[<-recovery|-norecovery>]

[<-runinsname|-rin> runInsName]

taskInstancePath
La tabla siguiente describe las opciones y los argumentos de pmcmd StartTask:
Opción
Argumento
Descripción
-service
-sv
service
Obligatorio. Nombre del servicio de integración.
-domain
-d
domain
Opcional. Nombre del dominio.
-timeout
-t
timeout
Opcional. Tiempo, en segundos, durante el que pmcmd intenta conectar con el servicio de integración.
Si se omite la opción -timeout, pmcmd utiliza el valor de tiempo de espera especificado en la variable de entorno INFA_CLIENT_RESILIENCE_TIMEOUT. Si la variable de entorno no está definida, pmcmd usa el valor de tiempo de espera predeterminado. El valor predeterminado es 180.
-user
-u
username
Obligatorio en el modo de línea de comandos si no se especifica la variable de entorno de nombre de usuario. Nombre de usuario. No se usa en el modo interactivo.
-uservar
-uv
userEnvVar
Especifica la variable de entorno de nombre de usuario.
Obligatorio en el modo de línea de comandos si no se especifica el nombre de usuario. No se usa en el modo interactivo.
-password
-p
password
Obligatorio en el modo de línea de comandos si no se especifica la variable de entorno de contraseña. Contraseña. No se usa en el modo interactivo.
-passwordvar
-pv
passwordEnvVar
Obligatorio en el modo de línea de comandos si no se especifica la contraseña. Variable de entorno de contraseña. No se usa en el modo interactivo.
-usersecuritydomain
-usd
usersecuritydomain
Opcional en el modo de línea de comandos. Obligatorio si se utiliza autenticación de LDAP. Nombre del dominio de seguridad al que pertenece el usuario. No se usa en el modo interactivo. El valor predeterminado es Native.
-usersecuritydomainvar
-usdv
userSecuritydomainEnvVar
Opcional en el modo de línea de comandos. Variable de entorno de dominio de seguridad. No se usa en el modo interactivo.
-folder
-f
folder
Obligatorio si el nombre del flujo de trabajo no es único en el repositorio. Nombre de la carpeta que contiene el flujo de trabajo.
-workflow
-w
workflow
Obligatorio. Nombre del flujo de trabajo.
-paramfile
paramfile
Opcional. Determina el archivo de parámetros utilizado cuando se ejecuta una tarea o un flujo de trabajo. Reemplaza el archivo de parámetros configurado para la tarea o el flujo de trabajo.
-wait
-nowait
-
Opcional. Configura el modo de espera:
  • - wait. Sólo se puede especificar un nuevo comando pmcmd después de que el servicio de integración complete el comando anterior.
  • - nowait. Se puede especificar un nuevo comando pmcmd después de que el servicio de integración reciba el comando anterior.
El valor predeterminado es nowait.
-recovery
-norecovery
-
Opcional. Si la tarea es una sesión, el servicio de integración ejecuta la sesión en base a la estrategia de recuperación configurada.
  • - recovery. Para las sesiones en tiempo real que se habilitan para la recuperación, el servicio de integración recupera la sesión que causó un error y detiene la ejecución del resto de tareas en el flujo de trabajo.
  • La opción recovery es la misma que la opción recuperar tarea del administrador de flujos de trabajo. Esta opción no es aplicable para sesiones que no tienen la recuperación habilitada.
  • - norecovery. Para las sesiones en tiempo real que se habilitan para la recuperación, el servicio de integración no recupera datos. El servicio de integración elimina el estado de operación y el archivo o tabla de recuperación antes de reiniciar la tarea. Para sesiones que no tienen la recuperación habilitada, el servicio de integración elimina el estado de operación y reinicia la tarea.
  • La opción norecovery es la misma que la opción de tarea de inicio en frío del administrador de flujos de trabajo.
Si no se proporciona ninguna opción para las sesiones con la recuperación habilitada, el servicio de integración ejecuta la sesión en modo de recuperación. Si no se proporciona ninguna opción para las sesiones sin la recuperación habilitada, el servicio de integración ejecuta la sesión en modo de no recuperación.
-runinsname
-rn
runInsName
Nombre de la instancia de ejecución del flujo de trabajo que contiene la tarea que se desea iniciar. Utilice esta opción si va a ejecutar flujos de trabajo simultáneos.
-
taskInstancePath
Obligatorio. Especifica un nombre de tarea y el lugar en que aparece en el flujo de trabajo. Si la tarea se encuentra en un flujo de trabajo, basta con especificar el nombre. Si la tarea se encuentra en un worklet, especifique WorkletName.TaskName. Especifique taskInstancePath como una cadena completa.

Cómo utilizar los archivos de parámetro con starttask

Al iniciar una tarea, si lo desea, puede introducir el directorio y el nombre de un archivo de parámetro. Al hacerlo, el servicio de integración ejecuta la tarea utilizando los parámetros del archivo que haya especificado.
En el caso de los usuarios de shell de UNIX, escriba el nombre del archivo de parámetro entre comillas simples:
-paramfile '$PMRootDir/myfile.txt'
En el caso de los usuarios de línea de comandos de Windows, el nombre del archivo de parámetro no puede contener espacios iniciales ni finales. En caso de que los incluya, escriba el nombre del archivo entre comillas dobles:
-paramfile "$PMRootDir\my file.txt"
Al escribir un comando pmcmd que incluya un archivo de parámetro ubicado en otro equipo, utilice la barra inclinada invertida (\) con el símbolo del dolar ($). De esta forma, se garantiza que el equipo en que se encuentra definida la variable amplíe la variable del proceso.
pmcmd starttask -sv MyIntService -d MyDomain -uv USERNAME -pv PASSWORD ‑f east -w wSalesAvg -paramfile '\$PMRootDir/myfile.txt' taskA