Manejador de línea de mandatos.
El manejador CMDLINE toma un mandato y un punto final como entrada. El manejador CMDLINE utiliza el protocolo SSH para ejecutar el mandato en el sistema de destino y devolver los resultados.
Se pasa un parámetro de metadatos durante una invocación del sistema cuando se llama al manejador. El parámetro es una correlación que contiene el nombre del punto final que representa el sistema de destino. El interlocutor puede asignar como destino cualquier sistema en tiempo de ejecución y pasar el punto final al manejador de mandatos. El interlocutor utiliza cualquier configuración que el punto final tenga en el momento de la invocación.
Propiedades del manejador CMDLINE
El manejador CMDLINE tiene las propiedades siguientes:
- CMDTIMEOUT – El valor de tiempo de espera para la ejecución del mandato
- CONNTIMEOUT – El valor de tiempo de espera para la conexión
- USERNAME – El nombre de usuario para la conexión
- PASSWORD – La contraseña para el nombre de usuario correspondiente
- HOST – El nombre de host del destino en el que se ejecuta el mandato
- PORTNO – El número de puerto del destino donde se ejecuta el mandato
- IGNORESETUPERR – Un valor booleano que indica si se debe ignorar un error al ejecutar el mandato de configuración
- RETRYINTERVAL – El tiempo que se debe esperar entre reintentos de un mandato
- MAXRETRY – El número de intentos de ejecutar un mandato antes de devolver una excepción
- SSHEXIT-La clase de salida Java™ que se puede implementar para personalizar el proceso del manejador
Parámetros de datos del mandato
El parámetro de datos es una representación de matriz de bytes de un documento XML. El parámetro de datos contiene la información siguiente:
- Los códigos correspondientes al mandato de configuración
- El directorio de trabajo
- El mandato que se debe ejecutar
- Cualquier parámetro de sustitución
Códigos disponibles
Están disponibles los códigos siguientes:
- CLWORKINGDIR – Un directorio al que se debe cambiar (
cd) en el sistema remoto antes de ejecutar el mandato. - CLSSETUPCMD – Un mandato de configuración que se debe ejecutar antes del mandato principal. Utilice este código para cualquier configuración de entorno que se deba producir en el sistema remoto antes de que se emita el mandato principal.
- CLCMDPATTERN - Una serie que define el patrón del mandato que se debe ejecutar. El formato de este patrón es similar al de la clase java.text.MessageFormat. Un ejemplo es
ls -l {0}, donde {0} representa un parámetro que se sustituye. - CLSUB0 - El valor que se debe sustituir en las posiciones marcadas por {0} en CLCMDPATTERN.
- CLSUB1 - El valor que se debe sustituir en las posiciones marcadas por {1} en CLCMDPATTERN.
- CLSUBn - El valor que se debe sustituir en las posiciones marcadas por {n} en CLCMDPATTERN. Un código CLSUBn debe equivaler a cada posición de substitución en el código CLCMDPATTERN.
Resultados del mandato
La representación de matriz de bytes de retorno de un documento XML contiene los resultados del mandato. El documento XML contiene códigos que corresponden al valor de retorno, salida estándar y error estándar.
Están disponibles los códigos siguientes:
- CLRETURNCODE – El código de retorno del mandato remoto.
- CLRESPONSEOUT – Los datos devuelve el mandato remoto en el código de salida estándar (STDOUT).
- CLRESPONSEERR – Los datos devuelve el mandato remoto en el código de error estándar (STDERR).